check-avm command checks whether an image file contains AVM (Astronomy
Visualization Metadata) tags in its metadata. AVM metadata often include
spatial positioning data that specify how an astronomical image maps onto the
sky, similar to WCS headers in FITS files.
toasty check-avm [--print] [-p] [--exitcode] IMAGE-PATH
IMAGE-PATH argument gives the filesystem path of an image to check. This
should typically be an RGB bitmap image such as a JPEG, PNG, or TIFF file. The
tool will try to load AVM data from the file and report whether it is
By default, the presence of AVM data is reported along with some information
about the agreement between the AVM and the image shape. If the
-p option is given, the actual AVM data will be dumped out.
--exitcode option is given, the exit code of the command line tool
will reflect whether spatial AVM data were found. Zero (success) means that
spatial data were found, while nonzero (failure) indicates that no data were
present, the data were corrupt, or that some other failure occurred. Without
this option, the exit code will be zero if the image can be opened but contains
no AVM data.
This functionality requires that the pyavm Python package has been installed.