discretize_scan
===============

.. py:function:: pride.utils.discretize_scan(reference_epoch: datetime.datetime, initial_offset: int, final_offset: int, scan_id: str = '') -> list[datetime.datetime]

   Discretize a scan using internal constraints

   Given the reference epoch, and the initial and final offsets of a scan,
   discretizes it according to internal constraints defined in the `data`
   submodule (`config.yaml`). The constraints are:
   - Minimum number of observations per scan

   Given the initial and final offsets of a scan, the function calculates a
   step size required for the discretization to comply with the minimum number
   of observations per scan defined in `data/config.yaml`, as well as with the
   minimum allowed step size. If all the criteria are met, the function will
   return the default step size, and the associated number of observations.

   :param reference_epoch: Reference initial epoch of the scan
   :param initial_offset: Initial offset of the scan
   :param final_offset: Final offset of the scan
   :param scan_id: ID of the scan (for logging purposes)
   :return discretized_time_range: List of datetime objects representing the
   discretized time range for the scan