ISIS Application Documentation
hijitter | Standard View | TOC | Home |
Correct jitter in input cubes and output corrected undistorted cubes
Description
Categories
Groups
History
This application computes angular corrections from pixel offsets in the input jitter file and applies the corrections to the undistorted output cube. This application is procedural in that it runs other applications. It runs through a series of applications twice. The first time it applies the jitter corrections and calculates additional pitch rate and yaw angles to center the remaining camera pointing errors around zero. The output cube files are deleted and the series of applications is run again, including the additional pitch rate and yaw corrections. The first step it performs is to run spiceinit on all the FROMLIST cubes with the parameter attach=no. A version of the MASTER file is saved and run through the application spicefit to remove noise in the camera pointing. This file will be used in the noproj runs as the match cube. The next application run is appjit and it needs to load the Spice from the files directly in order have access to Spice information not typically stored on the Isis cube labels. This application applies the corrections from the JITTER file to the camera pointing in the FROMLIST cubes. Now the FROMLIST cubes are run through noproj, removing the jitter from the pixel positions and the camera distortion. The results are measured on adjacent ccd's by the application hijitreg and used to compute the additional pitch rate and yaw required to center the errors around zero. Now the procedure is repeated with the calculated pitch and yaw passed into appjit as input parameters. The jitter-reduced and distortion-free output cubes are created by the final set of noproj runs on adjacent ccd's. If crop=true then the application crops the extended portion of the image. The starting line and number of lines parameter for crop application is calculated from the ephemeris time in the jitter correction file. LineRate is used to get the starting and ending line information.
Name | Description |
---|---|
FROMLIST | Cubes to correct |
JITTER | Ascii table of pixel offsets representing jitter for a given time |
REGDEF | The Auto Registration template used in hijitreg |
TOLIST | The list of the corrected undistorted cubes to be created |
Name | Description |
---|---|
MASTER | The file to use as the MASTER |
DEGREE | The degree of fit used in appjit |
JITTERCK | Optional jittery ck file for using to correct spice" |
CROP | Crop the top and bottom extending portion of the image |
This file is a list of the file specifications for the input cubes all from the save observation and containing pointing errors due to jitter modeled by the pixel offsets in the JITTER file. The list should be in ascending order, by CCD. Each CCD in the list must have at least one overlapping CCD.
Type | filename |
---|---|
File Mode | input |
Filter | *.lis *.txt |
The file specification of the Ascii table of pixel offsets modeling the jitter errors in the camera pointing based on time. The table has three columns: sampleOffset, lineOffset, and ephemerisTimeSeconds.
Type | filename |
---|---|
File Mode | input |
Filter | *.txt |
The registration template for correlating the overlapping input cubes of the observation. See hijitreg for more information.
Type | filename |
---|---|
File Mode | input |
Filter | *.txt *.def |
This list of output files should contain a file to correspond to each input file. The output files will have both the jitter removed, as modeled in the input JITTER file, and camera distortions by the application noproj. The MASTER file with its camera pointing adjusted by the application spicefit, will be used as the MATCH file in noproj
Type | filename |
---|---|
File Mode | output |
Internal Default | Automatic |
The application appjit applies the jitter corrections to the camera pointing in the MASTER file first and then copies it to the other files in the FROMLIST. The MASTER file is also used as the MATCH file in the application NOPROJ
Type | integer |
---|---|
Default | 5 |
Minimum | 0 (inclusive) |
Maximum | 13 (inclusive) |
Enter the degree of the polynomial to fit to the data
Type | integer |
---|---|
Default | 2 |
Optionally enter the name of an output Naif ck containing the jittery pointing data. This ck can be used in spiceinit as the csmithed camera pointing to get correct pointing on mission cubes (not noproj'd). The default is to not create the jittery ck.
Type | filename |
---|---|
Internal Default | None |
Crop the top and bottom extending portion of CCDs in the image using the jitter file's first and last non zero corrections. This option when enabled removes the lines at the beginning and end of the image as determined by the jitter file
Type | boolean |
---|---|
Default | false |
Steven Lambright | 2008-12-17 | Original Version |
Debbie A. Cook | 2009-01-14 | Added documentation |
Jai Rideout | 2011-08-04 | Made a small modification to the code in FindRed(...) that created a Pvl object for each file in the file list. FileList's overloaded '[]' operator that was used inside of the call to Filename's constructor confused the compiler on Ubuntu 10.04 systems. |
Debbie A. Cook | 2011-08-15 | Added an option to run ckwriter to create a ck with jitter for correcting image geometry. |
Debbie A. Cook | 2011-12-21 | Fixed the loop that calculated pitch to only loop the number of overlaps (count). |
Sharmila Prasad | 2011-12-27 | Added an option to crop the extended portion of the image using the jitter correction file |
Sharmila Prasad | 2012-02-05 | Crop option false by default |
Debbie A. Cook | 2012-07-06 | Updated Spice members to be more compliant with Isis standards. References #972. |
Jeannie Backer | 2012-11-21 | Modified to work with IR and BG ccd images. Fixed bug with computation of yaw and pitch. Fixes #795. |
U.S. Department of the Interior | U.S. Geological Survey ISIS | Privacy & Disclaimers | Astrogeology Research Program To contact us, please post comments and questions on the USGS Astrogeology Discussion Board To report a bug, or suggest a feature go to: ISIS Github File Modified: 02/24/2025 16:09:04 |