Loading [MathJax]/extensions/tex2jax.js
LSST Applications g0fba68d861+05816baf74,g1ec0fe41b4+f536777771,g1fd858c14a+a9301854fb,g35bb328faa+fcb1d3bbc8,g4af146b050+a5c07d5b1d,g4d2262a081+6e5fcc2a4e,g53246c7159+fcb1d3bbc8,g56a49b3a55+9c12191793,g5a012ec0e7+3632fc3ff3,g60b5630c4e+ded28b650d,g67b6fd64d1+ed4b5058f4,g78460c75b0+2f9a1b4bcd,g786e29fd12+cf7ec2a62a,g8352419a5c+fcb1d3bbc8,g87b7deb4dc+7b42cf88bf,g8852436030+e5453db6e6,g89139ef638+ed4b5058f4,g8e3bb8577d+d38d73bdbd,g9125e01d80+fcb1d3bbc8,g94187f82dc+ded28b650d,g989de1cb63+ed4b5058f4,g9d31334357+ded28b650d,g9f33ca652e+50a8019d8c,gabe3b4be73+1e0a283bba,gabf8522325+fa80ff7197,gb1101e3267+d9fb1f8026,gb58c049af0+f03b321e39,gb665e3612d+2a0c9e9e84,gb89ab40317+ed4b5058f4,gcf25f946ba+e5453db6e6,gd6cbbdb0b4+bb83cc51f8,gdd1046aedd+ded28b650d,gde0f65d7ad+941d412827,ge278dab8ac+d65b3c2b70,ge410e46f29+ed4b5058f4,gf23fb2af72+b7cae620c0,gf5e32f922b+fcb1d3bbc8,gf67bdafdda+ed4b5058f4,w.2025.16
LSST Data Management Base Package
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Modules Pages
Pixelization.h
Go to the documentation of this file.
1/*
2 * This file is part of sphgeom.
3 *
4 * Developed for the LSST Data Management System.
5 * This product includes software developed by the LSST Project
6 * (http://www.lsst.org).
7 * See the COPYRIGHT file at the top-level directory of this distribution
8 * for details of code ownership.
9 *
10 * This software is dual licensed under the GNU General Public License and also
11 * under a 3-clause BSD license. Recipients may choose which of these licenses
12 * to use; please see the files gpl-3.0.txt and/or bsd_license.txt,
13 * respectively. If you choose the GPL option then the following text applies
14 * (but note that there is still no warranty even if you opt for BSD instead):
15 *
16 * This program is free software: you can redistribute it and/or modify
17 * it under the terms of the GNU General Public License as published by
18 * the Free Software Foundation, either version 3 of the License, or
19 * (at your option) any later version.
20 *
21 * This program is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 * GNU General Public License for more details.
25 *
26 * You should have received a copy of the GNU General Public License
27 * along with this program. If not, see <http://www.gnu.org/licenses/>.
28 */
29
30#ifndef LSST_SPHGEOM_PIXELIZATION_H_
31#define LSST_SPHGEOM_PIXELIZATION_H_
32
35
36#include <string>
37
38#include "RangeSet.h"
39
40
41namespace lsst {
42namespace sphgeom {
43
44class Region;
45class UnitVector3d;
46
47
85public:
86 virtual ~Pixelization() {}
87
89 virtual RangeSet universe() const = 0;
90
102
104 virtual std::uint64_t index(UnitVector3d const & v) const = 0;
105
107 virtual std::string toString(std::uint64_t i) const = 0;
108
138 RangeSet envelope(Region const & r, size_t maxRanges = 0) const {
139 return _envelope(r, maxRanges);
140 }
141
150 RangeSet interior(Region const & r, size_t maxRanges = 0) const {
151 return _interior(r, maxRanges);
152 }
153
154private:
155 virtual RangeSet _envelope(Region const & r, size_t maxRanges) const = 0;
156 virtual RangeSet _interior(Region const & r, size_t maxRanges) const = 0;
157};
158
159}} // namespace lsst::sphgeom
160
161#endif // LSST_SPHGEOM_PIXELIZATION_H_
This file provides a type for representing integer sets.
A Pixelization (or partitioning) of the sphere is a mapping between points on the sphere and a set of...
virtual std::uint64_t index(UnitVector3d const &v) const =0
index computes the index of the pixel for v.
virtual RangeSet universe() const =0
universe returns the set of all pixel indexes for this pixelization.
RangeSet interior(Region const &r, size_t maxRanges=0) const
interior returns the indexes of the pixels within the spherical region r.
virtual std::unique_ptr< Region > pixel(std::uint64_t i) const =0
pixel returns the spherical region corresponding to the pixel with index i.
virtual RangeSet _interior(Region const &r, size_t maxRanges) const =0
virtual std::string toString(std::uint64_t i) const =0
toString converts the given pixel index to a human-readable string.
RangeSet envelope(Region const &r, size_t maxRanges=0) const
envelope returns the indexes of the pixels intersecting the spherical region r.
virtual RangeSet _envelope(Region const &r, size_t maxRanges) const =0
A RangeSet is a set of unsigned 64 bit integers.
Definition RangeSet.h:106
Region is a minimal interface for 2-dimensional regions on the unit sphere.
Definition Region.h:89
UnitVector3d is a unit vector in ℝ³ with components stored in double precision.