GRASS logo

NAME

p.automos - Build a seamless planetary mosaic from multiple rasters.
Composites a comma-separated list of planetary rasters into a single seamless mosaic. Optionally equalises per-image brightness to minimise seam artefacts. Images are listed in priority order (first = highest). Delegates to r.patch for the compositing step.

KEYWORDS

Planetary, Mosaic, mosaic, photometry, composite

SYNOPSIS

p.automos
p.automos --help
p.automos [-eo] input=name[,name,...] output=name [blend_width=integer] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-e
Equalise per-image mean before mosaicking
-o
Overwrite output if it exists
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

input=name[,name,...] [required]
Name of input raster map(s)
output=name [required]
Name for output raster map
blend_width=integer
Blend width in pixels at seams (0=no blend)
Default: 0

Table of contents

DESCRIPTION

p.automos creates a mosaic from multiple input GRASS rasters. For each input raster, the overlap with neighbouring rasters is detected and blended using distance-weighted feathering: pixels near the seam receive a weighted average of the two contributing images, with weights proportional to the distance from the nearest no-data boundary.

Priority ordering for overlapping pixels (when not feathering): nadir (centre-of-image pixels preferred) or latest (last image in the list preferred).

NOTES

All input rasters must be in the same projection and resolution. Use r.proj or p.cam2map to reproject before mosaicking. The computational region is expanded to cover all inputs unless explicitly set.

For very large mosaics (hundreds of images) use the GRASS r.patch + r.mblend pipeline instead.

EXAMPLES

Mosaic three CTX images with feathering:

p.automos input=ctx_001,ctx_002,ctx_003 \
    feather=50 output=ctx_mosaic

Nadir-priority mosaic without blending:

p.automos input=ctx_001,ctx_002,ctx_003 \
    priority=nadir output=ctx_mosaic_nadir

REFERENCES

SEE ALSO

p.cam2map, r.patch, r.proj

AUTHOR

Yann Chemin

SOURCE CODE

Available at: p.automos source code (history)

Accessed: Sunday Nov 15 11:05:54 2026


Main index | Paint index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual