KPL/IK SIR Instrument kernel =========================================================================== This instrument kernel (I-kernel) contains SMART-1 Near Infrared Spectrometer (SIR) optics, detector, and FOV parameters. Version and Date --------------------------------------------------------------------------- Version 0.2 -- March 2, 2005 -- Jorge Diaz del Rio, RSSD/ESA Replaced non-unit FOV_REF_VECTOR in INS-238200 FOV definition with a unit vector along +X to work around a bug in the GETFOV routine. Corrected spelling and grammar. Version 0.1 -- January 10, 2005 -- Jorge Diaz del Rio, RSSD/ESA Corrections made to the preliminary version after revision of SIR team. First official delivery. Version 0.0 -- December 10, 2004 -- Jorge Diaz del Rio, RSSD/ESA Preliminary Version. Pending review and approval by SIR instrument team. References --------------------------------------------------------------------------- 1. ``Kernel Pool Required Reading'' 2. ``C-kernel Required Reading'' 3. ``SIR Experiment ICD'', S1-SIR-EID-3001, Issue 4.0, May 17, 2001 4. SMART-1 Frames Definition Kernel (FK), latest version. 5. ... Contact Information ------------------------------------------------------------------------ Jorge Diaz del Rio, RSSD/ESA, (31) 71-565-5175, jdiaz@rssd.esa.int Implementation Notes ------------------------------------------------------------------------ Applications that need SPICE I-kernel data must ``load'' the I-kernel file, normally during program initialization. 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''. The application program may then obtain the value(s) for any IK data item using the SPICELIB routines GDPOOL, GIPOOL, GCPOOL. Routine GETFOV may also be used if the file contains instrument field-of-view (FOV) specifications. See [1] for details. This file was created with, and can be updated with a text editor or word processor. Conventions for Specifying Data ------------------------------------------------------------------------ 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 SMART-1 instrument ID code, constructed using the spacecraft ID number, -238, followed by the NAIF three digit ID number for SIR (200). This ID is defined in [4] as follows: Instrument name ID -------------------- ------- SMART1_SIR -238200 The remainder of the keyword is an underscore character followed by the unique name of the data item. For example, the number of pixels of the SIR is specified by INS-238200_NUMBER_OF_PIXELS The upper bound on the length of all keywords is 32 characters. If a keyword is included in more then one file, or if the same keyword appears more than once within a single file, the last assignment supersedes any earlier assignments. Instrument Overview ------------------------------------------------------------------------ From [TBD]: "SIR description. To be copied from TBD source provided by the SIR team." Mounting Alignment ------------------------------------------------------------------------ Refer to the latest version of the SMART-1 Frames Definition Kernel (FK) [4] for the SIR reference frame definitions and mounting alignment information. Optics and Detector Parameters ------------------------------------------------------------------------ This section contains assignments specifying the SIR optics and detector parameters. The following SIR optical and fiber shape/size parameters are included in the data section below, taken from [3]: ----------------------------------------------------------------- parameter SIR ----------------------------------------------------------------- Focal Length, mm 180 f/ratio 2.5 Fiber shape circle Fiber size, mm 0.200 Number of pixels 1 IFOV, rad/pixel nominal 0.00111 ----------------------------------------------------------------- These values are provided in the assignments below, with the same units as in the table. \begindata INS-238200_FOCAL_LENGTH = ( 180 ) INS-238200_F/RATIO = ( 2.5 ) INS-238200_FIBER_SIZE = ( 0.200 ) INS-238200_NUMBER_OF_PIXELS = ( 1 ) INS-238200_IFOV = ( 0.00111 ) \begintext FOV Definitions ------------------------------------------------------------------------ This section contains assignments defining the SIR FOV. These definitions are based on the SIR detector and optics parameters provided in the previous section and are provided in a format consistent with/required by the SPICE (CSPICE) function GETFOV (getfov_c). The SIR FOV is defined as a cone with a half angle of 0.000555 radians. It is defined with respect to the SMART1_SIR frame. The boresight vector, along the +Z axis of the frame, was scaled to be equal to the focal length. The cross-reference vector is a unit vector along the +X axis of the frame. \begindata INS-238200_FOV_FRAME = 'SMART1_SIR' INS-238200_FOV_SHAPE = 'CIRCLE' INS-238200_BORESIGHT = ( 0.0 0.0 180.0 ) INS-238200_FOV_CLASS_SPEC = 'ANGLES' INS-238200_FOV_REF_VECTOR = ( 1.0 0.0 0.0 ) INS-238200_FOV_REF_ANGLE = ( 0.000555 ) INS-238200_FOV_CROSS_ANGLE = ( 0.000555 ) INS-238200_FOV_ANGLE_UNITS = 'RADIANS' \begintext Spectral Parameters ------------------------------------------------------------------------ This section contains assignments specifying SIR spectral resolution parameters. The SIR spectral resolution parameters, included in the data section below, are taken from [3]. ----------------------------------------------------------------- parameter SIR ----------------------------------------------------------------- Spectral range, microns nominal 0.94 - 2.40 Number of spectral bins 256 ----------------------------------------------------------------- These values are provided in the assignments below, with the same units as in the table. \begindata INS-238200_SPECTRAL_RANGE = ( 0.94, 2.40 ) INS-238200_NUMBER_OF_BINS = ( 256 ) \begintext Platform ID ------------------------------------------------------------------------ This number is the NAIF instrument ID of the platform on which the instrument is mounted. SIR is mounted directly on the spacecraft. \begindata INS-238200_PLATFORM_ID = ( -238000 ) \begintext