xenial (7) muse_scipost_make_cube.7.gz

Provided by: cpl-plugin-muse-doc_1.2.1+dfsg-2_all bug

NAME

       muse_scipost_make_cube - Make a MUSE cube from a MUSE pixel table.

SYNOPSIS

       esorex muse_scipost_make_cube [OPTIONS] FILE.sof

DESCRIPTION

       This  recipe  takes a pixel table and resamples it to either a FITS cube or a Euro3D table and optionally
       to a stacked spectrum. This is a part of the muse_scipost recipe.

OPTIONS

       --lambdamin <float>
              Cut off the data below this wavelength after loading the pixel table(s). (float; default: 4000.0).
              The    full    name    of    this    option    for    the    EsoRex    configuration    file    is
              muse.muse_scipost_make_cube.lambdamin [default = 4000.0].

       --lambdamax <float>
              Cut off the data above  this  wavelength  after  loading  the  pixel  table(s).  (float;  default:
              10000.0).   The   full   name   of   this   option   for   the   EsoRex   configuration   file  is
              muse.muse_scipost_make_cube.lambdamax [default = 10000.0].

       --resample <str>
              The resampling technique to use for the final output cube. (str;  default:  ´drizzle´).  The  full
              name  of  this  option  for  the EsoRex configuration file is muse.muse_scipost_make_cube.resample
              [default = drizzle].

       --dx <float>
              Horizontal step size for resampling (in arcsec or pixel). The following defaults  are  taken  when
              this  value  is set to 0.0: 0.2´´ for WFM, 0.075´´ for NFM, 1.0 if data is in pixel units. (float;
              default:  0.0).  The  full  name  of  this  option  for   the   EsoRex   configuration   file   is
              muse.muse_scipost_make_cube.dx [default = 0.0].

       --dy <float>
              Vertical step size for resampling (in arcsec or pixel). The following defaults are taken when this
              value is set to 0.0: 0.2´´ for WFM, 0.075´´ for NFM, 1.0  if  data  is  in  pixel  units.  (float;
              default:   0.0).   The   full   name   of  this  option  for  the  EsoRex  configuration  file  is
              muse.muse_scipost_make_cube.dy [default = 0.0].

       --dlambda <float>
              Wavelength step size (in Angstrom). Natural instrument sampling is used, if this  is  0.0  (float;
              default:   0.0).   The   full   name   of  this  option  for  the  EsoRex  configuration  file  is
              muse.muse_scipost_make_cube.dlambda [default = 0.0].

       --crtype <str>
              Type of statistics used for detection of cosmic rays during  final  resampling.  "iraf"  uses  the
              variance  information,  "mean" uses standard (mean/stdev) statistics, "median" uses median and the
              median median of the absolute median deviation. (str; default: ´median´). The full  name  of  this
              option for the EsoRex configuration file is muse.muse_scipost_make_cube.crtype [default = median].

       --crsigma <float>
              Sigma rejection factor to use for cosmic ray rejection during final resampling. A zero or negative
              value switches cosmic ray rejection off. (float; default: 15.0). The full name of this option  for
              the EsoRex configuration file is muse.muse_scipost_make_cube.crsigma [default = 15.0].

       --rc <float>
              Critical  radius  for the "renka" resampling method. (float; default: 1.25). The full name of this
              option for the EsoRex configuration file is muse.muse_scipost_make_cube.rc [default = 1.25].

       --pixfrac <float>
              Pixel down-scaling factor for the "drizzle" resampling method. (float;  default:  0.8).  The  full
              name  of  this  option  for  the  EsoRex configuration file is muse.muse_scipost_make_cube.pixfrac
              [default = 0.8].

       --ld <long>
              Number of adjacent pixels to take into account during resampling in  all  three  directions  (loop
              distance); this affects all resampling methods except "nearest". (long; default: 1). The full name
              of this option for the EsoRex configuration file is muse.muse_scipost_make_cube.ld [default = 1].

       --format <str>
              Type of output file format, "Cube" is a standard FITS cube with NAXIS=3  and  multiple  extensions
              (for data and variance). The extended "x" formats include the reconstructed image(s) in FITS image
              extensions within the same file. (str; default: ´Cube´). The full name  of  this  option  for  the
              EsoRex configuration file is muse.muse_scipost_make_cube.format [default = Cube].

       --stacked <bool>
              If  true,  write  an  additional  output  file  in  form  of  a  2D  stacked image (x direction is
              pseudo-spatial, y direction is wavelength). (bool; default: False). The full name of  this  option
              for the EsoRex configuration file is muse.muse_scipost_make_cube.stacked [default = False].

       --filter <str>
              The  filter  name(s) to be used for the output field-of-view image. Each name has to correspond to
              an EXTNAME in an extension of the FILTER_LIST file.  If  an  unsupported  filter  name  is  given,
              creation  of  the respective image is omitted. If multiple filter names are given, they have to be
              comma  separated.  (str;  default:  ´white´).  The  full  name  of  this  option  for  the  EsoRex
              configuration file is muse.muse_scipost_make_cube.filter [default = white].

       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 muse pipeline can be downloaded as a PDF file using the following URL:

              ftp://ftp.eso.org/pub/dfs/pipelines/muse/muse-pipeline-cookbook-1.2.1.pdf

       An   overview   over   the   existing   ESO   pipelines    can    be    found    on    the    web    page
       http://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
       http://packages.python.org/python-cpl/index.html for further information.

       The  other  recipes  of  the  muse   pipeline   are   muse_ampl(7),   muse_astrometry(7),   muse_bias(7),
       muse_create_sky(7), muse_dark(7), muse_exp_align(7), muse_exp_combine(7), muse_flat(7), muse_geometry(7),
       muse_lsf(7),  muse_qi_mask(7),   muse_scibasic(7),   muse_scipost(7),   muse_scipost_apply_astrometry(7),
       muse_scipost_calibrate_flux(7),      muse_scipost_combine_pixtables(7),      muse_scipost_correct_dar(7),
       muse_scipost_correct_rv(7),      muse_scipost_subtract_sky(7),       muse_scipost_subtract_sky_simple(7),
       muse_standard(7), muse_twilight(7), muse_wavecal(7)

VERSION

       muse_scipost_make_cube 1.2.1

AUTHOR

       Ole Streicher <usd-help@eso.org>

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

LICENSE

       This file is part of the MUSE Instrument Pipeline Copyright (C) 2005, 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., 51 Franklin St, Fifth Floor, Boston, MA  02111-1307  USA