map2map
Modify a cube's map projection
This program will alter the projection of a cube which is already
in a map projection (ISIS level2 cube).
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
6. Match the mapping parameters of another ISIS leve2 cube for
comparison.
If you need to generate your own map file you can use the maptemplate program or alternatively, hand create a file using your favorite editor. The map file need only specify the ProjectionName as defaults will be computed for the remaining map file parameters.
The map file can be an existing map projected (level2) cube. A level2 cube has PVL labels and contains the Mapping group. Depending on the values of the input parameters, the output cube can use some or all of the keyword values of the map file. For instance, setting MATCHMAP = true causes all of the mapping parameters to come from the map file, resulting in an output cube having the same number of lines and samples as the map file. If MATCHMAP = true and the map file is missing a keyword like PixelResolution, the application will fail with a PVL error. Setting MATCHMAP=false allows for some of the mapping components to be overridden by the user or computed from the FROM cube.To learn more about using map projections in ISIS, refer to the ISIS Workshop "Learning About Map Projections".
Categories
Related Applications to Previous Versions of ISIS
This program replaces the following applications existing in previous versions of ISIS:- nuproj
- newmap
- lev2tolev2
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. |
| Steven Lambright | 2008-11-12 | Moved the MATCHMAP parameter to the "FILES" parameter group. Fixed a problem with this program that caused null output images when the input longitude domain was inconsistent with the input longitude range in equatorial cylindrical projections. |
| Christopher Austin | 2008-12-11 | Changed the parameters SLAT, ELAT, SLON, ELON to MINLAT, MAXLAT, MINLON, MAXLON in correlation with autimos. |
| Christopher Austin | 2008-03-12 | Added a default path as well as a helper function for the MAP parameter. |
| Steven Lambright | 2010-08-27 | Made automatic calculation of longitude range more likely to succeed |
| Lynn Weller and Debbie A. Cook | 2012-01-05 | Updated documentation text, added glossary links, and improved compatability with Isis documentation. |
| Tracie Sucharski | 2012-12-06 | Changed to use TProjection instead of Projection. References #775 |
| David L Miller | 2015-08-10 | Fixed bug where map2map fails when missing Scale keyword in the MAP file. Fixes #2151 |
