KPL/FK Frame (FK) SPICE kernel file for TGO-specific science generic frames =============================================================================== This frames kernel defines a number of frames used by the TGO science operations centre for Science opportunities identification, data analysis and scientific research. These frames are currently not ``built'' into the SPICE toolkit. Version and Date ------------------------------------------------------------------------------- Version 0.1 -- July 15, 2025 -- Alfredo Escalante Lopez, ESAC/ESA Initial version. References ------------------------------------------------------------------------------- [1] "Frames Required Reading" [2] "Kernel Pool Required Reading" [3] ``Science Operations Centre - Flight Dynamics - Pointing Timeline-ICD'' EXM-GS-ICD-ESC-50003 Issue 1.4, 15-12-2015 Contact Information ------------------------------------------------------------------------------- If you have any questions regarding this file contact SPICE support at ESAC: Alfredo Escalante Lopez (+34) 91-8131-429 spice@cosmos.esa.int, or SPICE support at IKI: Anton Ledkov +7 (495) 333-12-66 aledkov@rssi.ru or NAIF at JPL: Boris Semenov (818) 354-8136 Boris.Semenov@jpl.nasa.gov Implementation Notes ----------------------------------------------------------------------------- This file is used by the SPICE system as follows: programs that make use of this frame kernel must "load" the kernel normally during program initialization. Loading the kernel associates the data items with their names in a data structure called the "kernel pool". The SPICELIB routine FURNSH loads a kernel into the pool as shown below: FORTRAN: (SPICELIB) CALL FURNSH ( frame_kernel_name ) C: (CSPICE) furnsh_c ( frame_kernel_name ); IDL: (ICY) cspice_furnsh, frame_kernel_name MATLAB: (MICE) cspice_furnsh ( 'frame_kernel_name' ) PYTHON: (SPICEYPY)* furnsh( frame_kernel_name ) In order for a program or routine to extract data from the pool, the SPICELIB routines GDPOOL, GIPOOL, and GCPOOL are used. See [2] for more details. This file was created and may be updated with a text editor or word processor. * SPICEYPY is a non-official, community developed Python wrapper for the NAIF SPICE toolkit. Its development is managed on Github. It is available at: https://github.com/AndrewAnnex/SpiceyPy TGO Science Generic NAIF ID Codes ----------------------------------------------------------------------------- The following names and NAIF ID codes are assigned to the natural bodies and other science ``entities'' (the keywords implementing these definitions are located in the section "TGO Science Generic NAIF ID Codes to Name Mapping -- Definition Section" at the end of this file): --------------------- ------- -------------------------- Name ID Synonyms --------------------- ------- -------------------------- C/2025 N1 1004083 C_2025_N1, 3I/ATLAS --------------------- ------- -------------------------- TGO Science Generic Frame ------------------------------------------------------------------------------- The following frames are defined in this kernel file: SPICE Frame Name Long-name ------------------------ --------------------------------------------- C_2025_N1_DUST Comet C/2025 N1 Dust tail frame C_2025_N1_ION Comet C/2025 N1 Ion tail frame This frame has the following center, frame class and NAIF ID: SPICE Frame Name Center Class NAIF ID ------------------------ --------------------- ------- ---------- C_2025_N1_DUST C_2025_N1 DYNAMIC 1004083001 C_2025_N1_ION C_2025_N1 DYNAMIC 1004083002 The keywords implementing a frame definition is located in the "TGO Science Operations Frame Definitions" section. General Notes About This File ------------------------------------------------------------------------------- About Required Data: -------------------- All the dynamic frames defined in this file require at least one of the following kernel types to be loaded prior to their evaluation, normally during program initialization: - Planetary and Satellite ephemeris data (SPK), i.e. de432, de405, etc; - Spacecraft ephemeris data (SPK); Note that loading different kernels will lead to different orientations of the same frame at a given epoch, providing different results from each other, in terms of state vectors referred to these frames. It is strongly recommended to indicate what data have been used in the evaluation of these frames when referring to them, e.g. C_2025_N1_DUST using the IAU 2015 constants, the DE432 ephemeris and the C_2025_N1 ephemeris version NN. TGO Science Generic Frame Definitions ------------------------------------------------------------------------------- This section contains the definition of the TGO science generic frames. Comet C/2025 N1 Dust tail frame (C_2025_N1_DUST) ------------------------------------------------------------------------ Definition: ----------- The C/2025 N1 Comet Dust Coma frame is defined as follows: - the velocity of C/2025 N1 relative to the Sun is the primary vector: +Z axis points to the velocity direction; - the position of C/2025 N1 relative to the Sun is the secondary vector: the projection of the C/2025 N1 - SUN vector perpendicular to the +Z axis defines the +X axis; - +Y axis completes the right-handed system; - the origin of this frame is the center of mass of the C/2025 N1 nucleus. All vectors are geometric: no aberration corrections are used. Required Data: -------------- This frame is defined as a two-vector frame using two different types of specifications for the primary and secondary vectors. The primary and secondary vectors are defined as 'observer-target position' and 'observer-target velocity' vectors, therefore, the ephemeris data required to compute the Sun - C/2025 N1 position vector in the J2000 reference frame must be loaded before using this frame. \begindata FRAME_C_2025_N1_DUST = 1004083001 FRAME_1004083001_NAME = 'C_2025_N1_DUST' FRAME_1004083001_CLASS = 5 FRAME_1004083001_CLASS_ID = 1004083001 FRAME_1004083001_CENTER = 1004083 FRAME_1004083001_RELATIVE = 'J2000' FRAME_1004083001_DEF_STYLE = 'PARAMETERIZED' FRAME_1004083001_FAMILY = 'TWO-VECTOR' FRAME_1004083001_PRI_AXIS = '-Z' FRAME_1004083001_PRI_VECTOR_DEF = 'OBSERVER_TARGET_VELOCITY' FRAME_1004083001_PRI_OBSERVER = 'C_2025_N1' FRAME_1004083001_PRI_TARGET = 'SUN' FRAME_1004083001_PRI_ABCORR = 'NONE' FRAME_1004083001_PRI_FRAME = 'J2000' FRAME_1004083001_SEC_AXIS = 'X' FRAME_1004083001_SEC_VECTOR_DEF = 'OBSERVER_TARGET_POSITION' FRAME_1004083001_SEC_OBSERVER = 'C_2025_N1' FRAME_1004083001_SEC_TARGET = 'SUN' FRAME_1004083001_SEC_ABCORR = 'NONE' \begintext Comet C/2025 N1 Ion tail frame (C_2025_N1_ION) ------------------------------------------------------------------------ Definition: ----------- The C/2025 N1 Comet Ion Coma frame is defined as follows: - the position of C/2025 N1 relative to the Sun is the primary vector: +Z axis points from C/2025 N1 to the Sun; - the velocity of C/2025 N1 relative to the Sun is the secondary vector: the projection of the velocity vector perpendicular to the +Z axis defines the +X axis; - +Y axis completes the right-handed system; - the origin of this frame is the center of mass of C/2025 N1 nucleus. All vectors are geometric: no aberration corrections are used. Required Data: -------------- This frame is defined as a two-vector frame using two different types of specifications for the primary and secondary vectors. The primary and secondary vectors are defined as 'observer-target position' and 'observer-target velocity' vectors, therefore, the ephemeris data required to compute the Sun - C/2025 N1 position vector in the J2000 reference frame must be loaded before using this frame. \begindata FRAME_C_2025_N1_ION = 1004083002 FRAME_1004083002_NAME = 'C_2025_N1_ION' FRAME_1004083002_CLASS = 5 FRAME_1004083002_CLASS_ID = 1004083002 FRAME_1004083002_CENTER = 1004083 FRAME_1004083002_RELATIVE = 'J2000' FRAME_1004083002_DEF_STYLE = 'PARAMETERIZED' FRAME_1004083002_FAMILY = 'TWO-VECTOR' FRAME_1004083002_PRI_AXIS = 'Z' FRAME_1004083002_PRI_VECTOR_DEF = 'OBSERVER_TARGET_POSITION' FRAME_1004083002_PRI_OBSERVER = 'C_2025_N1' FRAME_1004083002_PRI_TARGET = 'SUN' FRAME_1004083002_PRI_ABCORR = 'NONE' FRAME_1004083002_SEC_AXIS = 'X' FRAME_1004083002_SEC_VECTOR_DEF = 'OBSERVER_TARGET_VELOCITY' FRAME_1004083002_SEC_OBSERVER = 'C_2025_N1' FRAME_1004083002_SEC_TARGET = 'SUN' FRAME_1004083002_SEC_ABCORR = 'NONE' FRAME_1004083002_SEC_FRAME = 'J2000' \begintext TGO Science Generic NAIF ID Codes to Name Mapping ------------------------------------------------------------------------------ This section contains name to NAIF ID mappings. Once the contents of this file are loaded into the KERNEL POOL, these mappings become available within SPICE, making it possible to use names instead of ID code in the high level SPICE routine calls. --------------------- ------- -------------------------- Name ID Synonyms --------------------- ------- -------------------------- C/2025 N1 1004083 C_2025_N1, 3I/ATLAS --------------------- ------- -------------------------- Name-ID Mapping keywords: \begindata NAIF_BODY_CODE += ( 1004083 ) NAIF_BODY_NAME += ( 'C_2025_N1' ) NAIF_BODY_CODE += ( 1004083 ) NAIF_BODY_NAME += ( 'C/2025 N1' ) NAIF_BODY_CODE += ( 1004083 ) NAIF_BODY_NAME += ( '3I/ATLAS' ) \begintext End of FK file.