S2FIL PACKAGE
                 Optimal filtering on the sphere
  ---------------------------------------------------------------

DESCRIPTION 
     This package provides functionality to support optimal filtering
     on the sphere. Optimal directional matched filters (MF) and scale
     adaptive filters (SAF) may be constructed from a template and
     stochastic background process. Functionality is incorporated also
     to filter a sky data map using an optimal filter and to detect
     compact objects using a naive thresholding strategy.

VERSION
     Release 1.1

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

ACKNOWLEDGEMENTS
     M. P. Hobson

REFERENCE
     If you use the code to produce published works please reference
     the download site http://www.jasonmcewen.org/codes.html and our
     related paper:

       J. D. McEwen, M. P. Hobson, and A. N. Lasenby. Optimal filters
       on the sphere. IEEE Trans. Sig. Proc., 56(8), 3813-3823, 2008
       (astro-ph/0612688).

       J. D. McEwen, S. M. Feeney, M. C. Johnson, and
       H. V. Peiris. Optimal filters for detecting cosmic bubble
       collisions. Phys. Rev. D., 85(10):103502, 2012
       (arXiv:1202.2861).

DOCUMENTATION
     See doc/index.html

REQUIREMENTS
     FastCSWT (http://www.jasonmcewen.org/codes.html)
     COMB (http://www.jasonmcewen.org/codes.html)
     S2 (http://www.jasonmcewen.org/codes.html)
     HEALPix (http://healpix.jpl.nasa.gov/)
     CFITSIO (http://heasarc.gsfc.nasa.gov/docs/software/fitsio/)
     FFTW 2.1.5 (http://www.fftw.org/)

INSTALLATION
     See doc/index.html

DOWNLOAD
     http://www.jasonmcewen.org/codes.html     
     Data files at:
       http://www.mrao.cam.ac.uk/~jdm57/data/s2fil-1.0-data.tar.gz

SUPPORT
     Contact Jason McEwen

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

LICENSE
     S2FIL package to provide functionality for optimal filtering 
     on the sphere
     Copyright (C) 2005  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.