manual_registration

Attributes

PREV_REF_LABEL
NEXT_REF_LABEL
NO_REF_LABEL

Classes

ManualImageCorrection

Manual image correction using a graphical user interface. Corrections

Functions

apply_transform(ty, tx, theta, coordinates)	Apply transformation to coordinates. Coordinates are expected to be
apply_scaling(data, vmin, vmax)	Rescale image intensities from (vmin, vmax) to (0.0, 1.0). Values
transform_and_rescale_slice(slice, ty, tx, theta, ...)	Transform and rescale 2D slice. Transform consists of a translation

Module Contents

manual_registration.PREV_REF_LABEL = 'Previous slice as reference'

manual_registration.NEXT_REF_LABEL = 'Next slice as reference'

manual_registration.NO_REF_LABEL = 'No reference slice'

class manual_registration.ManualImageCorrection(data, resolution, downsample_factor, transforms=None, custom_ranges=None)

Manual image correction using a graphical user interface. Corrections include independent translation and rotation of each z-slice as well as image intensities rescaling per z-slice.

Parameters:

• data (ndarray of shape (nz, ny, nx)) – Stack of images, where images are stacked along the first axis (z).

• resolution (3-tuple) – Resolution of the dataset (rz, ry, rx).

• downsample_factor (int) – Factor by which the full resolution images are downscaled prior to rendering. Tradeoff between image quality and interactivity of the GUI. Does not influence the resolution of the corrected image.

• transforms (ndarray (nz, 3), optional) – Transform for each slice where each array (3,) contains a translation (ty, tx) and a rotation (theta).

• custom_ranges (ndarray (nz, 2), optional) – Intensities for rescaling each slice. One (vmin, vmax) per slice.

downsample

max_z

image_interpolator

grid_coordinates

transforms = None

custom_ranges = None

ref_z_mode = 'No reference slice'

current_x

current_y

current_z = 0

axim_a

axim_b

axim_c

scalebar

s_offset_a

s_offset_b

s_current_z

s_current_y

s_current_x

s_theta

radio_buttons

start()

Start GUI.

Returns:

return – True when the window closes.

Return type:

bool

on_change_scaling(scaling_range)

Return type:

None

on_change_z(val)

Return type:

None

on_change_y(val)

Return type:

None

on_change_x(val)

Return type:

None

on_change_offset_a(val)

Return type:

None

on_change_offset_b(val)

Return type:

None

on_change_theta(val)

Return type:

None

on_change_ref_z(label)

Return type:

None

transform_coordinates(coordinates, z=None)

apply_scaling(data, z=None)

draw_cursor(data)

get_view_a()

get_view_b()

get_view_c()

save_results(filename)

Save resulting corrections to npz file.

Parameters:

filename (string or Path) – Output filename.

Return type:

None

manual_registration.apply_transform(ty, tx, theta, coordinates)

Apply transformation to coordinates. Coordinates are expected to be of shape (nz, ny, nx, 3), with each coordinate given in the order (z, y, x).

Parameters:

• ty (float or ndarray of shape (nz,)) – Translation along y axis.

• tx (float or ndarray of shape (nz,)) – Translation along x axis.

• theta (float or ndarray of shape (nz,)) – Rotation around z axis in radians. The center of rotation is the center of the image.

Returns:

coordinates – Transformed coordinates.

Return type:

ndarray (nz, ny, nx, 3)

manual_registration.apply_scaling(data, vmin, vmax)

Rescale image intensities from (vmin, vmax) to (0.0, 1.0). Values outside the range (vmin, vmax) are clipped.

Rescaling can be performed with a single range for the whole image or with a different range for each ROW. In the case, the first dimension of data should correspond to the number of elements in vmin, vmax.

Parameters:

• data (ndarray) – The intensities to rescale.

• vmin (float or ndarray of shape (data.shape[0],)) – Minimum value. Will be worth 0 after rescaling.

• vmax (float or ndarray of shape (data.shape[0],)) – Maximum value. Will be worth 1 after rescaling.

Returns:

data – Recaled intensities.

Return type:

ndarray

manual_registration.transform_and_rescale_slice(slice, ty, tx, theta, vmin, vmax)

Transform and rescale 2D slice. Transform consists of a translation (ty, tx) and a rotation theta. Rescaling clips intensities to (vmin, vmax) and rescales the resulting values to the range (0, 1).

Parameters:

• slice (ndarray of shape (ny, nx)) – Slice to process.

• ty (float) – Translation along y axis (first axis).

• tx (float) – Translation along x axis (second axis).

• theta (float) – Rotation in radians.

• vmin (float) – Minimum value for rescaling.

• vmax (float) – Maximum value for rescaling.

Returns:

slice – Processed slice.

Return type:

ndarray of shape (ny, nx)