Imaging tasks

How to use

These tasks come from ewoksndreg. It can be installed with

pip install ewoksndreg

ℹ️ These tasks are used at the following ESRF beamlines: ID16b, ID21

Example2DStack

Generate example images with successive transformations to test registration methods.

Identifier:

ewoksndreg.tasks.example2d_stack.Example2DStack

Task type:

class

Required inputs:

transformation_type, name

Optional inputs:

nimages, add_noise_dim, shape

Outputs:

transformations, imagestack

FluoStack

Fetch a stack of images corresponding to the given counter from the given h5 file

Identifier:

ewoksndreg.tasks.fluo_stack.FluoStack

Task type:

class

Required inputs:

path, stack

Optional inputs:

normalize, exclude

Outputs:

stack_name, energies, imagestack

FluoAllStacks

Fetch all of the different counters from a given h5 file

Identifier:

ewoksndreg.tasks.fluo_stack.FluoAllStacks

Task type:

class

Required inputs:

path

Optional inputs:

normalize, exclude, stack_names

Outputs:

stack_names, imagestacks

ID16BFileRead

Identifier:

ewoksndreg.tasks.id16b_file_read.ID16BFileRead

Task type:

class

Required inputs:

recsuffix, scandir

Optional inputs:

url, normalize

Outputs:

imagestack

Reg2DFeatures

Use an feature-based registration method to calculate transformations to register the images in the stack.

Identifier:

ewoksndreg.tasks.reg2d_features.Reg2DFeatures

Task type:

class

Required inputs:

matcher, transformation_type, detector, mapper, imagestack

Optional inputs:

inputs_are_stacks, reference

Outputs:

matches, transformations, features

Reg2DIntensities

Use an intensity-based registration method to calculate transformations to register the 2D-images in the stack.

Identifier:

ewoksndreg.tasks.reg2d_intensities.Reg2DIntensities

Task type:

class

Required inputs:

transformation_type, mapper, imagestack

Optional inputs:

mask, block_size, preprocessing_options, method_options, inputs_are_stacks, reference

Outputs:

transformations

Reg2DPreEvaluation

Given several different stacks of images requiring the same alignment, create a ranking of which stacks might be the most suitable to get a correct alignment.

Identifier:

ewoksndreg.tasks.reg2d_multistack.Reg2DPreEvaluation

Task type:

class

Required inputs:

imagestacks

Optional inputs:

preferences, relevant_stacks, inputs_are_stacks, stack_names

Outputs:

ranking, full_ranking, stack_names

Reg2DPostEvaluation

Given several stacks of images requiring the same alignment and their calculated transformations, determine the stack and list of transformations that resulted in the best registration.

Identifier:

ewoksndreg.tasks.reg2d_multistack.Reg2DPostEvaluation

Task type:

class

Required inputs:

transformations, imagestacks

Optional inputs:

url, inputs_are_stacks, chosen_stack

Outputs:

transformations, imagestack, imagestacks

Reg2DTransform

Apply transformations calculated from image registration to images.

Identifier:

ewoksndreg.tasks.reg2d_transform.Reg2DTransform

Task type:

class

Required inputs:

transformations, imagestack

Optional inputs:

stack_names, inputs_are_stacks, url, crop, interpolation_order

Outputs:

imagestack

SelectSlice

Slice out a subvolume of the imagestack

Identifier:

ewoksndreg.tasks.select_slice.SelectSlice

Task type:

class

Required inputs:

imagestack

Optional inputs:

x, y, z, url, inputs_are_stacks

Outputs:

imagestack