preprocess_kh9

Run pre-processing steps for KH-9 Hexagon Mapping Camera images. By default, runs all steps (equivalent to “–steps all”):

  • extract: extracts images from tar files (skips if no tar files are found)

  • join: joins scanned image halves

  • reseau: finds reseau marker locations in the joined image

  • erase: erases reseau markers from image

  • filter: use a 1-sigma gaussian filter to smooth the images before resampling

  • resample: resamples images to common size using the reseau marker locations

  • tapioca: calls mm3d Tapioca MulScale to find tie points

  • tapas: calls mm3d Tapas to calibrate camera model, find relative image orientation

  • aperi: calls mm3d AperiCloud to create point cloud using calibrated camera model

To run steps individually, use the –steps flag with the corresponding step name(s). For example, to only run the ‘reseau’ and ‘erase’ steps:

preprocess_kh9 –steps reseau erase <additional arguments>

usage: preprocess_kh9 [-h] [--steps STEPS [STEPS ...]] [--tar_ext TAR_EXT]
                      [-s SCALE] [-b] [--add_sfs] [--res_low RES_LOW]
                      [--res_high RES_HIGH] [--camera_model CAMERA_MODEL]
                      [--ori ORI] [--init_cal INIT_CAL] [--lib_foc] [--lib_pp]
                      [--lib_cd] [-n NPROC]

Named Arguments

--steps

The pre-processing steps to run.

Default: “all”

--tar_ext

Extension for tar files (default: .tgz)

Default: “.tgz”

-s, --scale

The scale of the resampled images, in pixels per mm. (default: 70)

Default: 70

-b, --blend

Blend across image halves to prevent a sharp line at edge.

Default: False

--add_sfs

use SFS to help find tie points in low-contrast images [False]

Default: False

--res_low

the size of the largest image axis, in pixels, for low-resolution matching with Tapioca (default: 400)

Default: 400

--res_high

the size of the largest image axis, in pixels, for low-resolution matching with Tapioca (default: 1200)

Default: 1200

--camera_model

The camera calibration model to use for Tapas (default: RadialExtended)

Default: “RadialExtended”

--ori

The output Ori directory to create using Tapas (default: Relative)

Default: “Relative”

--init_cal

The initial calibration Ori to use for Tapas (default: Init)

Default: “Init”

--lib_foc

Use LibFoc=1 for mm3d Tapas (default: LibFoc=0)

Default: False

--lib_pp

Use LibPP=1 for mm3d Tapas (default: LibPP=0)

Default: False

--lib_cd

Use LibCD=1 for mm3d Tapas (default: LibCD=0)

Default: False

-n, --nproc

number of sub-processes to use (default: 1).

Default: 1