Level 2 Help for HRORTHO

PROJECT

Project directory 
e.g./pho_pictor/berlin


STRIP

strip name


SENSOR

sensor name
valid=(nd,s1,s2,p1,p2,re,gr,bl,ir)


INP

Input image
used if set,
if not set then
/project/strip/img/sensor.l2
will be used


DTM

dtm-file or 
height above sea level (geom-mode)
used if set,
in meter,
if not set then
/project/dtm/dtm
will be used


OUT

Output image
generated if set,
if not set then:
in project notation:
 in geom-mode
 /project/strip/geo/sensor.l3
 or in ortho-mode
 /project/strip/ort/sensor.l4
 or generally in match-mode
 /project/strip/mat/sensor.mat
 will be generated
without project notation:
 out = "inp"_out


FITTOFILE

File to which OUT should fit.
if set to 
nd,s1,s2,p1,p2,re,gr,bl or ir,
then OUT will be fit to 
/project/strip/geo/fittofile.l3
in geom-mode, to
/project/strip/mat/fittofile.mat
generally in match-mode or to
/project/strip/ort/fittofile.l4
in ortho-mode
NOTE :
in geom-mode from fittofile-name
REFERENCE_HEIGHT will be used


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)


IPOL

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


NL_OUT

Number of lines of the output image
(setting NL_OUT, NS_OUT, L_PR_OFF, S_PR_OFF
the user defines the location and size of the
output file, if not set, hrortho generates
an appropriate output file by itself)


NS_OUT

(setting NL_OUT, NS_OUT, L_PR_OFF, S_PR_OFF
the user defines the location and size of the
output file, if not set, hrortho generates
an appropriate output file by itself)
Number of samples of the output image


SL_INP

Start line of the input image
(default=1)


NL_INP

Number of lines of the input image
counted from SL_INP
(default=1)


SWATH

Percentage of swath width to be used
default = 100


ANCHDIST

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


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 = 0

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.


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.  (default)
NO  = No monitor output is requested


MATCH

Match coordinates request buttom.
MATCH = Two file will be generated,
they contain the line-coordinates
and the the sample-coordinates of the 
output pixels in the input file 
(lines are counted from the very first line 
of the input file, not from SL_INP !!)
NOMATCH  = No match coordinate-files are requested (default)


PREC

Precision of coordinates in
New Match-Files [in pixels]
default = 0.1


OUTMAX

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


RAM

e.g. if set to 256.
then only 256 MByte
will be used for output allocation
NOTE: hrortho might acceed
this number in fitto-mode
if input-file is much larger
than fitto-file
VALID=(32:2500)
default=-- (use available, 
	    max. 2500 Mbyte)


ORI

Switch between use of EXTORI files
or SPICE data


EXTORIFILE

Name of the EXTORI-file,
used if ORI is set to EXTORI


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.


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. 


TARGET

defines reference body for map.
Default = MARS


BSPFILE

Binary SP-Kernel. 


BCFILE

Binary C-Kernel.


TSCFILE

Clock, SCLK-kernel.


TIFILE

Instrument data, I-kernel.


TPCFILE

Planetary constants, PC-kernels.


TLSFILE

Leapseconds, LS-kernel.


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.


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.
if neither MP_SCA nor MP_RES is set, the mean real scale/resolution
on ground is calculated.


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.
For earth only east is valid, see function flgeoid
and dlrmapsub.com


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.
(setting NL_OUT, NS_OUT, L_PR_OFF, S_PR_OFF
the user defines the location and size of the
output file, if not set, hrortho generates
an appropriate output file by itself)


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.
(setting NL_OUT, NS_OUT, L_PR_OFF, S_PR_OFF
the user defines the location and size of the
output file, if not set, hrortho generates
an appropriate output file by itself)


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.
if set to 999, hrortho lets the output become bottom down
(similar to Level2-images)


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.


PHO_FUNC

default=NONE


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.