dbdicom.extensions.vreg.apply_translation#

dbdicom.extensions.vreg.apply_translation(series_moving: Series, parameters: ndarray, target: Series | None = None, description: str | None = None) Series[source]#

Apply active translation of an image volume.

Parameters:
  • series_moving (dbdicom.Series) – Series containing the volune to be moved.

  • parameters (np.ndarray) – three-element numpy array with coordinates of the translation in the absolute reference frame (mm).

  • target (dbdicom.Series, optional) – If provided, the result is mapped onto the geometry of this series. If none is provided, the result has the same geometry of the moving series. Defaults to None.

Raises:
  • ValueError – If the moving series contains multiple slice groups with different orientations.

  • ValueError – If the array to be moved is empty.

Returns:

Sibling dbdicom series in the same study, containing the translated volume.

Return type:

dbdicom.Series