Shareloc, a simple remote sensing geometric library

[](https://www.python.org/downloads/release/python-380/) [](CONTRIBUTING.md) [](https://opensource.org/licenses/Apache-2.0/) [](https://shareloc.readthedocs.io/?badge=latest)

Overview . Why Shareloc . Quick Start . Documentation . Contribution .

Overview

Shareloc is an open source remote sensing geolocation library.

It performs image coordinates projections between sensor and ground and vice versa. Shareloc handles RPC models and direct location grids.

Direct localization at constant elevation | Direct localization on DEM :-------------------------:|:-------------------------: |

Shareloc main functions :

• Direct/inverse localization at constant elevation (ellipsoidal earth model).
• Direct localization on 2.5D DEM (w.r.t ellipsoid or geoid).
• Line of sight triangulation.
• Rectification grid creation.
• Rectification grid interpolation.

Why Shareloc

Shareloc development has been motivated by the need of a full python component for CNES studies and the need of an underlying geometrical component for CARS.

Quick start

Installation

Shareloc can be installed in a virtualenv from Pypi repository:

python -m venv shareloc-venv
source shareloc-venv/bin/activate
pip install --upgrade pip
pip install shareloc

For developers, Shareloc can be installed from source in a virtualenv using the following commands:

git clone https://github.com/CNES/shareloc
cd shareloc
make install
source venv/bin/activate # to go in installed dev environment

Dependencies : git, make

Import

To test the import of the library:

python3
>>> import shareloc

And go to Getting started in Shareloc Documentation for an example.

Documentation

Go to Shareloc Main Documentation

Contribution

To do a bug report or a contribution, see the Contribution Guide. For project evolution, see Changelog