nimstplane Documentation

nimstplane - Create x,y (map) backplanes for NIMS data for all grating
NIMSTPLANE adds two backplanes of the x,y coordinates of the desired
map projection to the output cube for each grating position.  These
backplanes will be used by "nimsgeom" to actually project the cube to
the map projection.  Before running this program, "nimsgeoplane" must
be run to create the latitude and longitude backplanes or cone and
clock or right ascension and declination backplanes.  If the OFF
option is used, the radius backplane must also exist.  These
backplanes are then used as input to this program.  The backplanes
will be called GR_POS_nn_PROJECTED_LINE and GR_POS_nn_PROJECTED_SAMPLE
where nn is the grating position.

Programmer: Kay Edwards, U.S.G.S., Flagstaff

Input cube file name
  (default extension is .cub)

NONE

Output cube file name
  (default extension is .cub)

NONE

Planes to use to project cube

LAT_LON

Output projection

ORTH

Image resolution (km/pix)
    OR

0.

Image resolution (pix/deg)

0.

Latitude range

-900.,900.

Longitude range

-900.,900.

Map rotation

0.

Latitude of new pole

0.

Longitude of new pole

0.

Center longitude of projection

900.

Center latitude of projection

900.

First standard parallel

900.

Second standard parallel

900.

Scale factor

1.

Time of planet rotation (min)

0.

Time of satellite rotation (min)

0.

Orbit inclination

0.

Longitude of ascending node

0.

Height above planet (km)

0.

Latitude of control point 1

0.

Longitude of control point 1

0.

Latitude of control point 2

0.

Longitude of control point 2

0.

Project off planet points

NO

Trim to exact latitude and
longitude boundaries

NO

ADDITIONAL NOTES:

Parm	Description
FROM	This is the name of the input NIMS "tube" that has the geometric backplanes (latitude, longitude, etc).
TO	The mapping coordinate backplanes will be added to this cube. The backplanes will be called GR_POS_nn_PROJECTED_LINE and GR_POS_nn_PROJECTED_SAMPLE where nn is the grating position.
SOURCE	This program will create backplanes of output coordinates for one of several projections using one of three pairs of backplanes that were created by "nimsgeoplan"e. The LAT_LON option will use the latitude and longitude backplane information to compute the output coordinates. The CONE_CLOCK option will set latitude equal to 90 - cone, since cone is measured from the pole instead of the equator, and longitude will be set equal to clock. The RA_DEC option will set latitude equal to declination and longitude equal to right ascension.
OFF	This option is only used when SOURCE=LAT_LON. A radius backplane must exist along with latitude and longitude backplanes. When OFF=NO, only the points that are on the planet will be projected. When OFF=YES, the points that are off the planet also. Note: the algorithm that projects the off-planet points does not give very satisfactory results at this time (not cosmetically pleasing).
PROJ	Each projection is identified by a four letter keyword. The following table lists the keywords for all possible projections and the parameters that are required for each projection. KEYWORD PROJECTION PARAMETERS REQUIRED ALBE Albers Conical Equal-area CLON,CLAT,PAR1,PAR2 AZEQ Azimuthal Equidistant CLON,CLAT CYLI Cylindrical Equal-area CLON,CLAT* ECON Equidistant Conic CLON,CLAT,PAR1,PAR2 or CLON,CLAT,PAR1 GNOM Gnomonic CLON,CLAT LAMA Lambert Azimuthal Equal-area CLON,CLAT (+90 to -90 from CLON,CLAT) LAMB Lambert Conformal CLON,CLAT,PAR1,PAR2 LAMG Lambert Azimuthal Equal-area CLON,CLAT (+170 to -170 from CLON,CLAT) MERC Mercator CLON,CLAT* MILL Miller Cylindrical CLON MSC Modified Stereographic Conformal OMER Oblique Mercator or Hotine CLAT,SCFA and CLON,INCL or LAT1,LON1,LAT2,LON2 ORTH Orthographic CLON,CLAT POIN Point Perspective CLON,CLAT,DIST POLA Polar Stereographic CLON,CLAT* POLY Polyconic CLON,CLAT ROBI Robinson CLON SIMP Simple Cylindrical CLON,CLAT* or Equidistant Cylindrical SINU Sinusoidal CLON SOM Space Oblique Mercator TIM1,TIM2,INCL,ASCN STER Stereographic CLON,CLAT TRAN Transverse Mercator CLON,CLAT,SCFA UTM Universal Transverse Mercator CLON,CLAT,SCFA VANG Van der Grinten I CLON *CLAT defines the latitude of true scale for the following projections: CYLI, MERC, POLA and SIMP. These projections are described by John Snyder in the U.S.G.S. Professional paper 1395 titled "Map Projections - A Working Manual".
LAT	The latitude boundaries of the projection. If no values are input and SOURCE=LAT-LON, the range of the input image will be used. If SOURCE=CONE_CLOCK, the latitude range should be entered in actual cone values. The range will be converted within the program to a range from -90 to 90 by subtracting the cone angle from 90 degrees. Do not use a latitude range greater than +90 for any option but CONE_CLOCK. The valid range is from -90. to 180. degrees.
LON	The longitude boundaries of the projection. On Earth, Venus and the Uranian system longitude is positive to the east. The rest of the solar system is positive to the west. The valid range is -360. to 360. degrees. See note in latitude description.
KM	Resolution is usually specified in kilometers/pixel, degrees/pixel or pixels/degree. KM is the resolution of the image in km/pix. Either this parameter or DEG can be used to enter the desired resolution. The equations relating the two parameters are: KM=RADIUS*.0174533/DEG or DEG=RADIUS*.0174533/KM If DEG=0., then KM will be used to define resolution.
DEG	DEG is the resolution of the image in pix/deg. The default will be to use KM to define the resolution. If the desired resolution is given in degrees/pixel such as: 1/32 deg/pix, or .03125 deg/pix then the inverse must be used which is DEG=32 (pix/deg) and any value in KM will be ignored.
MAPROT	This parameter defines which way is up. For most projections, North is at the top when MAPROT=0. When MAPROT=90., the image will be rotated clockwise. The valid range is -360 to 360 degrees.
PLAT	Latitude of the pole of a new spherical coordinate system. For the majority of cases, the default of no rotation is what should be used. The valid range is -90 to 90 degrees.
PLON	Longitude of the pole of a new spherical coordinate system. For the majority of cases the default of no rotation is what should be used. The valid range is -360 to 360 degrees.
CLON	Projections requiring a center longitude are: ALBE, AZEQ, CYLI, ECON, GNOM, LAMA, LAMB, LAMG, MERC, MILL, OMER, ORTH, POIN, POLA, POLY, ROBI, SIMP, SINU, STER, TRAN, UTM and VANG. The center longitude defines the central meridian of the projection, not necessarily the center of your input or output image. It is a parameter defined by the user of the final product. If working with images which will be computer mosaicked, then the center longitude for all those images must be the same. If the TRAN is being used on Earth, there is a convention used of defining the center longitude of 6 degree wide zones (Universal Transverse Mercator or UTM). These zones are defined by measuring 6 degree increments from 0 degrees longitude. This means that the center longitudes of these zones start at 3 and go in increments of 6 degrees through 357 degrees. Or from -177 degrees to 177 degrees. On Earth, Venus and the Uranian system longitude is positive to the east. The rest of the solar system is positive to the west. The valid range is from -360 degrees to 360 degrees.
CLAT	If SOURCE=CONE_CLOCK, the center latitude should be entered in actual cone values. The center latitude will be converted within the program to a range from -90 to 90 by subtracting the cone angle from 90 degrees. Do not use a center latitude greater than +90 for any option but CONE_CLOCK. Projections requiring a center latitude are: ALBE, AZEQ, CYLI, GNOM, LAMA, LAMB, LAMG, MERC, OMER, ORTH, POIN, POLA, POLY, SIMP, STER, TRAN and UTM. The center latitude defines the latitude of origin of the projection, except for the following projections: CYLI, MERC, POLA and SIMP where it defines the latitude of true scale. It is a parameter defined by the user of the final product. If working with images which will be computer mosaicked, then the center latitude for all those images must be the same. The valid range is from -90. degrees to 180. degrees.
PAR1	Projections requiring standard parallels are: ALBE, ECON and LAMB (The ECON may have one or 2 parallels). Standard parallels must have the same sign as the latitude range of the projection. Default standard parallels for Lambert Conformal are: PLANET PAR1 PAR2 ------- ---- ---- CALLISTO 30. 58. EARTH 33. 45. GANYMEDE 30. 58. MARS 35.83 59.17 MERCURY 30. 60. Default standard parallels for Albers Equal-area are: PLANET PAR1 PAR2 ------- ---- ---- EARTH 29.5 45.5
PAR2	See PAR1
SCFA	The projections requiring a scale factor are: OMER, TRAN and UTM. This is the ratio between true scale at some standard point such as a standard parallel and the scale at any given point. This value is normally left at 1. The UTM overides the default and sets SCFA=.99996. The UTM should only be used for Earth.
TIM1	The SOM is only projection requiring the time of planet rotation. TIM1 is the length of Earth's rotation with respect to the precessed ascending node of the satellite orbit in minutes. For Lansat this value is 1440 minutes or one day (See Snyder).
TIM2	The SOM is only projection requiring the time of satellite rotation. TIM2 is the time required for one revolution of the spacecraft in minutes. For Landsat 1,2,3 TIM2=103.267, for Landsat 4,5 TIM2=98.884.
INCL	The projections requiring the orbit inclination are: OMER and SOM. INCL is the angle of inclination between the plane of the planet's equator and the plane of the satellite orbit, measured counterclockwise from the equator to the orbital plane at the ascending node. For Landsat 1,2,3 INCL=99.092, for Landsat 4,5 INCL=98.20.
ASCN	The SOM is only projection requiring the longitude of the ascending node of the orbit.
DIST	The POIN is the only projection requiring the height above the planet.
LAT1	The OMER is the only projection requiring the latitude and longitude of two control points. These control points must be on the great circle chosen for the projection. The Mercator is a special case of the Oblique Mercator where the Equator is the great circle chosen for the projection.
LON1	See LAT1
LAT2	See LAT1
LON2	See LAT1
TRIM	The default of TRIM=N will project all points within a rectangle that contains the latitude and longitude range that was input. TRIM=Y will trim the image to the exact latitude and longitude range. (No trimming will occur when the latitude and longitude range is found by the program.)