.\" Automatically generated by Pod::Man version 1.02 .\" Tue Jan 27 15:36:07 2004 .\" .\" Standard preamble: .\" ====================================================================== .de Sh \" Subsection heading .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Ip \" List item .br .ie \\n(.$>=3 .ne \\$3 .el .ne 3 .IP "\\$1" \\$2 .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. | will give a .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used .\" to do unbreakable dashes and therefore won't be available. \*(C` and .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<> .tr \(*W-|\(bv\*(Tr .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` ` . ds C' ' 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" If the F register is turned on, we'll generate index entries on stderr .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and .\" index entries marked with X<> in POD. Of course, you'll have to process .\" the output yourself in some meaningful fashion. .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" . . . nr % 0 . rr F .\} .\" .\" For nroff, turn off justification. Always turn off hyphenation; it .\" makes way too many mistakes in technical documents. .hy 0 .if n .na .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. .bd B 3 . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ====================================================================== .\" .IX Title "IMCORE_LIST 1" .TH IMCORE_LIST 1 "January 2004" "0.2" "CASU" .UC .SH "NAME" imcore_list \- list driven photometry package .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBimcore_list\fR \fIinputfile\fR \fIconfmap\fR \fIlistfile\fR \fItransfile\fR \fIaperture\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBimcore_list\fR performs aperture photometry on the \s-1FITS\s0 image \&\fIinputfile\fR, optionally using a confidence map \fIconfmap\fR. If no confidence map is to be used, \fIconfmap\fR should be specified as \&\f(CW\*(C`noconf\*(C'\fR. The list of coordinates to drive the photometry is taken from the catalogue specified in \fIlistfile\fR subject to one of several options specified in \fItransfile\fR. The catalogue may be given either as a \s-1FITS\s0 binary table in standard \s-1CASU\s0 format, or as an ascii \s-1RA\s0,Dec list. .PP The output is a \s-1FITS\s0 binary table catalogue, in \fBexactly\fR the same order as the input catalogue, in standard \s-1CASU\s0 catalogue format. The name of the output catalogue is derived from the \fIinputfile\fR rootname and will be of the generic form \fIfilename_list.fits\fR. Pre-existing catalogue files with this name will be automatically clobbered. In addition to the photometry, for compatibliy with normal \s-1CASU\s0 catalogues and for more general purpose use, the standard \s-1CASU\s0 parameter set for position and shape information is also derived, but is only based on the flux distribution in the default aperture specified on the command line. .PP Repeat runs using different \fIinputfile\fRs will generate identically ordered catalogues which can, for example, form the basis for matched lists of derived photometry for all processed files. Example uses would be for doing lightcurve analysis for temporal variablity studies or for matched multicolour aperture photometry analysis. .PP Single or multi-extension input \s-1FITS\s0 images may be processed. If the source catalogue is a \s-1FITS\s0 binary table the number of extensions must match those of the input image. If the target position is close to the edge of the detector (within the aperture radius) or not on the detector, zero flux is returned. Positions are mapped using either \s-1WCS\s0 information or using an X-Y transformation matrix specified in \fItransfile\fR. The latter option being more suited to accurate temporal lightcurve analysis of multiple repeat observations of the same field. .PP For each extension processed, a regions file for the \s-1DS9\s0 image display tool is produced (these can be loaded from \f(CW\*(C`Load regions\*(C'\fR in the \f(CW\*(C`Regions\*(C'\fR menu), containing commands to plot an ellipse (default circular aperture in this case) for each of the sources in the input catalogue list. These files are named by appending \&\fI_n_list.ell\fR to the filename of the input image (after removing any \&\fI.fit\fR extension), where \fIn\fR is the number of the corresponding extension in the output catalogue file (numbered from 1). .PP Background analysis and estimation is performed in the same manner as used for the \s-1CASU\s0 standard catalogue generation package and is used to track and effectively remove background variations on the scale of 64 pixels (default). For each valid target position a fixed aperture of radius \fIaperture\fR is overlaid on the image and the background-corrected flux summed over the region. Proportionating the flux across boundary pixels compensates for pixel edge effects and follows essentially the same procedure used in the standard \s-1CASU\s0 catalogue generator. The remaining flux parameters are estimated in the same way and position, shape parameters are derived as indicated above. .SH "OPTIONS" .IX Header "OPTIONS" The following command-line arguments are supported: .Ip "\fIinputfile\fR" 4 .IX Item "inputfile" Standard \s-1FITS\s0 images either single or multiextension are supported. .Ip "\fIconfmap\fR" 4 .IX Item "confmap" Uses the confidence map from \fIconfmap\fR in the analysis. If a filename of \fInoconf\fR is specified no confidence map is used in the analysis. .Ip "\fIlistfile\fR" 4 .IX Item "listfile" This file can either be a standard \s-1CASU\s0 \s-1FITS\s0 binary catalogue table or an external ascii list of Ra,Dec (J2000 only), with one entry per line in sexagesimal format (eg. \s-1HH\s0 \s-1MM\s0 \s-1SS\s0 \s-1DD\s0 \s-1MM\s0 \s-1SS\s0 ..........). (A later additional supported format will be to allow object positions to be taken from a standard \s-1CASU\s0 merge file as output by \fIfitsio_merge\fR.) .Ip "\fItransfile\fR" 4 .IX Item "transfile" There are 3 options for this argument: \fIuse=wcs\fR implies take the binary catalogue table \s-1WCS\s0 to generate positions; \fIuse=radeclist\fR implies that the file \fIlistfile\fR is an ascii \s-1RA\s0,Dec list and the positions are to be taken directly from it; \fItransfile\fR alternatively an X-Y transformation matrix may be provided to directly map the target list using a more accurate pixel coordinate transformation (this can be generated automatically using \&\fIfitsio_merge\fR). .Ip "\fIaperture\fR" 4 .IX Item "aperture" The radius of the aperture to be used for the photometry. Each object in the list is currently processed independently if it derives from an external \s-1RA\s0,Dec list, or is processed in groups in the original blend pattern embedded in the binary catalogue file. .SH "EXAMPLES" .IX Header "EXAMPLES" Build up a series of light curve anaylsis files by repeatedly running on a time series of images using the same master list, use fixed default apertures of radius 3 pixels, and use pixel coordinate mapping. .PP .Vb 4 \& imcore_list image001.fit noconf master_cat.fits image001.trans 3.0 \& imcore_list image002.fit noconf master_cat.fits image002.trans 3.0 \& ................................................................... \& imcore_list image320.fit noconf master_cat.fits image320.trans 3.0 .Ve Use an Ra,Dec list derived from eg. radio sources to lay down fixed size apertures and estimate the flux at the expected positions of the radio sources. .PP .Vb 1 \& imcore_list r12345.fit I_conf.fits radiolist use=radeclist 5.0 .Ve Analyse the J and H images using the K catalogue detection file .PP .Vb 2 \& imcore_list J_today.fit J_conf.fits K_today_cat.fits use=wcs 3.5 \& imcore_list H_today.fit H_conf.fits K_today_cat.fits use=wcs 3.5 .Ve .SH "AUTHOR" .IX Header "AUTHOR" Mike Irwin (mike@ast.cam.ac.uk)