Provided by: cpl-plugin-muse-doc_2.8.7+dfsg-3build1_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.025´´ 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.025´´ 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 <str>
              Pixel down-scaling factor for the "drizzle"  resampling  method.  Up  to  three,  comma-separated,
              floating-point  values can be given. If only one value is given, it applies to all dimensions, two
              values are interpreted as spatial and spectral direction, respectively, while three are  taken  as
              horizontal,  vertical,  and  spectral. (str; default: ´0.8,0.8´). The full name of this option for
              the EsoRex configuration file is muse.muse_scipost_make_cube.pixfrac [default = 0.8,0.8].

       --ld <int>
              Number of adjacent pixels to take into account during resampling in  all  three  directions  (loop
              distance);  this affects all resampling methods except "nearest". (int; 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-2.8.7.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  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_illum(7),  muse_lingain(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_raman(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 2.8.7

AUTHOR

       Ole Streicher <https://support.eso.org>

BUG REPORTS

       Please report any problems to https://support.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, 2019 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