Tests codecov PyPI version conda-forge Documentation Status License: AGPL v3

Orthority

banner

Orthority provides a command line toolkit and Python API for orthorectifying drone, aerial and satellite imagery, given a camera model and DEM. It supports common frame, and RPC camera models. Camera parameters can be read from various file formats, or image tags. Related algorithms including RPC refinement and pan-sharpening, are also provided.

Installation

Orthority is a python 3 package that can be installed with pip or conda.

pip

pip install orthority

conda

conda install -c conda-forge orthority

Quick start

Command line interface

Orthority command line functionality is accessed with the oty command, and its sub-commands:

  • frame: Orthorectify images with frame camera model(s) defined by interior and exterior parameter files.

  • exif: Orthorectify images with frame camera model(s) defined by image EXIF / XMP tags.

  • odm: Orthorectify images in a processed OpenDroneMap dataset that includes a DSM.

  • rpc: Orthorectify images with RPC camera models defined by image tags / sidecar files or parameter files.

  • sharpen: Pan-sharpen an image using the Gram-Schmidt method.

Get help on oty with:

oty --help

and help on an oty sub-command with:

oty <sub-command> --help

Options for configuring output images are common to all sub-commands.

Examples

Orthorectify source.tif with the DEM in dem.tif, and frame camera model defined by int_param.yaml and ext_param.geojson interior and exterior parameters:

oty frame --dem dem.tif --int-param int_param.yaml --ext-param ext_param.geojson source.tif

Orthorectify source.tif with the DEM in dem.tif, and frame camera model defined by source.tif EXIF / XMP tags:

oty exif --dem dem.tif source.tif

As above, but the create the ortho image with bilinear interpolation, a 0.5 m pixel size and deflate compression:

oty exif --dem dem.tif --interp bilinear --res 0.5 --compress deflate source.tif

Orthorectify images in the OpenDroneMap dataset odm, with the dataset DSM and camera models. Ortho images are placed in odm/orthority.

oty odm --dataset-dir odm --out-dir odm/orthority

Orthorectify source.tif with the DEM in dem.tif, and RPC camera model defined by source.tif tags / sidecar files:

oty rpc --dem dem.tif source.tif

As above, but refine the RPC camera model with GCPs in source.tif tags:

oty rpc --dem dem.tif --gcp-refine tags source.tif

Pan-sharpen the multispectral image ms.tif with the panchromatic image pan.tif:

oty sharpen  --pan pan.tif --multispectral ms.tif --out-file pan_sharp.tif

API

Orthorectify an image using interior and exterior parameter files to generate the camera model:

import orthority as oty

# URLs of required files
url_root = 'https://raw.githubusercontent.com/leftfield-geospatial/orthority/main/tests/data/'
src_file = url_root + 'ngi/3324c_2015_1004_05_0182_RGB.tif'  # aerial image
dem_file = url_root + 'ngi/dem.tif'  # DEM covering imaged area
int_param_file = url_root + 'io/ngi_int_param.yaml'  # interior parameters
ext_param_file = url_root + 'io/ngi_xyz_opk.csv'  # exterior parameters

# create a camera model for src_file from interior & exterior parameters
cameras = oty.FrameCameras(int_param_file, ext_param_file)
camera = cameras.get(src_file)

# create Ortho object and orthorectify
ortho = oty.Ortho(src_file, dem_file, camera=camera, crs=cameras.crs)
ortho.process('ortho.tif')

Pan-sharpen a multispectral image with the matching panchromatic image:

import orthority as oty

# URLs of required files
url_root = 'https://raw.githubusercontent.com/leftfield-geospatial/orthority/main/tests/data/'
pan_file = url_root + 'pan_sharp/pan.tif'  # panchromatic drone image
ms_file = url_root + 'pan_sharp/ms.tif'  # multispectral (RGB) drone image

# create PanSharpen object and pan-sharpen
pan_sharp = oty.PanSharpen(pan_file, ms_file)
pan_sharp.process('pan_sharp.tif')

Documentation

See orthority.readthedocs.io for usage and reference documentation.

Contributing

Contributions are welcome - the online documentation has a guide. Please report bugs and make feature requests with the github issue tracker.

Licensing

Orthority is licensed under the GNU Affero General Public License v3.0 (AGPLv3).

Portions of the AGPLv3 licensed OpenDroneMap software, and BSD-style licensed OpenSfM library have been adapted and included in the Orthority package.

Acknowledgements

Special thanks to Yu-Huang Wang & the OpenDroneMap Community, National Geo-spatial Information and the Centre for Geographical Analysis for sharing imagery, DEM and aero-triangulation data that form part of the package test data.

Project links

Data verified by PyPI on Aug 19, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dugalh from gravatar.com dugalh

Credits

Author: Leftfield Geospatial

GitHub Statistics

Data verified by PyPI on Aug 19, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GNU Affero General Public License v3 or later (AGPLv3+) (AGPL-3.0-or-later)

Requires

Python >=3.10

Provides Extra

http

Tags

orthorectify orthorectification georeference uav drone aerial satellite exif xmp image rpc pan sharpen

Classifiers

Report project as malware

Download files

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

Source Distribution

orthority-0.7.0.tar.gz (148.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

orthority-0.7.0-py3-none-any.whl (101.2 kB view details)

Uploaded Python 3

File details

Details for the file orthority-0.7.0.tar.gz.

File metadata

  • Download URL: orthority-0.7.0.tar.gz
  • Upload date:
  • Size: 148.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for orthority-0.7.0.tar.gz
Algorithm Hash digest
SHA256 72fbea3ba31a75956ea03ae2c47413109ea8df826449eecae19b52219761825c
MD5 2cb365138121620bca2a993ee4be592a
BLAKE2b-256 89ece3b9242b77abf840227fa2ad60f0b79ce5390fc33d5bb114f1959b1d0e40

See more details on using hashes here.

Provenance

The following attestation bundles were made for orthority-0.7.0.tar.gz:

Publisher: publish-pypi.yml on leftfield-geospatial/orthority

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file orthority-0.7.0-py3-none-any.whl.

File metadata

  • Download URL: orthority-0.7.0-py3-none-any.whl
  • Upload date:
  • Size: 101.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for orthority-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e740923852a35569643b802ba1976ab49cddeca67f065a6f7e62a37cc62cf5ca
MD5 77119e72d183165691c1b8f65b22aa94
BLAKE2b-256 2db738721777a43dd2915fa46e85c90f33b13eab9cffe86458fa21e2aeb67446

See more details on using hashes here.

Provenance

The following attestation bundles were made for orthority-0.7.0-py3-none-any.whl:

Publisher: publish-pypi.yml on leftfield-geospatial/orthority

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.7.0 This release

2 files

0.6.1

2 files

0.6.0

2 files

0.5.1

2 files

0.5.0

2 files

0.4.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page