ISIS 3 Application Documentation
spiceinit | Printer Friendly View | TOC | Home |
Update SPICE data (kernels, pointing, and position) for a camera cube
Overview | Parameters | Example 1 | Example 2 | Example 3 | Example 4 |
Parameter GroupsInput Files
Spice Data
Instrument Orientation Kernel (CK) quality
Instrument Position Kernel (SPK) quality
User Override of System Kernels
Shape Model Parameters
Time Parameters
Spice Service Parameters
|
The input cube for which the Kernels group will be updated. InstrumentPointing, InstrumentPosition, BodyRotation, and SunPosition tables will also be added to the cube.
Type | cube |
---|---|
File Mode | input |
Filter | *.cub |
This option uses the ISIS SPICE Website to get the most up to date kernels available. The ATTACH parameter must be enabled for this option. Manually specifying kernel files is not allowed when this option is used. This service may be temporarily unavailable when new Isis releases are being distributed. Any mismatch in Isis version will cause this option to fail; only the most recent version of ISIS is supported. An active internet connection is required to use this service. Running with this option is slower than downloading the SPICE data locally (download all of $ISIS3DATA) and running spiceinit with the local data. This data can take up a lot of space. The size of the download will depend heavily on the mission and instrument of your input file.
Type | boolean |
---|---|
Default | false |
Exclusions |
|
Inclusions |
|
This option attaches binary tables to the cube which contain the instrument position (SPK) and orientation (CK), as well as the sun position and body/target orientation. This is the prefered initialization option as it allows the pointing to be updated by further programs.
Type | boolean |
---|---|
Default | TRUE |
Allow the use of pointing kernels marked as Smithed. If this parameter is selected, smithed kernels may be used to cover the time requirements of the image. Please consider the source, content, and completeness of a smithed ck-kernel before selecting. The keyword InstrumentPointingQuality=Smithed will be added to the Kernels group if this quality kernel is loaded.
Type | boolean |
---|---|
Default | FALSE |
Allow the use of pointing kernels marked as Reconstructed. This is the default option. If reconstructed kernels cannot be found for the given time range, the program will fail. The keyword InstrumentPointingQuality=Reconstructed will be added to the Kernels group if this quality kernel is loaded.
Type | boolean |
---|---|
Default | TRUE |
Allow the use of pointing kernels marked as Predicted. The program will check the reconstructed kernels for the given time range first. If the time range is not found, spiceinit will check for predicted kernels. If predicted kernels cannot be found for the given time range, the program will fail. The keyword InstrumentPointingQuality=Predicted will be added to the Kernels group if this quality kernel is loaded.
Type | boolean |
---|---|
Default | FALSE |
This option will create nadir pointing data. The higher quality kernels will be checked first. If the given time range cannot be found, spiceinit will use a nadir kernel. The keyword InstrumentPointingQuality=Nadir will be added to the Kernels group if this quality kernel is loaded.
Type | boolean |
---|---|
Default | FALSE |
Allow the use of position kernels marked as Smithed. If this parameter is turned on, smithed kernels may be used to cover the time requirements of the image. If a smithed kernel cannot be found, spiceinit will look for a reconstructed kernel for the given time frame. Please consider the source, content, and completeness of a smithed spk-kernel when selected. The keyword InstrumentPositionQuality=Smithed will be added to the Kernels group if this quality kernel is loaded.
Type | boolean |
---|---|
Default | FALSE |
Allow the use of position kernels marked as Reconstructed. This is the default option. If no lower quality options are selected and spiceinit cannot find reconstructed kernels for the given time frame, the program will fail. The keyword InstrumentPositionQuality=Reconstructed will be added to the Kernels group if this quality kernel is loaded.
Type | boolean |
---|---|
Default | TRUE |
Allow the use of pointing kernels marked as Predicted. The program will check the reconstructed kernels for the given time range first. If the time range is not found, spiceinit will check for predicted kernels. If predicted kernels cannot be found for the given time range, the program will fail The keyword InstrumentPositionQuality=Predicted will be added to the Kernels group if this quality kernel is loaded.
Type | boolean |
---|---|
Default | FALSE |
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. If none is specified, spiceinit will use the latest kernel configuration file or kernel database file to find the appropriate kernel(s) for the given input file.
Type | filename |
---|---|
File Mode | input |
Default Path | $base/kernels/lsk/ |
Internal Default | none |
Filter | *.tls |
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. If none is specified, spiceinit will use the latest kernel configuration file or kernel database file to find the appropriate kernel(s) for the given input file.
Type | filename |
---|---|
File Mode | input |
Default Path | $base/kernels/pck/ |
Internal Default | none |
Filter | *.tpc |
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. If none is specified, spiceinit will use the latest kernel configuration file or kernel database file to find the appropriate kernel(s) for the given input file.
Type | filename |
---|---|
File Mode | input |
Default Path | $base/kernels/spk/ |
Internal Default | none |
Filter | *.bsp |
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. If none is specified, spiceinit will use the latest kernel configuration file or kernel database file to find the appropriate kernel(s) for the given input file.
Type | filename |
---|---|
File Mode | input |
Default Path | $ISIS3DATA |
Internal Default | none |
Filter | *.ti |
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. If none is specified, spiceinit will use the latest kernel configuration file or kernel database file to find the appropriate kernel(s) for the given input file.
Type | filename |
---|---|
File Mode | input |
Default Path | $ISIS3DATA |
Internal Default | none |
Filter | *.tsc |
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. If none is specified, spiceinit will use the latest kernel configuration file or kernel database file to find the appropriate kernel(s) for the given input file.
Type | filename |
---|---|
File Mode | input |
Default Path | $ISIS3DATA |
Internal Default | none |
Filter | *.bc |
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. If none is specified, spiceinit will use the latest kernel configuration file or kernel database file to find the appropriate kernel(s) for the given input file.
Type | filename |
---|---|
File Mode | input |
Default Path | $ISIS3DATA |
Internal Default | none |
Filter | *.tf |
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. If none is specified, spiceinit will use the latest kernel configuration file or kernel database file to find the appropriate kernel(s) for the given input file.
Type | filename |
---|---|
File Mode | input |
Default Path | $ISIS3DATA |
Internal Default | none |
Filter | *.bsp |
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. If none is specified, spiceinit will use the latest kernel configuration file or kernel database file to find the appropriate kernel(s) for the given input file.
Type | filename |
---|---|
File Mode | input |
Default Path | $ISIS3DATA |
Internal Default | none |
Filter | *.ti |
Optional extra NAIF formatted kernel file. The EXTRA kernel will be referenced in the keyword Extra by the resulting Kernel group.
Type | filename |
---|---|
File Mode | input |
Default Path | $ISIS3DATA |
Internal Default | none |
ISIS camera models can use a shape model (a projected ISIS cube that defines the radii for a global or regional area). You can choose to select a shape model or to use the definition of the ellipsoid found in the planetary constants (PCK) file.
Type | string | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Default | SYSTEM | |||||||||||||||
Option List: |
|
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. The filename and path of the shape model loaded will be found in the cube labels Kernels Group in the ShapeModel keyword.
Type | cube |
---|---|
File Mode | input |
Default Path | $base//dems/ |
Filter | *.cub |
When the kernels for an image are loaded, by default only what the image requires is loaded. By setting this option, the loaded kernels start at the specified amount of time before the image start time. Using this option for framing cameras could significantly decrease the accuracy of the NAIF information because this will cause the information to be interpolated between the STARTPAD and ENDPAD.
Type | double |
---|---|
Default | 0.0 |
Minimum | 0.0 (inclusive) |
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. Using this option for framing cameras could significantly decrease the accuracy of the NAIF information because this will cause the information to be interpolated between the STARTPAD and ENDPAD.
Type | double |
---|---|
Default | 0.0 |
Minimum | 0.0 (inclusive) |
This is where a request for SPICE data is sent. The default is the USGS SPICE server.
Type | string |
---|---|
Default | http://services.isis.astrogeology.usgs.gov/cgi-bin/spiceinit.cgi |
This is the port on which a request for SPICE data is sent. The USGS server works on port 80.
Type | integer |
---|---|
Default | 80 |
Minimum | 0 (inclusive) |
Example 1Example of spiceinit using default parameters. Description
This example shows how to use spiceinit using the default parameters. That is, the SPICE
data will be attached to the cube labels (attach=yes). Only reconstructed kernel types
will be allowed for CK and SPK kernels, the default system kernels will be found in
the kernel database files, and no time parameters will be set. It shows how spiceinit
will default to the LOLA shapemodel for a cube that has the TargetName keyword in the
Instrument group set to "Moon."
Command Line
spiceinit
from=inputCube.cub
An example of how to run this program with default parameters from the command line.
GUI Screenshot
Data File
|
Example 2Example of spiceinit with user defined options. Description
This example shows how to run spiceinit with a user defined dem. This run of spiceinit will
also look for smithed CK kernels.
Command Line
spiceinit
from=inputCube.cub cksmithed=true shape=user
model=/usgs/cpkgs/isis3/data/base/dems/ulcn2005_clean_0004.cub
An example of how to run this program with user defined parameters from the command line.
GUI Screenshot
Data File
|
Example 3This example shows how to run spiceinit with no shapemodel. Description
This example shows how to run spiceinit with no shapemodel. The system has no shapemodel
for Europa.
Command Line
spiceinit
from=inputCube.cub
An example of how to run this program with default parameters from the command line.
GUI Screenshot
Data File
|
Example 4Example of spiceinit with a ringplane image. Description
This example shows how to use spiceinit for a ringplane image.
Command Line
spiceinit
from=inputCube.cub
An example of how to run this program with default parameters from the command line.
GUI Screenshot
Data File
|