16.29. image2qtree

image2qtree turns a georeferenced image (or images) into a quadtree with geographical metadata. For example, it can output a kml file for viewing in Google Earth.

Command-line options for image2qtree:


Display a help message.

-o, --output-name <directory-name>

Specify the base output directory.

-q, --quiet

Quiet output.

-v, --verbose

Verbose output.

--cache <number-of-MB (default: 1024)>

Cache size, in megabytes.


Use WGS84 as the input images’ geographic coordinate systems, even if they’re not (old behavior).

--pixel-scale <factor (default: 1)>

Scale factor to apply to pixels.

--pixel-offset <offset (default: 0)>

Offset to apply to pixels.


Normalize input images so that their full dynamic range falls in between [0,255].

-m, --output-metadata <kmltms|uniview|gmap|celestia|none (default: none)>

Specify the output metadata type.

--file-type <type (default: png)>

Output file type.

--channel-type <uint8|uint16|int16|float (default: uint8)>

Output (and input) channel type.

--module-name <name (default: marsds)>

The module where the output will be placed. Ex: marsds for Uniview, or Sol/Mars for Celestia.


Outputs image files suitable for a Uniview terrain view. Implies output format as PNG, channel type uint16. Uniview only.

--jpeg-quality <factor (default: 0.75)>

JPEG quality factor (0.0 to 1.0).

--png-compression <level (default: 3)>

PNG compression level (0 to 9).

--palette-file <filename>

Apply a palette from the given file.

--palette-scale <factor>

Apply a scale factor before applying the palette.

--palette-offset <value>

Apply an offset before applying the palette.

--tile-size <number-of-pixels (default: 256)>

Tile size, in pixels.

--max-lod-pixels <number-of-pixels (default: 1024)>

Max LoD in pixels, or -1 for none (kml only).

--draw-order-offset <value (default: 0)>

Offset for the <drawOrder> tag for this overlay (kml only).


Composite images using multi-band blending.

--aspect-ratio <ratio (default: 1)>

Pixel aspect ratio (for polar overlays; should be a power of two).

--north <latitude-in-degrees>

The northernmost latitude in degrees.

--south <latitude-in-degrees>

The southernmost latitude in degrees.

--east <longitude-in-degrees>

The easternmost longitude in degrees.

--west <longitude-in-degrees>

The westernmost longitude in degrees.


Assume a sinusoidal projection.


Assume a Mercator projection.


Assume a transverse Mercator projection.


Assume an orthographic projection.


Assume a stereographic projection.


Assume a Lambert azimuthal projection.


Assume a Lambert Conformal Conic projection.

--utm <zone>

Assume UTM projection with the given zone.

--proj-lat <latitude>

The center of projection latitude (if applicable).

--proj-lon <longitude>

The center of projection longitude (if applicable).

--proj-scale <scale>

The projection scale (if applicable).

--std-parallel1 <latitude>

Standard parallels for Lambert Conformal Conic projection.

--std-parallel2 <latitude>

Standard parallels for Lambert Conformal Conic projection.

--nudge-x <arg>

Nudge the image, in projected coordinates.

--nudge-y <arg>

Nudge the image, in projected coordinates.