Level 2 Help for FRAMEORTHO

INP

Input file
(has to be frame image)


DTM

DTM file of fix height in m
above target body
(default= 0m,
i.e. the reference ellipsoid)


OUT

Output VICAR-image with complete label information


ADJUFILE

File containing adjusted position
and pointing (if set, no SPICE is used)


FITTOFILE

File to which output has to fit


O_FORMAT

Output format (valid=BYTE) default=--
Only effective, if PHO_FUNC != NONE and
fileformat of input file is BYTE
frameortho will cut grayvalues > 255 to 255


MP_TYPE

Identifies the type of cartographic projection characteristic of 
a given map.  These names or types are derived from names used in 
USGS Professional Paper 1395. (default: SINUSOIDAL)


PHO_FUNC

Photometric function type (default: NONE)

This parameter selects the menu point for input the photometry task:
   1. to run the program without using a photometric function, you have 
      to select "NONE"'
   3. to run the program without using a photometric correction you have to 
      select the desired photometric function.

Note for the tutor mode :
  When returning to the highest level of the menu program you will
  see that the fourth selection point has been changed according to your input 
  of PHO_FUNC in the first menu point.


IPOL

Interpolation type: NN = Nearest Neighbor
                    BI = Bilinear Interpolation (default)
                    CC = Cubic Convolution


NL_OUT

Number of lines of the output image


NS_OUT

Number of samples of the output image


ANCHDIST

Distance between the points that define the 
anchorpoint grid: valid is a value between 1 and 1000


LIMB

setting to BADLIMB does not make
a (time consuming) nicelimb
default and in MATCH-Mode: NICELIMB


MIN_LAT

Minimum latitude of image data (wrt. MP_RADIUS if set)
allowed in output file
(should be set by user, e.g. if south pole is in image)
(def.: -90.0)


MAX_LAT

Maximum latitude of image data (wrt. MP_RADIUS if set)
allowed in output file
(should be set by user, e.g. if north pole is in image)
(def.: 90.0)


BORDER

This is the width of a black border region with a
grayvalue of 0 which is generated all arround the
output image. If a special projection offset is given by
the user the border will only be generated at the bottom and
right side of the output image. Default for BORDER = 20

Note, that BORDER does not allways define the width exact.
It might vary due to real-to-integer-conversion of
offsets by +/- 1 pixel and due to interpolation limitations
at the image border (e.g. using Cubic Convolution or 
Bilinear Interpolation) by additional +/- 1 pixel.
This does not affect the correctness of offsets.


TRIM_LEFT

user-defined border of the input image,
which will be ignored; additional to 
VOYAGER: TOP/BOTTOM/LEFT/RIGHT 50
VIKING:  TOP 25 BOTTOM 20 LEFT/RIGHT 30


TRIM_RIGHT

user-defined border of the input image,
which will be ignored; additional to 
VOYAGER: TOP/BOTTOM/LEFT/RIGHT 50
VIKING:  TOP 25 BOTTOM 20 LEFT/RIGHT 30


TRIM_TOP

user-defined border of the input image,
which will be ignored; additional to 
VOYAGER: TOP/BOTTOM/LEFT/RIGHT 50
VIKING:  TOP 25 BOTTOM 20 LEFT/RIGHT 30


TRIM_BOTTOM

user-defined border of the input image,
which will be ignored; additional to 
VOYAGER: TOP/BOTTOM/LEFT/RIGHT 50
VIKING:  TOP 25 BOTTOM 20 LEFT/RIGHT 30


REPORT

Monitor output request buttom.
YES = The monitor output of
      - Output image dimensions (lines, samples)
      - Location within the map projection
	(Line and Sample Projection Offset)
      - progress in processing 
      is requested.
NO  = No monitor output is requested (default)


OUTMAX

Sizelimit for output image [in MegaByte]
default: 100.


MATCH

Match request parameter,
may be set to MATCH=MATCH,
if program should generate 
OUT_l and OUT_s files with information
about the history of each pixel in OUT
NOTE: These files will have together
a size of 8 times the OUT size !
default: --


T_EMI_A

Target emission angle (in degrees) for the photometric correction from the 
nativ illumination condition to target artficial ons.

The emission angle element provides the value of the angle between the surface 
normal vector at the interception point and a vector from the intercept point 
to the viewer (artificial spacecraft). The emission angle varies 
from 0 degrees when the viewer is looking perpendicular to the local surface 
(nadir viewing) to 90 degrees when the intercept is tangent to the surface 
of the target body. 


T_INC_A

Target incidence angle (in degrees) for the photometric correction from the 
nativ illumination condition to target artficial ons.

The target incidence angle element provides a measure of the target artificial 
lighting condition at the intercept point. The target incidence angle is the 
angle between the surface normal vector at the intercept point (at the surface) 
and a vector from the intercept point to the artificial "sun". The incidence 
angle varies from 0 degrees when the "solar" direction is perpendicular to the 
local surface to 90 degrees when the intercept is tangent to the surface of the 
target body. 


T_AZI_A

Target azimuth angle (in degrees) for the photometric correction from the 
nativ illumination condition to target artficial ons.

The target phase angle element provides a measure of the relationship between 
the target viewing direction (corrected to desired ons) and incidence 
artificial "solar" light direction. Phase angle is defined as the angle between 
a vector from the intercept point to the "sun" and a vector from the intercept 
point to the viewer. Phase angle varies from 0 degrees, when the "sun" is 
directly behind the viewer, to 180 degrees, when the "sun" is opposite the 
viewer.


MP_RADIUS

radius of map reference body [km],
especially for "potato targets",
where the SPICE-defined 
non-spherical model.
It is used for the map projection,
BUT is NOT  used for intersection
of line-of-sight with the real (SPICE-defined) body. 


A_AXIS

The a-axis measure provides the value of the a-axis of a solar 
system body.  This element provides the semimajor equatorial 
radius measured perpendicular to the spin axis. In the case of 
a spherical or oblate spherical body, the a-axis and b-axis 
measures have the same value. A_AXIS_RADIUS is measured in kilometers.


B_AXIS

The b-axis measure provides the value of the b-axis of a solar 
system body.  This element provides the semiminor equatorial 
radius measured perpendicular to the spin axis. In the case of 
a spherical or oblate spherical body, the a-axis and b-axis 
measures have the same value. B_AXIS_RADIUS is measured in kilometers.


C_AXIS

The C axis measure provides the value of the c-axis of a solar 
system body.  This element provides the polar radius as measured 
along the spin axis. C_AXIS_RADIUS is measured in kilometers.


BOD_LONG

The longitude of the semimajor (longest) axis of a triaxial 
ellipsoid.  Some bodies, like Mars, have the prime meridian 
defined at a longitude which does not correspond to the 
equatorial semimajor axis, if the equatorial plane is modeled 
as an ellipse.


TOL

Clock tolerance of pointing requests


BSPFILE

Binary SP-Kernel. Default = EPHEMERIS 


BCFILE

Binary C-Kernel. Default = POINTING


TSCFILE

Clock, SCLK-kernel.  Default = SCLK


TIFILE

Instrument data, I-kernel.  Default = INSTRUMENT


TPCFILE

Planetary constants, PC-kernels.  Default = CONSTANTS


BPCFILE

Binary Planetary constants, PC-kernels.  Default = --


TLSFILE

Leapseconds, LS-kernel.  Default = LEAPSECONDS


MP_RES

Identifies the scale of a given map in pixels per degree.  Please refer
to the definition for map scale for a more complete definition. Note 
that map resolution and map scale both define the scale of a map except 
that they are expressed in different units. Map scale is measured in 
kilometers per pixel.


MP_SCALE

Map scale is defined as the ratio of the actual distance between two 
points on the surface of the target body to the distance between the
corresponding points on the map.  The map scale references the scale 
of a map at a certain reference point or line, measured in kilometers 
per pixel.  Certain map projections vary in scale throughout the map. 
In general, the map scale usually refers to the scale of the map at 
the center latitude and center longitude. An exception are the Conic 
projections; the map scale refers to the scale at the standard 
parallels for these projections.  The relationship between map 
scale and the map resolution element is that they both define 
the scale of a given map, except they are expressed in different 
units.  Map resolution is in pixels per degree.


POS_DIR

Identifies the direction of longitude (e.g. EAST, WEST) for a planet. 
The IAU definition for direction of positive longitude is adopted.  
Typically, for planets with prograde rotations, positive longitude 
direction is to the west. For planets with retrograde rotations, positive
longitude direction is to the east.


CEN_LAT

The center_latitude element provides a reference latitude for certain 
map projections, measured in degrees with a valid range of (-90.0, 90.0). 
In many projections, the center_latitude along with the center_longitude 
defines the point or tangency between the sphere of the planet and the 
plane of the projection.  For spherical projections, the center_latitude 
is formally defined in terms of Euler angles (please refer to the definition 
for spherical_azimuth for a more complete explanation).  The map_scale 
(or map_resolution) is typically defined at the center_latitude and
center_longitude.


CEN_LONG

The center_longitude element provides a reference longitude for certain 
map projections, measured in degrees with a valid range of (0,360).  In 
many projections, the center_longitude along with the center_latitude 
defines the point or tangency between the sphere of the planet and the 
plane of the projection.  For spherical projections, the center_longitude 
is formally defined in terms of Euler angles (please refer to the definition 
for spherical_azimuth for a more complete explanation).  The map_scale 
(or map_resolution) is typically defined at the center latitude and 
longitude.


SPHER_AZ

For the spherical body model, a clockwise rotation of that body about 
an imaginary axis through a specified center latitude and longitude 
(MIPS-PDS keywords CENTER_LATITUDE, CENTER_LONGITUDE) allows for a 
reorientation prior to map projection of the surface to the image space. 
The measure of this clockwise rotation in degrees is the spherical 
azimuth.
More specifically, the spherical body model is first rotated about its 
polar axis until the specified center longitude lies at the projection 
center. Then the body model is rotated about an axis perpendicular to 
the specified center longitude until the center latitude lies at the 
projection center. Finally, the body model is rotated clockwise about 
the radius vector from the center of the sphere to the center latitude 
and longitude point to complete the pre-mapping body reorientation.


L_PR_OFF

Provides the line offset value of the map projection origin position 
from the center of the pixel line and sample {1,1} (line and sample 
1,1 is considered the upper left corner of the digital array). Note 
that the positive direction is to the right and down.


S_PR_OFF

The sample offset value of the map projection origin position from the 
center of the pixel line and sample 1,1 (line and sample 1,1 is 
considered the upper left corner of the digital array). Note that the 
positive direction is to the right and down.


CART_AZ

After points have been projected to image space (x,y or line,sample), 
a clockwise rotation, in degrees, of the line and sample coordinates 
can be made with respect to the map projection origin - specified by
line and sample projection offset. This clockwise rotation in degrees 
is the Cartesian azimuth. This parameter is used to indicate where 'up' 
is in the projection.


F_ST_PAR

Standard parallels are used in certain projections, e.g. Lambert Conic 
and Albers, to mark selected latitudes for defining components of a map
projection.  If a Conic projection has a single standard parallel, then 
the first standard parallel is the point of tangency between the sphere 
of the planet and the cone of the projection. If there are two standard
parallels, both first and second parallels, these are the intersection 
lines between the sphere of the planet and the cone of the projection. 
For respective map projections, map scale is defined at the standard 
parallels.


S_ST_PAR

Standard parallels are used in certain projections, e.g. Lambert Conic 
and Albers, to mark selected latitudes for defining components of a map
projection.  If a Conic projection has a single standard parallel, then 
the first standard parallel is the point of tangency between the sphere 
of the planet and the cone of the projection. If there are two standard
parallels, both first and second parallels, these are the intersection 
lines between the sphere of the planet and the cone of the projection. 
For respective map projections, map scale is defined at the standard 
parallels.


FOC_LEN

The camera focal length measured in millimeters.


FOC_SCAL

The scale in the camera focal plane in pixels per millimeter. The 
scale is measured on the geometrically corrected image.


NORTH_AN

The angle in degrees measured clockwise from up, where up is 
defined in the direction of the planet spin axis, projected onto 
the image plane.


INTERC_L

The image line which intersects the optical axis in the camera focal 
plane after distortion correction.


INTERC_S

The image sample which intersects the optical axis in the camera focal 
plane after distortion correction. Sample increases to the right.


PL_CEN_L

The picture line coincident with the center of the planet. This line 
is measured on the geometrically corrected image.


PL_CEN_S

The picture sample coincident with the center of the planet. This sample 
is measured on the geometrically corrected image.


SUB_LAT

The planetocentric latitude of the intersection of a vector drawn from 
the planet center to the spacecraft with the surface of the planet.


SUB_LONG

The  west longitude of the intersection of a vector drawn from the planet
 center to the spacecraft with the surface of the planet.


SPC_DIST

Distance in kilometers between the planet center and the spacecraft 
at the time the image was obtained.


ALBEDO

Albedo -  valid for the Lambert and Minnaert photometric functions.


EXPONENT

Exponent - the geometrical constant k of the Minnaert photometric function.


A_VEVERKA

Parameter of the Veverka, Squyres-Veverka and Mosher photometric functions.


B_VEVERKA

Parameter of the Veverka, Mosher, Squyres-Veverka and Buratti 
photometric functions.


C_VEVERKA

Parameter of the Veverka, Mosher, Squyres-Veverka and Buratti 
photometric functions.


D_VEVERKA

Parameter of the Veverka, Mosher, Squyres-Veverka and Buratti 
photometric functions.


E_BURATTI

Buratti's parameter for modification of the Veverka photometric function.


MO_EXP1

Modification of the coefficient k in the Minnaert part 
of Mosher's photometric function (goes along with MO_EXP2).


MO_EXP2

Modification of the coefficient k in the Minnaert part 
of Mosher's photometric function (goes along with MO_EXP1).


DEN_SOIL

Specific volume density of the soil.


W_SOIL

Single-scattering albedo of the soil particles. It characterizes the efficiencu of an average particle to scatter and absorb light. 
One of the classical Hapke parameter.


HG1_SOIL

Parameter of the first term of the Henyey-Greenstein soil particle 
phase function.


HG2_SOIL

Parameter of the second term of the Henyey-Greenstein soil particle 
phase function.


HG_ASY_SOIL

Asymmetry parameter (weight of the two terms 
in the Henyey-Greenstein soil phase function).


LE1_SOIL

Parameter of the first term of the Legendre-Polynomial soil particle 
phase function.


LE2_SOIL

Parameter of the second term of the Legendre-Polynomial soil particle 
phase function.


H_SHOE

Parameter which characterizes the soil structure in the terms of porosity, particle-size distribution, and rate of compaction with depth (angular width of opposition surge due to shadowing). 
One of the classical Hapke parameter.


B_SHOE

Opposition magnitude coefficient (total amplitude of the opposition surge due to shadowing).
One of the classical Hapke parameter. 
B_SHOE=S(0)/(W_SOIL*p(0))
with p(0) - soil phase function
S(0) - opposition surge amplitude term which characterizes the contribution of 
light scattered from near the front surface of individual particles at zero 
phase 


H_CBOE

Parameter of the coherent backscattering ( width of theopposition surge due 
to the backscatter ).


B_CBOE

Opposition magnitude coefficient of the coherent backscattering 
(height of opposition surge due to backscatter). 


THETA

Average topographic slope angle of surface roughness at subresolution scale.
One of the classical Hapke parameter. 


COOK

 Parameter of the Cook's modification of the old Hapke function.


TAU_ATM

Optical depth of the atmosphere.


W_ATM

Single scattering albedo of the atmospheric aerosols.


HG1_ATM

Parameter of the first term of the Henyey-Greenstein atmospheric phase function.


IRV_EXP1

Parameter of the Irvine photometric function.


IRV_EXP2

Parameter of the Irvine photometric function.