toasty tile-wwtl

The tile-wwtl command is like toasty tile-study, but loads up .wwtl WWT “layers” files, from which it can load preexisting astrometric information and convert it to the format needed for its tiled output. The purpose of this specialized command is to enable an easy workflow where you can interactively position a large image file on the sky in the AAS WorldWide Telescope Windows application, then tile it for web viewing while preserving the astrometric alignment.


toasty tile-wwtl
   [standard image-loading options]
   [--outdir DIR]
   [--name NAME]

See the Standard image-loading options section for documentation on those options. Note that options that deal with image processing will process the image contained in the input WWTL file. Other options might not make sense for this command.

The WWTL-PATH argument gives the filename of the input WWTL file. This file should contain one layer, which should be an image-set layer. The WWTL file will include the contents of the associated image as well. The source image should be in a tangential (gnomonic) projection on the sky.

The --outdir DIR option specifies where the output data should be written. If unspecified, the data root will be the current directory.

The --name NAME option specifies the descriptive name for the imagery to be embedded inside the output WTML file. It defaults to “Toasty”.

If the --placeholder-thumbnail argument is given, an all-black placeholder thumbnail will be created. Otherwise, the thumbnail will be created by downsampling the input image. This operation can actually be the most memory-intensive part of the process, and can yield poor results with mostly-empty images. You can avoid this by using this argument and then invoking toasty make-thumbnail with a better-suited input image.