Sanchez brings your dull IR satellite images to life.
Utilising a full-colour, high resolution, static ándale underlay image, combining it with a single greyscale IR satellite image, and some serious maths, Sanchez will create beautiful images to be proud of.
This could be considered cheating, but this is the approach that NASA used to utilise for older weather satellites. If it's good enough for NASA, it should be good enough for you.
Sanchez can bring colour to full-disc images, but it can also reproject and blend images from multiple satellites - either creating a flat projected image, or by creating a virtual satellite image at a given longitude.
Full documentation with examples of all options is available in the wiki.
¡Arriba, Arriba! ¡Ándale, Ándale!
Sample images can be found here. If you have interesting images to contribute, let me know!
Releases are available for Raspberry Pi, Linux, Mac OS X and Windows. Head on over and pick your poison!
For Raspberry Pi, pick the ARM build.
-b, --brightness (Default: 1) Brightness adjustment
-d, --tolerance (Default: 30) Time tolerance in minutes in identifying suitable satellite images when combining
-D, --definitions Path to custom satellite definitions
-e, --endtimestamp End timestamp in UTC if stitching multiple files; e.g. 2020-12-20T23:00:30
-i, --interpolation (Default: B) Interpolation type. Valid values are N (nearest neighbour), B (bilinear)
-I, --interval Time interval in minutes between images when stitching
-f, --force (Default: false) Force overwrite existing output file
-L, --noadjustlevels (Default: false) Don't perform histogram equalisation on satellite imagery
-m, --minsatellites Minimum number of satellites in images when stitching
-o, --output Required. Path to output file or folder
-q, --quiet (Default: false) Don't perform console output
-r, --resolution (Default: 4) Output spatial resolution in km; valid values are 2 or 4
-s, --source Required. Path to IR satellite image(s)
-S, --saturation (Default: 0.7) Saturation adjustment
-t, --tint (Default: 1b3f66) Tint to apply to satellite image
-T, --timestamp Target timestamp in UTC if stitching multiple files; e.g. 2020-12-20T23:00:30
-u, --underlay Path to custom full-colour underlay image
-U, --nounderlay If no underlay should be rendered
-v, --verbose (Default: false) Verbose console output
--help Display this help screen.
--version Display version information.
-l, --longitude Target longitude for geostationary satellite projection
-h, --haze (Default: 0.2) Amount of haze to apply to image; valid values are between 0 (no haze) and 1 (full haze)
-a, --autocrop (Default: false) Whether to create an automatically cropped image.
Sanchez automatically identifies target images based on known file prefixes, so to convert multiple images, just specify the input and output folders:
./Sanchez -s "c:\images\Himawari8" -o Output
./Sanchez -s "c:\images\Himawari8\**\Himawari8_FD_VS_20200727T005100Z.jpg" -o Output.jpg"
./Sanchez reproject -s c:\images -o stitched.jpg --mode stitch -T 2020-08-30T03:50:20 -a
./Sanchez reproject -s c:\images -o stitched.jpg --mode stitch -I 60 -a
More examples are available in the wiki.
Sanchez supports any of the following tint formats, with or without the leading #:
#xxx#xxxxxx
Sanchez supports converting single or batch satellite files. If converting a batch, the output argument is assumed to be a folder and is created if needed. Original file names are preserved, with a -fc suffix.
Sanchez supports glob and directory patterns for the --source argument.
Examples are:
images/images/*.*images/*.jpgimages/**/*.*images/2020-*/*IR*.jpg
Note that patterns with wildcards should be quoted with "" on shells that do wildcard expansion (i.e., everything other than Windows).
Detailed logs are written to disk in the logs directory relative to the directory where Sanchez is called from.