Isis 3 Application Documentation
Change a cube's map projection
Description
This program will alter the projection of a cube which is already in a map
projection. Pixels are physically moved using either a nearest neighbor,
bilinear, or cubic convolution interpolator. Usage examples of this
program include:
1. Converting from Sinusodial to Mercator or any other
supported projection
2. No projection change but altering projection parameters
such as center longitude or standard parallels
3. No projection change but altering pixel resolution
4. No projection change but altering latitude/longitude window
5. No projection change but altering latitude types, longitude
domains, or longitude direction
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
Kay Edwards | 1986-09-27 |
Original version
|
Jeff Anderson | 2003-01-15 |
Converted to Isis 3.0
|
Stuart Sides | 2003-05-16 |
Modified schema location from astogeology... to isis.astrogeology...
|
Stuart Sides | 2003-05-30 |
Fixed compiler error with uninitialized variable after adding -O1 flag
|
Stuart Sides | 2003-07-29 |
Modified filename parameters to be cube parameters where necessary
|
Jacob Danton | 2005-12-05 |
Added appTest
|
Elizabeth Miller | 2006-05-18 |
Depricated CubeProjection and ProjectionManager to ProjectionFactory
|
Steven Lambright | 2007-06-22 |
Fixed typo in user documentation
|
Steven Lambright | 2007-06-27 |
Expanded options, fixed conversions when switching measurement systems (such as from planetographic to planetocentric)
|
Steven Lambright | 2007-07-31 |
Fixed bug with changing resolutions
|
Steven Lambright | 2007-08-09 |
Rewrote resolution handling code to be simpler and fix yet another bug.
|
Steven Lambright | 2007-08-14 |
Fixed method of getting cube specific projection group parameters, such as the scale and resolution.
|
Jeff Anderson | 2007-11-08 |
Fixed bug trimming longitudes
|
Stuart Sides | 2007-11-16 |
Fixed bug when TRIM option was used and most if not all data was being
NULLed.
|
Steven Lambright | 2007-12-05 |
Fixed bug where user-entered resolutions could be ignored
|
Christopher Austin | 2008-04-18 |
Added the MATCHMAP option.
|
Steven Lambright | 2008-05-13 |
Removed references to CubeInfo
|
Steven Lambright | 2008-06-13 |
The rotation keyword will no longer automatically propagate
|
Steven Lambright | 2008-06-23 |
Added helper button and improved error message
|
Steven Lambright | 2008-08-04 |
Changed MATCHMAP to default off and added exclusions. If MATCHMAP is true,
the ground range and pixel resolution can not be set because they are to be
taken from the map file.
|
|
Parameter Groups
Files
Name
|
Description
|
FROM |
Input cube to remap
|
MAP |
File containing mapping parameters
|
TO |
Newly mapped cube
|
Output Cube Resolution
Name
|
Description
|
MATCHMAP | Match number of Lines and Samples |
PIXRES | Defines how the pixel resolution in the output map file is obtained |
RESOLUTION | Pixel resolution |
Output Map Ground Range
Name
|
Description
|
DEFAULTRANGE | Defines how the default ground range is determined |
SLAT | Starting latitude |
ELAT | Ending latitude |
SLON | Starting longitude |
ELON | Ending longitude |
TRIM |
Trim pixels outside ground range
|
Interpolation
Name
|
Description
|
INTERP | Type of interpolation |
|
Files:
FROM
Description
The specification of the input cube to be remapped. The cube must
contain a valid Mapping group in the labels.
Type
| cube |
File Mode
| input |
Filter
|
*.cub
|
Files:
MAP
Description
A file containing the desired output mapping parameters. This
file can be a simple label file, hand produced or created via
the "maptemplate" program. It can also be an existing cube label
which contains a Mapping group. In the later case the input cube
will be transformed into the same map projection, resolution, etc.
Type
| filename |
File Mode
| input |
Filter
|
*.map *.cub
|
Files:
TO
Description
This file will contain the results of the remapping.
Type
| cube |
File Mode
| output |
Filter
|
*.cub
|
Output Cube Resolution:
MATCHMAP
Description
This makes the number of lines, number of samples, resolution
and ground range of the output cube match the MAP file.
Type
| boolean |
Default
| FALSE |
Exclusions
|
- PIXRES
- RESOLUTION
- DEFAULTRANGE
- SLAT
- ELAT
- SLON
- ELON
|
Output Cube Resolution:
PIXRES
Description
This parameter is used to specify how the pixel resolution is obtained for the output map
projected cube.
Type
| string |
Default
| FROM |
Option List:
|
Option |
Brief |
Description |
FROM | Read resolution from input cube |
This option will automatically determine the resolution from the input cube.
Exclusions
|
MAP | Read resolution from input map file |
This option will use either the PixelResolution (meters/pixel) or Scale (pixels/degree) in the map file.
Exclusions
|
MPP | Get resolution from user in meters per pixel |
This option allows the user to specify the resolution in meters per pixel using the RESOLUTION parameter
Inclusions
|
PPD | Get resolution from user in pixels per degree |
This option allows the user to specify the resolution in pixels per degree using the RESOLUTION parameter
Inclusions
|
|
Output Cube Resolution:
RESOLUTION
Description
Specifies the resolution in either meters per pixel or pixels per degree
Type
| double |
Minimum
| 0.0
(exclusive)
|
Output Map Ground Range:
DEFAULTRANGE
Description
This parameter is used to specify how the default latitude/longitude ground range for the output map projected image
is obtained. The ground range can be obtained from the camera or map file. Note the user can overide the default using the SLAT, ELAT, SLON, ELON parameters.
The purpose of the ground range is to define the coverage of the map projected image. Essentially, the ground range and
pixel resolution are used to compute the size (samples and line) of the output image.
Type
| string |
Default
| FROM |
Option List:
|
Option |
Brief |
Description |
FROM | Read default range from input cube |
This option will automatically determine the mininum/maximum latitude/longitude from the input cube specified
using the FROM parameter.
|
MAP | Read default range from map file |
This option will read the mininum/maximum latitude/longitude from the input map file.
|
|
Output Map Ground Range:
SLAT
Description
The minimum latitude of the ground range. If this is entered by the user it will override the default input cube or map value.
Type
| double |
Internal Default
| Use default range |
Minimum
| -90.0
(inclusive)
|
Maximum
| 90.0
(inclusive)
|
Output Map Ground Range:
ELAT
Description
The maximum latitude of the ground range. If this is entered by the user it will override the default input cube or map value.
Type
| double |
Internal Default
| Use default range |
Minimum
| -90.0
(inclusive)
|
Maximum
| 90.0
(inclusive)
|
Greater Than
| SLAT
|
Output Map Ground Range:
SLON
Description
The minimum longitude of the ground range. If this is entered by the user it will override the default input cube or map value.
Type
| double |
Internal Default
| Use default range |
Output Map Ground Range:
ELON
Description
The maximum longitude of the ground range. If this is entered by the user it will override the default input cube or map value.
Type
| double |
Internal Default
| Use default range |
Greater Than
| SLON
|
Output Map Ground Range:
TRIM
Description
If this option is selected, pixels outside the latitude/longtiude
range will be trimmed or set to null.
This is useful for certain projections whose lines of latitude and
longitude are not parallel to image lines and sample columns.
Type
| boolean |
Default
| FALSE |
Interpolation:
INTERP
Description
This is the type of interpolation to be performed on the input.
Type
| string |
Default
|
CUBICCONVOLUTION
|
Option List:
|
Option |
Brief |
Description |
NEARESTNEIGHBOR | Nearest Neighbor |
Each output pixel will be set to the pixel nearest the
calculated input pixel.
|
BILINEAR | Bi-Linear interpolation |
Each output pixel will be set to the value calculated by
a bi-linear interpolation of the calculated input pixel.
|
CUBICCONVOLUTION | Cubic Convolution interpolation |
Each output pixel will be set to the value calculated by
a cubic convolution interpolation of the calculated input pixel.
|
|