libera_utils.kernel_maker.create_jpss_kernel_dataframe_from_csv#

libera_utils.kernel_maker.create_jpss_kernel_dataframe_from_csv(csv_path: CloudPath | Path) → tuple[DataFrame, tuple[datetime, datetime]]#

Create a Curryer-compatible JPSS kernel DataFrame from a CSV ephemeris file.

This function reads a CSV file containing simulated JPSS ephemeris data with GPS time, position, and velocity information. It converts the GPS time to UTC and then to SPICE Ephemeris Time (ET) for use in kernel generation.

Parameters:

csv_path (filenaming.PathType) – Path to the CSV ephemeris file (local or S3).

Returns:

A tuple containing: - DataFrame with ET time columns (ADGPS_JPSS_ET and ADCFA_JPSS_ET)

and position/velocity data fields

  • UTC time range tuple (start, end) for the data

Return type:

tuple[pd.DataFrame, tuple[datetime, datetime]]

Raises:

  • FileNotFoundError – If the CSV file does not exist at the specified path

  • ValueError – If required columns are missing from the CSV file

Notes

  • Requires SPICE leap second kernel (LSK) to be loaded for ET conversion

  • Creates both ADGPS_JPSS_ET and ADCFA_JPSS_ET columns with identical values