aws.osml.photogrammetry.elevation_model module

class aws.osml.photogrammetry.elevation_model.ElevationRegionSummary(min_elevation: float, max_elevation: float, no_data_value: int, post_spacing: float)

Bases: object

This class contains a general summary of an elevation tile.

min_elevation: float

max_elevation: float

no_data_value: int

post_spacing: float

class aws.osml.photogrammetry.elevation_model.ElevationModel

Bases: ABC

An elevation model associates a height z for a given x, y of a world coordinate. It typically provides information about the terrain associated with longitude, latitude locations of an ellipsoid, but it can also be used to model surfaces for other ground domains.

abstract set_elevation(world_coordinate: GeodeticWorldCoordinate) → None

This method updates the elevation component of a world coordinate to match the surface elevation at longitude, latitude.

Parameters:

world_coordinate – the coordinate to update

Returns:

None

abstract describe_region(world_coordinate: GeodeticWorldCoordinate) → ElevationRegionSummary | None

Get a summary of the region near the provided world coordinate

Parameters:

world_coordinate – the coordinate at the center of the region of interest

Returns:

the summary information

class aws.osml.photogrammetry.elevation_model.ConstantElevationModel(constant_elevation: float)

Bases: ElevationModel

A constant elevation model with a single value for all longitude, latitude.

set_elevation(world_coordinate: GeodeticWorldCoordinate) → None

Updates world coordinate’s elevation to match the constant elevation.

Parameters:

world_coordinate – the coordinate to update

Returns:

None

describe_region(world_coordinate: GeodeticWorldCoordinate) → ElevationRegionSummary | None

Get a summary of the region near the provided world coordinate

Parameters:

world_coordinate – the coordinate at the center of the region of interest

Returns:

[min elevation value, max elevation value, no elevation data value, post spacing]