oty frame

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

SOURCE images can be specified with paths, URIs or path / URI wildcard patterns.

Interior parameters are supported in Orthority .yaml, OpenDroneMap cameras.json, and OpenSfM reconstruction.json formats. Exterior parameters are supported in Orthority .geojson, CSV, and OpenSfM reconstruction.json formats. Parameter file extensions are used to distinguish their format.

The --int-param and --ext-param options are required. The --dem option is required, except when exporting camera parameters with --export-params. Depending on the input file formats, --crs may also be required:

oty frame --dem dem.tif --int-param int_param.yaml --ext-param ext_param.csv --crs EPSG:32651 source*.tif

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

oty frame --int-param reconstruction.json --ext-param reconstruction.json --export-params

Ortho images and exported files are placed in the current working directory by default. This can be changed with --out-dir.

Usage

oty frame [OPTIONS] SOURCE...

Options

-d, --dem <dem_file>

Path / URI of a DEM file covering the source image(s).

-ip, --int-param <int_param_file>

Required Path / URI of an interior parameter file.

-ep, --ext-param <ext_param_file>

Required Path / URI of an exterior parameter file.

-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'

-db, --dem-band <dem_band>

Index of the DEM band to use (1 based).

Default:

1

-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

-lc, --lla-crs <lla_crs>

CRS of any geographic coordinate exterior parameters 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:

'EPSG:4979'

-rd, --radians, -dg, --degrees

Orientation angle units. Only used for --ext-param in CSV format.

Default:

False

-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:

'current working'

-o, --overwrite

Overwrite existing output(s).

Default:

False

Arguments

SOURCE...

Optional argument(s)

See https://orthority.readthedocs.io/ for more detail on file formats and usage.