ISIS Documentation

csminit

Attach a CSM model state to a cube.

This program takes Instrument Support Data (ISD) and attempts to create a valid Community Sensor Model (CSM) state string using models from the loaded CSM Libraries. If a single state string can be created, it is attached to the cube in the CSMState BLOB for later use. If there are multiple models that create valid state strings, then this program will error and return a list of possible models. The user will then have to re-run this program using the PLUGINNAME and/or MODELNAME parameters to select a specific model.

Information about the CSM model will also be added to the CsmInfo group on the cube label. The group includes names, units, and types for model parameters. 

Group = CsmInfo
CSMPlatformID       = Mars_Reconnaissance_Orbiter
CSMInstrumentId     = "CONTEXT CAMERA"
ReferenceTime       = 2014-05-21T15:48:56Z
ModelParameterNames = ("IT Pos. Bias   ", "CT Pos. Bias   ",
                        "Rad Pos. Bias  ", "IT Vel. Bias   ",
                        "CT Vel. Bias   ", "Rad Vel. Bias  ",
                        "Omega Bias     ", "Phi Bias       ",
                        "Kappa Bias     ", "Omega Rate     ",
                        "Phi Rate       ", "Kappa Rate     ",
                        "Omega Accl     ", "Phi Accl       ",
                        "Kappa Accl     ", "Focal Bias     ")
ModelParameterUnits = (m, m, m, m, m, m, m, m, m, m, m, m, m, m, m, m)
ModelParameterTypes = (REAL, REAL, REAL, REAL, REAL, REAL, REAL, REAL,
                        REAL, REAL, REAL, REAL, REAL, REAL, REAL, REAL)
End_Group

The ModelParameter keywords contain information that can be used when running jigsaw. This information is unique for each model. For more detail, see the CSMSOLVELIST parameter in the jigsaw documentation.

This program can be run on any Cube file, but if the Cube has spice data from spiceinit then it will be removed so that there is no ambiguity between the ISIS and CSM model.

See the Plugins group in the IsisPreferences file for information about how to load CSM Libraries for use with this and other ISIS applications.

Categories

History

Jesse Mapel2020-11-18 Original Version
Jesse Mapel and Stuart Sides2021-02-03 Modified to always add a TargetName and Instrument group to the label for the camera model.
Kristin Berry and Stuart Sides2021-02-10 Modified to revert label and Cube changes on failure.
Kristin Berry and Stuart Sides2021-02-12 Added the ability to take a state string instead of an ISD.