libera_utils.packets.parse_packets_to_dataset

libera_utils.packets.parse_packets_to_dataset(packet_files: list[PathLike | str], packet_definition: str | PathLike, apid: int, **generator_kwargs) → Dataset

Parse packets from files into an xarray Dataset using specified packet definition.

This function does not make any changes to the packet data other than filtering by a single APID.

Parameters:

• packet_files (list[PathLike | str]) – List of filepaths to packet files.

• packet_definition (str | PathLike) – Path to the XTCE packet definition file.

• apid (int) – Application Process Identifier to filter for.

• **generator_kwargs – Additional keyword arguments passed to the packet generator.

Returns:

xarray Dataset containing parsed packet data.

Return type:

xr.Dataset