Provided by: cpl-plugin-hawki-doc_2.4.6+dfsg-1build1_all bug

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