toasty pipeline approve¶
The approve pipeline command marks one or more images
as ready for publication. It creates the index.wtml file for each image.
Usage¶
toasty pipeline approve [--workdir=WORKDIR] {IMAGE-IDs...}
The IMAGE-IDs argument specifies one or more images by their unique
identifiers. You can specify exact ID’s, or glob patterns as processed by the
Python fnmatch module. See examples below.
The WORKDIR argument optionally specifies the location of the pipeline
workspace directory. The default is the current directory.
Example¶
Before approving an image, it should be validated. First, check the astrometry
with the help of wwtdatatool command. To check a group of images all at once,
it can be convenient to merge the individual image files into a temporary index:
wwtdatatool wtml merge processed/*/index_rel.wtml processed/index_rel.wtml
wwtdatatool preview processed/index_rel.wtml
(Change the forward slashes to backslashes if you’re using Windows.) The first
command merges the individual image WTMLs into a new file,
processed/index_rel.wtml. The second command opens up this combined file in
the WWT webclient, running an internal webserver to make the data available.
Next, get a metadata report and check for any issues:
wwtdatatool wtml report processed/noao0201b/index_rel.wtml
If everything is OK, you can mark the image as approved:
toasty pipeline approve noao0201b
You can use glob patterns to match image names. For instance,
toasty pipeline approve "vla*20" "?vlba"
will match every processed image whose identifier begins with vla and ends
with 20, as well as those whose names are exactly four letters long and end
with vlba. You generally must make sure to encase glob arguments in
quotation marks, as shown above, to prevent your shell from attempting to
process them before Toasty gets a chance to.
After approval of a batch of images, the next step is to toasty pipeline publish.
Notes¶
The specified images must be in the “processed” state. That is, each image ID
specified must correspond to a directory inside the processed subfolder of
the pipeline workspace. After processing, the specified images will be moved to
the “approved” state.
The approval stage will create a index.wtml file in the data directory,
which will derive from the index_rel.wtml file but insert the final absolute
URLs paths to be used by the published data.
