pip

pip install orthority

conda

conda install -c conda-forge orthority

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.

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

oty exif --dem dem.tif source.tif

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

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

oty rpc --dem dem.tif source.tif

oty rpc --dem dem.tif --gcp-refine tags source.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')