hpx2dm

This IDL facility provides a means to turn a HEALPix data set into a DomeMaster compliant image (azimuthal equidistant projection of the half-sphere in a PNG or lossless JPEG file) that can be projected on a planetarium. See eg http://fulldome.ryanwyatt.net/fulldome_domemasterSpec_v05.pdf

Location in HEALPix directory tree: src/idl/visu/hpx2dm.pro 

FORMAT

IDL> hpx2dm, File, [ Select, ] [ /HELP, JPEG=, PNG=, PREVIEW=, PXSIZE=, + most of azeqview keywords$\ldots$ ]

QUALIFIERS

File

Required name of a FITS file containing the HEALPix map in an extension or in the image field, or name of an online variable (either array or structure) containing the HEALPix map (See note below); if Save is set : name of an IDL saveset file containing the HEALPix map stored under the variable data (default : none)

Select

Optional column of the BIN FITS table to be plotted, can be either – a name : value given in TTYPEi of the FITS file NOT case sensitive and can be truncated, (only letters, digits and underscore are valid) – an integer : number i of the column containing the data, starting with 1 (also valid if File is an online array) default:1 for full sky maps, 'SIGNAL' column for FITS files containing cut sky maps

KEYWORDS

JPEG=

name of the output lossless JPEG file

PNG=

name of the output PNG file

/PREVIEW

if set, the output JPEG or PNG file will be previewed

/HELP

Prints out the documentation header

PXSIZE=

number of pixels in each dimension of the square output image

/ASINH,

COLT=, COORD=, FACTOR=, /FLIP, HBOUND=,

/HIST_EQUAL, /LOG, MAX=, MIN=, /NESTED, OFFSET=,

/QUADCUBE, ROT=, SAVE=, /SILENT,

TRUECOLORS=

those keywords have the same meaning as in azeqview and mollview

DESCRIPTION

hpx2dm reads in a HEALPix sky map in FITS format or from a memory array and generates a PNG or JPEG file containing a DomeMaster compliant map (azimuthal equidistant projection of the half-sky).

RELATED ROUTINES

This section lists the routines related to hpx2dm

azeqview

performs Azimuthal Equidistant projection required by hpx2dm.

hpx2gs

turns Healpix maps into GoogleEarth, GoogleSky or Oculus VR compatible images