KPL/IK EnVision Venus Spectrometer Instrument kernel ============================================================================== This instrument kernel (I-kernel) contains the Venus Spectrometer (VenSpec) optics, detector, and field-of-view parameters. Version and Date ------------------------------------------------------------------------------ Version 0.3 -- August 4, 2025 -- Alfredo Escalante Lopez, ESAC/ESA Rafael Andres Blasco, ESAC/ESA Updated VenSpec-M, VenSpec-H and VenSpec-U FOVs accordingly to issue SPICEPCR-1665. Added VenSpec-M-MIN and VenSpec-U-MIN FOVs accordingly to issue SPICEPCR-1700. Version 0.2 -- August 30, 2024 -- Ricardo Valles Blanco, ESAC/ESA Updated VenSpec FOVs accordingly to issue SPICEPCR-1467. Updated contact information. Version 0.1 -- February 10, 2023 -- Ricardo Valles Blanco, ESAC/ESA Alfredo Escalante Lopez, ESAC/ESA Corrected typos and added missing reference frame name keywords. Version 0.0 -- September 20, 2022 -- Alfredo Escalante Lopez, ESAC/ESA Ian Thomas Initial release. References ------------------------------------------------------------------------------ 1. ``Kernel Pool Required Reading'' 2. ``C-kernel Required Reading'' 3. EnVision Frames Definition Kernel (FK), latest version. Contact Information ------------------------------------------------------------------------ If you have any questions regarding this file contact the ESA SPICE Service (ESS) at ESAC: Alfredo Escalante Lopez (+34) 91-8131-429 spice@cosmos.esa.int or NAIF at JPL: Boris Semenov (818) 354-8136 Boris.Semenov@jpl.nasa.gov Implementation Notes ------------------------------------------------------------------------------ Applications that need SPICE I-kernel data must ``load'' the I-kernel file, normally during program initialization. The SPICE routine FURNSH loads a kernel file into the pool as shown below. CALL FURNSH ( 'frame_kernel_name' ) -- FORTRAN furnsh_c ( "frame_kernel_name" ); -- C cspice_furnsh, frame_kernel_name -- IDL cspice_furnsh( 'frame_kernel_name' ) -- MATLAB Loading the kernel using the SPICELIB routine FURNSH causes the data items and their associated values present in the kernel to become associated with a data structure called the ``kernel pool''. Once the file has been loaded, the SPICE routine GETFOV (getfov_c in C, cspice_getfov in IDL and MATLAB) can be used to retrieve FOV parameters for a given instrument or structure. The application program may obtain the value(s) for any other IK data item using the SPICELIB routines GDPOOL, GIPOOL, GCPOOL (gdpool_c, gipool_c, gcpool_c in C, cspice_gdpool, cspice_gipool, cspice_gcpool in IDL and MATLAB). See [1] for details. This file was created with, and can be updated with a text editor or word processor. Naming Conventions ------------------------------------------------------------------------------ Data items are specified using ``keyword=value'' assignments [1]. All keywords referencing values in this I-kernel start with the characters `INS' followed by the NAIF EnVision instrument ID code, constructed using the spacecraft ID number (-668) followed by the NAIF three digit ID number. The ID numbers are defined in [3] as follows: Instrument name ID ------------------------ ------- ENVISION_VENSPEC_M -668310 ENVISION_VENSPEC_M_MIN -668311 ENVISION_VENSPEC_H -668320 ENVISION_VENSPEC_U -668330 ENVISION_VENSPEC_U_MIN -668331 The remainder of the keyword is an underscore character followed by the unique name of the data item. For example, the f/ratio of the VENSPEC_M is specified by INS-668310_F/RATIO The upper bound on the length of all keywords is 32 characters. If a keyword is included in more than one file, or if the same keyword appears more than once within a single file, the last assignment supersedes any earlier assignments. Description ------------------------------------------------------------------------------ TBW. Mounting Alignment ------------------------------------------------------------------------------ Refer to the latest version of the EnVision Frames Definition Kernel (FK) [3] for the VenSpec reference frame definitions and mounting alignment information. Apparent FOV Layout ------------------------------------------------------------------------------ This section provides a diagram illustrating the VENSPEC_M, VENSPEC_M_MIN, VENSPEC_H, VENSPEC_U and VENSPEC_U_MIN apparent FOV layout in the corresponding reference frames. Pixel (0,0) is in the lower left corner of the image, and pixel (n,n) is in the top right corner. +X, +Y, +Z axes are defined in the EnVision Frames Definition Kernel (FK) [3]. VENSPEC_M --------- | 41.0 deg | Boresight (+Z axis) |<------------------->| is into the page | | --- +---------------------+ ^ | | | | +Zvspecm | |35.0 deg | x---------------> +Xvspecm | | | | v | | | --- (0,0)--------|----------+ Pixel | | v +Yvspecm VENSPEC_M_MIN ------------- | 40.0 deg | Boresight (+Z axis) |<------------------->| is into the page | | --- +---------------------+ ^ | | | | +Zvspecm | |35.0 deg | x---------------> +Xvspecm | | | | v | | | --- (0,0)--------|----------+ Pixel | | v +Yvspecm VENSPEC_H --------- | 6.593 deg | Boresight |<--------------------------------->| (+Z axis) | | is into the page Non-illuminated --- +---------+|||||||+-----------------+ ^ | |||+Zvspech | |0.162 deg | ||x-------------> +Xvspech v | |||||||| | --- (0,0)-------+--|----+-----------------+ Pixel | | v +Yvspech VENSPEC_U --------- | 20.59 deg | Boresight |<--------------------------------->| (+Z axis) | | is into the page --- +-----------------------------------+ ^ | +Zvspecu | |1.36 deg | x-------------> +Xvspecu v | | | --- (0,0)---------------|-----------------+ Pixel | | v +Yvspecu VENSPEC_U_MIN ------------- | 20 deg | Boresight |<--------------------------------->| (+Z axis) | | is into the page --- +-----------------------------------+ ^ | +Zvspecu | |1.36 deg | x-------------> +Xvspecu v | | | --- (0,0)---------------|-----------------+ Pixel | | v +Yvspecu Optical Parameters ------------------------------------------------------------------------------ TBW. CCD Parameters ------------------------------------------------------------------------------ TBW. Filter Parameters ------------------------------------------------------------------------------ TBW. FOV Definitions ------------------------------------------------------------------------------ This section contains definitions for the VenSpec FOVs. These definitions are provided in a format required by the SPICE (CSPICE) function GETFOV (getfov_c). The set of assignments in the data section below defines the VenSpec FOVs with respect to the corresponding frames to be a rectangle with the corners defined by the first and last pixels of the first and last lines of the CCD and the boresight along the +Z axis. This FOV definition uses the FOV_ANGULAR_SIZE values from the ``Optical Parameters'' section above converted to degrees. VENSPEC_M \begindata INS-668310_NAME = 'ENVISION_VENSPEC_M' INS-668310_BORESIGHT = ( 0.0, 0.0, 1.0 ) INS-668310_FOV_FRAME = 'ENVISION_VENSPEC_M' INS-668310_FOV_SHAPE = 'RECTANGLE' INS-668310_FOV_CLASS_SPEC = 'ANGLES' INS-668310_FOV_REF_VECTOR = ( 1.0, 0.0, 0.0 ) INS-668310_FOV_REF_ANGLE = ( 20.5 ) INS-668310_FOV_CROSS_ANGLE = ( 17.5 ) INS-668310_FOV_ANGLE_UNITS = 'DEGREES' \begintext VENSPEC_M_MIN \begindata INS-668311_NAME = 'ENVISION_VENSPEC_M_MIN' INS-668311_BORESIGHT = ( 0.0, 0.0, 1.0 ) INS-668311_FOV_FRAME = 'ENVISION_VENSPEC_M' INS-668311_FOV_SHAPE = 'RECTANGLE' INS-668311_FOV_CLASS_SPEC = 'ANGLES' INS-668311_FOV_REF_VECTOR = ( 1.0, 0.0, 0.0 ) INS-668311_FOV_REF_ANGLE = ( 20.0 ) INS-668311_FOV_CROSS_ANGLE = ( 17.5 ) INS-668311_FOV_ANGLE_UNITS = 'DEGREES' \begintext VENSPEC_H \begindata INS-668320_NAME = 'ENVISION_VENSPEC_H' INS-668320_BORESIGHT = ( 0.0, 0.0, 1.0 ) INS-668320_FOV_FRAME = 'ENVISION_VENSPEC_H' INS-668320_FOV_SHAPE = 'RECTANGLE' INS-668320_FOV_CLASS_SPEC = 'ANGLES' INS-668320_FOV_REF_VECTOR = ( 1.0, 0.0, 0.0 ) INS-668320_FOV_REF_ANGLE = ( 3.2965 ) INS-668320_FOV_CROSS_ANGLE = ( 0.081 ) INS-668320_FOV_ANGLE_UNITS = 'DEGREES' \begintext VENSPEC_U \begindata INS-668330_NAME = 'ENVISION_VENSPEC_U' INS-668330_BORESIGHT = ( 0.0, 0.0, 1.0 ) INS-668330_FOV_FRAME = 'ENVISION_VENSPEC_U' INS-668330_FOV_SHAPE = 'RECTANGLE' INS-668330_FOV_CLASS_SPEC = 'ANGLES' INS-668330_FOV_REF_VECTOR = ( 1.0, 0.0, 0.0 ) INS-668330_FOV_REF_ANGLE = ( 10.295 ) INS-668330_FOV_CROSS_ANGLE = ( 0.680 ) INS-668330_FOV_ANGLE_UNITS = 'DEGREES' \begintext VENSPEC_U_MIN \begindata INS-668331_NAME = 'ENVISION_VENSPEC_U_MIN' INS-668331_BORESIGHT = ( 0.0, 0.0, 1.0 ) INS-668331_FOV_FRAME = 'ENVISION_VENSPEC_U' INS-668331_FOV_SHAPE = 'RECTANGLE' INS-668331_FOV_CLASS_SPEC = 'ANGLES' INS-668331_FOV_REF_VECTOR = ( 1.0, 0.0, 0.0 ) INS-668331_FOV_REF_ANGLE = ( 10.0 ) INS-668331_FOV_CROSS_ANGLE = ( 0.680 ) INS-668331_FOV_ANGLE_UNITS = 'DEGREES' \begintext \begindata INS-668310_PLATFORM_ID = ( -668000 ) INS-668311_PLATFORM_ID = ( -668000 ) INS-668320_PLATFORM_ID = ( -668000 ) INS-668330_PLATFORM_ID = ( -668000 ) INS-668331_PLATFORM_ID = ( -668000 ) \begintext End of IK file.