-
Notifications
You must be signed in to change notification settings - Fork 169
SPICE_Information
SPICE Information ¶
Introduction ¶
Once an image has been correctly ingested into ISIS3 (meaning that the ISIS cube label contains all required mission-specific keywords ), additional navigational and ancillary information (SPICE) is required in order to calibrate and geometrically/photometrically process the data. ISIS3 utilizes software supplied by the Navigation and Ancillary Information Facility ( NAIF ).
SPICE ( S pacecraft & P lanetary ephemerides, I nstrument C -matrix and E vent kernels) refers to all the information that is required and computed in order for ISIS to map each image onto a surface with reference to spacecraft position, sun position, instrument and mission activities.
SPICEINIT ¶
The ISIS3 application spiceinit adds the necessary SPICE information to an image cube. It is important to note that if spiceinit is unsuccessful then further cartographic processing will not be possible.
Required Mission Keywords ¶
At a minimum spiceinit requires SpacecraftName, InstrumentId, TargetName, StartTime and StopTime. These keywords are loaded at the ingestion step ( Importing Mission Data ).
See also: Mission Specific Programs
ISIS SPICE Labels ¶
-
The information supplied by spiceinit is placed in the Group=Kernels and Group=Instrument label portion of the ISIS image cube.
-
Information on the quality of the kernels is added to keywords within the Kernels Group ( InstrumentPointingQuality and InstrumentPositionQuality )
-
SPICE computation results can also be attached to the blob portion of the ISIS image cube
(i.e., parameter ATTACH=TRUE - the current spiceinit default). -
See also in the ISIS3 Documentation:
Label Dictionary .
Camera Pointing ¶
Spiceinit will load the location and filename of the camera pointing
kernel (CK) in the ISIS keyword InstrumentPointing .
Which file that is loaded depends on a couple of things:
First, the StartTime of the image must be found within any CK kernel
Secondly, The user can specify what type of CK kernel
- CKSMITHED - This is considered camera pointing that has been through a bundle-adjustment and most likely the most accurate; this level of pointing is not often available and might not include the entire collection of mission image data.
- CKRECON - The default ck kernel for spiceinit. This kernel is the mission actual and is often improved on by NAIF or the mission navigation team.
- CKPREDICTED - The least desired, but "better than nothing" kernel that is most available during real-time on newly acquired mission data.
- CKNADIR - Nadir pointing is computed if no CK kernels exist ( Requirements...under construction )
TIPs :
- All parameters above can be set to =TRUE and spiceinit will search and load in a hierarcial order from c-smithed first to predicted last. Be aware if processing multiple files and allowing inconsistencies in different ck sources.
- The InstrumentPointingQuality keyword will be added to the Kernels Group with a value indicating what quality of camera pointing was found and loaded for the input image (InstrumentPointingQuality = Reconstructed or Predicted).
Spacecraft Position ¶
Spiceinit will load the location and filename of the spacecraft pointing kernel (SPK) in the ISIS keyword InstrumentPosition .
Which file that is loaded depends on a couple of things:
First, the StartTime of the image must be found within any SPK kernel
Secondly, The user can specify what type of SPK kernel
- SPKSMITHED - This is considered camera pointing that has been through a bundle-adjustment and most likely the most accurate; this level of pointing is not often available and might not include the entire collection of mission image data.
- SPKRECON - The default spk kernel for spiceinit. This kernel is the mission actual and is often improved on by NAIF or the mission navigation team.
- SPKPREDICTED - The least desired, but "better than nothing" kernel that is most available during real-time on newly acquired mission data.
TIPs :
- All parameters above can be set to =TRUE and spiceinit will search and load in a hierarcial order from c-smithed first to predicted last. Be aware if processing multiple files and allowing inconsistencies in different spk sources.
- The InstrumentPositionQuality keyword will be added to the Kernels Group with a value indicating what quality of camera pointing was found and loaded for the input image (InstrumentPositionQuality = Reconstructed or Predicted).
Shape Model ¶
Under Construction!!
References & Related Resources ¶
- About NAIF
- About NAIF SPICE
- NAIF Software Toolkit
- Building
- Writing Tests
- Test Data
- Start Contributing
- Public Release Process
- Continuous Integration
- Updating Application Documentation
- Deprecating Functionality
- LTS Release Process and Support
- RFC1 - Documentation Delivery
- RFC2 - ISIS3 Release Policy
- RFC3 - SPICE Modularization
- RFC3 - Impact on Application Users
- RFC4 - Migration of ISIS Data to GitHub - Updated Information 2020-03-16
- RFC5 - Remove old LRO LOLA/GRAIL SPK files
- RFC6 - BLOB Redesign
- Introduction to ISIS
- Locating and Ingesting Image Data
- ISIS Cube Format
- Understanding Bit Types
- Core Base and Multiplier
- Special Pixels
- FAQ