KPL/IK SWI Instrument Kernel =============================================================================== This instrument kernel (I-kernel) contains the JUICE Sub-millimeter Wave Instrument (SWI) instrument field-of-view (FOV) parameters. Version and Date ------------------------------------------------------------------------------- Version 0.1 -- February 28, 2016 -- Jorge Diaz del Rio, ODC Space Preliminary version. Pending review by the SWI instrument and JUICE Science Operations Working Group team. Version 0.0 -- July 24, 2013 -- Marc Costa Sitja, ISDEFE/ESA Initial Release. References ------------------------------------------------------------------------------- 1. ``Kernel Pool Required Reading'' 2. ``C-kernel Required Reading'' 3. JUICE Frames Definition Kernel (FK), latest version. 4. ``JUICE - Jupiter Icy Moons Explorer. Exploring the emergence of habitable worlds around gas giants. Definition Study report,'' ESA/SRE(2014)1, September 2014 (JUICE Red book v1.0) 5. ``JUICE - JUpiter Icy Moons Explorer SWI - Submillimetre Wave Instrument. Experiment Interface Document EID-B,'' JUI-MPS-SWI-EID-001 Issue 4.3, 17 July 2015 Contact Information ------------------------------------------------------------------------------- If you have any questions regarding this file contact SPICE support at ESAC: Marc Costa Sitja (+34) 91-8131-457 mcosta@sciops.esa.int, esa_spice@sciops.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 and Conventions for Specifying Data ------------------------------------------------------------------------------- All names referencing values in this IK file start with the characters `INS' followed by the NAIF JUICE spacecraft ID number (-907) followed by a NAIF three digit ID code for one of the SWI ``sensors''. This is the full list of names and IDs for the SWI structures described by this IK file: Name NAIF ID --------------------- --------- JUICE_SWI_BASE -907800 JUICE_SWI -907810 The remainder of the keyword name is an underscore character followed by the unique name of the data item. For example, the Sub-millimeter Wave Instrument boresight direction in the JUICE_SWI frame is specified by: INS-907810_BORESIGHT The upper bound on the length of the name of any data item is 32 characters. If the same item is included in more than one file, or if the same item appears more than once within a single file, the latest value supersedes any earlier values. Instrument Description and Overview ------------------------------------------------------------------------------- From [4]: TBW Mounting Alignment ------------------------------------------------------------------------------- Refer to the latest version of the JUICE Frames Definition Kernel (FK) [3] for the SWI reference frame definitions and mounting alignment information. SWI Field-of-View Layout ------------------------------------------------------------------------------- This section provides a diagram illustrating the SWI apparent FoV layout in the JUICE_SWI_BASE reference frame and an auxiliary field-of-view circumscribing the full range of positions due to the reflector rotations. Note that the SWI Field-of-View is zoomed with respect to the auxiliary field-of-view, and that the shape of the later does not match reality. Yswi_base (along-track) ^ x - - - - | - - - - x ------------------ | | | ^ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | SWI_BASE FoV . - . ------------ | Xswi_base | / | \ | ^ | 152.11459 deg <----------------------o | | 2mrad | along-track | \ | / | v (FoV) | ` - ' ------------ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | v x - - - - | - - - - x ------------------ | | |<----------------->| | 8.71459 deg | The reflector can be rotated by +/-76 degrees along track and +/-4.3 degrees cross track. SWI Field of View Definition ------------------------------------------------------------------------------- The SWI field of view is defined based on the receiver main beam half power point directions (-3 dB), and corresponds to a half-cone of 1-mrad (see [5]). \begindata INS-907810_FOV_FRAME = 'JUICE_SWI_SCANNER' INS-907810_FOV_SHAPE = 'CIRCLE' INS-907810_BORESIGHT = ( 0.000, 0.000, 1.000 ) INS-907810_FOV_CLASS_SPEC = 'ANGLES' INS-907810_FOV_REF_VECTOR = ( 0.000, 1.000, 0.000 ) INS-907810_FOV_REF_ANGLE = ( 0.001 ) INS-907810_FOV_ANGLE_UNITS = 'RADIANS' \begintext An auxillary FOV approximately circumscribing the full range of positions due to the SWI reflector rotation is defined for the ``instrument'' ID -907800 (JUICE_SWI_BASE) as a rectangular pyramid centered on the +Z axis of the JUICE_SWI_BASE frame with half angular extents of 76.057295 degrees (76 degree scan + 1/2 of 2mrad FOV height) in the YZ plane and 4.357295 degrees (4.3 degree scan + 1/2 of 2mrad FOV width) in XZ plane of the JUICE_SWI_BASE frame. \begindata INS-907800_FOV_FRAME = 'JUICE_SWI_BASE' INS-907800_FOV_SHAPE = 'RECTANGLE' INS-907800_BORESIGHT = ( 0.0, 0.0, 1.0 ) INS-907800_FOV_CLASS_SPEC = 'ANGLES' INS-907800_FOV_REF_VECTOR = ( 0.0, 1.0, 0.0 ) INS-907800_FOV_REF_ANGLE = ( 76.057295 ) INS-907800_FOV_CROSS_ANGLE = ( 4.357295 ) INS-907800_FOV_ANGLE_UNITS = 'DEGREES' \begintext