shareloc.geofunctions.localization

Localization class for localization functions.

Module Contents

Classes

Localization

Base class for localization function.

Functions

coloc(model1, model2, row, col[, elevation, image1, ...])

Colocalization : direct localization with model1, then inverse localization with model2
class shareloc.geofunctions.localization.Localization(model, elevation=None, image=None, epsg=None)[source]

Base class for localization function. Underlying model can be both multi layer localization grids or RPCs models

direct(row, col, h=None, using_geotransform=False)[source]

direct localization

Parameters:

  • row (float or 1D np.ndarray) – sensor row

  • col (float or 1D np.ndarray) – sensor col

  • h (float or 1D np.ndarray) – altitude, if none DTM is used

  • using_geotransform (boolean) – using_geotransform

Return coordinates:

[lon,lat,h] (2D np.array)

Return type:

np.ndarray of 2D dimension

extent(margin=0.0)[source]
returns model extent:

  • whole validity domains if image is not given

  • image footprint if image is set

  • epipolar footprint if right_model is set

Parameters:

margin (float) – footprint margin (in degrees)

Returns:

extent [lon_min,lat_min,lon max,lat max] (2D np.array)

Return type:

numpy.array

inverse(lon, lat, h=None, using_geotransform=False)[source]

inverse localization

Parameters:

  • lat – latitude (or y)

  • lon – longitude (or x)

  • h – altitude

  • using_geotransform (boolean) – using_geotransform

Returns:

coordinates [row,col,h] (1D np.ndarray)

Return type:

Tuple(1D np.ndarray row position, 1D np.ndarray col position, 1D np.ndarray alt)

shareloc.geofunctions.localization.coloc(model1, model2, row, col, elevation=None, image1=None, image2=None, using_geotransform=False)[source]

Colocalization : direct localization with model1, then inverse localization with model2

Parameters:

  • model1 (GeomodelTemplate) – geometric model 1

  • model2 (GeomodelTemplate) – geometric model 2

  • row (int or 1D numpy array) – sensor row

  • col (int or 1D numpy array) – sensor col

  • elevation (shareloc.dtm or float or 1D numpy array) – elevation

  • image1 (shareloc.image.Image) – image class to handle geotransform

  • image2 (shareloc.image.Image) – image class to handle geotransform

  • using_geotransform (boolean) – using_geotransform

Returns:

Corresponding sensor position [row, col, altitude] in the geometric model 2

Return type:

Tuple(1D np.array row position, 1D np.array col position, 1D np.array alt) using row and col input dimensions