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

Version 3.82, 2022-07-28