RULES : ------ The permission to use and copy this software and its documentation, without fee or royalty is limited to non-commercial purposes related to PLANCK Surveyor project and provided that you agree to comply with the following copyright notice and statements, and that the same appear on ALL copies of the software and documentation. An appropriate acknowledgement has to be included in any publications based on work where the package has been used. Copyright 1997 by Eric Hivon and Krzysztof M. Gorski. All rights reserved. CONTENTS : -------- this directory contains IDL routines to project data in HEALPIX tesselation, create maps, plot them, and I/O them in FITS format. (symbols : (*) new, (+) recommended, (-) obsolete) README.txt : this file examples/ * coadd_raw_obs.pro : procedure to transform a set of RA,DEC,MEASURE into a HEALPIX signal and N_obs maps (in galactic coordinate) for illustration purpose only * raw_obs.txt : ASCII file used for input of coadd_row_obs.pro fits/ : fits I/O routines * extract_ttype.pro : function to extract the value of the keywords TTYPEi in an extension header fxbread.pro : routine from the IDL ASTRONOMY USER'S LIBRARY corrected from a bug (in versions older than June 98) if needed make sure that this one is used instead of the original one (by setting correctly your !path variable in IDL) (used by mollview) - read_fits_map.pro : procedure to read FITS file images and bintable *+ read_fits_s.pro : procedure to read FITS file images, ascii and bintable using structures as interface, much more flexible than write_fits_map (used by mollview) * sxaddpar.pro : routine from the IDL ASTRONOMY USER'S LIBRARY to write FITS keywords modified to deal with several COMMENT's - write_fits_map.pro : procedure to write bintable in FITS file *+ write_fits_sb.pro : procedure to write images and bintable in FITS file using structures as interface, much more flexible than write_fits_map misc/ : misc. IDL routines toolkit/ : set of routines for conversion to and from HEALPIX *+ ang2pix_nest.pro : procedure to convert (theta,phi) position on the sphere to pixel number for HEALPIX pixelisation and NESTED scheme (previously ang_pix_nest.pro, used by mollview) - ang_pix_nest.pro : obsolete, replaced by ang2pix_nest.pro *+ ang2pix_ring.pro : procedure to convert (theta,phi) position on the sphere to pixel number for HEALPIX pixelisation and RING scheme (previously ang_pix.pro, used by mollview) - ang_pix.pro : obsolete, replaced by ang2pix_ring.pro * init_pix2xy : initialize some arrays necessary to conversion routines * init_xy2pix : initialize some arrays necessary to conversion routines (used by mollview) * nest2ring.pro : procedure to convert NESTED pixel number to RING pixel number * pix2ang_nest.pro : procedure to convert pixel number to (theta,phi) position on the sphere for HEALPIX pixelisation and NESTED scheme *+ pix2ang_ring.pro : procedure to convert pixel number to (theta,phi) position on the sphere for HEALPIX pixelisation and RING scheme (previously pix_ang.pro) - pix_ang.pro : obsolete, replaced by pix2ang_ring.pro * pix2vec_nest.pro : procedure to convert pixel number to vector position on the sphere for HEALPIX pixelisation and NESTED scheme * pix2vec_ring.pro : procedure to convert pixel number to vector position on the sphere for HEALPIX pixelisation and RING scheme * ring2nest.pro : procedure to convert RING pixel number to NESTED pixel number * vec2pix_nest.pro : procedure to convert vector position on the sphere to pixel number for HEALPIX pixelisation and NESTED scheme * vec2pix_ring.pro : procedure to convert vector position on the sphere to pixel number for HEALPIX pixelisation and RING scheme visu/ : visualisation routines mollview.pro : Mollweide projection of the full sky mollcursor.pro : show the latitude, longitude and pixel value on a mollweide map gnomview.pro : Gnomic projection of a part of sky TO GET MORE INFORMATION : ------------------------ See ../html/idl_index.html with your Web brower or type doc_library,'routine name' under IDL FEED BACK : --------- If you have any questions, comments or suggestions regarding this package, please email them to hivon@tac.dk NOTE : ----- It requires the THE IDL ASTRONOMY USER'S LIBRARY that can be found at http://idlastro.gsfc.nasa.gov/homepage.html latest version (jan 99) written for IDL V5.0 or newer a version for IDL 4 can also be found there It requires the COBE Analysis Software http://www.gsfc.nasa.gov/astro/cobe/cgis.html latest version = 4.0, July 1998 Technical note (about colors in IDL) --------------- It has been noted that, on various terminals older versions of mollview could feature an unexpected color table when executed immediately after opening the IDL session (but following runs within the same session are just fine). I don't know of patches working on all terminals for this IDL strange behaviour with respect to colors. Ask you local expert .. update (march 1999) The problem seems to be resolved on current version of mollview, if not, let me know (hivon@tac.dk or efh@astro.caltech.edu) Eric Hivon