Pre-Registration Evaluation

Orders the given stacks by likelihood of yielding a successful alignment when using phase-cross-correlation to align by translation

Parameters

imagestacks

List of imagestacks that require the same alignment

inputs_are_stacks

If true: Will treat imagestacks input of shape [B,N,M,H,W] as [B*N,M,H,W]

stack_names

Names of the different stacks

preferences

List of indices or names (if provided) that will take precedence over the calculated ranking

relevant_stacks

Amount of stacks that will be returned

Outputs

full_ranking

All indices in the calculated order

ranking

Identical to full_ranking, but truncated to {relevant_stacks} elements if specified

stack_names

The names of the first {relevant_stacks} stacks, if stack_names have been specified

Notes

This ranking is only relevant for images requiring translations and does not have meaningful output in other cases

The ranking is based on the phase-cross-correlation algorithm. The cross-correlogram between the first and every other image is calculated, which has a peak corresponding to the shift between the images. By taking the ratio of the peak value and the mean, we can examine how sure this method would be and how much the two images correspond to a pure translation