The Duchamp Source Finder

| Background | Duchamp | The Name | Download | Feedback |

Background

A lot of radio astronomy data consist of three dimensions: two representing the position on the sky, and the third representing frequency (or wavelength, or velocity). If one is observing a particular spectral line, objects such as galaxies (if it is HI) or masers (OH, say) will appear as discrete objects in three dimensions, being constrained in spatial position and frequency coverage.

If one is conducting a survey over a reasonably large area of the sky, one will not want to search manually through the data, but instead do so in an automated and repeatable way, with well-defined selection criteria.

| Top |

Duchamp

Duchamp is a solution to this problem of three-dimensional source finding. It has the following features:

Example of the spectral output
Example of the spectral output of Duchamp.

Duchamp does not make assumptions about the shape of the detections -- it does not fit Gaussians or any other function to the detected objects, it simply reports their locations. Note that it has been designed for the case of small numbers of object pixels in a lot of noise (what one would expect for HI or maser surveys). As it keeps track of all detected pixels, it may not perform as efficiently for cubes with a large amount of extended emission, such as millimetre observations of molecular lines. You are welcome to try it however, and feedback is always well received.

| Top |

Why "Duchamp"?

Odd name — where does it come from? I wanted the program to have an interesting name, preferably not an acronym (so many are just too forced and dodgy...). As it is designed for data cubes, I had initially though of Picasso, after the leading cubist, but that had already been taken by Robert Minchin. So I went with Marcel Duchamp, a cubist, dadaist and surrealist artist, who pioneered the art of "readymades", or "found objects".

| Top |

Obtaining Duchamp

Duchamp

Version 1.6.2 of Duchamp is now available [26 September 2017]. It can be downloaded in source format, in a gzipped tar archive. The code will need to be compiled on your local machine: a configure script and a Makefile are provided to make this as easy as possible.

This release contains a number of patches accumulated during ASKAPsoft development, as well as a fix for an error when plotting spectra (with spectralMethod=peak). The sizes of ellipses written to the karma annotation files have also been fixed. For further details of these changes, consult the CHANGES file.

Three external libraries are required (in addition to the standard C/C++ libraries): PGPLOT, CFITSIO and WCSLIB. It is possible to compile Duchamp without having PGPLOT on your system: you just won't get any of the nice useful graphical output. See the README file for complete information on installation of Duchamp.

Downloads available:

Changes from the previous version can be seen here (this file is included in the tar archive), while the archive files and documentation from the previous release versions are here, if you are really interested.

| Top |

Feedback and bug reporting

I'm always keen to hear from people who have used Duchamp, especially if they have comments on the way it works or suggestions as to how it can be improved. I may not have been thinking of your particular application when I wrote it, so if it doesn't do something you think it should, let me know!

There is a mailing list duchamp-user<at>atnf.csiro.au that users of Duchamp can subscribe to. This will be used to announce updates to the code and any other general issues. All messages will be archived here.

Note that you need to be subscribed to send and receive messages from this list:

If you wish to report a bug or a problem, or make a suggestion for new and/or improved features, then go to the Duchamp Trac wiki site. There you can submit a new ticket (computer-speak for a bug report or feature request). You can also view any previous reports -- perhaps your problem has already been reported.

| Top |