LSST Applications g044012fb7c+304891ab8a,g04a91732dc+4e1b87f259,g07dc498a13+f701f15b83,g114c6a66ad+c7887c1284,g1409bbee79+f701f15b83,g1a7e361dbc+f701f15b83,g1fd858c14a+6ebd102b59,g35bb328faa+0eb18584fe,g3bd4b5ce2c+e83bf4edc8,g4e0f332c67+976ceb6bc8,g53246c7159+0eb18584fe,g5477a8d5ce+51234355ef,g60b5630c4e+c7887c1284,g623d845a50+c7887c1284,g6f0c2978f1+98123c34b6,g71fabbc107+c7887c1284,g75b6c65c88+ce466f4385,g78460c75b0+85633614c8,g786e29fd12+02b9b86fc9,g8852436030+cfe5cf5b7b,g89139ef638+f701f15b83,g9125e01d80+0eb18584fe,g95236ca021+d4f98599f0,g974caa22f6+0eb18584fe,g989de1cb63+f701f15b83,g9f33ca652e+b4908f5dcd,gaaedd4e678+f701f15b83,gabe3b4be73+543c3c03c9,gace736f484+07e57cea59,gb1101e3267+487fd1b06d,gb58c049af0+492386d360,gc99c83e5f0+a513197d39,gcf25f946ba+cfe5cf5b7b,gd0fa69b896+babbe6e5fe,gd6cbbdb0b4+3fef02d88a,gde0f65d7ad+e8379653a2,ge278dab8ac+ae64226a64,gfba249425e+0eb18584fe,w.2025.07
LSST Data Management Base Package
Loading...
Searching...
No Matches
lsst.skymap.detail.utils Namespace Reference

Classes

class  Index2D
 

Functions

 coordFromVec (vec, defRA=None)
 
 makeSkyPolygonFromBBox (bbox, wcs)
 

Variables

 _TinyFloat = numpy.finfo(float).tiny
 

Function Documentation

◆ coordFromVec()

lsst.skymap.detail.utils.coordFromVec ( vec,
defRA = None )
Convert an ICRS cartesian vector to an ICRS `lsst.geom.SpherePoint`.

Parameters
----------
vec : `list` of `float`
    An ICRS catesian vector.
defRA : `lsst.geom.Angle` or None
    The RA to use if the vector is too near a pole;
    ignored if not near a pole.

Raises
------
RuntimeError
    Raised if vec too near a pole and defRA is None.

Definition at line 34 of file utils.py.

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
Point in an unspecified spherical coordinate system.
Definition SpherePoint.h:57
Vector3d is a vector in ℝ³ with components stored in double precision.
Definition Vector3d.h:51

◆ makeSkyPolygonFromBBox()

lsst.skymap.detail.utils.makeSkyPolygonFromBBox ( bbox,
wcs )
Make an on-sky polygon from a bbox and a SkyWcs.

Parameters
----------
bbox : `lsst.geom.Box2I` or `lsst.geom.Box2D`
    Bounding box of region, in pixel coordinates.
wcs : `lsst.afw.geom.SkyWcs`
    Celestial WCS.

Returns
-------
polygon : `lsst.sphgeom.ConvexPolygon`
    On-sky region

Definition at line 61 of file utils.py.

61def makeSkyPolygonFromBBox(bbox, wcs):
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
A floating-point coordinate rectangle geometry.
Definition Box.h:413
ConvexPolygon is a closed convex polygon on the unit sphere.

Variable Documentation

◆ _TinyFloat

lsst.skymap.detail.utils._TinyFloat = numpy.finfo(float).tiny
protected

Definition at line 31 of file utils.py.