Skip to content

nabu.preproc.shift

source module nabu.preproc.shift

Classes

  • VerticalShift — This class is used when a vertical translation (along the tomography rotation axis) occurred.

source class VerticalShift(radios_shape, shifts)

This class is used when a vertical translation (along the tomography rotation axis) occurred.

These translations are meant "per projection" and can be due either to mechanical errors, or can be applied purposefully with known motor movements to smear rings artefacts.

The object is initialised with an array of shifts: one shift for each projection. A positive shifts means that the axis has moved in the positive Z direction. The interpolation is done taking for a pixel (y,x) the pixel found at (y+shft,x) in the recorded images.

The method apply_vertical_shifts performs the corrections on the radios.

Parameters

  • radios_shape : tuple — Shape of the radios chunk, in the form (n_radios, n_y, n_x)

  • shifts : sequence of floats — one shift for each projection

Notes

During the acquisition, there might be other translations, each of them orthogonal to the rotation axis. - A "horizontal" translation in the detector plane: this is handled directly in the Backprojection operation. - A translation along the beam direction: this one is of no concern for parallel-beam geometry

Methods

  • apply_vertical_shifts — Parameters

    radios: a sequence of np.array The input radios. If the optional parameter is not given, they are modified in-place iangles: a sequence of integers Must have the same length as radios. It contains the index at which the shift is found in self.shifts given by shifts argument in the initialisation of the object. output: a sequence of np.array, optional If given, it will be modified to contain the shifted radios. Must be of the same shape of radios.

source method VerticalShift.apply_vertical_shifts(radios, iangles=None, output=None)

Parameters

radios: a sequence of np.array The input radios. If the optional parameter is not given, they are modified in-place iangles: a sequence of integers Must have the same length as radios. It contains the index at which the shift is found in self.shifts given by shifts argument in the initialisation of the object. output: a sequence of np.array, optional If given, it will be modified to contain the shifted radios. Must be of the same shape of radios.