LSST Applications g0b6bd0c080+a72a5dd7e6,g1182afd7b4+2a019aa3bb,g17e5ecfddb+2b8207f7de,g1d67935e3f+06cf436103,g38293774b4+ac198e9f13,g396055baef+6a2097e274,g3b44f30a73+6611e0205b,g480783c3b1+98f8679e14,g48ccf36440+89c08d0516,g4b93dc025c+98f8679e14,g5c4744a4d9+a302e8c7f0,g613e996a0d+e1c447f2e0,g6c8d09e9e7+25247a063c,g7271f0639c+98f8679e14,g7a9cd813b8+124095ede6,g9d27549199+a302e8c7f0,ga1cf026fa3+ac198e9f13,ga32aa97882+7403ac30ac,ga786bb30fb+7a139211af,gaa63f70f4e+9994eb9896,gabf319e997+ade567573c,gba47b54d5d+94dc90c3ea,gbec6a3398f+06cf436103,gc6308e37c7+07dd123edb,gc655b1545f+ade567573c,gcc9029db3c+ab229f5caf,gd01420fc67+06cf436103,gd877ba84e5+06cf436103,gdb4cecd868+6f279b5b48,ge2d134c3d5+cc4dbb2e3f,ge448b5faa6+86d1ceac1d,gecc7e12556+98f8679e14,gf3ee170dca+25247a063c,gf4ac96e456+ade567573c,gf9f5ea5b4d+ac198e9f13,gff490e6085+8c2580be5c,w.2022.27
LSST Data Management Base Package
Region.h
Go to the documentation of this file.
1/*
2 * LSST Data Management System
3 * Copyright 2014-2015 AURA/LSST.
4 *
5 * This product includes software developed by the
6 * LSST Project (http://www.lsst.org/).
7 *
8 * This program is free software: you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation, either version 3 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the LSST License Statement and
19 * the GNU General Public License along with this program. If not,
20 * see <https://www.lsstcorp.org/LegalNotices/>.
21 */
22
23#ifndef LSST_SPHGEOM_REGION_H_
24#define LSST_SPHGEOM_REGION_H_
25
28
29#include <memory>
30#include <vector>
31
32#include "Relationship.h"
33
34
35namespace lsst {
36namespace sphgeom {
37
38// Forward declarations
39class Box;
40class Box3d;
41class Circle;
42class ConvexPolygon;
43class Ellipse;
44class UnitVector3d;
45
79class Region {
80public:
81 virtual ~Region() {}
82
84 virtual std::unique_ptr<Region> clone() const = 0;
85
87 virtual Box getBoundingBox() const = 0;
88
90 virtual Box3d getBoundingBox3d() const = 0;
91
93 virtual Circle getBoundingCircle() const = 0;
94
96 virtual bool contains(UnitVector3d const &) const = 0;
97
100 bool contains(double x, double y, double z) const;
101
104 bool contains(double lon, double lat) const;
105
124 virtual Relationship relate(Region const &) const = 0;
125 virtual Relationship relate(Box const &) const = 0;
126 virtual Relationship relate(Circle const &) const = 0;
127 virtual Relationship relate(ConvexPolygon const &) const = 0;
128 virtual Relationship relate(Ellipse const &) const = 0;
130
133 virtual std::vector<uint8_t> encode() const = 0;
134
138 return decode(s.data(), s.size());
139 }
140
141 static std::unique_ptr<Region> decode(uint8_t const * buffer, size_t n);
143};
144
145}} // namespace lsst::sphgeom
146
147#endif // LSST_SPHGEOM_REGION_H_
double x
double z
Definition: Match.cc:44
int y
Definition: SpanSet.cc:48
Box3d represents a box in ℝ³.
Definition: Box3d.h:42
Box represents a rectangle in spherical coordinate space that contains its boundary.
Definition: Box.h:54
Circle is a circular region on the unit sphere that contains its boundary.
Definition: Circle.h:46
ConvexPolygon is a closed convex polygon on the unit sphere.
Definition: ConvexPolygon.h:57
Ellipse is an elliptical region on the sphere.
Definition: Ellipse.h:170
Region is a minimal interface for 2-dimensional regions on the unit sphere.
Definition: Region.h:79
virtual Relationship relate(Circle const &) const =0
virtual Relationship relate(Ellipse const &) const =0
virtual Circle getBoundingCircle() const =0
getBoundingCircle returns a bounding-circle for this region.
virtual Relationship relate(Region const &) const =0
virtual Relationship relate(Box const &) const =0
virtual ~Region()
Definition: Region.h:81
static std::unique_ptr< Region > decode(std::vector< uint8_t > const &s)
Definition: Region.h:137
virtual Box getBoundingBox() const =0
getBoundingBox returns a bounding-box for this region.
virtual bool contains(UnitVector3d const &) const =0
contains tests whether the given unit vector is inside this region.
virtual std::unique_ptr< Region > clone() const =0
clone returns a deep copy of this region.
virtual std::vector< uint8_t > encode() const =0
encode serializes this region into an opaque byte string.
virtual Box3d getBoundingBox3d() const =0
getBoundingBox3d returns a 3-dimensional bounding-box for this region.
virtual Relationship relate(ConvexPolygon const &) const =0
UnitVector3d is a unit vector in ℝ³ with components stored in double precision.
Definition: UnitVector3d.h:55
T data(T... args)
A base class for image defects.
This file provides a type alias for describing set relationships.
T size(T... args)