aws.osml.photogrammetry.sensor_model module

class aws.osml.photogrammetry.sensor_model.SensorModel

Bases: ABC

A sensor model is an abstraction that maps the information in a georeferenced image to the real world. The concrete implementations of this abstraction will either capture the physical service model characteristics or more frequently an approximation of that physical model that allow users to transform world coordinates to image coordinates.

abstract image_to_world(image_coordinate: ImageCoordinate, elevation_model: ElevationModel | None = None, options: Dict[str, Any] | None = None) → GeodeticWorldCoordinate

This function returns the longitude, latitude, elevation world coordinate associated with the x, y coordinate of any pixel in the image.

Parameters:

• image_coordinate – the x, y image coordinate

• elevation_model – optional elevation model used to transform the coordinate

• options – optional dictionary of hints that will be passed on to sensor models

Returns:

GeodeticWorldCoordinate = the longitude, latitude, elevation world coordinate

abstract world_to_image(world_coordinate: GeodeticWorldCoordinate) → ImageCoordinate

This function returns the x, y image coordinate associated with a given longitude, latitude, elevation world coordinate.

Parameters:

world_coordinate – the longitude, latitude, elevation world coordinate

Returns:

the x, y image coordinate

class aws.osml.photogrammetry.sensor_model.SensorModelOptions(value)

Bases: str, Enum

These are common options for SensorModel operations. Not all implementations will support these, but they are included here to encourage convention.

INITIAL_GUESS = 'initial_guess'

INITIAL_SEARCH_DISTANCE = 'initial_search_distance'