Command line programs for source extraction, stacking, astrometric fitting and mosaicking of astronomical images, as used in the CASU pipelines.
CASUTools is a set of command line programs for processing astronomical imaging data. The Cambridge Astronomy Survey Unit (CASU) uses them in its pipeline processing of survey data. The package is still downloaded by research groups around the world, and every version CASU published that is still available is kept on this page.
The package contains these programs:
- object detection and parameterisation: imcore, imcore_list and classify
- image stacking and dribbling: imstack and dribble
- astrometric fitting: wcsfit
- background filtering, to remove large scale structure: nebuliser
- the final mosaic of a list of image extensions: mosaic, grout and ungrout
- removal of pickup noise from VST images: vstpickup
The use of each program is described in the documentation pages listed below. The source files carry the copyright notice of the Cambridge Astronomy Survey Unit.
Installation
The software has been tested on several Linux distributions (32 and 64 bit), on Solaris and on macOS. It needs a C compiler and recent versions of the CFITSIO and WCSLIB libraries. For most systems the build is the usual sequence of configure, make and make install. If CFITSIO and WCSLIB are not in a standard location, give their paths to configure.
tar xzf casutools-1.0.42.tar.gz
cd casutools-1.0.42
./configure --with-cfitsio=/usr/local --with-wcs=/usr/local
make
make installWithout the --prefix option the programs are installed in a bin directory at the top of the distribution tree, and you then need to add that directory to your PATH. The README file in the archive describes the build in more detail. Each download below shows a SHA-256 checksum, which you can compare with the output of sha256sum after downloading.
Support
For questions about the software write to casuhelp@ast.cam.ac.uk.
Key features
Source extraction
imcore and imcore_list detect and parameterise objects, with an optional confidence map. classify assigns a morphological class to every object.
Stacking and mosaicking
imstack, dribble and mosaic combine exposures onto a common grid using the WCS in the image headers and their confidence maps.
Astrometric fitting
wcsfit matches the objects of a catalogue to astrometric standards such as 2MASS and Gaia and fits the astrometric solution.
Background filtering
nebuliser removes medium and large scale variations in the background, which helps source detection in nebulous fields.
VISTA and VST tools
grout and ungrout correct catalogues made from VISTA tiles. vstpickup removes pickup noise from VST images.
Plain build
A standard autotools build with no dependencies beyond CFITSIO and WCSLIB.
Releases
Version 1.0.42
Latest 2 September 2024- Added RPATH to CFITSIO and WCS linker flags
- Hardwired site for Vizier to CDS
- Fixed printf() format string issues and erroneuous uses of abs() where fabs() was intended
- Configure now checks for a specific CFITSIO version so the macro is used correctly
- Hard wired use of gcc for multiarch use
Previous versions (22)
Version 1.0.41
2 December 2022- Bug fix release to correct the use of extern in imcore.h, this is now an error by default in the latest GCC 10. Older compilers would convert this into a common block, which can still be done by passing -fcommon to the compiler to restore the old behaviour.
Version 1.0.40
14 October 2022- Overhauled configure for CFITSIO 4.x, which now depends on zlib and sometimes also libcurl if it was found by the CFITSIO configure script. Improved the wcslib search and fixed issues with finding libcfitsio and wcslib on Debian multiarch systems.
- Fixed off-by-one error in catsearch for local 2MASS/USNOB catalogues. This could cause a row to get left off the search results in cases where the last row was within the search box.
- Fixed segfault for cattype=1 and 2 when nbit=0.
Version 1.0.36
8 November 2017- Modified cir_getstds.c and wcsfit_main.c to allow Gaia data to be used in wcs fitting.
- A few superficial fixes
Version 1.0.35
25 April 2017- Modified mosaic so that scaling the background by the photometric zeropoints is now optional
- Fixed a number of compiler warnings.
Version 1.0.34
14 November 2016- Fixed small bug in imcore_overlp.c
Version 1.0.33
2 March 2016- Fixed missing include. Modified imcore routines and wcsfit routines so that RA and Dec columns are now doubles and in degrees
Version 1.0.30
3 November 2014- Modified wcsfit.c so that there is now a magnitude cut in the standard star list if there are too many.
Version 1.0.25
7 February 2013- Fixed bug in the projection part of the WCS routines in cir_imstack_cat.c and cir_mosaic.c which was caused by crpix being exact integers
Version 1.0.24
8 December 2012- Fixed cir_classify so that it traps for WFCAM data and modifies the moffat profile exponent. Also fixed grout and ungrout so that you can't accidently repeat the procedure
- Added vstpickup
Version 1.0.23
1 October 2012- Fixed bug in cir_mosaic affecting zeropoint.
- Fixed duplicate column names in imcore create_table_1.c
Version 1.0.22
4 September 2012- Fixed nebuliser so that any tables in the input FITS file just get copied to the output file. Also stole some code from ESO so that the autoconf now checks whether cfitsio has been configured for threads.
- Fixed a bug in some of the sort routines
- Fixed a bug in imcore_main that causes the routine to barf if the output file doesn't have a filename extension (eg .fit).
- Fixed outloc in cir_imstack_cat and cir_mosaic so that the zpn is calculated correctly. Added PPMXL to list of astrometric catalogues in wcsfit.
- Fixed small memory leak in mosaic
Version 1.0.21
Version 1.0.19
Version 1.0.18
Version 1.0.15
Version 1.0.13
Version 1.0.11
Version 1.0.9
Version 1.0.8
Version 1.0.7
Version 1.0.6
Version 1.0.5
Extra information
Technical details that support the paper: data formats, module interfaces, scientific methods and operations.
imcore: source extraction
Detects and parameterises objects in FITS images and writes source catalogues (imcore and imcore_list).
imstack: image stacking
Stacks a set of FITS images onto a common grid using the WCS in their headers and their confidence maps.
wcsfit: WCS fitting
Matches the objects of a catalogue to astrometric standards and fits the astrometric solution.
nebuliser: background filtering
Removes medium and large scale variations in the background of an image.
mosaic: image mosaicking
Combines a list of images and their confidence maps into one output tile.
dribble: dribbling
Smooths the point spread function of interleaved WFCAM data.
grout and ungrout
Corrects catalogues made from VISTA tiles for the variation of the point spread function and zero point between the images of the tile.
vstpickup: pickup noise removal
Removes pickup noise from individual VST images.
classify: object classification
Re-runs the classification and the header statistics of an imcore catalogue.
fitsio_cat_list: FITS to ASCII catalogues
Converts imcore catalogues to ASCII, applying all corrections. Fortran source.
Changelog
The history of CASUTools versions and the changes made in each.