----------------------------------------------------------------------- The Duchamp Source Finder ----------------------------------------------------------------------- Duchamp 1.1.1 -- an object finder for spectral-line data cubes Copyright (C) 2006, Matthew Whiting, ATNF Duchamp 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. Duchamp 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. You should have received a copy of the GNU General Public License along with Duchamp; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA Correspondence concerning Duchamp may be directed to: Internet email: Matthew.Whiting [at] atnf.csiro.au Postal address: Dr. Matthew Whiting Australia Telescope National Facility, CSIRO PO Box 76 Epping NSW 1710 AUSTRALIA ----------------------------------------------------------------------- Introduction ============ Duchamp is a stand-alone program designed to find objects in astronomical data cubes, particularly spectral-line observations. Its features include a wavelet-based reconstruction technique for reducing the noise in the cube (and thereby enhancing detectability of sources), easy-to-use text-based interface, flexibility to control all relevant parameters such as detection thresholds, and a useful range of text- and graphics-based output. Duchamp works on any FITS image using the CFITSIO package, and uses Mark Calabretta's WCSLIB library to provide accurate position and velocity information for all detected sources. Obtaining and Building Duchamp ============================== The Duchamp web page is at http://www.atnf.csiro.au/people/Matthew.Whiting/Duchamp where you can download a gzipped tar archive of the source code. Duchamp uses three main external libraries: pgplot (although see note below), cfitsio (version 2.5 and greater, version 3+ preferred) and wcslib. If you do not have the libraries, they can be downloaded from the following locations: PGPLOT -- http://www.astro.caltech.edu/~tjp/pgplot/ cfitsio -- http://heasarc.gsfc.nasa.gov/docs/software/fitsio/fitsio.html wcslib -- http://www.atnf.csiro.au/people/Mark.Calabretta/WCS/index.html Note that PGPLOT is optional. Duchamp can be compiled and run without PGPLOT, but you will miss out on the useful graphical outputs! The other two libraries, cftisio and wcslib, are essential. Basic Compilation and Installation ---------------------------------- Duchamp can be built and installed on Unix systems by typing (note that the terminal prompt here is represented by > -- don't type this character!): > ./configure > make > make clean (optional -- to remove the object files from the src directory) > make install This default setup will search in standard locations for the necessary libraries, and install the executable ("Duchamp") in /usr/local/bin (a copy will also be in the current directory). If you want this to go somewhere else, eg if you don't have write-access to that directory, or you need to tweak the libraries, see the next section. Otherwise, jump to the testing section. Tweaking the installation setup ------------------------------- To install Duchamp in a directory other than /usr/local/bin, use the --prefix option with configure. eg: > ./configure --prefix=/home/mduchamp/bin If the above-mentioned libraries have been installed in non-standard locations, or you have more than one version installed on your system, you can specify specific locations by using the --with-cfitsio=