ISIS 3 Application Documentation
sumspice | Standard View | TOC | Home |
Update ISIS start times, pointing and spacecraft position with Gaskell SUMFILEs
Description
Categories
Groups
History
This program allows the user to update a cube's labels, spaceraft attitude (pointing) and position with more accurate information found in the appropriate Gaskell SUMFILE. There are multiple options for the how the labels should be updated. See the MODE parameter documentation for a description of these options.
The Gaskell SUMFILEs provided are expected to have a format described below:
W46908480918 2014 NOV 12 17:20:03.128 2048 2048 500 65535 NPX, NLN, THRSH 0.1356800000D+03 0.1044000000D+04 0.9380000000D+03 MMFL, CTR -0.9665063720D+01 0.1326644487D+02 -0.6673084308D+01 SCOBJ -0.6442479111D+00 -0.1829032409D-01 0.7645979944D+00 CX 0.5935707119D+00 0.6184779444D+00 0.5149357652D+00 CY -0.4823053379D+00 0.7855892670D+00 -0.3875965231D+00 CZ 0.7254908676D+00 -0.3292717307D+00 0.6043534796D+00 SZ 74.07410 0.00000 0.00000 0.00000 74.07410 0.00000 K-MATRIX 0.00000D+00 0.00000D+00 0.00000D+00 0.00000D+00 DISTORTION 0.1007758363D-02 0.1482813397D-02 0.8902614968D-03 SIGMA_VSO 0.3071768580D-04 0.3093941486D-04 0.1565302183D-04 SIGMA_PTG LANDMARKS AO0001 2049.39 668.15 AO0002 2020.70 644.81 AO0003 2035.17 708.66 BD0009 1902.39 884.05 BD0010 1891.13 909.86 ... EK0022 675.73 1371.97 EQ0088 721.76 738.13 FI0002 727.77 220.40 LIMB FITS END FILE
sumspice has been used to apply Gaskell control to Hayabusa Itokawa AMICA images. There is up to 12 seconds of uncertainty in the start times of these images. The Hayabusa team improved the start time with brute force comparisons of the position of Itokawa in the AMICA field of view. The SUMFILEs contained the correction of the start time. This was the motivation behind adding support for the start time adjustment.
To apply the complete functionality of sumspice, the start time must be updated first if required. Note that it is rather uncommon the start time will need to be updated. If it is, this option will recompute the SpacecraftClockStartTIme which is used primarily by most camera models for best accuracy of image acquisition times. This mode will require a rerun of spiceinit mainly to reestablish the body orientation for the new start time.
The update of pointing attitude and spacecraft position requires spiceinit to be applied to the image. This operation will update the InstrumentPointing and InstrumentPosition Tables in the label of the ISIS cube with the contents of the Gaskell SUMFILE. Note that SUMFILEs contain vectors in body-fixed format, so you must ensure the proper PCK is used with the image. NAIF routines are used to apply any required transformations to retain the integrity of the data. Once the fidelity of the updates are confirmed, new CK and SPK kernels can be created using the ISIS ckwriter and spkwriter applications, respectively.
Name | Description |
---|---|
FROM | A single cube to process. |
FROMLIST | A list of cubes to process. |
SUMFILE | The name of the SUMFILE to be used to update the input cube(s). |
SUMFILELIST | A list of SUMFILEs to search for the best match to update the given cube(s). |
MODE | Determines how the program will use the appropriate SUMFILE to update the labels. |
TIMEDIFF | The maximum allowed time difference between the cube's current start time and the time found in the SUMFILE. |
METAKERNEL | List of SPICE kernels to support conversions |
The name of a single input cube whose labels will be updated using a Gaskell SUMFILE. Note: Use the FROMLIST parameter instead of this one if there are multiple cubes to process.
Type | filename |
---|---|
File Mode | input |
Default | None |
Exclusions |
|
A text file containing a list of input cubes whose labels will be updated using Gaskell SUMFILEs. Note: Use the FROM parameter instead of this one if there is only one cube to process.
Type | filename |
---|---|
File Mode | input |
Default | None |
Exclusions |
|
The name of a single Gaskell SUMFILE containing an updated start time and SPICE information. Note: Use the SUMFILELIST parameter instead of this one if the exact SUMFILE that should be used to update the cube(s) is unknown or if there are more than one.
Type | filename |
---|---|
File Mode | input |
Default | None |
Exclusions |
|
Filter | *.SUM |
A text file containing a list of Gaskell SUMFILEs that each contain an updated start time and SPICE information. Note: Use the SUMFILE parameter instead of this one if the exact SUMFILE is known for the given cube(s).
Type | filename |
---|---|
File Mode | input |
Default | None |
Exclusions |
|
Filter | *.lis |
Determines how the program will use the appropriate SUMFILE to update the labels. Note that there are input requirements for each option.
Type | string | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
Default | UPDATETIMES | |||||||||
Option List: |
|
This value is used when the UPDATETIME option is selected and a SUMFILELIST is provided. The file in the SUMFILELIST with the time that is closest to the cube's start clock must be within this tolerance for the cube to be updated.
Type | double |
---|---|
Default | 0.0 |
In some cases, additional kernels may be required in order to compute some of the data acquired from the NAIF toolkit. If the ISIS labels do not contain sufficient kernels, this parameter can specify a NAIF meta kernel, or a single kernel of any supported NAIF type that will be loaded prior to any computations. These kernels remain loaded for all files and for the entirety of the runtime of this application. See SPICE Kernel Required Reading for additional information about NAIF meta kernels.
Type | filename |
---|---|
File Mode | input |
Default | None |
Filter | *.meta *.tm |
Kris Becker | 2015-02-25 | Original Version |
Jeannie Backer | 2015-12-07 | Generalized to program work with Dawn and Hayabusa data. Clock times are now updated in the instrument group and the original times are saved in the Archive group of the cube labels. |
Kris Becker | 2016-02-09 | Added implementation to support NAIF META kernel files. Updated documentation. |