|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.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 |