Isis 3 Application Documentation
Determine SPICE kernels for a camera cube
Description
Cubes which have supported camera models in the ISIS system require spacecraft position, pointing, body shape and orientation, sun position, and much
more information in order to compute ground positions (latitude/longitude) and photometric viewing angles. This information is stored in SPICE kernels.
This program attempts to search the ISIS data areas in order to discern the SPICE kernels required for the camera cube.
The program examines the "SpacecraftName", "InstrumentId", "TargetName", "StartTime", and "StopTime" keywords in the cube label to determine the kernels to use. It
attempts to find kernels files for the following keywords and writes them to the Kernels group:
- Leap Second (LS)
- Spacecraft Clock (SCLK)
- Target Position (TSPK)
- Target AttitudeShape (PCK)
- Instrument (IK)
- Instrument Addendum (IAK)
- Frame (FK)
- Spacecraft Position (SPK)
- Instrument Pointing (CK)
- Shape Model (DEM)
If you are unfamilar with SPICE terminology it is recommended you read the NAIF required reading at http://naif.jpl.nasa.gov/naif/doc_C.html
The program modifies the kernels group and writes the name of the SPICE files that need to be loaded by the camera models. It has the option of pre-reading the
data from the SPICE kernels and loading it as a binary table attached to the cube. This can faciliate faster load times and allows the instrument pointing to be easily updated.
Please note: Kernel Files specified that reside in the current working directory will not have their paths expanded. This is to allow variables like $msg/ to work correctly.
Categories
Related Applications in Previous Versions of Isis
This application replaces the following
applications existing in previous versions of Isis, which have been deprecated
from the current version of Isis:
History
| Debbie A. Cook | 2000-06-08 |
Original Version
|
| Stuart Sides | 2003-11-05 |
Complete rewrite under Isis 3.0 conversion.
|
| Stuart Sides | 2004-01-14 |
Modified to use an existing "Kernels" group instead of creating a
new one. This was because the mission specific import program
(e.g., moc2isis) was modified to create the "kernels" group and
put the "NaifFrameCode" into it.
|
| Stuart Sides | 2004-01-23 |
Added new parameter "TEST". This parameter controls the
testing of the final kernel list. If false the kernels will not be
tested for completness by createing a camera model.
|
| Stuart Sides | 2004-02-23 |
Added elevation model DEM capabilities.
|
| Stuart Sides | 2004-02-24 |
Completed capabilities to search for kernels of different qualities
such as PREDICTED, NADIR, RECONSTRUCTED, and C-SMITHED.
|
| Stuart Sides | 2005-11-08 |
Added fix for framing cameras, so they would not need a stop time in
the instrument group of the labels.
|
| Elizabeth Miller | 2005-11-14 |
Added appTest
|
| Jacob Danton | 2005-12-22 |
Added support for multiple files within the kernels
|
| Jacob Danton | 2005-12-27 |
Added a progress bar
|
| Jacob Danton | 2006-01-03 |
Fixed the xml description
|
| Jacob Danton | 2006-01-25 |
Changed the mission translation file name
|
| Jacob Danton | 2006-01-25 |
Changed the appTest to comply with changes in the String class.
|
| Jeff Anderson | 2006-03-27 |
Modified to write InstrumentPointing, InstrumentPosition, SunPosition, and BodyRotation information to
SPICE tables in the cube.
|
| Brendan George | 2006-09-19 |
Added call to modify the history of the cube
|
| Brendan George | 2006-10-19 |
Modifed to remove label entries for spice tables, if ATTACH is unchecked,
and the input cube already has them.
|
| Steven Lambright | 2007-07-10 |
Combined Frame and InstrumentPointing. Changed to support new version of KernelDb. Cleaned up the code.
|
| Steven Lambright and Steve Koechle | 2007-07-10 |
Fixed problem where the allowed kernels were being set improperly.
|
| Steven Lambright | 2007-08-10 |
Fixed so that when no spacecraft pointing is found, but frame kernels are, and Nadir is allowed it still adds the Nadir keyword.
|
| Steven Koechle | 2007-10-05 |
Added a check to see if the cube had an existing polygon, if so delete it.
|
| Steven Koechle | 2007-10-25 |
Fixed Smithed enum, changed from C-Smithed.
|
| Steven Koechle | 2007-12-14 |
Added error handling logic. If the user chose to use Nadir CK and
another type, and the system found a file where the image falls in a gap
(no pointing is available) Nadir would never be calculated. Fixed.
|
| Steven Lambright | 2008-02-13 |
Added time padding options
|
| Steven Lambright | 2008-02-21 |
Added additional explanation of time padding options
|
| Steven Lambright | 2008-02-22 |
Split the CK parameter into FK and CK, they are still combined in the label as
InstrumentPointing.
|
| Steven Lambright | 2008-04-14 |
All found CK kernels will now be tested before giving an error
|
| Christopher Austin | 2008-05-02 |
Fixed the propagation of the EXTRA Kernel.
|
| Steven Lambright | 2008-05-12 |
Removed references to CubeInfo
|
| Steven Lambright | 2008-05-19 |
Fixed documentation
|
| Christopher Austin | 2008-06-03 |
Furthered documentation.
|
| Steven Koechle | 2008-06-17 |
Added CK check and throw more appropriate error
|
| Christopher Austin | 2008-09-12 |
Added the removal of StartPadding and EndPadding keywords from previous
spiceinit runs, and added some double inited tests. NOTE: Whenever
adding new keywords, run spiceinit twice on the same cube in your test,
dumping out both labels to verify that the keyword is not being
duplicated.
|
|
Parameter Groups
Input Files
|
Name
|
Description
|
| FROM |
The input file cube to have "kernel" labels added to it
|
| ATTACH |
Attach SPICE data to cube
|
Instrument Orientation Kernel (CK) quality
|
Name
|
Description
|
| CKSMITHED |
Use smithed pointing kernels if available
|
| CKRECON |
Use reconstructed pointing kernels if available
|
| CKPREDICTED |
Use predicted pointing kernels if available
|
| CKNADIR |
Compute nadir pointing if no other kernels exist
|
Instrument Position Kernel (SPK) quality
|
Name
|
Description
|
| SPKSMITHED |
Use smithed position kernels if available
|
| SPKRECON |
Use reconstructed position kernels if available
|
| SPKPREDICTED |
Use predicted pointing kernels if available
|
User Override of System Kernels
|
Name
|
Description
|
| LS |
User defined leap second kernel file.
|
| PCK |
User defined target attitude and shape kernel file.
|
| TSPK |
User defined target position kernel file.
|
| IK |
User defined instrument kernel file.
|
| SCLK |
User defined spacecraft clock kernel file.
|
| CK |
User defined spacecraft pointing kernel file.
|
| FK |
User defined frames kernel file.
|
| SPK |
User defined spacecraft position kernel file.
|
| IAK |
User defined instrument addendum kernel file.
|
| EXTRA |
User defined extra kernel file.
|
Shape Model Parameters
|
Name
|
Description
|
| SHAPE |
Select the definition of the shape model
|
| MODEL |
User defined ISIS cube shape model.
|
Time Parameters
|
Name
|
Description
|
| STARTPAD |
Time padding (in seconds) to load from the kernels before the start time of the image
|
| ENDPAD |
Time padding (in seconds) to load from the kernels after the end time of the image
|
|
Instrument Orientation Kernel (CK) quality:
CKSMITHED
Description
Allow the use of pointing kernels marked as c-smithed.
If this parameters is turned on, c-smithed kernels may be used to
cover the time requirements of the image. At least one of the
parameters "CKPREDICTED", "CKNADIR", "CKRECON", "CKSMITHED"
must be entered.
|
Type
| boolean |
|
Default
| FALSE |
Instrument Orientation Kernel (CK) quality:
CKRECON
Description
Allow the use of pointing kernels marked as reconstructed.
If this parameters is turned on, reconstructed kernels may be used to
cover the time requirements of the image. At least one of the
parameters "CKPREDICTED", "CKNADIR", "CKRECON", "CKSMITHED"
must be entered.
|
Type
| boolean |
|
Default
| TRUE |
Instrument Orientation Kernel (CK) quality:
CKPREDICTED
Description
Allow the use of pointing kernels marked as predicted.
If this parameters is turned on, predicted kernels may be used to
cover the time requirements of the image. At least one of the
parameters "CKPREDICTED", "CKNADIR", "CKRECON", "CKSMITHED"
must be entered.
|
Type
| boolean |
|
Default
| FALSE |
Instrument Orientation Kernel (CK) quality:
CKNADIR
Description
This option will create nadir pointing data if the other kernel types do not exist or do not cover the
time range of the input cube. At least one of the
parameters "CKPREDICTED", "CKNADIR", "CKRECON", "CKSMITHED"
must be entered.
|
Type
| boolean |
|
Default
| FALSE |
Instrument Position Kernel (SPK) quality:
SPKSMITHED
Description
Allow the use of position kernels marked as smithed.
If this parameters is turned on, smithed kernels may be used to(
cover the time requirements of the image. At least one of the
parameters "SPKPREDICTED", "SPKRECON", "SPKSMITHED"
must be entered.
|
Type
| boolean |
|
Default
| FALSE |
Instrument Position Kernel (SPK) quality:
SPKRECON
Description
Allow the use of position kernels marked as reconstructed.
If this parameters is turned on, reconstructed kernels may be used to
cover the time requirements of the image. At least one of the
parameters "SPKPREDICTED", "SPKRECON", "SPKSMITHED"
must be entered.
|
Type
| boolean |
|
Default
| TRUE |
Instrument Position Kernel (SPK) quality:
SPKPREDICTED
Description
Allow the use of position kernels marked as predicted.
If this parameters is turned on, predicted kernels may be used to
cover the time requirements of the image. At least one of the
parameters "SPKPREDICTED", "SPKRECON", "SPKSMITHED"
must be entered.
|
Type
| boolean |
|
Default
| FALSE |
User Override of System Kernels:
LS
Description
Naif kernel file to be used for the leap second in place of the
automated leap second kernel. The LS kernel will be referenced in the
keyword LeapSecond by the resulting Kernel group.
|
Type
| filename |
|
File Mode
| input |
|
Default Path
| $base/kernels/lsk/ |
|
Internal Default
| none |
|
Filter
| *.tls |
User Override of System Kernels:
PCK
Description
Naif kernel file to be used for the target attitude and shape in place
of the automated attitude and shape kernel. The PCK kernel will be
referenced in the keyword TargetAttitudeShape by the resulting Kernel
group.
|
Type
| filename |
|
File Mode
| input |
|
Default Path
|
$BASE/kernels/pck/
|
|
Internal Default
| none |
|
Filter
| *.tpc |
User Override of System Kernels:
TSPK
Description
Naif kernel file to be used for the target position in place of the
automated position kernel. The TSPK kernel will be referenced in the
keyword TargetPosition by the resulting Kernel group.
|
Type
| filename |
|
File Mode
| input |
|
Default Path
|
$BASE/kernels/spk/
|
|
Internal Default
| none |
|
Filter
| *.bsp |
User Override of System Kernels:
IK
Description
Naif kernel file to be used for the instrument in place of the
automated instrument kernel. The IK kernel will be referenced in the
keyword Instrument by the resulting Kernel group.
|
Type
| filename |
|
File Mode
| input |
|
Default Path
| $ISIS3DATA |
|
Internal Default
| none |
|
Filter
| *.ti |
User Override of System Kernels:
SCLK
Description
Naif kernel file to be used for the spacecraft clock in place of the
automated spacecraft clock kernel. The SCLK kernel will be referenced
in the keyword Instrument by the resulting Kernel group.
|
Type
| filename |
|
File Mode
| input |
|
Default Path
| $ISIS3DATA |
|
Internal Default
| none |
|
Filter
| *.tsc |
User Override of System Kernels:
CK
Description
Naif kernel file to be used for the spacecraft pointing in place of
the automated spacecraft pointing kernel. The CK kernel will be referenced
in the keyword InstrumentPointing by the resulting Kernel group.
|
Type
| filename |
|
File Mode
| input |
|
Default Path
| $ISIS3DATA |
|
Internal Default
| none |
|
Filter
| *.bc |
User Override of System Kernels:
FK
Description
Naif kernel file to be used for the instrument frame in place of the
automated frames kernel. The FK kernel will be referenced in the
keyword InstrumentPointing by the resulting Kernel group.
Note: If you enter a filename for CK some instruments may require a
frame kernel as well.
|
Type
| filename |
|
File Mode
| input |
|
Default Path
| $ISIS3DATA |
|
Internal Default
| none |
|
Filter
| *.tf |
User Override of System Kernels:
SPK
Description
Naif kernel file to be used for the spacecraft position in place of
the automated spacecraft position kernel. The SPK kernel will be
referenced in the keyword InstrumentPosition by the resulting Kernel
group.
|
Type
| filename |
|
File Mode
| input |
|
Default Path
| $ISIS3DATA |
|
Internal Default
| none |
|
Filter
| *.bsp |
User Override of System Kernels:
IAK
Description
Naif formatted kernel file to be used for the ISIS specific instrument
addendum kernel, in place of the automated. The IAK kernel will be
referenced in the keyword InstrumentAddendum by the resulting Kernel
group.
|
Type
| filename |
|
File Mode
| input |
|
Default Path
| $ISIS3DATA |
|
Internal Default
| none |
|
Filter
| *.ti |
Shape Model Parameters :
MODEL
Description
A map projected ISIS cube which contains the radii of the target. The file can cover more than the input cube (FROM) but must minimally cover the data in the input cube.
|
Type
| cube |
|
File Mode
| input |
|
Default Path
| $base//dems/ |
|
Filter
| *.cub |
Time Parameters:
ENDPAD
Description
When the kernels for an image are loaded, by default only what the image requires is loaded.
By setting this option, the loaded kernels end at the specified amount of time after the
image end time. This option should always be zero for framing cameras.
|
Type
| double |
|
Default
| 0.0 |
|
Minimum
| 0.0
(inclusive)
|