hicrop
This program extracts a sub-area from a HiRise cube.
This program can be used to crop lines from a HiRise cube. The purpose of
the application is to remove boundary image data for which the
corresponding CK binary file data is missing or discontiuous. The user may
choose from one of 4 options for determining where to crop the image.
- The CK file provided by the user.
- A jitter analysis file provided by the user.
- A user entered start and stop times.
- A user entered start line and number of lines.
Categories
History
Jeannie Backer | 2012-11-21 | Original version |
Lynn Weller | 2012-01-22 | Application category name changed from Trim and Mask to Mars Reconnaissance Orbiter. Fixes mantis ticket #951. |
Kristin Berry | 2015-07-31 | Added additional NaifStatus::CheckErrors() calls to see if any NAIF errors were signaled. References #2248. |
Parameters
Files
The HiRISE cube which will be cropped.
Type | cube |
---|---|
File Mode | input |
Filter | *.cub |
The camera kernel file that will be used to spiceinit the cube. This
parameter is required to validate that the chosen crop area is covered
in the CK kernel. It is also the default method to determine the crop
area, if no other crop boundary source is chosen.
Type | filename |
---|---|
File Mode | input |
Default Path | $mro/kernels/ck |
Filter | *.bc |
The spacecraft clock kernel file for the given cube. This parameter
is required to find the true spacecraft clock counts and ephemeris
times associated with the cube. The default is the highest version
found in the mro sclk directory.
Type | filename |
---|---|
File Mode | input |
Default Path | $mro/kernels/sclk |
Internal Default | Use latest MRO SCLK file |
Filter | *.tsc |
The leapsecond file for the given cube. This parameter is required to
find the spacecraft clock counts and ephemeris times. The default is
the highest version found in the base lsk directory.
Type | filename |
---|---|
File Mode | input |
Default Path | $base/kernels/lsk |
Internal Default | Use latest LSK file |
Filter | *.tls |
Ascii table of pixel offsets representing jitter errors in the camera
pointing for a given time. The table has three columns: sampleOffset,
lineOffset, and ephemerisTimeSeconds. The user may choose this file
as the crop boundary source. In that case, SOURCE=JITTER must also be
entered. When the jitter analsis file is used, the program will find
earliest and latest times in the file that do not have sample and line
offsets that both equal zero. If any other SOURCE value is chosen,
this file should not be entered by the user.
Type | filename |
---|---|
File Mode | input |
Filter | *.txt |
The cropped output cube containing a sub-area of the input cube.
Type | cube |
---|---|
File Mode | output |
Filter | *.cub |
Options
This option determines how the boundaries of the cropped cube will
be chosen.
Type | string | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Default | CK | |||||||||||||||
Option List: |
|
The earliest time that will be kept in the cropped cube. This is the
initial start time for the cropped cube. If it does not correspond to
the beginning of a line, the start time of the cropped cube will be
the time corresponding to the beginning of the next line in the input
cube. This parameter should only be entered if SOURCE=TIME. If any
other SOURCE value is chosen, this value should not be entered by the
user.
Type | double |
---|---|
Inclusions |
|
The latest time that will be kept in the cropped cube. This is the
initial stop time for the cropped cube. If it does not correspond to
the end of a line, the stop time of the cropped cube will be
the time corresponding to the end of the previous line in the input
cube. This parameter should only be entered if SOURCE=TIME. If any
other SOURCE value is chosen, this value should not be entered by the
user.
Type | double |
---|---|
Inclusions |
|
The line number of the input cube that will be the first line of the
cropped cube. This parameter should only be entered if
SOURCE=LINEVALUES. If any other SOURCE value is chosen, this value
should not be entered by the user.
Type | integer |
---|---|
Minimum | 1 (inclusive) |
Inclusions |
|
The number of lines that will be taken from the input cube. The last
line to be kept from the input cube is found by (NLINES - LINE + 1).
If this end line is greater than the number of lines in the input
cube, then the number of lines kept will be modified so that the
end line calculation equals the number of lines in the input cube.
This parameter should only be entered if SOURCE=LINEVALUES. If any
other SOURCE value is chosen, this value should not be entered by the
user.
Type | integer |
---|---|
Minimum | 1 (inclusive) |
Inclusions |
|