LSST Applications g0f08755f38+9c285cab97,g1635faa6d4+13f3999e92,g1653933729+a8ce1bb630,g1a0ca8cf93+bf6eb00ceb,g28da252d5a+0829b12dee,g29321ee8c0+5700dc9eac,g2bbee38e9b+9634bc57db,g2bc492864f+9634bc57db,g2cdde0e794+c2c89b37c4,g3156d2b45e+41e33cbcdc,g347aa1857d+9634bc57db,g35bb328faa+a8ce1bb630,g3a166c0a6a+9634bc57db,g3e281a1b8c+9f2c4e2fc3,g414038480c+077ccc18e7,g41af890bb2+fde0dd39b6,g5fbc88fb19+17cd334064,g781aacb6e4+a8ce1bb630,g80478fca09+55a9465950,g82479be7b0+d730eedb7d,g858d7b2824+9c285cab97,g9125e01d80+a8ce1bb630,g9726552aa6+10f999ec6a,ga5288a1d22+2a84bb7594,gacf8899fa4+c69c5206e8,gae0086650b+a8ce1bb630,gb58c049af0+d64f4d3760,gc28159a63d+9634bc57db,gcf0d15dbbd+4b7d09cae4,gda3e153d99+9c285cab97,gda6a2b7d83+4b7d09cae4,gdaeeff99f8+1711a396fd,ge2409df99d+5e831397f4,ge79ae78c31+9634bc57db,gf0baf85859+147a0692ba,gf3967379c6+41c94011de,gf3fb38a9a8+8f07a9901b,gfb92a5be7c+9c285cab97,w.2024.46
LSST Data Management Base Package
Loading...
Searching...
No Matches
Public Member Functions | List of all members
lsst.sphgeom._continue_class.Region Class Reference

Public Member Functions

Region from_ivoa_pos (cls, str pos)
 
str to_ivoa_pos (self)
 

Detailed Description

A minimal interface for 2-dimensional regions on the unit sphere.

Definition at line 101 of file _continue_class.py.

Member Function Documentation

◆ from_ivoa_pos()

Region lsst.sphgeom._continue_class.Region.from_ivoa_pos ( cls,
str pos )
Create a Region from an IVOA POS string.

Parameters
----------
pos : `str`
    A string using the IVOA SIAv2 POS syntax.

Returns
-------
region : `Region`
    A region equivalent to the POS string.

Notes
-----
See
https://ivoa.net/documents/SIA/20151223/REC-SIA-2.0-20151223.html#toc12
for a description of the POS parameter but in summary the options are:

* ``CIRCLE <longitude> <latitude> <radius>``
* ``RANGE <longitude1> <longitude2> <latitude1> <latitude2>``
* ``POLYGON <longitude1> <latitude1> ... (at least 3 pairs)``

Units are degrees in all coordinates.

Definition at line 105 of file _continue_class.py.

105 def from_ivoa_pos(cls, pos: str) -> Region:
106 """Create a Region from an IVOA POS string.
107
108 Parameters
109 ----------
110 pos : `str`
111 A string using the IVOA SIAv2 POS syntax.
112
113 Returns
114 -------
115 region : `Region`
116 A region equivalent to the POS string.
117
118 Notes
119 -----
120 See
121 https://ivoa.net/documents/SIA/20151223/REC-SIA-2.0-20151223.html#toc12
122 for a description of the POS parameter but in summary the options are:
123
124 * ``CIRCLE <longitude> <latitude> <radius>``
125 * ``RANGE <longitude1> <longitude2> <latitude1> <latitude2>``
126 * ``POLYGON <longitude1> <latitude1> ... (at least 3 pairs)``
127
128 Units are degrees in all coordinates.
129 """
130 shape, *coordinates = pos.split()
131 coordinates = tuple(float(c) for c in coordinates)
132 n_floats = len(coordinates)
133 if shape == "CIRCLE":
134 if n_floats != 3:
135 raise ValueError(f"CIRCLE requires 3 numbers but got {n_floats} in '{pos}'.")
136 center = LonLat.fromDegrees(coordinates[0], coordinates[1])
137 radius = Angle.fromDegrees(coordinates[2])
138 return Circle(UnitVector3d(center), radius)
139
140 if shape == "RANGE":
141 if n_floats != 4:
142 raise ValueError(f"RANGE requires 4 numbers but got {n_floats} in '{pos}'.")
143 # POS allows +Inf and -Inf in ranges. These are not allowed by
144 # Box and so must be converted.
145 return Box(
146 LonLat.fromDegrees(_inf_to_lon(coordinates[0]), _inf_to_lat(coordinates[2])),
147 LonLat.fromDegrees(_inf_to_lon(coordinates[1]), _inf_to_lat(coordinates[3])),
148 )
149
150 if shape == "POLYGON":
151 if n_floats % 2 != 0:
152 raise ValueError(f"POLYGON requires even number of floats but got {n_floats} in '{pos}'.")
153 if n_floats < 6:
154 raise ValueError(
155 f"POLYGON specification requires at least 3 coordinates, got {n_floats // 2} in '{pos}'"
156 )
157 # Coordinates are x1, y1, x2, y2, x3, y3...
158 # Get pairs by skipping every other value.
159 pairs = list(zip(coordinates[0::2], coordinates[1::2]))
160 vertices = [LonLat.fromDegrees(lon, lat) for lon, lat in pairs]
161 return ConvexPolygon([UnitVector3d(c) for c in vertices])
162
163 raise ValueError(f"Unrecognized shape in POS string '{pos}'")
164

◆ to_ivoa_pos()

str lsst.sphgeom._continue_class.Region.to_ivoa_pos ( self)
Represent the region as an IVOA POS string.

Returns
-------
pos : `str`
    The region in ``POS`` format.

Definition at line 165 of file _continue_class.py.

165 def to_ivoa_pos(self) -> str:
166 """Represent the region as an IVOA POS string.
167
168 Returns
169 -------
170 pos : `str`
171 The region in ``POS`` format.
172 """
173 raise NotImplementedError("This region can not be converted to an IVOA POS string.")
174
175
176@_continueClass

The documentation for this class was generated from the following file: