KPL/IK


MAG Instrument Kernel
==============================================================================

   This instrument kernel (I-kernel) contains references to mounting
   alignment, operating modes, and timing as well as internal geometry
   for the Psyche Magnetometer (MAG).


Version and Date
------------------------------------------------------------------------------

   Version 0.4 -- June 14, 2022 -- Matt Barnes, NAIF/JPL

      Updated comments to reflect actual beam length and updated comments 
      describing defined FOV, both per [4].

   Version 0.3 -- April 26, 2021 -- Matt Barnes, NAIF/JPL

      Changed IDs to start with -255 instead of -69 to reflect PSYCH 
      S/C ID change to -255, see [2] for details.

   Version 0.2 -- February 5, 2018 -- Masha Liukis, NAIF/JPL

      Updated MAG Description.

      Replaced references to fluxgate magnetometer with references to
      magnetometer.

      Replaced FGM (fluxgate magnetometer) with MAG (magnetometer) for
      instruments and frames names:

         PSYC_FGM1 with PSYC_MAG1
         PSYC_FGM2 with PSYC_MAG2

   Version 0.1 -- January 29, 2018 -- Boris Semenov, NAIF/JPL

      Preliminary version based on the mission proposal information; to
      be reviewed by the instrument team and updated based on their
      feedback.

      Updated some descriptions, diagrams, indentation, and paragraph
      wrapping. Removed the Patform ID section. Added bogus FOVs
      intended for testing FGM frames.

   Version 0.0 -- May 8, 2017 -- Masha Liukis, NAIF/JPL

      Preliminary version.


References
------------------------------------------------------------------------------

   1. ``Kernel Pool Required Reading''

   2. Psyche Frames Definition Kernel (FK), latest version.

   3. 02_Psyche_CSR_Redacted_Science.pdf.

   4. 'Psyche - Review of NAIF Instrument Kernels', e-mail from Jodie Ream, 
      MIT, August 15, 2019.

Contact Information
------------------------------------------------------------------------------

   Matt Barnes, NAIF/JPL, (818) 354-5942, matthew.j.barnes@jpl.nasa.gov


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 be used if the file contains instrument field-of-view
   (FOV) specification. 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 (see
   [1]). All keywords referencing values in this I-kernel start with
   the characters `INS' followed by the NAIF Psyche instrument ID code,
   constructed using the spacecraft ID number (-255) followed by the
   NAIF three digit ID number. The ID numbers are defined in [2] as
   follows:

               Instrument name          ID
               --------------------   -------
               PSYC_MAG1              -255170
               PSYC_MAG2              -255180

   The remainder of the keyword is an underscore character followed by
   the unique name of the data item. For example, the boresight of MAG1
   is specified by

               INS-255170_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.


MAG Description
---------------------------------------------------------------

   From [3] and [4]:

      Dual unit magnetometer characterizes Psyche's magnetic field
      while mounted in a gradiometer configuration on a fixed
      2.15 m boom.

      Two identical high-sensitivity magnetic field sensors are
      mounted at the end (2.15 m) and at 1.45 m on the composite
      boom and connected by cables to electronics boxes located
      in the main S/C bus.


Kernel Contents
---------------------------------------------------------------

   While a FOV concept is in general not applicable to a magnetometer,
   this IK file defines a 5 degree half-angle cone FOV centered on the
   +Z axis of the corresponding MAG frames for each of the two FGMs to
   facilitate FK/IK verification and testing.


MAG FOVs
---------------------------------------------------------------

   This section defines FOVs intended solely for testing MAG frames.

   \begindata

      INS-255170_FOV_FRAME            = 'PSYC_MAG1'
      INS-255170_FOV_SHAPE            = 'CIRCLE'
      INS-255170_BORESIGHT            = ( 0.0, 0.0, 1.0 )
      INS-255170_FOV_CLASS_SPEC       = 'ANGLES'
      INS-255170_FOV_REF_VECTOR       = ( 0.0, 1.0, 0.0 )
      INS-255170_FOV_REF_ANGLE        = ( 5.0 )
      INS-255170_FOV_ANGLE_UNITS      = 'DEGREES'

      INS-255180_FOV_FRAME            = 'PSYC_MAG2'
      INS-255180_FOV_SHAPE            = 'CIRCLE'
      INS-255180_BORESIGHT            = ( 0.0, 0.0, 1.0 )
      INS-255180_FOV_CLASS_SPEC       = 'ANGLES'
      INS-255180_FOV_REF_VECTOR       = ( 0.0, 1.0, 0.0 )
      INS-255180_FOV_REF_ANGLE        = ( 5.0 )
      INS-255180_FOV_ANGLE_UNITS      = 'DEGREES'

   \begintext

End of IK file.