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.11.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.11

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