command line tools#

spymicmac comes with the following command line tools, organized roughly by what they are used for:

setting up micmac files#

generate_measures_files: for creating the various input files needed for processing KH-9 Hexagon mapping camera images.
create_localchantier_xml: for creating a MicMac-LocalChantierDescripteur.xml file.
write_micmac_xml: creates an XML file for a geotiff. Used for preparing a seed DEM to pass to mm3d Malt, for example.

preprocess_kh9_mc: for pre-processing KH-9 Hexagon mapping camera images from .tgz files to a relative orientation
preprocess_pan: for pre-processing panoramic camera images from .tgz files to cropped images.

These tools do individual steps as part of pre-processing:

join_hexagon: for joining scanned parts of an image together.
find_reseau_grid: for finding réseau marks in a KH-9 Hexagon mapping camera image.
remove_crosses: for removing réseau marks in a KH-9 Hexagon mapping camera image.
resample_hexagon: for resampling a KH-9 Hexagon mapping camera image using the réseau marks found previously.

The following tools perform steps related to automatically finding GCPs:

register_relative: for automatically finding GCPs, given a relative DEM/orthophoto and a reference DEM/orthoimage.
download_cop30_vrt: for downloading and creating a VRT of Copernicus 30m DSM tiles.
block_orientation: combines GCPs and Measures files from multiple blocks into a single orientation, then runs spymicmac.micmac.iterate_campari() to refine the orientation + camera parameters.
combine_auto_measures: used for combining the outputs of mm3d XYZ2Im into a single xml file.
remove_measures: used for removing named GCPs from a Measures xml file - for example, if the GCP is badly placed.

post_process_micmac: for masking and georeferencing the DEM and orthophoto(s) or orthomosaic.
mosaic_micmac_tiles: for mosaicking the tiled outputs from Malt.