Level 2 Help for XYZSUN

INP

ascii tiepoints file from tracker3.
Contains these quantities:
linel   left image line
sampl   left image sample
liner   right image line
sampr   right image sample
dnl     left image dn
dnr     right image dn


OUT

output ascii file with xyz values.
Contains these quantities:
linel   left image line
sampl   left image sample
liner   right image line
sampr   right image sample
dnl     left image dn
dnr     right image dn
x       sun cartesian x in km   
y       sun cartesian y in km   
z       sun cartesian z in km   
lat     sun centric latitude in degrees
lon     sun centric longitude in degrees west
r       distance from sun center in km
dr      distance above apparent surface
error   miss distance between view rays in km


MANUAL

To use the first 4 tiepoints for navigation purposes.
The first 4 tiepoints are used to set the solar image location, size, camera
focal length and scale. So the first 4 points must be placed on the:
1. left solar limb
2. right solar limb
3. top solar limb
4. bottom solar limb
Default is to assume the image is centered in the picture and the scale
is 42 arc minutes over 512 pixels.


OAL

Optical Axis Line
Defaults to 256


OAS

Optical Axis Sample
Defaults to 256


CENLINE

Line of sun center.
Computed from first 4 input tiepoints.


CENSAMP

Sample of sun center
Computed from first 4 input tiepoints.


SCALE

Image plane scale.
Pixels/mm.
Computed from first 4 input tiepoints.


FOCAL

Camera focal length.
In mm.
Computed from first 4 input tiepoints.


SCLONG1

Sub spacecraft longitude. 
Left picture.
Degrees solarcentric West.
Overrides SPICE


SCLAT1

Sub spacecraft latitude.
Left picture.
Degrees solarcentric.
Overrides SPICE


SCLONG2

Sub spacecraft longitude.
Right picture.
Degrees solarcentric West
Overrides SPICE


SCLAT2

Sub spacecraft latitude.
Right picture.
Degrees solarcentric.
Overrides SPICE


NORTH

North angle.
Angle of north spin axis
Degrees clockwise from up.


RANGE

Distance to planet.
In km.
Overrides SPICE


ERADIUS

Equatorial planet 
radius km
DEFAULT=695990.


PRADIUS

Polar planet 
radius km
DEFAULT=695990.


SWITCH

Switches line with sample on the input file.
For people who can't keep it straight.


EPIPOLAR

Sets the right image line to the left image line, so both line coordinates
are the same for each tiepoint.


NOSPICE

Keyword to specify the source of navigation (sclong, sclat, range).
SPICE (the default) says to compute them using spice kernels.
NOSPICE says to bypass spice and take them from the parameters.
To be used only if the spice kernels are unavailable, to avoid a crash.


SPICEFILE

The name of the solar system spice sp kernel. Defaults to:
/project/spice/ops/generic_kernels/spk/de405s.bsp
This is a binary kernel operating under solaris operating system.
It is assumed that the LEAPSECONDS and CONSTANTS kernels are defined by
these 2 logical names and exist in the standard GLL spice directory.