.TH HAWKI_STEP_DETECT_OBJ "7" "1.8.14" "hawki_step_detect_obj" "hawki recipes"
.SH NAME
hawki_step_detect_obj \- Object detection recipe

.SH SYNOPSIS
esorex
.B hawki_step_detect_obj
[OPTIONS] FILE.sof

.SH DESCRIPTION
hawki_step_detect_obj \-\- hawki detect objects recipe.
.PP
This recipe detects objects from the combined image creating a mask
and a list of object properties
The input of the recipe files listed in the Set Of Frames (sof\-file)
must be tagged as:
combined.fits COMBINED
The recipe creates as an output:
hawki_step_detect_obj_mask.fits (OBJ_MASK): A mask with 1 where the objects are present and 0 elsewhere
hawki_step_detect_obj_stars.fits (OBJ_PARAM): A table with the detected objects characteristics
Return code:
esorex exits with an error code of 0 if the recipe completes successfully
or 1 otherwise

.SH OPTIONS
.TP
\fB\-\-sigma_det\fR \fI<float>\fR
detection level (float; default: 6.0). The full name of this option for the EsoRex configuration
file is \fBhawki.hawki_step_detect_obj.sigma_det\fR [default = \fI6.0\fR].
.TP
\fB\-\-growing_radius\fR \fI<long>\fR
radius of convolution kernel to apply to objects (long; default: 5). The full name of this option for the EsoRex configuration
file is \fBhawki.hawki_step_detect_obj.growing_radius\fR [default = \fI5\fR].

.PP
Note that it is possible to create a configuration file containing these
options, along with suitable default values. Please refer to the details
provided by the 'esorex \-\-help' command.

.SH SEE ALSO
The full documentation for the hawki pipeline can be downloaded as 
a PDF file using the following URL:
.IP
.B ftp://ftp.eso.org/pub/dfs/pipelines/hawki/hawki\-pipeline\-manual\-1.8.14.pdf
.PP
An overview over the existing ESO pipelines can be found on the web page
\fBhttp://www.eso.org/sci/software/pipelines/\fR.
.PP
Basic documentation about the EsoRex program can be found at the esorex (1) 
man page.
.PP
It is possible to call the pipelines from python using the python\-cpl package.
See \fBhttp://packages.python.org/python\-cpl/index.html\fR for further
information.
.PP
The other recipes of the hawki pipeline are
.IR hawki_cal_zpoint (7),
.IR hawki_step_stats (7),
.IR hawki_step_apply_dist (7),
.IR hawki_cal_flat (7),
.IR hawki_util_stdstars (7),
.IR hawki_step_basic_calib (7),
.IR hawki_step_photom_2mass (7),
.IR hawki_cal_dark (7),
.IR hawki_step_compute_bkg (7),
.IR hawki_cal_distortion (7),
.IR hawki_util_gendist (7),
.IR hawki_sci_jitter (7),
.IR hawki_tec_filtchk (7),
.IR hawki_step_subtract_bkg (7),
.IR hawki_step_refine_offsets (7),
.IR hawki_step_stitch (7),
.IR hawki_step_combine (7)

.SH VERSION
hawki_step_detect_obj 1.8.14

.SH AUTHOR
Cesar Enrique Garcia Dabo <usd\-help@eso.org>

.SH BUG REPORTS
Please report any problems to usd\-help@eso.org. Alternatively, you may send a report to the ESO User Support Department <usd\-help@eso.org>.

.SH LICENSE
This file is part of the HAWKI Instrument Pipeline
Copyright (C) 2002,2011 European Southern Observatory

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 
MA 02110\-1301 USA