register_pet
====================================

.. py:function:: petpal.preproc.register.register_pet(input_reg_image_path: str, out_image_path: str, reference_image_path: str, motion_target_option: Union[str, tuple], verbose: bool, type_of_transform: str = 'DenseRigid', **kwargs)

   Computes and runs rigid registration of 4D PET image series to 3D anatomical image, typically
   a T1 MRI. Runs rigid registration module from Advanced Normalisation Tools (ANTs) with  default
   inputs. Will upsample PET image to the resolution of anatomical imaging.

   :param input_reg_image_path: Path to a .nii or .nii.gz file containing a 4D
                                PET image to be registered to anatomical space.
   :type input_reg_image_path: str
   :param reference_image_path: Path to a .nii or .nii.gz file containing a 3D
                                anatomical image to which PET image is registered.
   :type reference_image_path: str
   :param motion_target_option: Target image for computing
                                transformation. See :meth:`determine_motion_target`.
   :type motion_target_option: str | tuple
   :param type_of_transform: Type of transform to perform on the PET image, must be one of
                             antspy's transformation types, i.e. 'DenseRigid' or 'Translation'. Any transformation
                             type that uses >6 degrees of freedom is not recommended, use with caution. See
                             :py:func:`ants.registration`.
   :type type_of_transform: str
   :param out_image_path: Path to a .nii or .nii.gz file to which the registered PET series
                          is written.
   :type out_image_path: str
   :param verbose: Set to ``True`` to output processing information.
   :type verbose: bool
   :param kwargs: Additional arguments passed to :py:func:`ants.registration`.
   :type kwargs: keyword arguments