|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectcom.bbn.openmap.proj.GreatCircle
public class GreatCircle
Methods for calculating great circle and other distances on the sphere and ellipsoid. Note that as of OpenMap 4.7, all the method calls with a '_' in them have been deprecated, replaced by method names that conform to Java conventions.
Spherical equations taken from John Synder's Map Projections --A Working
Manual , pp29-31.
Latitude/longitude arguments must be in valid radians: -PI<=lambda<PI,
-PI/2<=phi<=PI/2
| Method Summary | |
|---|---|
static double[] |
earthCircle(double phi1,
double lambda0,
double c,
double s,
double e,
int n)
Calculate partial earth circle on the sphere with double precision. |
static double[] |
earthCircle(double phi1,
double lambda0,
double c,
double s,
double e,
int n,
double[] ret_val)
Calculate earth circle in the sphere in double precision. |
static double[] |
earthCircle(double phi1,
double lambda0,
double c,
int n)
Calculate earth circle on the sphere with double precision. |
static double[] |
earthCircle(double phi1,
double lambda0,
double c,
int n,
double[] ret_val)
Calculate earth circle in the sphere with double precision. |
static float[] |
earthCircle(float phi1,
float lambda0,
float c,
float s,
float e,
int n)
Calculate partial earth circle on the sphere. |
static float[] |
earthCircle(float phi1,
float lambda0,
float c,
float s,
float e,
int n,
float[] ret_val)
Calculate earth circle in the sphere. |
static float[] |
earthCircle(float phi1,
float lambda0,
float c,
int n)
Calculate earth circle on the sphere. |
static float[] |
earthCircle(float phi1,
float lambda0,
float c,
int n,
float[] ret_val)
Calculate earth circle in the sphere. |
static double[] |
greatCircle(double phi1,
double lambda0,
double phi,
double lambda,
int n,
boolean include_last)
Calculate great circle between two points on the sphere with double precision. |
static float[] |
greatCircle(float phi1,
float lambda0,
float phi,
float lambda,
int n,
boolean include_last)
Calculate great circle between two points on the sphere. |
static LatLonPoint |
pointAtDistanceBetweenPoints(double phi1,
double lambda0,
double phi,
double lambda,
double distance,
int n)
Return a point that is approximately a certain distance along the great circle line between two points. |
static double |
sphericalAzimuth(double phi1,
double lambda0,
double phi,
double lambda)
Calculate spherical azimuth between two points with double precision. |
static LatLonPoint |
sphericalBetween(double phi1,
double lambda0,
double c,
double Az)
Calculate point at azimuth and distance from another point, with double precision. |
static double[] |
sphericalBetween(double phi1,
double lambda0,
double c,
double Az,
int n)
Calculate point between two points with double precision. |
static float[] |
sphericalBetween(float phi1,
float lambda0,
float c,
float Az,
int n)
Calculate point between two points. |
static double |
sphericalDistance(double phi1,
double lambda0,
double phi,
double lambda)
Calculate spherical arc distance between two points with double precision. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Method Detail |
|---|
public static final double sphericalDistance(double phi1,
double lambda0,
double phi,
double lambda)
Computes arc distance `c' on the sphere. equation (5-3a). (0 <= c <= PI)
phi1 - latitude in radians of start pointlambda0 - longitude in radians of start pointphi - latitude in radians of end pointlambda - longitude in radians of end point
public static final double sphericalAzimuth(double phi1,
double lambda0,
double phi,
double lambda)
Computes the azimuth `Az' east of north from phi1, lambda0 bearing toward phi and lambda. (5-4b). (-PI <= Az <= PI).
phi1 - latitude in radians of start pointlambda0 - longitude in radians of start pointphi - latitude in radians of end pointlambda - longitude in radians of end point
public static final LatLonPoint sphericalBetween(double phi1,
double lambda0,
double c,
double Az)
Returns a LatLonPoint.Double at arc distance `c' in direction `Az' from start point.
phi1 - latitude in radians of start pointlambda0 - longitude in radians of start pointc - arc radius in radians (0 < c <= PI)Az - azimuth (direction) east of north (-PI <= Az < PI)
public static final float[] sphericalBetween(float phi1,
float lambda0,
float c,
float Az,
int n)
Same as spherical_between() above except it calculates n equal segments along the length of c.
phi1 - latitude in radians of start pointlambda0 - longitude in radians of start pointc - arc radius in radians (0 < c <= PI)Az - azimuth (direction) east of north (-PI <= Az < PI)n - number of points along great circle edge to calculate
public static final double[] sphericalBetween(double phi1,
double lambda0,
double c,
double Az,
int n)
Same as spherical_between() above except it calculates n equal segments along the length of c.
phi1 - latitude in radians of start pointlambda0 - longitude in radians of start pointc - arc radius in radians (0 < c <= PI)Az - azimuth (direction) east of north (-PI <= Az < PI)n - number of points along great circle edge to calculate
public static final float[] greatCircle(float phi1,
float lambda0,
float phi,
float lambda,
int n,
boolean include_last)
Folds all computation (distance, azimuth, points between) into one function for optimization. returns n or n+1 pairs of lat,lon on great circle between lat-lon pairs.
phi1 - latitude in radians of start pointlambda0 - longitude in radians of start pointphi - latitude in radians of end pointlambda - longitude in radians of end pointn - number of segmentsinclude_last - return n or n+1 segments
public static final double[] greatCircle(double phi1,
double lambda0,
double phi,
double lambda,
int n,
boolean include_last)
Folds all computation (distance, azimuth, points between) into one function for optimization. returns n or n+1 pairs of lat,lon on great circle between lat-lon pairs.
phi1 - latitude in radians of start pointlambda0 - longitude in radians of start pointphi - latitude in radians of end pointlambda - longitude in radians of end pointn - number of segments, should be at least 1include_last - return n or n+1 segments
public static LatLonPoint pointAtDistanceBetweenPoints(double phi1,
double lambda0,
double phi,
double lambda,
double distance,
int n)
phi1 - latitude of point 1 in radians.lambda0 - longitude of point 1 in radians.phi - latitude of point 2 in radians.lambda - longitude of point 2 in radians.distance - in radians.n - number of segments to divide path into. The more segments, the
more accurate. If n <= 0, the OpenMap default of 512 is used.
public static final float[] earthCircle(float phi1,
float lambda0,
float c,
float s,
float e,
int n)
Returns n float lat,lon pairs at arc distance c from point at phi1,lambda0.
phi1 - latitude in radians of center pointlambda0 - longitude in radians of center pointc - arc radius in radians (0 < c < PI)s - starting angle in radians. North up is zero.e - angular extent in radians, clockwise right from starting angle.n - number of points along circle edge to calculate
public static final float[] earthCircle(float phi1,
float lambda0,
float c,
int n)
Returns n float lat,lon pairs at arc distance c from point at phi1,lambda0.
phi1 - latitude in radians of center pointlambda0 - longitude in radians of center pointc - arc radius in radians (0 < c < PI)n - number of points along circle edge to calculate
public static final float[] earthCircle(float phi1,
float lambda0,
float c,
int n,
float[] ret_val)
Returns n float lat,lon pairs at arc distance c from point at phi1,lambda0.
phi1 - latitude in radians of center pointlambda0 - longitude in radians of center pointc - arc radius in radians (0 < c < PI)n - number of points along circle edge to calculateret_val - float[] ret_val array of n*2 number of points along circle
edge to calculate
public static final float[] earthCircle(float phi1,
float lambda0,
float c,
float s,
float e,
int n,
float[] ret_val)
Returns n float lat,lon pairs at arc distance c from point at phi1,lambda0.
phi1 - latitude in radians of center point.lambda0 - longitude in radians of center point.c - arc radius in radians (0 < c < PI).s - starting angle in radians. North up is zero.e - angular extent in radians, clockwise right from starting angle.n - number of points along circle edge to calculate.ret_val - float[] ret_val array of n*2 number of points along circle
edge to calculate.
public static final double[] earthCircle(double phi1,
double lambda0,
double c,
double s,
double e,
int n)
Returns n double lat,lon pairs at arc distance c from point at phi1,lambda0.
phi1 - latitude in radians of center pointlambda0 - longitude in radians of center pointc - arc radius in radians (0 < c < PI)s - starting angle in radians. North up is zero.e - angular extent in radians, clockwise right from starting angle.n - number of points along circle edge to calculate
public static final double[] earthCircle(double phi1,
double lambda0,
double c,
int n)
Returns n double lat,lon pairs at arc distance c from point at phi1,lambda0.
phi1 - latitude in radians of center pointlambda0 - longitude in radians of center pointc - arc radius in radians (0 < c < PI)n - number of points along circle edge to calculate
public static final double[] earthCircle(double phi1,
double lambda0,
double c,
int n,
double[] ret_val)
Returns n float lat,lon pairs at arc distance c from point at phi1,lambda0.
phi1 - latitude in radians of center pointlambda0 - longitude in radians of center pointc - arc radius in radians (0 < c < PI)n - number of points along circle edge to calculateret_val - double[] ret_val array of n*2 number of points along
circle edge to calculate
public static final double[] earthCircle(double phi1,
double lambda0,
double c,
double s,
double e,
int n,
double[] ret_val)
Returns n double lat,lon pairs at arc distance c from point at phi1,lambda0.
phi1 - latitude in radians of center point.lambda0 - longitude in radians of center point.c - arc radius in radians (0 < c < PI).s - starting angle in radians. North up is zero.e - angular extent in radians, clockwise right from starting angle.n - number of points along circle edge to calculate.ret_val - double[] ret_val array of n*2 number of points along
circle edge to calculate.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||