LSST Applications g1653933729+34a971ddd9,g28da252d5a+6ecf39ab43,g2bbee38e9b+7117419c07,g2bc492864f+7117419c07,g2cdde0e794+704103fe75,g3156d2b45e+6e87dc994a,g347aa1857d+7117419c07,g35bb328faa+34a971ddd9,g3a166c0a6a+7117419c07,g3e281a1b8c+8ec26ec694,g4005a62e65+ba0306790b,g414038480c+40f8eb5d96,g569e0e2b34+d8e684fe9f,g717e5f8c0f+b9f74a9651,g76fe02a360+28e3f83f63,g80478fca09+fdb1f299e2,g82479be7b0+2fffa722b6,g858d7b2824+b9f74a9651,g8b782ad322+b9f74a9651,g8cd86fa7b1+ed49507c07,g90e5cb8612+3a7ace1691,g9125e01d80+34a971ddd9,g979bb04a14+232ddb636d,g9a700aaafa+34a971ddd9,ga5288a1d22+3504ff4bc9,gae0086650b+34a971ddd9,gae74b0b5c6+761ee125be,gb3d89ef091+14ce01cc3a,gb58c049af0+ace264a4f2,gc28159a63d+7117419c07,gcf0d15dbbd+34f38ce56c,gda6a2b7d83+34f38ce56c,gdaeeff99f8+7774323b41,ge33fd446bb+b9f74a9651,ge5cf12406b+d328917b0a,ge79ae78c31+7117419c07,gf0baf85859+890af219f9,gf5289d68f6+fe3ed47e0d,w.2024.35
LSST Data Management Base Package
Loading...
Searching...
No Matches
utils.py
Go to the documentation of this file.
2# LSST Data Management System
3# Copyright 2008, 2009, 2010 LSST Corporation.
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 <http://www.lsstcorp.org/LegalNotices/>.
21#
22
23__all__ = ["coordFromVec", "makeSkyPolygonFromBBox", "Index2D"]
24
25from typing import NamedTuple
26import numpy
27
28import lsst.sphgeom
29import lsst.geom as geom
30
31_TinyFloat = numpy.finfo(float).tiny
32
33
34def coordFromVec(vec, defRA=None):
35 """Convert an ICRS cartesian vector to an ICRS `lsst.geom.SpherePoint`.
36
37 Parameters
38 ----------
39 vec : `list` of `float`
40 An ICRS catesian vector.
41 defRA : `lsst.geom.Angle` or None
42 The RA to use if the vector is too near a pole;
43 ignored if not near a pole.
44
45 Raises
46 ------
47 RuntimeError
48 Raised if vec too near a pole and defRA is None.
49 """
50 if abs(vec[0]) < _TinyFloat and abs(vec[1]) < _TinyFloat:
51 if defRA is None:
52 raise RuntimeError("At pole and defRA==None")
53 if vec[2] > 0:
54 decDeg = 90.0
55 else:
56 decDeg = -90.0
57 return geom.SpherePoint(defRA, decDeg*geom.degrees)
59
60
62 """Make an on-sky polygon from a bbox and a SkyWcs.
63
64 Parameters
65 ----------
66 bbox : `lsst.geom.Box2I` or `lsst.geom.Box2D`
67 Bounding box of region, in pixel coordinates.
68 wcs : `lsst.afw.geom.SkyWcs`
69 Celestial WCS.
70
71 Returns
72 -------
73 polygon : `lsst.sphgeom.ConvexPolygon`
74 On-sky region
75 """
76 pixelPoints = geom.Box2D(bbox).getCorners()
77 skyPoints = wcs.pixelToSky(pixelPoints)
78 return lsst.sphgeom.ConvexPolygon([sp.getVector() for sp in skyPoints])
79
80
81class Index2D(NamedTuple):
82 """Two dimensional index for patches and cells.
83
84 This class contains the x and y values of the location of a patch
85 within a tract, or a cell within a patch.
86
87 Parameters
88 ----------
89 x : `int`
90 y : `int`
91 """
92 x: int
93 y: int
A floating-point coordinate rectangle geometry.
Definition Box.h:413
Point in an unspecified spherical coordinate system.
Definition SpherePoint.h:57
ConvexPolygon is a closed convex polygon on the unit sphere.
Vector3d is a vector in ℝ³ with components stored in double precision.
Definition Vector3d.h:51
coordFromVec(vec, defRA=None)
Definition utils.py:34
makeSkyPolygonFromBBox(bbox, wcs)
Definition utils.py:61