nsidc.spheres
Class Scene

java.lang.Object
  nsidc.spheres.Sphere
      nsidc.spheres.Orbit
          nsidc.spheres.Scene

public class Scene

extends Orbit

Field Summary

double	end_clat Circular Latitude (0-360) of nadir at the end of the scene.
double	nodal_crossing Nodal Crossing of the orbit that this scene is part of.
double	start_clat Circular Latitude (0-360) of nadir at the start of the scene.

Fields inherited from class nsidc.spheres.Orbit

declination, eq_swath_width, eq_swath_width_deg, eq_swath_width_rad, inflection_lat, inflection_max_lat, inflection_min_lat, maxCoverageLat, period, pole_to_pole, ROTATION_RATE, totalCoverageLat

Fields inherited from class nsidc.spheres.Sphere

radius, Re_km

Constructor Summary

Scene(double given_declination, double given_period, double given_eq_swath_width, double given_start, double given_end, double given_crossing)

Scene(float given_declination, float given_period, float given_eq_swath_width, float given_start, float given_end, float given_crossing)

Scene(Orbit given_orbit, float given_start, float given_end, float given_crossing)

Scene(Orbit given_orbit, java.lang.String given_start, java.lang.String given_end, java.lang.String given_crossing)
The constructors.

Method Summary

float	getNadirLongitude(float lat, boolean ascending) Get the longitude of nadir at the given latitude
boolean	overlaps(LatLonBoundingBox box) Determine if this scene overlaps a lat/lon bounding box.
boolean	overlaps(Scene other) Determine if this scene overlaps another.
boolean	overlaps(SphericalPolygon s_poly) Determine if this scene overlaps a spherical polygon.
SphericalPolygon	toSphericalPolygon(int side_points) Convert the scene to a spherical polygon.
java.lang.String	toString()

Methods inherited from class nsidc.spheres.Orbit

circularLat, circularLat, directedLonDistance, getAreaCrossingRange, getAreaCrossingRange, getAreaCrossingRange, getAreaCrossingRange, getAreaCrossingRange, getCrossSwathEdges, getLonSwathEdges, getNodalCrossing, getNodalCrossing, getPointCrossingRange, getPointCrossingRange, lonDistance, shortestLonDistance, standardLat, systemLog, systemLog

Methods inherited from class nsidc.spheres.Sphere

degrees, degrees, getRadius, normalize, normalize, radians, radians, scalarTripleProductTest, setRadius

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

start_clat

public double start_clat

Circular Latitude (0-360) of nadir at the start of the scene.

end_clat

public double end_clat

Circular Latitude (0-360) of nadir at the end of the scene.

nodal_crossing

public double nodal_crossing

Nodal Crossing of the orbit that this scene is part of.

Constructor Detail

Scene

public Scene(Orbit given_orbit,
             java.lang.String given_start,
             java.lang.String given_end,
             java.lang.String given_crossing)

The constructors.

Scene

public Scene(Orbit given_orbit,
             float given_start,
             float given_end,
             float given_crossing)

Scene

public Scene(float given_declination,
             float given_period,
             float given_eq_swath_width,
             float given_start,
             float given_end,
             float given_crossing)

Scene

public Scene(double given_declination,
             double given_period,
             double given_eq_swath_width,
             double given_start,
             double given_end,
             double given_crossing)

Method Detail

getNadirLongitude

public float getNadirLongitude(float lat,
                               boolean ascending)

Get the longitude of nadir at the given latitude

Parameters:

lat - Latitude of the given point in degrees.

ascending - If true find edges for the orbit with nadir passing through the given point on the ascending pass.
Else find the edges for the orbit with nadir passing through the given point on the descending pass.

toSphericalPolygon

public SphericalPolygon toSphericalPolygon(int side_points)

Convert the scene to a spherical polygon.

See Also:

SphericalPolygon

overlaps

public boolean overlaps(Scene other)

Determine if this scene overlaps another. After determining if it's even possible, and we don't have the trivial case where one area is entirely inside the other, this method checks for arc instersections between the sides of the two areas. If any arcs intersect the areas overlap.

Returns:

true if the areas overlap.
false if the areas do not overlap.

See Also:

GreatCircleArc, SmallCircleArc

overlaps

public boolean overlaps(SphericalPolygon s_poly)

Determine if this scene overlaps a spherical polygon. After determining if it's even possible, and we don't have the trivial case where one area is entirely inside the other, this method checks for arc intersections between the sides of the two areas. If any arcs intersect the areas overlap.

Returns:

true if the areas overlap.
false if the areas do not overlap.

See Also:

SphericalPolygon, GreatCircleArc

overlaps

public boolean overlaps(LatLonBoundingBox box)

Determine if this scene overlaps a lat/lon bounding box. After determining if it's even possible, and we don't have the trivial case where one area is entirely inside the other, this method checks for arc intersections between the sides of the two areas. If any arcs intersect the areas overlap.

Returns:

true if the areas overlap.
false if the ares donot overlap.

See Also:

LatLonBoundingBox, GreatCircleArc

toString

public java.lang.String toString()

Overrides:

toString in class Orbit