[3] | 1 | The Duchamp Source Finder |
---|
| 2 | ------------------------- |
---|
| 3 | |
---|
| 4 | Here's a brief guide to getting Duchamp up and running. |
---|
| 5 | |
---|
| 6 | There is an executable (Duchamp) that has been compiled on a Debian |
---|
| 7 | Linux kernel 2.6.8-2-686, with gcc version 3.3.5 (Debian 1:3.3.5-13) |
---|
| 8 | |
---|
| 9 | If that is no good to you, you can compile it yourself using the |
---|
| 10 | Makefile included in this directory (sorry for not having a configure |
---|
| 11 | script or similar yet!). |
---|
| 12 | |
---|
| 13 | Duchamp uses three main external libraries: pgplot, cfitsio and |
---|
| 14 | wcslib. You will need to set the paths for the base directory and |
---|
| 15 | three libraries, as they are currently configured for my use and will |
---|
| 16 | not be of much use to you! These are: |
---|
| 17 | |
---|
| 18 | BASE --> the current directory |
---|
| 19 | PGDIR --> where the pgplot libraries (and header files) are located |
---|
| 20 | CFITSIODIR --> where the header file fitsio.h is |
---|
| 21 | CFITSIOLDIR --> where the cfitsio library is located (libcfitsio.a) |
---|
| 22 | WCSDIR --> where the wcslib header files are |
---|
| 23 | WCSLDIR --> where the wcslib library is located (libwcs.a) |
---|
| 24 | |
---|
[8] | 25 | If you do not have the libraries, they can be downloaded from the |
---|
| 26 | following locations: |
---|
| 27 | PGPlot -- http://www.astro.caltech.edu/~tjp/pgplot/ |
---|
| 28 | cfitsio -- http://heasarc.gsfc.nasa.gov/docs/software/fitsio/fitsio.html |
---|
| 29 | wcslib -- http://www.atnf.csiro.au/people/Mark.Calabretta/WCS/index.html |
---|
| 30 | |
---|
| 31 | Once you've set up the Makefile correctly, then simply typing |
---|
[3] | 32 | > make duchamp |
---|
| 33 | will compile the program. |
---|
| 34 | |
---|
| 35 | To run it, you need to use the syntax |
---|
| 36 | > Duchamp -p parameterFile |
---|
| 37 | where parameterFile is a file with the input parameters, including the |
---|
| 38 | name of the cube you want to search. |
---|
| 39 | |
---|
| 40 | There are two example input files included with the distribution. The |
---|
| 41 | smaller one, InputExample, shows the typical parameters one might want |
---|
| 42 | to set. The large one, InputComplete, lists all parameters that can be |
---|
| 43 | entered, and a brief description of them. Refer to the documentation |
---|
| 44 | for further details. |
---|
| 45 | |
---|
| 46 | To get going quickly, just replace the "your-file-here" in |
---|
| 47 | InputExample with your image name, and type |
---|
| 48 | > Duchamp -p InputExample |
---|
| 49 | and you're off! |
---|
| 50 | |
---|
| 51 | Any questions, please contact me! |
---|
| 52 | |
---|
| 53 | Matthew Whiting |
---|
| 54 | March 2006 |
---|
| 55 | Matthew.Whiting@csiro.au |
---|
| 56 | |
---|