Skip to main content

Rational Polynomial Camera Model for optical satellite images.

Project description

RPCM - Rational Polynomial Camera Model

Python implementation of the Rational Polynomial Camera (RPC) model for optical satellite images.

Carlo de Franchis, Gabriele Facciolo, Enric Meinhardt-Llopis (Centre Borelli, ENS Paris-Saclay, Université Paris-Saclay) 2013-21

rpcm is a Python library and command line tool for geolocating satellite images with RPCs. Its main source code repository is https://github.com/centreborelli/rpcm.

Installation

To install rpcm from PyPI:

pip install rpcm

Alternatively, to install rpcm from sources:

git clone https://github.com/centreborelli/rpcm.git
cd rpcm
pip install -e .

Usage

rpcm is a Python library that can be imported into other applications. A Jupyter notebook tutorial covering the main features of the library is included (TODO).

rpcm also comes with a Command Line Interface (CLI). The rpcm CLI has an extensive help that can be printed with the -h and --help switches.

$ rpcm -h
usage: rpcm [-h] {projection, localization, crop, footprint, angle} ...

Some CLI usage examples can be found in tests/tests.sh.

There are several subcommands, projection, localization, crop, footprint, angle, each of which has its own help.

Projection

$ rpcm projection -h
usage: rpcm projection [-h] [--lon LON] [--lat LAT] [-z Z] [--points POINTS]
                       [--crop CROP] [--svg SVG]
                       img

positional arguments:
  img              path or url to a GeoTIFF image file with RPC metadata

optional arguments:
  -h, --help       show this help message and exit
  --lon LON        longitude
  --lat LAT        latitude
  -z Z             altitude, in meters
  --points POINTS  path to a 2/3 columns txt file: lon lat [z]
  --crop CROP      path to a tif crop previously produced by rpcm. Image
                   coordinates are computed with respect to this crop.
  --svg SVG        path to an svg file where to plot projected points.

Localization

$ rpcm localization -h
usage: rpcm localization [-h] [-x X] [-y Y] [-z Z] [--points POINTS]
                     [--crop CROP]
                     img

positional arguments:
  img              path or url to a GeoTIFF image file with RPC metadata

optional arguments:
  -h, --help       show this help message and exit
  -x X             horizontal pixel coordinate (i.e. column index)
  -y Y             vertical pixel coordinate (i.e. row index)
  -z Z             altitude, in meters
  --points POINTS  path to a 3 columns txt file: x y z
  --crop CROP      path to a tif crop previously produced by rpcm. Image
                   coordinates are interpreted with respect to this crop.

Crop

$ rpcm crop -h
usage: rpcm crop [-h] [-z Z] img aoi crop

positional arguments:
  img         path to a GeoTIFF image file with RPC metadata
  aoi         path to geojson file defining the area of interest (AOI)
  crop        path to the output cropped tif image

optional arguments:
  -h, --help  show this help message and exit
  -z Z        altitude of the crop center

Footprint

$ rpcm footprint -h
usage: rpcm footprint [-h] [-z Z] img

positional arguments:
  img         path or url to a GeoTIFF image file with RPC metadata

optional arguments:
  -h, --help  show this help message and exit
  -z Z        altitude, in meters

Angle

$ rpcm angle -h
usage: rpcm angle [-h] [--lon LON] [--lat LAT] [-z Z] img1 img2

positional arguments:
  img1        path to a GeoTIFF image file with RPC metadata
  img2        path to a GeoTIFF image file with RPC metadata

optional arguments:
  -h, --help  show this help message and exit
  --lon LON   longitude
  --lat LAT   latitude
  -z Z        altitude

Common issues

Warning: A rasterio issue on Ubuntu causes the need for this environment variable (more info on rasterio's github):

export CURL_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rpcm-1.4.10.tar.gz (16.7 kB view hashes)

Uploaded Source

Built Distribution

rpcm-1.4.10-py3-none-any.whl (17.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page