64 lines
2.0 KiB
Python
64 lines
2.0 KiB
Python
"""Ground control points"""
|
|
|
|
import uuid
|
|
|
|
|
|
class GroundControlPoint:
|
|
"""A mapping of row, col image coordinates to x, y, z."""
|
|
|
|
def __init__(self, row=None, col=None, x=None, y=None, z=None,
|
|
id=None, info=None):
|
|
"""Create a new ground control point
|
|
|
|
Parameters
|
|
----------
|
|
row, col : float, required
|
|
The row (or line) and column (or pixel) coordinates that
|
|
map to spatial coordinate values ``y`` and ``x``,
|
|
respectively.
|
|
x, y : float, required
|
|
Spatial coordinates of a ground control point.
|
|
z : float, optional
|
|
Optional ``z`` coordinate.
|
|
id : str, optional
|
|
A unique identifier for the ground control point.
|
|
info : str, optional
|
|
A short description for the ground control point.
|
|
"""
|
|
if any(x is None for x in (row, col, x, y)):
|
|
raise ValueError("row, col, x, and y are required parameters.")
|
|
if id is None:
|
|
id = str(uuid.uuid4())
|
|
self.id = id
|
|
self.info = info
|
|
self.row = row
|
|
self.col = col
|
|
self.x = x
|
|
self.y = y
|
|
self.z = z
|
|
|
|
def __repr__(self):
|
|
args = ", ".join(
|
|
[
|
|
f"{att}={repr(getattr(self, att))}"
|
|
for att in ("row", "col", "x", "y", "z", "id", "info")
|
|
if getattr(self, att) is not None
|
|
]
|
|
)
|
|
return f"GroundControlPoint({args})"
|
|
|
|
def asdict(self):
|
|
"""A dict representation of the GCP"""
|
|
return {'id': self.id, 'info': self.info, 'row': self.row,
|
|
'col': self.col, 'x': self.x, 'y': self.y, 'z': self.z}
|
|
|
|
@property
|
|
def __geo_interface__(self):
|
|
"""A GeoJSON representation of the GCP"""
|
|
coords = [self.x, self.y]
|
|
if self.z is not None:
|
|
coords.append(self.z)
|
|
return {'id': self.id, 'type': 'Feature',
|
|
'geometry': {'type': 'Point', 'coordinates': tuple(coords)},
|
|
'properties': self.asdict()}
|