S2 PACKAGE
        Object oriented wrapper for functions on the sphere       
  ---------------------------------------------------------------

DESCRIPTION
     The s2 package contains functionality to support functions
     defined on the sky/sphere and was developed primarily for 
     astrophysical applications. Both real space map and harmonic
     space spherical harmonic representations are supported. 
     Basic sky representations have been extended to simulate full sky
     noise distributions and Gaussian cosmic microwave background
     realisations.  Support for the representation and convolution of
     beams is also provided.  A HEALPix spherical pixelisation scheme
     is adopted, although this may be extended in the future to
     support other pixelisations of the sphere.

VERSION
     Release 1.1

AUTHORS
     J. D. McEwen  (http://www.jasonmcewen.org)

ACKNOWLEDGEMENTS
     D. J. Mortlock
     S. M. Feeney

REFERENCE
     The s2 package was written originally for the development of fast
     continuous wavelet transform algorithms on the sphere but has
     since evolved to provide much additional functionality.  
     If you use the code to produce published works please reference
     the download site http://www.mrao.cam.ac.uk/~jdm57/ and our
     related paper:      
       J. D. McEwen, M. P. Hobson, D. J. Mortlock, and A. N. Lasenby. 
       Fast directional continuous spherical wavelet transform
       algorithms.  IEEE Trans. Sig. Proc., 55(2):520-529,
       2007 (astro-ph/0506308).

DOCUMENTATION
     See doc/index.html

REQUIREMENTS
     HEALPix (http://healpix.jpl.nasa.gov/)
     CFITSIO (http://heasarc.gsfc.nasa.gov/docs/software/fitsio/)

INSTALLATION
     See doc/index.html

DOWNLOAD
     http://www.jasonmcewen.org/codes.html

SUPPORT
     Contact Jason McEwen (http://www.jasonmcewen.org)

NOTE
     The package is still under development
     Please report problems/bugs by email to Jason McEwen

LICENSE
     s2 package to provide object oriented functionality for
     functions on the sky/sphere
     Copyright (C) 2008  Jason McEwen

     This program is free software; you can redistribute it and/or
     modify it under the terms of the GNU General Public License
     as published by the Free Software Foundation; either version 2
     of the License, or (at your option) any later version.

     This program is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details (LICENSE.txt).

     You should have received a copy of the GNU General Public License
     along with this program; if not, write to the Free Software
     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 
     MA  02110-1301, USA.