oty odm

Orthorectify images in a processed OpenDroneMap dataset that includes a DSM.

The images, DSM and camera models are read from the dataset. If --crs is not supplied (recommended), the world / ortho CRS is also read from the dataset. --dataset-dir is the only required option:

oty odm --dataset-dir dataset

Camera parameters can be exported to Orthority format files with --export-params:

oty odm --dataset-dir dataset --export-params

Ortho images and exported files are placed in the dataset/orthority subdirectory by default. This can be changed with --out-dir.

Usage

oty odm [OPTIONS]

Options

-dd, --dataset-dir <dataset_dir>

Required Path / URI of the ODM dataset to process.

-c, --crs <crs>

CRS of ortho image(s) and world coordinates as an EPSG, proj4, or WKT string; path / URI of a text file containing string; or path / URI of an image with metadata CRS.

Default:

'auto'

-r, --res <resolution>

Ortho image resolution in units of the --crs. Can be used twice for non-square pixels: --res WIDTH --res HEIGHT.

Default:

'ground sampling distance'

-i, --interp <interp>

Interpolation method for remapping source to ortho image.

Default:

cubic

Options:

nearest | average | bilinear | cubic | lanczos

-di, --dem-interp <dem_interp>

Interpolation method for DEM reprojection.

Default:

cubic

Options:

nearest | average | bilinear | cubic | lanczos

-pb, --per-band, -npb, --no-per-band

Orthorectify band-by-band (--per-band) or all bands at once (--no-per-band). --no-per-band is faster but uses more memory.

Default:

False

-fr, --full-remap, -nfr, --no-full-remap

Orthorectify the source image with full camera model (--full-remap), or an undistorted source image with pinhole camera model (--no-full-remap). --no-full-remap is faster but can reduce ortho image quality.

Default:

True

-a, --alpha <alpha>

Scaling of the --no-full-remap undistorted image: 0 includes the largest source image portion that allows all undistorted pixels to be valid. 1 includes all source pixels in the undistorted image.

Default:

1

-wm, --write-mask, -nwm, --no-write-mask

Mask valid pixels with an internal mask (--write-mask), or with a nodata value based on --dtype (--no-write-mask). An internal mask helps remove nodata noise caused by lossy compression.

Default:

'true for jpeg compression.'

-dt, --dtype <dtype>

Ortho image data type.

Default:

'source image data type.'

Options:

uint8 | uint16 | int16 | float32 | float64

-cm, --compress <compress>

Ortho image compression.

Default:

'jpeg for uint8 --dtype, deflate otherwise'

Options:

jpeg | deflate | lzw

-bo, --build-ovw, -nbo, --no-build-ovw

Build overviews for the ortho image(s).

Default:

True

-co, --creation-option <NAME=VALUE>

Creation option(s) for the ortho image(s). If supplied, --compress is ignored. See the GDAL docs for details.

Default:

'auto'

-dv, --driver <driver>

Ortho image driver.

Default:

gtiff

Options:

gtiff | cog

-e, --export-params

Export camera parameters to Orthority format file(s), and exit.

Default:

False

-od, --out-dir <out_dir>

Path / URI of the output file directory.

Default:

'<dataset-dir>/orthority'

-o, --overwrite

Overwrite existing output(s).

Default:

False

See https://orthority.readthedocs.io/ for more detail.