Package: rpcm
RPCM - Rational Polynomial Camera ModelPython 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-21rpcmis a Python library and command line tool for geolocating satellite images
with RPCs. Its main source code repository ishttps://github.com/centreborelli/rpcm.InstallationTo installrpcmfrom PyPI:pip install rpcmAlternatively, to installrpcmfrom sources:git clone https://github.com/centreborelli/rpcm.git
cd rpcm
pip install -e .Usagerpcmis a Python library that can be imported into other applications. A
Jupyter notebook tutorial covering the main features of the library is included (TODO).rpcmalso comes with a Command Line Interface (CLI). TherpcmCLI has an
extensive help that can be printed with the-hand--helpswitches.$ rpcm -h
usage: rpcm [-h] {projection, localization, crop, footprint, angle} ...Some CLI usage examples can be found intests/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 centerFootprint$ 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 metersAngle$ 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        altitudeCommon issuesWarning: Arasterioissue on Ubuntu causes the need for this environment
variable (more info onrasterio's
github):export CURL_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt