Software Release
CASUTOOLS
CASUTools is a package of several programs that we routinely use on the pipeline processing we carry out at CASU. At the moment it contains the following tools:
- The image object detection and parameterization (imcore, imcore_list and classify)
- The image stacking and dribbling software (imstack, dribble)
- The astrometric fitting software (wcsfit)
- Background filtering to remove large scale structures (nebuliser)
- The software to do the final mosaic of a list of image extensions (mosaic, grout, ungrout)
DOCUMENTATION
The usage of each application is documented in imcore, stacking, wcsfit, nebuliser, mosaic, dribbling, grouting, ungrouting, VST pickup and classify.
Installation
The software has been tested in different Linux distributions, 32 and 64bit, Solaris and OSX. It requires a C compiler to build and recent versions of the CFITSIO and WCSLIB libraries installed in your system. See the README file in the distribution file for instructions on how to build the software. For most of the systems you just need to do
./configure && make && make install
In those cases where the FITSIO and WCSLIB libraries are not in a standard location you will need to specify additional flags to configure as in e.g.
./configure --with-cfitsio=/sw --with-wcs=/sw
DOWNLOAD
Last version is 1.0.41 can be downloaded from here. We just ask for your name and email so that we can inform you about updates or new versions.
CHANGELOG
* 20221202
Tagged as v1.0.41
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.
* 20221014
Tagged as v1.0.40
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.
* 20181127:
Tagged as v1.0.39
cir_getstds.c -- Original vizgaia entry is now vizgaia1. Added
vizgaia2 and vizhsc2
wcsfit_main.c -- added vizgaia2 and vizhsc2. vizgaia is now
vizgaia1
* 20180925:
Tagged as v1.0.38
cir_classify.c -- Fix for when there is no instrument specified
in header
cir_mosaic.c -- Add blocking to output file
mosaic.h
mosaic_main.c
cir_getstds.c -- Fix CASU vizier url and several small bugs
* 20180525:
Tagged as v1.0.37
Modified cir_classify to bring it into line with the toolbox version
be used in wcs fitting.
zeropoints is now optional
Tagged as v1.0.34
Fixed small bug in imcore_overlp.c
* 20150401 Tagged as v1.0.31:
Modified wcsfit.c so that there is now a magnitude cut in the standard star list if there are too many.
* 20140808: Tagged as v1.0.29
Added the nbsize <= 0 option to imcore_list
* 20140731: Tagged as v1.0.28
Fixed imcore so that nbsize <= 0 gives a constant background.
Also fixed long standing problem in imcore_list where the equatorial coordinates in the output catalogue are in degrees rather than radians as advertised
* 20140718: Tagged as v1.0.27
The ell file in imcore_list now places the objects at the original coordinate location rather than in the location where the detection algorithm _thinks_ there might be an object.
wcsfit now checks to see if there are any rows in the input catalogue. If there aren't then we just get a non-fatal error message and moves onto the next extension.
* 20130530: Tagged as v1.0.26
Fixed bug in vstpickup_main.c affecting one of the error messages
Added vstfix
Removed extraneous declaration in casu_wcs.h
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
* 20121208: Tagged as v1.0.24
SUPPORT
For additional support please contact us at ku.ca.mac.tsa@plehusac
FITS to ASCII catalogues
gfortran fitsio_cat_list.f -o fitsio_cat_list -L/sw/lib -lcfitsio -lm
fitsio_cat_list catalogue.fits
It writes a file named catalogue.asc with the following columns: RA and Dec coordinates, x, y, magnitude, magnitude error, chip number, stellar classification, ellipticity and position angle. Additional columns can be added by editing the source code which is available for download at the bottom of this page.
Note that v1.7 onwards now uses double precision arithmetic for the relevant part of the astrometric conversion since the original single precision version limited the external accuracy to up to ~50-100mas, particularly for fields with large RA.
The latest version is v1.10 (20130911).