cds.healpix.common.sphgeom

Class CooXYZ

java.lang.Object

cds.healpix.common.sphgeom.CooXYZ

Direct Known Subclasses:

Cone

public class CooXYZ
extends java.lang.Object

Defines a coordinates on the unit-sphere, internally both Euclidean and Spherical coordinates are storef.

Author:

F.-X. Pineau

Constructor Summary

Constructors

Constructor and Description
CooXYZ(double lonRad, double latRad)
CooXYZ(double x, double y, double z)

Method Summary

Modifier and Type	Method and Description
static CooXYZ	arcCenter(CooXYZ a, CooXYZ b) Returns the center of the arc define by the smallest distance (on the unit sphere) between the two given points.
static CooXYZ	arcCenter(CooXYZ a, CooXYZ b, double r) Faster version of arcCenter(CooXYZ, CooXYZ) when we already know the distance between the two given points.
static CooXYZ	circumCenter(CooXYZ a, CooXYZ b, CooXYZ c) Returns the center on the unit sphere of the circumcircle of a spherical triangle of given vertices a, b and c.
static CooXYZ	circumCenter(CooXYZ a, CooXYZ b, CooXYZ c, double r) Returns the center on the unit sphere of the circumcircle of radius r of a spherical triangle of given vertices a, b and c.
static double	circumRadiusSphe(CooXYZ a, CooXYZ b, CooXYZ c) Returns the angular radius (in radians) of the circumcircle of a spherical triangle of given vertices a, b and c.
static double	circumRadiusSphe(double a, double b, double c) Returns the angular radius (in radians) of the circumcircle of a spherical triangle of given side lengths a, b and c.
static cds.healpix.common.sphgeom.Vect3D	crossProd(CooXYZ v1, CooXYZ v2) Returns the cross-product of the two given vectors.
static double	euclDist(CooXYZ c1, CooXYZ c2) Returns the Euclidean distance separating the two given points.
static double	havDist(CooXYZ c1, CooXYZ c2) Returns the spherival distance (using the Haversine formula) separating the two given points.
double	lat() Getter
double	lon() Getter
static Cone	mec(CooXYZ... p) Returns the Minimum Enclosing Cone, i.e. the cone containig all the given points and having the smallest possible radius.
static Cone	mec(CooXYZ a, CooXYZ b) Returns the minimum enclosing cone, i.e. the cone containig the two given points and having the smallest possible radius.
static Cone	mec(CooXYZ a, CooXYZ b, CooXYZ c) Returns the Minimum Enclosing Cone, i.e. the cone containig the three given points and having the smallest possible radius.
static CooXYZ	normalizedSum(CooXYZ... vects) Returns the sum of the given vector, normalized so that the resulting vector is on the unit sphere.
double	scalarProd(CooXYZ v) Computes the scalar product of this point with given vectors.
double	scalarProd(cds.healpix.common.sphgeom.Vect3D v) Computes the scalar product of this point with given vectors.
static double	spheDist(CooXYZ c1, CooXYZ c2) Retruns the spherical distance separating the two given points.
static CooXYZ	toEquaCooXYZ(CooXYZ pos)
java.lang.String	toString()
double	x() Getter
double	y() Getter
double	z() Getter

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

CooXYZ

public CooXYZ(double lonRad,
              double latRad)

CooXYZ

public CooXYZ(double x,
              double y,
              double z)

Method Detail

toEquaCooXYZ

public static CooXYZ toEquaCooXYZ(CooXYZ pos)

lon

public final double lon()

Getter

Returns:

the longitude, in radians

lat

public final double lat()

Getter

Returns:

the latitude, in radians

x

public final double x()

Getter

Returns:

the x cartesian coordinate

y

public final double y()

Getter

Returns:

the y cartesian coordinate

z

public final double z()

Getter

Returns:

the z cartesian coordinate

normalizedSum

public static CooXYZ normalizedSum(CooXYZ... vects)

Returns the sum of the given vector, normalized so that the resulting vector is on the unit sphere.

Parameters:

vects - vector we are looking for the normalized sum.

Returns:

the sum of the given vector, normalized so that the resulting vector is on the unit sphere.

crossProd

public static cds.healpix.common.sphgeom.Vect3D crossProd(CooXYZ v1,
                                                          CooXYZ v2)

Returns the cross-product of the two given vectors.

Parameters:

v1 - first vector

v2 - second vector

Returns:

the cross-product of the two given vectors.

scalarProd

public double scalarProd(cds.healpix.common.sphgeom.Vect3D v)

Computes the scalar product of this point with given vectors.

Parameters:

v - the second vector used in the scalar product.

Returns:

the scalar product of this point with given vectors.

scalarProd

public double scalarProd(CooXYZ v)

Computes the scalar product of this point with given vectors.

Parameters:

v - the second vector used in the scalar product.

Returns:

the scalar product of this point with given vectors.

havDist

public static final double havDist(CooXYZ c1,
                                   CooXYZ c2)

Returns the spherival distance (using the Haversine formula) separating the two given points.

Parameters:

c1 - first point

c2 - second point

Returns:

the spherival distance (using the Haversine formula) separating the two given points.

spheDist

public static final double spheDist(CooXYZ c1,
                                    CooXYZ c2)

Retruns the spherical distance separating the two given points.

Parameters:

c1 - first point

c2 - second point

Returns:

the spherical distance separating the two given points.

euclDist

public static final double euclDist(CooXYZ c1,
                                    CooXYZ c2)

Returns the Euclidean distance separating the two given points.

Parameters:

c1 - first point

c2 - second point

Returns:

the Euclidean distance separating the two given points.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

mec

public static Cone mec(CooXYZ a,
                       CooXYZ b)

Returns the minimum enclosing cone, i.e. the cone containig the two given points and having the smallest possible radius. In this trivial case, the diameter of the cone is the arc (ab).

Parameters:

a - first point

b - secobd point

Returns:

the minimum enclosing cone, i.e. the cone containig the two given points and having the smallest possible radius. In this trivial case, the diameter of the cone is the arc (ab).

mec

public static Cone mec(CooXYZ a,
                       CooXYZ b,
                       CooXYZ c)

Returns the Minimum Enclosing Cone, i.e. the cone containig the three given points and having the smallest possible radius.

Parameters:

a - first point

b - secobd point

c - third point

Returns:

the Minimum Enclosing Cone, i.e. the cone containig the three given points and having the smallest possible radius.

mec

public static Cone mec(CooXYZ... p)

Returns the Minimum Enclosing Cone, i.e. the cone containig all the given points and having the smallest possible radius.

Parameters:

p - list of the points we look for the minimum enclising cone

Returns:

the Minimum Enclosing Cone, i.e. the cone containig all the given points and having the smallest possible radius.

circumRadiusSphe

public static final double circumRadiusSphe(double a,
                                            double b,
                                            double c)

Returns the angular radius (in radians) of the circumcircle of a spherical triangle of given side lengths a, b and c.

Parameters:

a - first size length (in radians)

b - second size length (in radians)

c - third size length (in radians)

Returns:

in the angular radius (in radians) of the circumcircle of a spherical triangle of given side lengths a, b and c.

circumRadiusSphe

public static final double circumRadiusSphe(CooXYZ a,
                                            CooXYZ b,
                                            CooXYZ c)

Returns the angular radius (in radians) of the circumcircle of a spherical triangle of given vertices a, b and c.

Parameters:

a - first vertex

b - second vertex

c - third vertex

Returns:

the angular radius (in radians) of the circumcircle of a spherical triangle of given vertices a, b and c.

circumCenter

public static final CooXYZ circumCenter(CooXYZ a,
                                        CooXYZ b,
                                        CooXYZ c)

Returns the center on the unit sphere of the circumcircle of a spherical triangle of given vertices a, b and c.

Parameters:

a - first vertex

b - second vertex

c - third vertex

Returns:

the center on the unit sphere of the circumcircle of a spherical triangle of given vertices a, b and c.

circumCenter

public static final CooXYZ circumCenter(CooXYZ a,
                                        CooXYZ b,
                                        CooXYZ c,
                                        double r)

Returns the center on the unit sphere of the circumcircle of radius r of a spherical triangle of given vertices a, b and c.

Parameters:

a - first vertex

b - second vertex

c - third vertex

r - spherical radius of the circumcircle

Returns:

the center on the unit sphere of the circumcircle of radius r of a spherical triangle of given vertices a, b and c.

arcCenter

public static final CooXYZ arcCenter(CooXYZ a,
                                     CooXYZ b)

Returns the center of the arc define by the smallest distance (on the unit sphere) between the two given points.

Parameters:

a - first point

b - second point

Returns:

the center of the arc define by the smallest distance (on the unit sphere) between the two given points.

arcCenter

public static final CooXYZ arcCenter(CooXYZ a,
                                     CooXYZ b,
                                     double r)

Faster version of arcCenter(CooXYZ, CooXYZ) when we already know the distance between the two given points.

Parameters:

a - first point

b - second point

r - half the distance between a and b

Returns:

the center of the arc define by the smallest distance (on the unit sphere, = 2*r) between the two given points.