warp_pet_to_atlas
=========================================

.. py:function:: petpal.preproc.register.warp_pet_to_atlas(input_image_path: str, anat_image_path: str, atlas_image_path: str, type_of_transform: str = 'SyN', **kwargs) -> ants.ANTsImage

   Warp a (3D or 4D) PET image (in anatomical space) to atlas space using an anatomical image.


   :param input_image_path: Path to PET Image to be registered to atlas. Must be in
                            anatomical space (i.e. same space as anat_image_path image). May be 3D or 4D.
   :type input_image_path: str
   :param anat_image_path: Path to anatomical image used to compute registration to atlas space.
   :type anat_image_path: str
   :param atlas_image_path: Path to atlas to which input image is warped.
   :type atlas_image_path: str
   :param type_of_transform: Type of non-linear transform applied to input
                             image using ants.registration. Default is 'SyN' (Symmetric Normalization).
   :type type_of_transform: str
   :param kwargs: Additional arguments passed to ants.registration().
   :type kwargs: keyword arguments

   :returns: *ants.ANTsImage* -- Input image warped to atlas space.