Mosaic Toolbox
Several filters of a mosaic, assembled onto one common grid in a single run.
Overview
Assembling a multi-filter mosaic by hand means reprojecting every tile, filter by filter, hoping each run lands on the same grid, then joining the seams one at a time. Mosaic Toolbox does it all in a single pass.
It computes one common astrometric grid from every tile of every filter, reprojects each plate-solved tile onto it, erodes the soft reprojection edges, then joins the tiles photometrically: star flux ratios set the brightness scale, and a smoothed surface spline models the residual gradient.
Because every filter is written onto the same grid, the L, R, G, B, S, H and O outputs share identical coordinates, field of view and pixel dimensions: they combine straight away (ChannelCombination, PixelMath, LRGB, SHO), with no further registration. Autocrop, a screen auto-stretch and a full per-join history are included.
Self-contained: no other mosaic script is required. Inputs must be linear, plate solved and already corrected for gradients. Written by Nicolas Godingen, maintained by Caelo Works. Interface in English and French. Licensed CC BY-NC 4.0 (non-commercial use).
With thanks
Nicolas Godingen
Author of Mosaic Toolbox
Nicolas Godingen wrote Mosaic Toolbox, and the heart of it is his: the common grid, the reprojection, the photometric join and every default that makes an unattended multi-filter assembly come out right. He built it against his own mosaics, and it shows in the details a quicker tool would have skipped. Caelo Works is glad to carry it forward. Thank you, Nico.
Features
One common grid
The astrometric grid is computed from every tile of every filter at once, then each plate-solved tile is reprojected onto it. No more separate per-filter runs each landing on a slightly different grid.
Photometric join
Matched-star flux ratios (identical aperture, identical position) set the brightness scale, then a smoothed surface spline models the residual gradient. A pixel fallback covers a star-poor overlap, and says so.
Every channel aligned
L, R, G, B, S, H and O come out on the same grid, with identical coordinates, field of view and pixel dimensions. They combine straight away (ChannelCombination, PixelMath, LRGB, SHO), with no further registration.
Autocrop and auto-stretch
Autocrop trims to the largest rectangle where all channels hold data everywhere (no empty border, no black corners), computed once for every channel. A screen auto-stretch shows the result instead of a black frame, touching no pixel.
Full per-join history
Each mosaic carries a rebuilt astrometric solution and a full HISTORY of every join: scale factor and star count per channel, sample count, smoothness, taper length, join mode.
Self-contained and bilingual
No dependency: the photometric join engine is the script's own, nothing else to install. Interface in English and French, switched in place from the header (HISTORY entries stay in English).
Screenshots
Install
-
01
Add the CaeloWorks repository
In PixInsight, open Resources → Updates → Manage Repositories and add the CaeloWorks repository URL:
-
02
Check for updates
Run Resources → Updates → Check for Updates and accept: PixInsight downloads and installs the script.
-
03
Restart PixInsight
Relaunch the application: the script shows up in the Script menu. Future updates then arrive automatically.
Once installed, the script shows up under Script → CaeloWorks → Mosaic Toolbox. Requires PixInsight 1.9.4+, Windows, macOS or Linux. Inputs must be linear, plate solved (ImageSolver) and already corrected for gradients. Written by Nicolas Godingen, distributed by Caelo Works under the CC BY-NC 4.0 licence (non-commercial use).
Changelog
-
2.4.0 2026-09-03
First release distributed by Caelo Works. The processing engine (common grid, reprojection, photometry, gradient model, join and per-channel assembly) is Nicolas Godingen's 2.3.1, carried over unchanged, so an assembled mosaic's pixels are identical. The changes are to the interface (a CaeloWorks-styled header, the language selector), the string catalogue, packaging and testing.