221 lines
5.3 KiB
C++
221 lines
5.3 KiB
C++
// Boost.Geometry (aka GGL, Generic Geometry Library)
|
|
|
|
// Copyright (c) 2007-2012 Barend Gehrels, Amsterdam, the Netherlands.
|
|
// Copyright (c) 2008-2012 Bruno Lalande, Paris, France.
|
|
// Copyright (c) 2009-2012 Mateusz Loskot, London, UK.
|
|
|
|
// Parts of Boost.Geometry are redesigned from Geodan's Geographic Library
|
|
// (geolib/GGL), copyright (c) 1995-2010 Geodan, Amsterdam, the Netherlands.
|
|
|
|
// Use, modification and distribution is subject to the Boost Software License,
|
|
// Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at
|
|
// http://www.boost.org/LICENSE_1_0.txt)
|
|
|
|
#ifndef BOOST_GEOMETRY_CORE_CS_HPP
|
|
#define BOOST_GEOMETRY_CORE_CS_HPP
|
|
|
|
#include <cstddef>
|
|
|
|
#include <boost/type_traits.hpp>
|
|
|
|
#include <boost/geometry/core/coordinate_system.hpp>
|
|
#include <boost/geometry/core/tags.hpp>
|
|
|
|
|
|
namespace boost { namespace geometry
|
|
{
|
|
|
|
/*!
|
|
\brief Unit of plane angle: Degrees
|
|
\details Tag defining the unit of plane angle for spherical coordinate systems.
|
|
This tag specifies that coordinates are defined in degrees (-180 .. 180).
|
|
It has to be specified for some coordinate systems.
|
|
\qbk{[include reference/core/degree_radian.qbk]}
|
|
*/
|
|
struct degree {};
|
|
|
|
|
|
/*!
|
|
\brief Unit of plane angle: Radians
|
|
\details Tag defining the unit of plane angle for spherical coordinate systems.
|
|
This tag specifies that coordinates are defined in radians (-PI .. PI).
|
|
It has to be specified for some coordinate systems.
|
|
\qbk{[include reference/core/degree_radian.qbk]}
|
|
*/
|
|
struct radian {};
|
|
|
|
|
|
namespace cs
|
|
{
|
|
|
|
/*!
|
|
\brief Cartesian coordinate system
|
|
\details Defines the Cartesian or rectangular coordinate system
|
|
where points are defined in 2 or 3 (or more)
|
|
dimensions and usually (but not always) known as x,y,z
|
|
\see http://en.wikipedia.org/wiki/Cartesian_coordinate_system
|
|
\ingroup cs
|
|
*/
|
|
struct cartesian {};
|
|
|
|
|
|
|
|
|
|
/*!
|
|
\brief Geographic coordinate system, in degree or in radian
|
|
\details Defines the geographic coordinate system where points
|
|
are defined in two angles and usually
|
|
known as lat,long or lo,la or phi,lambda
|
|
\see http://en.wikipedia.org/wiki/Geographic_coordinate_system
|
|
\ingroup cs
|
|
\note might be moved to extensions/gis/geographic
|
|
*/
|
|
template<typename DegreeOrRadian>
|
|
struct geographic
|
|
{
|
|
typedef DegreeOrRadian units;
|
|
};
|
|
|
|
|
|
|
|
/*!
|
|
\brief Spherical (polar) coordinate system, in degree or in radian
|
|
\details Defines the spherical coordinate system where points are
|
|
defined in two angles
|
|
and an optional radius usually known as r, theta, phi
|
|
\par Coordinates:
|
|
- coordinate 0:
|
|
0 <= phi < 2pi is the angle between the positive x-axis and the
|
|
line from the origin to the P projected onto the xy-plane.
|
|
- coordinate 1:
|
|
0 <= theta <= pi is the angle between the positive z-axis and the
|
|
line formed between the origin and P.
|
|
- coordinate 2 (if specified):
|
|
r >= 0 is the distance from the origin to a given point P.
|
|
|
|
\see http://en.wikipedia.org/wiki/Spherical_coordinates
|
|
\ingroup cs
|
|
*/
|
|
template<typename DegreeOrRadian>
|
|
struct spherical
|
|
{
|
|
typedef DegreeOrRadian units;
|
|
};
|
|
|
|
|
|
/*!
|
|
\brief Spherical equatorial coordinate system, in degree or in radian
|
|
\details This one resembles the geographic coordinate system, and has latitude
|
|
up from zero at the equator, to 90 at the pole
|
|
(opposite to the spherical(polar) coordinate system).
|
|
Used in astronomy and in GIS (but there is also the geographic)
|
|
|
|
\see http://en.wikipedia.org/wiki/Spherical_coordinates
|
|
\ingroup cs
|
|
*/
|
|
template<typename DegreeOrRadian>
|
|
struct spherical_equatorial
|
|
{
|
|
typedef DegreeOrRadian units;
|
|
};
|
|
|
|
|
|
|
|
/*!
|
|
\brief Polar coordinate system
|
|
\details Defines the polar coordinate system "in which each point
|
|
on a plane is determined by an angle and a distance"
|
|
\see http://en.wikipedia.org/wiki/Polar_coordinates
|
|
\ingroup cs
|
|
*/
|
|
template<typename DegreeOrRadian>
|
|
struct polar
|
|
{
|
|
typedef DegreeOrRadian units;
|
|
};
|
|
|
|
|
|
} // namespace cs
|
|
|
|
|
|
namespace traits
|
|
{
|
|
|
|
/*!
|
|
\brief Traits class defining coordinate system tag, bound to coordinate system
|
|
\ingroup traits
|
|
\tparam CoordinateSystem coordinate system
|
|
*/
|
|
template <typename CoordinateSystem>
|
|
struct cs_tag
|
|
{
|
|
};
|
|
|
|
|
|
#ifndef DOXYGEN_NO_TRAITS_SPECIALIZATIONS
|
|
|
|
template<typename DegreeOrRadian>
|
|
struct cs_tag<cs::geographic<DegreeOrRadian> >
|
|
{
|
|
typedef geographic_tag type;
|
|
};
|
|
|
|
template<typename DegreeOrRadian>
|
|
struct cs_tag<cs::spherical<DegreeOrRadian> >
|
|
{
|
|
typedef spherical_polar_tag type;
|
|
};
|
|
|
|
template<typename DegreeOrRadian>
|
|
struct cs_tag<cs::spherical_equatorial<DegreeOrRadian> >
|
|
{
|
|
typedef spherical_equatorial_tag type;
|
|
};
|
|
|
|
|
|
template<>
|
|
struct cs_tag<cs::cartesian>
|
|
{
|
|
typedef cartesian_tag type;
|
|
};
|
|
|
|
|
|
#endif // DOXYGEN_NO_TRAITS_SPECIALIZATIONS
|
|
} // namespace traits
|
|
|
|
/*!
|
|
\brief Meta-function returning coordinate system tag (cs family) of any geometry
|
|
\ingroup core
|
|
*/
|
|
template <typename G>
|
|
struct cs_tag
|
|
{
|
|
typedef typename traits::cs_tag
|
|
<
|
|
typename geometry::coordinate_system<G>::type
|
|
>::type type;
|
|
};
|
|
|
|
|
|
/*!
|
|
\brief Meta-function to verify if a coordinate system is radian
|
|
\ingroup core
|
|
*/
|
|
template <typename CoordinateSystem>
|
|
struct is_radian : boost::true_type {};
|
|
|
|
|
|
#ifndef DOXYGEN_NO_SPECIALIZATIONS
|
|
|
|
// Specialization for any degree coordinate systems
|
|
template <template<typename> class CoordinateSystem>
|
|
struct is_radian< CoordinateSystem<degree> > : boost::false_type
|
|
{
|
|
};
|
|
|
|
#endif // DOXYGEN_NO_SPECIALIZATIONS
|
|
|
|
}} // namespace boost::geometry
|
|
|
|
#endif // BOOST_GEOMETRY_CORE_CS_HPP
|