KPL/IK MaMiss Instrument kernel =============================================================================== This instrument kernel (I-kernel) contains Rover Mars Multispectral Imager for Subsurface Studies (MaMiss) optics, detector, and field-of-view parameters. Version and Date ------------------------------------------------------------------------------- Version 0.0.0 -- March 4, 2021 -- Ricardo Valles Blanco, ESA/ESAC Preliminary Version. References ------------------------------------------------------------------------------- 1. RM Frames Definition Kernel (FK), latest version 2. ''Kernel Pool Required Reading'' 3. ``Detailed Design Document for the ExoMars Rover Vehicle Navigation and Localisation Cameras'', N. Cristello, Airbus Defence and Space, EXM-RM-DDD-NDG-30000, Issue 8, January 2017 Contact Information ------------------------------------------------------------------------------- If you have any questions regarding this file contact SPICE support at ESA: Alfredo Escalante Lopez (+34) 91-8131-429 spice@sciops.esa.int, alfredo.escalante@esa.int or ROCC at Altec Space: Federico Salvioli +39 011 7430 097 federico.salvioli@altecspace.it 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 spiceypy.furnsh( 'frame_kernel_name' ) -- PYTHON 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 and 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 RM instrument ID code. The Star Tracker instrument IDs are defined in [1] as follows: Instrument name ID -------------------- ------- RM_MAMISS -174500 The remainder of the keyword is an underscore character followed by the unique name of the data item. For example, the boresight of MaMiss is specified by INS-174500_BORESIGHT 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. Overview ------------------------------------------------------------------------------- TBD. Apparent FOV Layout --------------------------------------------------------------------------- This section provides a diagram illustrating the MaMiss sapphire window apparent FOV layout in the corresponding reference frame. The MaMiss sapphire window creates a circular field of view with half cone angle of 5.71 degrees. The following diagrams illustrate the above field of view in the instrument frame: Drill rod front view Drill rod top view / / . . / / ./ . / o o / o | /| / o o |""o/ 5.71 |/ | / 5.71 o | x---------> +Zmmiss | [] o-------> +Zmmiss o |__o|\ | /| |\ o o | \ |/ | | \ | \ | /| | \ v +Xmmiss |/ | v +Ymmiss \ | /| \ +Ymmis is into the page |/ | +Xmmis is out of the page \||/ \/ Plane X = 0 Plane Y = 0 Please note that the FOV reference and cross angles are defined with half angle values. Mounting Alignment ------------------------------------------------------------------------------- Refer to the latest version of the RM Frames Definition Kernel (FK) [1] for the MaMiss reference frame definition and mounting alignment information. Optical Parameters --------------------------------------------------------------------------- The MaMiss Field-Of-View has a circle shape with a diameter of 120um (radius of 0.06mm) at the distance of 0.6mm from the sapphire window (Focal length). The FOV has been obtained using the following formula: FOV in deg = (180/pi)*arctan(radius_mm/focal_length_mm) = (180/pi)*arctan(0.06/0.6) = 5.71 deg CCD Parameters --------------------------------------------------------------------------- TBD. FOV Definitions ------------------------------------------------------------------------------- This section contains definitions for the MaMiss FOV. These definition is provided in the format required by the SPICE (CSPICE) function GETFOV (getfov_c). Please note that the FOV reference and cross angles are defined with half angle values. The FoV definition corresponds to the NAIF Body Name: RM_MAMISS. \begindata INS-174500_NAME = 'RM_MAMISS' INS-174500_BORESIGHT = ( 0.000 0.0000 1.000 ) INS-174500_FOV_FRAME = 'RM_MAMISS' INS-174500_FOV_SHAPE = 'CIRCLE' INS-174500_FOV_CLASS_SPEC = 'ANGLES' INS-174500_FOV_REF_VECTOR = ( 1.000 0.000 0.0000 ) INS-174500_FOV_REF_ANGLE = ( 5.71 ) INS-174500_FOV_ANGLE_UNITS = 'DEGREES' \begintext End of IK file.