Provided by: cpl-plugin-hawki-doc_2.4.6+dfsg-1build1_all 
NAME
hawki_science_postprocess - HAWKI post processing recipe
SYNOPSIS
esorex hawki_science_postprocess [OPTIONS] FILE.sof
DESCRIPTION
hawki_science_postprocess -- HAWKI science post processing recipe.
Postprocess a stacked pawprint for HAWKI data. Form a filled tile and photometrically and
astrometrically calibrate the tiled image Optionally nebulise the stacked images before
source detection
The program accepts the following files in the SOF:
Tag Description
BASIC_CALIBRATED_SCI A set of processed images from a jitter sequence
BASIC_VAR_MAP A variance map for each sequence image
MASTER_CONF A master confidence map for the jitter sequence
PHOTCAL_TAB A photometric calibration table
MASTER_2MASS_CATALOGUE_ASTROM A master 2MASS index for astrometry or
MASTER_PPMXL_CATALOGUE_ASTROM A master PPMXL index for astrometry or
MASTER_LOCAL_CATALOGUE_ASTROM A master local astrometric FITS file
MASTER_2MASS_CATALOGUE_PHOTOM A master 2MASS index for photometry or
MASTER_PPMXL_CATALOGUE_PHOTOM A master PPMXL index photometry or
MASTER_LOCAL_CATALOGUE_PHOTOM A master local photometric FITS file
MATCHSTD_PHOTOM A master photometric matched stds catalogue (optional)
SCHLEGEL_MAP_NORTH Northern Schlegel Map
SCHLEGEL_MAP_SOUTH Southern Schlegel Map All of the above are required unless
specified otherwise. The astrometricand photometric files are not required if these can be
obtained fromthe CDS using the --cdssearch options
OPTIONS
--nebulise <bool>
Nebulise the stacks before object detection? (bool; default: False). The full name
of this option for the EsoRex configuration file is
hawki.hawki_science_postprocess.nebulise [default = False].
--minphotom <int>
Minimum number of stars for photometry solution (int; default: 20). The full name
of this option for the EsoRex configuration file is
hawki.hawki_science_postprocess.minphotom [default = 20].
--prettynames <bool>
Use pretty product names? (bool; default: False). The full name of this option for
the EsoRex configuration file is hawki.hawki_science_postprocess.prettynames
[default = False].
--cdssearch_astrom <str>
CDS astrometric catalogue (str; default: ´none´). The full name of this option for
the EsoRex configuration file is hawki.hawki_science_postprocess.cdssearch_astrom
[default = none].
--cdssearch_photom <str>
CDS photometric catalogue (str; default: ´none´). The full name of this option for
the EsoRex configuration file is hawki.hawki_science_postprocess.cdssearch_photom
[default = none].
--stk_fast <str>
Use fast stacking? (str; default: ´auto´). The full name of this option for the
EsoRex configuration file is hawki.hawki_science_postprocess.stk_fast [default =
auto].
--stk_nfst <int>
Nframes before we switch to slow stack algorithm (int; default: 30). The full name
of this option for the EsoRex configuration file is
hawki.hawki_science_postprocess.stk_nfst [default = 30].
--savemstd <bool>
Save matched standard catalogues? (bool; default: False). The full name of this
option for the EsoRex configuration file is
hawki.hawki_science_postprocess.savemstd [default = False].
--neb_medfilt <int>
Median filter size for nebuliser (int; default: 101). The full name of this option
for the EsoRex configuration file is hawki.hawki_science_postprocess.neb_medfilt
[default = 101].
--neb_linfilt <int>
Linear filter size for nebuliser (int; default: 33). The full name of this option
for the EsoRex configuration file is hawki.hawki_science_postprocess.neb_linfilt
[default = 33].
--cat_ipix <int>
Minimum pixel area for each detected object (int; default: 4). The full name of
this option for the EsoRex configuration file is
hawki.hawki_science_postprocess.cat_ipix [default = 4].
--cat_thresh <float>
Detection threshold in sigma above sky (float; default: 2.5). The full name of this
option for the EsoRex configuration file is
hawki.hawki_science_postprocess.cat_thresh [default = 2.5].
--cat_icrowd <bool>
Use deblending? (bool; default: True). The full name of this option for the EsoRex
configuration file is hawki.hawki_science_postprocess.cat_icrowd [default = True].
--cat_rcore <float>
Value of Rcore in pixels (float; default: 10.0). The full name of this option for
the EsoRex configuration file is hawki.hawki_science_postprocess.cat_rcore [default
= 10.0].
--cat_nbsize <int>
Background smoothing box size (int; default: 64). The full name of this option for
the EsoRex configuration file is hawki.hawki_science_postprocess.cat_nbsize
[default = 64].
--cacheloc <str>
Location for standard star cache (str; default: ´.´). The full name of this option
for the EsoRex configuration file is hawki.hawki_science_postprocess.cacheloc
[default = .].
--magerrcut <float>
Cut in magnitude error (float; default: 100.0). The full name of this option for
the EsoRex configuration file is hawki.hawki_science_postprocess.magerrcut [default
= 100.0].
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.
SEE ALSO
The full documentation for the hawki pipeline can be downloaded as a PDF file using the
following URL:
ftp://ftp.eso.org/pub/dfs/pipelines/hawki/hawki-pipeline-manual-2.4.6.pdf
An overview over the existing ESO pipelines can be found on the web page
https://www.eso.org/sci/software/pipelines/.
Basic documentation about the EsoRex program can be found at the esorex (1) man page.
It is possible to call the pipelines from python using the python-cpl package. See
https://packages.python.org/python-cpl/index.html for further information.
The other recipes of the hawki pipeline are hawki_cal_dark(7), hawki_cal_distortion(7),
hawki_cal_flat(7), hawki_cal_zpoint(7), hawki_dark_combine(7), hawki_detector_noise(7),
hawki_linearity_analyse(7), hawki_sci_jitter(7), hawki_science_process(7),
hawki_standard_process(7), hawki_step_apply_dist(7), hawki_step_basic_calib(7),
hawki_step_combine(7), hawki_step_compute_bkg(7), hawki_step_detect_obj(7),
hawki_step_photom_2mass(7), hawki_step_refine_offsets(7), hawki_step_stats(7),
hawki_step_stitch(7), hawki_step_subtract_bkg(7), hawki_tec_filtchk(7),
hawki_twilight_flat_combine(7), hawki_util_gendist(7), hawki_util_stdstars(7)
VERSION
hawki_science_postprocess 2.4.6
AUTHOR
Jim Lewis <jrl@ast.cam.ac.uk>
BUG REPORTS
Please report any problems to jrl@ast.cam.ac.uk. Alternatively, you may send a report to
the ESO User Support Department <usd-help@eso.org>.
LICENSE
This file is part of the HAWKI Instrument Pipeline Copyright (C) 2015 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., 59 Temple Place, Suite 330, Boston,
MA 02111-1307 USA