lsst::sphgeom::LonLat Class Reference

LonLat represents a spherical coordinate (longitude/latitude angle) pair. More...

#include <LonLat.h>

Public Member Functions
	LonLat ()
	This constructor creates the point with longitude and latitude angle equal to zero.
	LonLat (NormalizedAngle lon, Angle lat)
	This constructor creates the point with the given longitude and latitude angles.
	LonLat (Vector3d const &v)
	This constructor creates the point on the unit sphere corresponding to the direction of v.
bool	operator== (LonLat const &p) const
bool	operator!= (LonLat const &p) const
NormalizedAngle	getLon () const
Angle	getLat () const

Static Public Member Functions
static LonLat	fromDegrees (double lon, double lat)
static LonLat	fromRadians (double lon, double lat)
static Angle	latitudeOf (Vector3d const &v)
	latitudeOf returns the latitude of the point on the unit sphere corresponding to the direction of v.
static NormalizedAngle	longitudeOf (Vector3d const &v)
	longitudeOf returns the longitude of the point on the unit sphere corresponding to the direction of v.

Detailed Description

LonLat represents a spherical coordinate (longitude/latitude angle) pair.

This class supports conversion from a Vector3d. All methods that accept a Vector3d parameter shall convert from vector to longitude/latitude coordinates according to the following conventions:

• (1, 0, 0) → (0°, 0°)
• (0, 1, 0) → (90°, 0°)
• (0, 0, 1) → (0°, +90°)

Definition at line 55 of file LonLat.h.

Constructor & Destructor Documentation

LonLat() [1/3]

lsst::sphgeom::LonLat::LonLat ( )

inline

This constructor creates the point with longitude and latitude angle equal to zero.

Definition at line 77 of file LonLat.h.

{}

LonLat() [2/3]

lsst::sphgeom::LonLat::LonLat	(	NormalizedAngle	lon,
		Angle	lat )

This constructor creates the point with the given longitude and latitude angles.

Definition at line 69 of file LonLat.cc.

                                             : _lon(lon), _lat(lat) {
    if (std::fabs(_lat.asRadians()) > 0.5 * PI) {
        throw std::invalid_argument("invalid latitude angle");
    }
    _enforceInvariants();
}

LonLat() [3/3]

lsst::sphgeom::LonLat::LonLat

(

Vector3d const &

v

)

This constructor creates the point on the unit sphere corresponding to the direction of v.

Definition at line 76 of file LonLat.cc.

                                 : _lon(longitudeOf(v)), _lat(latitudeOf(v)) {
    _enforceInvariants();
}

Member Function Documentation

fromDegrees()

static LonLat lsst::sphgeom::LonLat::fromDegrees ( double lon, double lat )

inlinestatic

Definition at line 57 of file LonLat.h.

                                                      {
        return LonLat(NormalizedAngle::fromDegrees(lon),
                      Angle::fromDegrees(lat));
    }

fromRadians()

static LonLat lsst::sphgeom::LonLat::fromRadians ( double lon, double lat )

inlinestatic

Definition at line 62 of file LonLat.h.

                                                      {
        return LonLat(NormalizedAngle::fromRadians(lon),
                      Angle::fromRadians(lat));
    }

getLat()

Angle lsst::sphgeom::LonLat::getLat ( ) const

inline

Definition at line 97 of file LonLat.h.

{ return _lat; }

getLon()

NormalizedAngle lsst::sphgeom::LonLat::getLon ( ) const

inline

Definition at line 95 of file LonLat.h.

{ return _lon; }

latitudeOf()

Angle lsst::sphgeom::LonLat::latitudeOf ( Vector3d const & v )

static

latitudeOf returns the latitude of the point on the unit sphere corresponding to the direction of v.

Definition at line 44 of file LonLat.cc.

                                           {
    double d2 = v(0) * v(0) + v(1) * v(1);
    double lat = 0.0;
    if (v(2) != 0.0) {
        lat = std::atan2(v(2), sqrt(d2));
        if (std::fabs(lat) > 0.5 * PI) {
            lat = ::copysign(0.5 * PI, lat);
        }
    }
    return Angle(lat);
}

longitudeOf()

NormalizedAngle lsst::sphgeom::LonLat::longitudeOf ( Vector3d const & v )

static

longitudeOf returns the longitude of the point on the unit sphere corresponding to the direction of v.

Definition at line 56 of file LonLat.cc.

                                                      {
    double d2 = v(0) * v(0) + v(1) * v(1);
    double lon = 0.0;
    if (d2 != 0.0) {
        lon = std::atan2(v(1), v(0));
        if (lon < 0.0) {
            lon += 2*PI;
        }
    }
    return NormalizedAngle(lon);
}

operator!=()

bool lsst::sphgeom::LonLat::operator!= ( LonLat const & p ) const

inline

Definition at line 91 of file LonLat.h.

                                            {
        return _lon != p._lon || _lat != p._lat;
    }

operator==()

bool lsst::sphgeom::LonLat::operator== ( LonLat const & p ) const

inline

Definition at line 87 of file LonLat.h.

                                            {
        return _lon == p._lon && _lat == p._lat;
    }

---

The documentation for this class was generated from the following files:

• /j/snowflake/release/lsstsw/stack/lsst-scipipe-12.1.0/Linux/sphgeom/g00d0e8bbd7+edbf708997/include/lsst/sphgeom/LonLat.h
• /j/snowflake/release/lsstsw/stack/lsst-scipipe-12.1.0/Linux/sphgeom/g00d0e8bbd7+edbf708997/src/LonLat.cc