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 | |
---|
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 |
---|
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 | |
---|