libera_utils 1.0.0__tar.gz

libera_utils-1.0.0/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.1
+Name: libera-utils
+Version: 1.0.0
+Summary: Utility package for Libera Science Data Processing and the Libera Science Data Center.
+Author: Stephane Beland
+Author-email: stephane.beland@lasp.colorado.edu
+Requires-Python: >=3.9,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Provides-Extra: plotting
+Requires-Dist: SQLAlchemy (>=1.4,<2.0)
+Requires-Dist: astropy (>=5.1,<6.0)
+Requires-Dist: bitstring (>=3.1,<4.0)
+Requires-Dist: cloudpathlib[s3] (>=0.9,<0.10)
+Requires-Dist: h5py (>=3.3,<4.0)
+Requires-Dist: lasp-packets (>=2.0,<3.0)
+Requires-Dist: matplotlib (>=3.4,<4.0); extra == "plotting"
+Requires-Dist: numpy (>=1.21,<2.0)
+Requires-Dist: psycopg2 (>=2.9,<3.0)
+Requires-Dist: requests (>=2.26,<3.0)
+Requires-Dist: spiceypy (>=5.0,<6.0)
+Requires-Dist: watchtower (>=3.0,<4.0)

libera_utils-1.0.0/libera_utils/__init__.py

@@ -0,0 +1,5 @@
+"""
+libera_utils
+"""
+# Local
+from .db.models import *

libera_utils-1.0.0/libera_utils/cli.py

@@ -0,0 +1,93 @@
+"""Module for the Libera SDC utilities CLI
+
+libera-utils
+    make-kernel
+        jpss-spk
+        jpss-ck
+        azel-ck
+"""
+# Standard
+import argparse
+# Local
+from libera_utils import kernel_maker
+from libera_utils.version import version as libera_utils_version
+
+
+def main(cli_args: list = None):
+    """Main CLI entrypoint that runs the function inferred from the specified subcommand"""
+    args = parse_cli_args(cli_args)
+    args.func(args)
+
+
+def print_version_info(*args):
+    """Print CLI version information"""
+    print(f"Libera SDC utilities CLI\n\tVersion {libera_utils_version()}")
+
+
+def parse_cli_args(cli_args: list):
+    """Parse CLI arguments
+
+    Parameters
+    ----------
+    cli_args : list
+        List of CLI arguments to parse
+
+    Returns
+    -------
+    Namespace
+        Parsed arguments in a Namespace object
+    """
+    parser = argparse.ArgumentParser(prog="libera-utils", description="Libera SDC utilities CLI")
+    parser.add_argument("--version",
+                        action='store_const', dest='func', const=print_version_info,
+                        help="print current version of the CLI")
+
+    subparsers = parser.add_subparsers(description="sub-commands for libera-utils CLI")
+
+    # make-kernel
+    make_kernel_parser = subparsers.add_parser('make-kernel',
+                                               help='generate SPICE kernel from telemetry data')
+
+    make_kernel_subparsers = make_kernel_parser.add_subparsers(description="sub-commands for make-kernel sub-command")
+
+    # make-kernel jpss-spk
+    jpss_spk_parser = make_kernel_subparsers.add_parser('jpss-spk', help="generate JPSS SPK kernel from telemetry")
+    jpss_spk_parser.set_defaults(func=kernel_maker.make_jpss_spk)
+    jpss_spk_parser.add_argument('packet_data_filepaths', nargs='+', type=str,
+                                 help="paths to L0 packet files")
+    jpss_spk_parser.add_argument('--outdir', '-o', type=str,
+                                 required=True,
+                                 help="output directory for generated SPK")
+    jpss_spk_parser.add_argument('--overwrite', action='store_true',
+                                 help="force overwriting an existing kernel if it exists")
+    jpss_spk_parser.add_argument('-v', '--verbose', action='store_true',
+                                 help="set DEBUG level logging output (otherwise set by LIBSDP_STREAM_LOG_LEVEL)")
+
+    # make-kernel jpss-ck
+    jpss_ck_parser = make_kernel_subparsers.add_parser('jpss-ck', help="generate JPSS CK kernel from telemetry")
+    jpss_ck_parser.set_defaults(func=kernel_maker.make_jpss_ck)
+    jpss_ck_parser.add_argument('packet_data_filepaths', nargs='+', type=str,
+                                help="paths to L0 packet files")
+    jpss_ck_parser.add_argument('--outdir', '-o', type=str,
+                                required=True,
+                                help="output directory for generated CK")
+    jpss_ck_parser.add_argument('--overwrite', action='store_true',
+                                help="force overwriting an existing kernel if it exists")
+    jpss_ck_parser.add_argument('-v', '--verbose', action='store_true',
+                                help="set DEBUG level logging output (otherwise set by LIBSDP_STREAM_LOG_LEVEL)")
+
+    # make-kernel azel-ck
+    azel_ck_parser = make_kernel_subparsers.add_parser('azel-ck', help="generate Libera Az-El CK kernel from telemetry")
+    azel_ck_parser.set_defaults(func=kernel_maker.make_azel_ck)
+    azel_ck_parser.add_argument('packet_data_filepaths', nargs='+', type=str,
+                                help="paths to L0 packet files")
+    azel_ck_parser.add_argument('--outdir', '-o', type=str,
+                                required=True,
+                                help="output directory for generated CK")
+    azel_ck_parser.add_argument('--overwrite', action='store_true',
+                                help="force overwriting an existing kernel if it exists")
+    azel_ck_parser.add_argument('-v', '--verbose', action='store_true',
+                                help="set DEBUG level logging output (otherwise set by LIBSDP_STREAM_LOG_LEVEL)")
+
+    parsed_args = parser.parse_args(cli_args)
+    return parsed_args

libera_utils-1.0.0/libera_utils/config.py

@@ -0,0 +1,139 @@
+"""Configuration reader. To modify the configuration, see file: emus_config.json"""
+# Standard
+import json
+import logging
+import os
+from pathlib import Path
+import re
+import string
+import sys
+import warnings
+
+logger = logging.getLogger(__name__)
+
+
+class ConfigurationFormatter(string.Formatter):
+    """Customize the string formatter to replace fields in a config string
+    with values from the configuration dictionary. This will allow configuration
+    parameters in the emus_config.json file to be based off of other configuration
+    parameters by wrapping the configuration key in curly braces."""
+
+    def get_value(self, key: str, *args, **kwargs):
+        """Overrides the default get_value method in the python formatter. This will
+        return the value from the emus configuration with the specified key."""
+        return config.get(key)
+
+
+class _ConfigurationCache:
+    """Class that stores the JSON configuration and provides methods for accessing configuration information"""
+
+    _json_config_filepath = Path(__file__).parent / 'data/config.json'
+
+    # Should handle all floats
+    FLOAT_REGEXP = re.compile(r'^[-+]?([0-9]+|[0-9]*\.[0-9]+)([eE][-+]?[0-9]+)?$')
+    # Example "-12.34E+56"      # sign (-)
+    #     integer (12)
+    #           OR
+    #             int/mantissa (12.34)
+    #                            exponent (E+56)
+
+    def __init__(self):
+        logger.debug("Initializing configuration cache from config.json.")
+        with open(self._json_config_filepath, encoding='utf_8') as config_file:
+            self._cached_json_config = json.load(config_file)
+            self._known_config_variables = set(self._cached_json_config)
+
+    def _format_return_value(self, value: str):
+        """Recursively formats the returned value, looking for config keys to substitute.
+
+        Parameters
+        ----------
+        value : str
+            String to format
+
+        Returns
+        -------
+        str
+        """
+        if isinstance(value, str):
+            formatter = ConfigurationFormatter()
+            # if the string contains only a curly bracket keyword, return the value of get_config(keyword)
+            key_iter = formatter.parse(value)
+            text_and_key = next(key_iter)
+            if text_and_key[0] == '' and not any(key_iter):
+                return config.get(text_and_key[1])
+
+            return formatter.format(value)
+
+        if isinstance(value, list):
+            return [self._format_return_value(x) for x in value]
+
+        if isinstance(value, dict):
+            return {k: self._format_return_value(v) for k, v in value.items()}
+
+        return value
+
+    def _parse_numeric_types(self, value: str):
+        """Checks the final result of a config retrieval. If it is a string that can be interpreted as a float or int,
+        parse it and return that.
+
+        Parameters
+        ----------
+        value : any
+            Final formatted value.
+
+        Returns
+        -------
+        : str or float or int
+        """
+        if not isinstance(value, str):  # Indicates a non-string type came from the JSON config. Leave it as is.
+            return value
+
+        if self.FLOAT_REGEXP.match(value):
+            f = float(value)
+            if f.is_integer():
+                return int(f)
+            return f
+        return value
+
+    def force_reload(self):
+        """Force reloading of the JSON config"""
+        self.__init__()  # pylint: disable=C2801
+
+    def get(self, key):
+        """Retrieves a configuration value from either the cached JSON or from the environment
+
+        Parameters
+        ----------
+        key : str
+            Key for which to retrieve the configured value.
+
+        Returns
+        -------
+        : any
+            Resulting value
+        """
+        if (key != 'PKG_ROOT') and (key not in self._known_config_variables):
+            warnings.warn(f"Configuration key {key} is not known to the config module. "
+                          f"We will try to find it in the environment anyway but a default should be added to "
+                          f"the config.json file.")
+
+        if key is None:
+            return self._cached_json_config
+
+        if key == 'PKG_ROOT':  # Special case for root of installed package
+            return str(Path(sys.modules[__name__.split('.', maxsplit=1)[0]].__file__).parent)
+
+        # Checking the environment first allows easy override of any json config variable
+        if os.getenv(key):
+            result = os.getenv(key)
+            return self._parse_numeric_types(self._format_return_value(result))
+
+        if key in self._cached_json_config:
+            result = self._cached_json_config[key]
+            return self._parse_numeric_types(self._format_return_value(result))
+
+        raise KeyError(f'Configuration variable {key} not found.')
+
+
+config = _ConfigurationCache()

libera_utils-1.0.0/libera_utils/data/config.json

@@ -0,0 +1,48 @@
+{
+  "LIBSDP_LOG_DIR": null,
+  "LIBSDP_STREAM_LOG_LEVEL": "INFO",
+  "LIBSDP_CLOUDWATCH_GROUP": null,
+  "LIBSDP_DATA_DIR": "{PKG_ROOT}/data",
+  "LIBSDP_ATTR": "{LIBSDP_DATA_DIR}/hdf5/attributes.json",
+  "LIBERA_DB_NAME": null,
+  "LIBERA_DB_USER": null,
+  "LIBERA_DB_HOST": null,
+  "JPSS_SCLK": "{LIBSDP_DATA_DIR}/spice/jpss_sclk_v01.tsc",
+  "LIBERA_FK": "{LIBSDP_DATA_DIR}/spice/libera_fk_v01.tf",
+  "EARTH_ASSOC_ITRF93_FK": "{LIBSDP_DATA_DIR}/spice/earth_assoc_itrf93.tf",
+  "JPSS_NORAD_ID": 43013,
+  "JPSS_SC_ID": -143013,
+  "JPSS_GEOLOCATION_PACKET_DEFINITION": "{LIBSDP_DATA_DIR}/jpss1_geolocation_xtce_v1.xml",
+  "MKSPK_SETUPFILE_CONTENTS": {
+    "INPUT_DATA_TYPE": "STATES",
+    "OUTPUT_SPK_TYPE": 13,
+    "OBJECT_ID": -143013,
+    "CENTER_ID": 399,
+    "REF_FRAME_NAME": "ITRF93",
+    "PRODUCER_ID": "Gavin Medley (for Libera SDC)",
+    "DATA_ORDER": ["epoch", "x", "y", "z", "vx", "vy", "vz"],
+    "DATA_DELIMITER": " ",
+    "LEAPSECONDS_FILE": "auto-populated",
+    "INPUT_DATA_UNITS": { "ANGLES": "DEGREES", "DISTANCES": "METERS" },
+    "IGNORE_FIRST_LINE": 0,
+    "LINES_PER_RECORD": 1,
+    "TIME_WRAPPER": "# ETSECONDS",
+    "POLYNOM_DEGREE": 7,
+    "APPEND_TO_OUTPUT": "NO",
+    "FRAME_DEF_FILE": "{LIBERA_FK}"
+  },
+  "MSOPCK_SETUPFILE_CONTENTS": {
+    "LSK_FILE_NAME": "auto-populated",
+    "SCLK_FILE_NAME": "{JPSS_SCLK}",
+    "REFERENCE_FRAME_NAME": "J2000",
+    "INPUT_DATA_TYPE": "SPICE QUATERNIONS",
+    "INPUT_TIME_TYPE": "SCLK",
+    "ANGULAR_RATE_PRESENT": "MAKE UP/NO AVERAGING",
+    "CHECK_TIME_ORDER": "YES",
+    "CK_TYPE": 3,
+    "INSTRUMENT_ID": -143013000,
+    "INCLUDE_INTERVAL_TABLE": "YES",
+    "PRODUCER_ID": "Gavin Medley (for Libera SDC)"
+  },
+  "TEST_KEY": -999
+}

libera_utils-1.0.0/libera_utils/data/hdf5/attributes.json

@@ -0,0 +1,9 @@
+{
+    "title": "Level 2 Libera Data",
+    "version": "0.0.0",
+    "doi": "doi: doi",
+    "institution": "NASA's EVC1 Science Investigator-led Processing System",
+    "source": "satellite observation",
+    "pi": "Peter Pilewskie",
+    "institute": "Laboratory for Atmospheric and Space Physics. Boulder, Colorado, USA."
+}

libera_utils-1.0.0/libera_utils/data/jpss1_geolocation_xtce_v1.xml

@@ -0,0 +1,217 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<xtce:SpaceSystem xmlns:xtce="http://www.omg.org/space/xtce" name="Libera">
+    <xtce:Header date="2021-06-08T14:11:00MST" version="1.0" author="Gavin Medley"/>
+    <xtce:TelemetryMetaData>
+        <xtce:ParameterTypeSet>
+            <xtce:IntegerParameterType name="VERSION_Type" signed="false">
+                <xtce:UnitSet/>
+                <xtce:IntegerDataEncoding sizeInBits="3" encoding="unsigned"/>
+            </xtce:IntegerParameterType>
+            <xtce:IntegerParameterType name="TYPE_Type" signed="false">
+                <xtce:UnitSet/>
+                <xtce:IntegerDataEncoding sizeInBits="1" encoding="unsigned"/>
+            </xtce:IntegerParameterType>
+            <xtce:IntegerParameterType name="SEC_HDR_FLG_Type" signed="false">
+                <xtce:UnitSet/>
+                <xtce:IntegerDataEncoding sizeInBits="1" encoding="unsigned"/>
+            </xtce:IntegerParameterType>
+            <xtce:IntegerParameterType name="PKT_APID_Type" signed="false">
+                <xtce:UnitSet/>
+                <xtce:IntegerDataEncoding sizeInBits="11" encoding="unsigned"/>
+            </xtce:IntegerParameterType>
+            <xtce:IntegerParameterType name="SEQ_FLGS_Type" signed="false">
+                <xtce:UnitSet/>
+                <xtce:IntegerDataEncoding sizeInBits="2" encoding="unsigned"/>
+            </xtce:IntegerParameterType>
+            <xtce:IntegerParameterType name="SRC_SEQ_CTR_Type" signed="false">
+                <xtce:UnitSet/>
+                <xtce:IntegerDataEncoding sizeInBits="14" encoding="unsigned"/>
+            </xtce:IntegerParameterType>
+            <xtce:IntegerParameterType name="PKT_LEN_Type" signed="false">
+                <xtce:UnitSet/>
+                <xtce:IntegerDataEncoding sizeInBits="16" encoding="unsigned"/>
+            </xtce:IntegerParameterType>
+            <xtce:FloatParameterType name="DOY_Type">
+                <xtce:UnitSet>
+                    <xtce:Unit>day</xtce:Unit>
+                </xtce:UnitSet>
+                <xtce:IntegerDataEncoding sizeInBits="16" encoding="unsigned"/>
+            </xtce:FloatParameterType>
+            <xtce:FloatParameterType name="MSEC_Type">
+                <xtce:UnitSet>
+                    <xtce:Unit>ms</xtce:Unit>
+                </xtce:UnitSet>
+                <xtce:IntegerDataEncoding sizeInBits="32" encoding="unsigned"/>
+            </xtce:FloatParameterType>
+            <xtce:FloatParameterType name="USEC_Type">
+                <xtce:UnitSet>
+                    <xtce:Unit>us</xtce:Unit>
+                </xtce:UnitSet>
+                <xtce:IntegerDataEncoding sizeInBits="16" encoding="unsigned"/>
+            </xtce:FloatParameterType>
+            <xtce:IntegerParameterType name="ADASCID_Type" signed="false">
+                <xtce:UnitSet/>
+                <xtce:IntegerDataEncoding sizeInBits="8" encoding="unsigned"/>
+            </xtce:IntegerParameterType>
+            <xtce:IntegerParameterType name="ADAETDAY_Type" signed="false">
+                <xtce:UnitSet>
+                    <xtce:Unit>day</xtce:Unit>
+                </xtce:UnitSet>
+                <xtce:IntegerDataEncoding sizeInBits="16" encoding="unsigned"/>
+            </xtce:IntegerParameterType>
+            <xtce:IntegerParameterType name="ADAETMS_Type" signed="false">
+                <xtce:UnitSet>
+                    <xtce:Unit>ms</xtce:Unit>
+                </xtce:UnitSet>
+                <xtce:IntegerDataEncoding sizeInBits="32" encoding="unsigned"/>
+            </xtce:IntegerParameterType>
+            <xtce:IntegerParameterType name="ADAETUS_Type" signed="false">
+                <xtce:UnitSet>
+                    <xtce:Unit>us</xtce:Unit>
+                </xtce:UnitSet>
+                <xtce:IntegerDataEncoding sizeInBits="16" encoding="unsigned"/>
+            </xtce:IntegerParameterType>
+            <xtce:FloatParameterType name="ADGPSPOS_Type">
+                <xtce:UnitSet>
+                    <xtce:Unit>m</xtce:Unit>
+                </xtce:UnitSet>
+                <xtce:FloatDataEncoding sizeInBits="32" encoding="IEEE-754"/>
+            </xtce:FloatParameterType>
+            <xtce:FloatParameterType name="ADGPSVEL_Type">
+                <xtce:UnitSet>
+                    <xtce:Unit>m/s</xtce:Unit>
+                </xtce:UnitSet>
+                <xtce:FloatDataEncoding sizeInBits="32" encoding="IEEE-754"/>
+            </xtce:FloatParameterType>
+            <xtce:FloatParameterType name="ADCFAQ_Type">
+                <xtce:UnitSet/>
+                <xtce:FloatDataEncoding sizeInBits="32" encoding="IEEE-754"/>
+            </xtce:FloatParameterType>
+        </xtce:ParameterTypeSet>
+        <xtce:ParameterSet>
+            <xtce:Parameter name="VERSION" parameterTypeRef="VERSION_Type">
+                <xtce:LongDescription>Not really used. We aren't changing the version of CCSDS that we use.</xtce:LongDescription>
+            </xtce:Parameter>
+            <xtce:Parameter name="TYPE" parameterTypeRef="TYPE_Type">
+                <xtce:LongDescription>Indicates whether this packet is CMD or TLM. TLM is 0.</xtce:LongDescription>
+            </xtce:Parameter>
+            <xtce:Parameter name="SEC_HDR_FLG" parameterTypeRef="SEC_HDR_FLG_Type">
+                <xtce:LongDescription>Always 1 - indicates that there is a secondary header.</xtce:LongDescription>
+            </xtce:Parameter>
+            <xtce:Parameter name="PKT_APID" parameterTypeRef="PKT_APID_Type">
+                <xtce:LongDescription>Unique to each packet type.</xtce:LongDescription>
+            </xtce:Parameter>
+            <xtce:Parameter name="SEQ_FLGS" parameterTypeRef="SEQ_FLGS_Type">
+                <xtce:LongDescription>Always set to 1.</xtce:LongDescription>
+            </xtce:Parameter>
+            <xtce:Parameter name="SRC_SEQ_CTR" parameterTypeRef="SRC_SEQ_CTR_Type">
+                <xtce:LongDescription>Increments from 0 at reset for each packet issued of that APID. Rolls over at 14b.</xtce:LongDescription>
+            </xtce:Parameter>
+            <xtce:Parameter name="PKT_LEN" parameterTypeRef="PKT_LEN_Type">
+                <xtce:LongDescription>Number of bytes of the data field following the primary header -1. (To get the length of the whole packet, add 7)</xtce:LongDescription>
+            </xtce:Parameter>
+            <xtce:Parameter name="DOY" parameterTypeRef="DOY_Type" shortDescription="Secondary Header Day of Year">
+                <xtce:LongDescription>CCSDS Packet 2nd Header Day of Year in days.</xtce:LongDescription>
+            </xtce:Parameter>
+            <xtce:Parameter name="MSEC" parameterTypeRef="MSEC_Type" shortDescription="Secondary Header Coarse Time (millisecond)">
+                <xtce:LongDescription>CCSDS Packet 2nd Header Coarse Time in milliseconds.</xtce:LongDescription>
+            </xtce:Parameter>
+            <xtce:Parameter name="USEC" parameterTypeRef="USEC_Type" shortDescription="Secondary Header Fine Time (microsecond)">
+                <xtce:LongDescription>CCSDS Packet 2nd Header Fine Time in microseconds.</xtce:LongDescription>
+            </xtce:Parameter>
+            <xtce:Parameter name="ADAESCID" parameterTypeRef="ADASCID_Type" shortDescription="Spacecraft ID"/>
+            <xtce:Parameter name="ADAET1DAY" parameterTypeRef="ADAETDAY_Type" shortDescription="Ephemeris Valid Time, Days Since 1/1/1958"/>
+            <xtce:Parameter name="ADAET1MS" parameterTypeRef="ADAETMS_Type" shortDescription="Ephemeris Valid Time, Milliseconds of Day"/>
+            <xtce:Parameter name="ADAET1US" parameterTypeRef="ADAETUS_Type" shortDescription="Ephemeris Valid Time, Microseconds of Milliseconds"/>
+            <xtce:Parameter name="ADGPSPOSX" parameterTypeRef="ADGPSPOS_Type" shortDescription="Ephemeris Position (ECEF) X"/>
+            <xtce:Parameter name="ADGPSPOSY" parameterTypeRef="ADGPSPOS_Type" shortDescription="Ephemeris Position (ECEF) Y"/>
+            <xtce:Parameter name="ADGPSPOSZ" parameterTypeRef="ADGPSPOS_Type" shortDescription="Ephemeris Position (ECEF) Z"/>
+            <xtce:Parameter name="ADGPSVELX" parameterTypeRef="ADGPSVEL_Type" shortDescription="Ephemeris Velocity (ECEF) X"/>
+            <xtce:Parameter name="ADGPSVELY" parameterTypeRef="ADGPSVEL_Type" shortDescription="Ephemeris Velocity (ECEF) Y"/>
+            <xtce:Parameter name="ADGPSVELZ" parameterTypeRef="ADGPSVEL_Type" shortDescription="Ephemeris Velocity (ECEF) Z"/>
+            <xtce:Parameter name="ADAET2DAY" parameterTypeRef="ADAETDAY_Type" shortDescription="Attitude Valid Time, Days Since 1/1/1958"/>
+            <xtce:Parameter name="ADAET2MS" parameterTypeRef="ADAETMS_Type" shortDescription="Attitude Valid Time, Milliseconds of Day"/>
+            <xtce:Parameter name="ADAET2US" parameterTypeRef="ADAETUS_Type" shortDescription="Attitude Valid Time, Microseconds of Milliseconds"/>
+            <xtce:Parameter name="ADCFAQ1" parameterTypeRef="ADCFAQ_Type" shortDescription="Control Frame Attitude Q1 (i)"/>
+            <xtce:Parameter name="ADCFAQ2" parameterTypeRef="ADCFAQ_Type" shortDescription="Control Frame Attitude Q2 (j)"/>
+            <xtce:Parameter name="ADCFAQ3" parameterTypeRef="ADCFAQ_Type" shortDescription="Control Frame Attitude Q3 (k)"/>
+            <xtce:Parameter name="ADCFAQ4" parameterTypeRef="ADCFAQ_Type" shortDescription="Control Frame Attitude Q4 (scalar)"/>
+        </xtce:ParameterSet>
+        <xtce:ContainerSet>
+            <xtce:SequenceContainer name="CCSDSPacket" abstract="true">
+                <xtce:LongDescription>Super-container for telemetry and command packets</xtce:LongDescription>
+                <xtce:AncillaryDataSet>
+                    <xtce:AncillaryData name="topLevelPacket">false</xtce:AncillaryData>
+                </xtce:AncillaryDataSet>
+                <xtce:EntryList>
+                    <xtce:ParameterRefEntry parameterRef="VERSION"/>
+                    <xtce:ParameterRefEntry parameterRef="TYPE"/>
+                    <xtce:ParameterRefEntry parameterRef="SEC_HDR_FLG"/>
+                    <xtce:ParameterRefEntry parameterRef="PKT_APID"/>
+                    <xtce:ParameterRefEntry parameterRef="SEQ_FLGS"/>
+                    <xtce:ParameterRefEntry parameterRef="SRC_SEQ_CTR"/>
+                    <xtce:ParameterRefEntry parameterRef="PKT_LEN"/>
+                </xtce:EntryList>
+            </xtce:SequenceContainer>
+            <xtce:SequenceContainer name="CCSDSTelemetryPacket" abstract="true">
+                <xtce:LongDescription>Super-container for all telemetry packets</xtce:LongDescription>
+                <xtce:AncillaryDataSet>
+                    <xtce:AncillaryData name="topLevelPacket">false</xtce:AncillaryData>
+                </xtce:AncillaryDataSet>
+                <xtce:EntryList/>
+                <xtce:BaseContainer containerRef="CCSDSPacket">
+                    <xtce:RestrictionCriteria>
+                        <xtce:ComparisonList>
+                            <xtce:Comparison parameterRef="VERSION" value="0" useCalibratedValue="false"/>
+                            <xtce:Comparison parameterRef="TYPE" value="0" useCalibratedValue="false"/>
+                        </xtce:ComparisonList>
+                    </xtce:RestrictionCriteria>
+                </xtce:BaseContainer>
+            </xtce:SequenceContainer>
+            <xtce:SequenceContainer name="SecondaryHeaderContainer" abstract="true">
+                <xtce:LongDescription>Container for telemetry secondary header items</xtce:LongDescription>
+                <xtce:AncillaryDataSet>
+                    <xtce:AncillaryData name="topLevelPacket">false</xtce:AncillaryData>
+                </xtce:AncillaryDataSet>
+                <xtce:EntryList>
+                    <xtce:ParameterRefEntry parameterRef="DOY"/>
+                    <xtce:ParameterRefEntry parameterRef="MSEC"/>
+                    <xtce:ParameterRefEntry parameterRef="USEC"/>
+                </xtce:EntryList>
+            </xtce:SequenceContainer>
+            <xtce:SequenceContainer name="JPSS_ATT_EPHEM" shortDescription="Spacecraft Attitude and Ephemeris">
+                <xtce:LongDescription>Spacecraft Attitude and Ephemeris packet used to geolocate mission data</xtce:LongDescription>
+                <xtce:AncillaryDataSet>
+                    <xtce:AncillaryData name="topLevelPacket">true</xtce:AncillaryData>
+                </xtce:AncillaryDataSet>
+                <xtce:EntryList>
+                    <xtce:ContainerRefEntry containerRef="SecondaryHeaderContainer"/>
+                    <xtce:ParameterRefEntry parameterRef="ADAESCID"/>
+                    <xtce:ParameterRefEntry parameterRef="ADAET1DAY"/>
+                    <xtce:ParameterRefEntry parameterRef="ADAET1MS"/>
+                    <xtce:ParameterRefEntry parameterRef="ADAET1US"/>
+                    <xtce:ParameterRefEntry parameterRef="ADGPSPOSX"/>
+                    <xtce:ParameterRefEntry parameterRef="ADGPSPOSY"/>
+                    <xtce:ParameterRefEntry parameterRef="ADGPSPOSZ"/>
+                    <xtce:ParameterRefEntry parameterRef="ADGPSVELX"/>
+                    <xtce:ParameterRefEntry parameterRef="ADGPSVELY"/>
+                    <xtce:ParameterRefEntry parameterRef="ADGPSVELZ"/>
+                    <xtce:ParameterRefEntry parameterRef="ADAET2DAY"/>
+                    <xtce:ParameterRefEntry parameterRef="ADAET2MS"/>
+                    <xtce:ParameterRefEntry parameterRef="ADAET2US"/>
+                    <xtce:ParameterRefEntry parameterRef="ADCFAQ1"/>
+                    <xtce:ParameterRefEntry parameterRef="ADCFAQ2"/>
+                    <xtce:ParameterRefEntry parameterRef="ADCFAQ3"/>
+                    <xtce:ParameterRefEntry parameterRef="ADCFAQ4"/>
+                </xtce:EntryList>
+                <xtce:BaseContainer containerRef="CCSDSTelemetryPacket">
+                    <xtce:RestrictionCriteria>
+                        <xtce:ComparisonList>
+                            <xtce:Comparison parameterRef="PKT_APID" value="11" useCalibratedValue="false"/>
+                        </xtce:ComparisonList>
+                    </xtce:RestrictionCriteria>
+                </xtce:BaseContainer>
+            </xtce:SequenceContainer>
+        </xtce:ContainerSet>
+    </xtce:TelemetryMetaData>
+</xtce:SpaceSystem>