HiRISE

HiRISE.HiPlan.HiSEAS
Interface StereoPair

All Known Implementing Classes:
AbstractStereoPair, MroStereoPair, SimpleStereoPair

public interface StereoPair

A definition of the minimal functionality required of a stereo pair.

This interface describes a "stereo-1" observation and a "stereo-2" observation. These labels are arbitrary and do not necessarily relate to the concept of "left-eye" or "right-eye" observation; in practice, they might reasonably describe the order in which the observations are to be acquired, but there is no enforcement of this practice.

Version:
1.7
Author:
Christian Schaller - UA/PIRL

Method Summary
 String getComment()
          Gets the stereo pair's comment.
 double getEmissionAngleDifference()
          Gets the absolute value of the difference in the emission angle between the two halves of the stereo pair.
 double getIncidenceAngleDifference()
          Gets the absolute value of the difference in the incidence angle between the two halves of the stereo pair.
 String getLabel()
          Gets the stereo pair's label.
 double getPhaseAngleDifference()
          Gets the absolute value of the difference in the phase angle between the two halves of the stereo pair.
 double getSolarAzimuthChange()
          Gets the change in solar azimuth between the two halves of the stereo pair.
 double getSolarAzimuthDifference()
          Gets the difference in solar azimuth between the two halves of the stereo pair.
 double getSolarLongitudeDifference()
          Gets the difference in solar longitude between the two halves of the stereo pair.
 double getSolarSeparation()
          Gets the solar separation angle for the pair.
 Observation getStereo1()
          Gets the stereo-1 observation of the pair.
 Observation getStereo2()
          Gets the stereo-2 observation of the pair.
 double getStereoSeparation()
          Gets the stereo separation angle for the pair.
 double getSubsolarLatitudeChange()
          Gets the change in subsolar latitude between the two halves of the stereo pair.
 

Method Detail

getStereo1

Observation getStereo1()
Gets the stereo-1 observation of the pair.

Returns:
the stereo-1 observation of the pair.

getStereo2

Observation getStereo2()
Gets the stereo-2 observation of the pair.

Returns:
the stereo-2 observation of the pair.

getStereoSeparation

double getStereoSeparation()
Gets the stereo separation angle for the pair. The separation angle is the angle between the view vectors of the two observations.

The separation angle is also known as the stereo convergence angle.

Returns:
the stereo separation angle in radians.

getSolarSeparation

double getSolarSeparation()
Gets the solar separation angle for the pair. The solar separation angle is the angle describing the change in the sun's position, as viewed from the target site, between the two observations.

Returns:
the solar separation angle in radians.

getSolarLongitudeDifference

double getSolarLongitudeDifference()
Gets the difference in solar longitude between the two halves of the stereo pair. This difference is the smaller positive difference; if the stereo-1 observation is at π radians (autumn) and the stereo-2 observation is π/2 radians (summer), this difference π/2 radians, not 3π/2.

Returns:
the small positive solar longitude difference in radians.

getSubsolarLatitudeChange

double getSubsolarLatitudeChange()
Gets the change in subsolar latitude between the two halves of the stereo pair. For subsolar latitude φS for the stereo-1 and stereo-2 observations, the change, ΔφS, is
ΔφS = φS,2 - φS,1

Returns:
the subsolar latitude change in radians.

getSolarAzimuthChange

double getSolarAzimuthChange()
Gets the change in solar azimuth between the two halves of the stereo pair. For solar azimuth phi; for the stereo-1 and stereo-2 observations, the change, Δφ, is
Δφ = φ2 - φ1

Returns:
the solar azimuth change in radians.

getSolarAzimuthDifference

double getSolarAzimuthDifference()
Gets the difference in solar azimuth between the two halves of the stereo pair. This difference is the smaller positive difference; if the stereo-1 observation is at π radians and the stereo-2 observation is π/2 radians, this difference π/2 radians, not 3π/2.

Returns:
the small positive solar between difference in radians.

getPhaseAngleDifference

double getPhaseAngleDifference()
Gets the absolute value of the difference in the phase angle between the two halves of the stereo pair.

Returns:
the phase angle difference in radians.

getIncidenceAngleDifference

double getIncidenceAngleDifference()
Gets the absolute value of the difference in the incidence angle between the two halves of the stereo pair.

Returns:
the incidence angle difference in radians.

getEmissionAngleDifference

double getEmissionAngleDifference()
Gets the absolute value of the difference in the emission angle between the two halves of the stereo pair.

Returns:
the emission angle difference in radians.

getLabel

String getLabel()
Gets the stereo pair's label.

Returns:
the stereo pair's label.

getComment

String getComment()
Gets the stereo pair's comment.

Returns:
the stereo pair's comment.

HiRISE

Copyright (C) Arizona Board of Regents on behalf of the Planetary Image Research Laboratory, Lunar and Planetary Laboratory at the University of Arizona