----------------------------------------------------------------
README
	IAS Stacking Library, in IDL

----------------------------------------------------------------
Released Version:
	18-Dec-2009 v1

----------------------------------------------------------------
Previous Versions
	 None so far

----------------------------------------------------------------
Full name and homepage:
	Institut d'Astrophysique Spatiale IAS Stacking Library
	http://www.ias.u-psud.fr/irgalaxies/

----------------------------------------------------------------
Authors (alphabetical order):
	Nicolas Bavouzet, Alexandre Beelen, Matthieu Bethermin,
	Herve Dole, Nicolas Ponthieu.

----------------------------------------------------------------
Licence:
        This software is distributed freely under the GPL
        licence. Read the GPL.txt file. 

----------------------------------------------------------------
Support:
        Matthieu Bethermin, Alexandre Beelen, Herve Dole. 

----------------------------------------------------------------
Summary:
	This IDL library is designed to be used on astronomical
	images. Its main aim is to stack data to allow a statistical
	detection of faint signal, using a prior.  For instance, you
	can stack 160um data using the positions of galaxies detected
	at 24um or 3.6um, or use WMAP sources to stack Planck data.
	It can estimate error bars using bootstrap, and it can perform
	photometry (aperture photometry, or PSF fitting, or other that
	you can plug).

	The IAS Stacking Library works with gnomonic projections
	(RA---TAN), but also with HEALPIX projection.

	The library has been widely used on Spitzer infrared data
	(Dole et al., 2006, A&A, 451, 417; Bavouzet et al., 2008 A&A,
	479, 83; Bethermin et al., 2010, A&A, subm; Jauzac et al.,
	2010, in prep), as well as on submm data (LABOCA, Beelen et
	al., 2010, in prep) and on pre-launch simulations of Planck &
	Herschel data (Fernandez-Conde et al., 2008, A&A, 481, 885,
	Fernandez-Conde, 2010, A&A, in press).

----------------------------------------------------------------
Requirements:
	- IDL 7.0 or later
	- IDL astron library
	- HEALPIX library (>=2.12) is mandatory for Healpix capabilities, but optional otherwise
	- Data in FITS file, with headers having WCS information
	- Data using Gnomonic Projection, such as RA---TAN, or Healpix

----------------------------------------------------------------
Content:
	GPL.txt
	README
	check/	
	data2gnom_stack.pro
	dostack_header.pro
	dostack_healpix.pro
	dostack_wcs.pro
	dostack_xy.pro
	fullstack_healpix.pro
	fullstack_xy.pro
	gnomview_stack.pro
	load_std_aper_param_stacking.pro
	stacking_bootstrap.pro
	stacking_photometry.pro
	test_stacking_ias_library.pro

----------------------------------------------------------------
Quick Startup Guide

Starting the test procedure:
	test_stacking_ias_library.pro

Quick start:
        fullstack_xy.pro for gnomonic data
        fullstack_healpix.pro for Healpix data

Programming your own stacking:
	- read FITS image to stack: map and header
	- load x, y (arrays) locations to stack (has to be in image pixel coordinates; use XY2AD and AD2XY to convert from another image)
	- DOSTACK_XY, image, x, y, stacked_output_image
	- for more options, read the program header documentation


----------------------------------------------------------------
Tarball for public resease:
cd ..
tar -cvzf ias_stacking_lib.tgz stacking/*.pro stacking/check/*fits stacking/check/*save stacking/check/*txt stacking/README stacking/GPL.txt

END