/usr/share/doc/cpl-plugin-xshoo-doc/html/_sources/xsh_respon_slit_stare.txt is in cpl-plugin-xshoo-doc 2.8.4+dfsg-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 | The xsh_respon_slit_stare recipe
===============================================================
.. data:: xsh_respon_slit_stare
Synopsis
--------
Compute the response function in SLIT stare mode
Description
-----------
This recipe computes the response function for arm
Input Frames :
- A RAW frame (Tag = STD_FLUX_SLIT_STARE_arm, Type = RAW)
- [UVB,VIS] A master bias frame (Tag = MASTER_BIAS_arm, Type = PRE)
- A master dark frame (Tag = MASTER_DARK_arm Type = PRE)
- A master flat frame (Tag = MASTER_FLAT_SLIT_arm Type = PRE)
- An order table frame(Tag = ORDER_TAB_EDGES_arm Type = ORD)
- A wave solution frame(Tag = WAVE_TAB_2D_arm, Type = WAV)
- [OPTIONAL] Table with dispersion coefficients (Tag = DISP_TAB_arm)
- [OPTIONAL] A telluric model catalog (Tag = TELL_MOD_CAT_arm arm=VIS,NIR)
- A standard star fluxes catalog (Tag = FLUX_STD_CATALOG_arm Type = FLX)
- A table to set response sampling points (Tag = RESP_FIT_POINTS_CAT_arm)
- An atmospheric extinction table (Tag = ATMOS_EXT_arm)
- [OPTIONAL] A master response curve table (Tag = MRESPONSE_MERGE1D_SLIT_arm)
if provided this is the one used to flux calibrate the spectra
Products :
- [If STD is in catal] The response ord-by-ord function (Tag = PREFIX_RESPONSE_ORDER1D_SLIT_arm)
- [If STD is in catal] The response merged function (Tag = PREFIX_RESPONSE_MERGE1D_SLIT_arm)
- The extracted 2D specturm (Tag = PREFIX_ORDER2D_arm)
- The extracted 1D specturm (Tag = PREFIX_ORDER1D_arm)
- The merged 2D specturm (Tag = PREFIX_MERGE2D_arm)
- The merged 1D specturm (Tag = PREFIX_MERGE1D_arm)
- The merged 2D sky frame (Tag = SLY_SLIT_MERGED2D)
- [If STD is in catal] Flux calibrated merged 2D spectrum (Tag = PREFIX_FLUX_ORDER2D_arm)
- [If STD is in catal] Flux calibrated merged 1D spectrum (Tag = PREFIX_FLUX_ORDER1D_arm)
- [If STD is in catal] Flux calibrated merged 2D spectrum (Tag = PREFIX_FLUX_MERGE2D_arm)
- [If STD is in catal] Flux calibrated merged 1D spectrum (Tag = PREFIX_FLUX_MERGE1D_arm)
- [If STD is in catal] The efficiency (Tag = EFFICIENCY_SLIT_arm)
- where PREFIX is SCI, FLUX, TELL if input raw DPR.TYPE contains OBJECT or FLUX or TELLURIC
Constructor
-----------
.. method:: cpl.Recipe("xsh_respon_slit_stare")
:noindex:
Create an object for the recipe xsh_respon_slit_stare.
::
import cpl
xsh_respon_slit_stare = cpl.Recipe("xsh_respon_slit_stare")
Parameters
----------
.. py:attribute:: xsh_respon_slit_stare.param.keep_temp
If 'no', temporary files are deleted. (str; default: 'no') [default="no"].
.. py:attribute:: xsh_respon_slit_stare.param.debug_level
Additional xshooter debug level. One of 'none', 'low', 'medium', 'high' (str; default: 'none') [default="none"].
.. py:attribute:: xsh_respon_slit_stare.param.time_stamp
Add timestamp to product file name. (bool; default: False) [default=False].
.. py:attribute:: xsh_respon_slit_stare.param.decode_bp
Integer representation of the bits to be considered bad when decoding the bad pixel mask pixel values. Most frequent codes relevant for the user: 0: good pixel, 8: pick-up noise, 16: cosmic-ray removed, 32: cosmic-ray unremoved, 128: calibration file defect, 256: hot pixel, 512: dark pixel, 4096: A/D converted saturation, 32768: non linear pixel, 1048576: extrapolated flux in NIR, 4194304: Interpolated flux during extraction. (long; default: 2144337919) [default=2144337919].
.. py:attribute:: xsh_respon_slit_stare.param.pre_overscan_corr
pre-overscan correction.0: no correction1: mean overscan correction2: mean prescan correction3: (mean pre+mean overscan)/2 correction (long; default: 1) [default=1].
.. py:attribute:: xsh_respon_slit_stare.param.background_edges_margin
X margin to order edge to define background sampling points (long; default: 1) [default=1].
.. py:attribute:: xsh_respon_slit_stare.param.background_poly_deg_y
Poly mode fit deg along Y. (long; default: 9) [default=9].
.. py:attribute:: xsh_respon_slit_stare.param.background_poly_deg_x
Poly mode fit deg along X. (long; default: 9) [default=9].
.. py:attribute:: xsh_respon_slit_stare.param.background_poly_kappa
Poly mode kappa value of kappa-sigma-clip outliers removal. (float; default: 10.0) [default=10.0].
.. py:attribute:: xsh_respon_slit_stare.param.removecrhsingle_sigmalim
Poisson fluctuation threshold to flag CRHs (see van Dokkum, PASP,113,2001,p1420-27) (float; default: 20.0) [default=20.0].
.. py:attribute:: xsh_respon_slit_stare.param.removecrhsingle_flim
Minimum contrast between the Laplacian image and the fine structure image that a point must have to be flagged as CRH. (see van Dokkum, PASP,113,2001,p1420-27) (float; default: 2.0) [default=2.0].
.. py:attribute:: xsh_respon_slit_stare.param.removecrhsingle_niter
Max number of iterations (long; default: 4) [default=4].
.. py:attribute:: xsh_respon_slit_stare.param.rectify_kernel
Name of the Interpolation Kernel Used. Possible values are: tanh, sinc, sinc2, lanczos, hamming, hann. (str; default: 'tanh') [default="tanh"].
.. py:attribute:: xsh_respon_slit_stare.param.rectify_radius
Rectify Interpolation radius [bin units]. (float; default: 2.0) [default=2.0].
.. py:attribute:: xsh_respon_slit_stare.param.rectify_bin_lambda
Wavelength step in the output spectrum [nm] (float; default: -1.0) [default=-1.0].
.. py:attribute:: xsh_respon_slit_stare.param.rectify_bin_slit
Spatial step along the slit in the output spectrum [arcsec] (float; default: -1.0) [default=-1.0].
.. py:attribute:: xsh_respon_slit_stare.param.localize_method
Localization method (MANUAL, MAXIMUM, GAUSSIAN) used to detect the object centroid and height on the slit (str; default: 'MANUAL') [default="MANUAL"].
.. py:attribute:: xsh_respon_slit_stare.param.localize_chunk_nb
Number of chunks in the full spectrum to localize the object (long; default: 10) [default=10].
.. py:attribute:: xsh_respon_slit_stare.param.localize_thresh
Threshold relative to the peak intensity below which the edges of the object are detected for MAXIMUM localization (float; default: 0.1) [default=0.1].
.. py:attribute:: xsh_respon_slit_stare.param.localize_deg_lambda
Degree in lambda in the localization polynomial expression slit=f(lambda), used only for MAXIMUM and GAUSSIAN (long; default: 0) [default=0].
.. py:attribute:: xsh_respon_slit_stare.param.localize_slit_position
Object position on the slit for MANUAL localization [arcsec] (float; default: 0.0) [default=0.0].
.. py:attribute:: xsh_respon_slit_stare.param.localize_slit_hheight
Object half height on the slit for MANUAL localization [arcsec] (float; default: 2.0) [default=2.0].
.. py:attribute:: xsh_respon_slit_stare.param.localize_kappa
Kappa value for sigma clipping in the localization polynomial fit (float; default: 3.0) [default=3.0].
.. py:attribute:: xsh_respon_slit_stare.param.localize_niter
Number of iterations for sigma clipping in the localization polynomial fit (long; default: 3) [default=3].
.. py:attribute:: xsh_respon_slit_stare.param.localize_use_skymask
TRUE if we want to mask sky lines using SKY_LINE_LIST file. (bool; default: False) [default=False].
.. py:attribute:: xsh_respon_slit_stare.param.sky_subtract
TRUE to use subtract sky single. (bool; default: True) [default=True].
.. py:attribute:: xsh_respon_slit_stare.param.sky_bspline_nbkpts_first
Nb of break points for Bezier curve fitting (without localization) (long; default: 3000) [default=3000].
.. py:attribute:: xsh_respon_slit_stare.param.sky_bspline_nbkpts_second
Nb of break points for Bezier curve fitting (with localization) (long; default: 3000) [default=3000].
.. py:attribute:: xsh_respon_slit_stare.param.sky_bspline_order
Bezier spline order (long; default: 7) [default=7].
.. py:attribute:: xsh_respon_slit_stare.param.sky_bspline_niter
Nb of iterations (long; default: 20) [default=20].
.. py:attribute:: xsh_respon_slit_stare.param.sky_bspline_kappa
Kappa value used to kappa-sigma-clip object (float; default: 5.0) [default=5.0].
.. py:attribute:: xsh_respon_slit_stare.param.sky_method
Sky subtract Method (BSPLINE, MEDIAN) (str; default: 'MEDIAN') [default="MEDIAN"].
.. py:attribute:: xsh_respon_slit_stare.param.bspline_sampling
BSPLINE sampling. UNIFORM-uses the user defined nbkpts value, corrected for binning, for all orders. FINE: multiplies the user defined nbkpts value, corrected for binning, by a hard coded coefficient optimized on each arm-order) (str; default: 'FINE') [default="FINE"].
.. py:attribute:: xsh_respon_slit_stare.param.sky_median_hsize
Half size of the running median. If sky-method=MEDIAN . (long; default: 20) [default=20].
.. py:attribute:: xsh_respon_slit_stare.param.sky_slit_edges_mask
Size of edges mask in arcsec (float; default: 0.5) [default=0.5].
.. py:attribute:: xsh_respon_slit_stare.param.sky_position1
Central position of the sky window #1 [arcsec] (float; default: 0.0) [default=0.0].
.. py:attribute:: xsh_respon_slit_stare.param.sky_hheight1
Half size of sky window #1 [arcsec] (float; default: 0.0) [default=0.0].
.. py:attribute:: xsh_respon_slit_stare.param.sky_position2
Central position of the sky window #2 [arcsec] (float; default: 0.0) [default=0.0].
.. py:attribute:: xsh_respon_slit_stare.param.sky_hheight2
Half size of the sky window #2 [arcsec] (float; default: 0.0) [default=0.0].
.. py:attribute:: xsh_respon_slit_stare.param.stdextract_interp_hsize
Half size of mask used to define object cross order profile (long; default: 30) [default=30].
.. py:attribute:: xsh_respon_slit_stare.param.do_optextract
TRUE if we do the optimal extraction (bool; default: False) [default=False].
.. py:attribute:: xsh_respon_slit_stare.param.optextract_oversample
Oversample factor for the science image (long; default: 5) [default=5].
.. py:attribute:: xsh_respon_slit_stare.param.optextract_box_half_size
Extraction box [pixel] (long; default: 10) [default=10].
.. py:attribute:: xsh_respon_slit_stare.param.optextract_chunk_size
Chunk size [bin] (long; default: 50) [default=50].
.. py:attribute:: xsh_respon_slit_stare.param.optextract_step_lambda
Lambda step [nm] (float; default: 0.02) [default=0.02].
.. py:attribute:: xsh_respon_slit_stare.param.optextract_clip_kappa
Kappa for cosmics ray hits rejection (float; default: 3.0) [default=3.0].
.. py:attribute:: xsh_respon_slit_stare.param.optextract_clip_frac
Maximum bad pixels fraction for cosmics ray hits rejection (float; default: 0.4) [default=0.4].
.. py:attribute:: xsh_respon_slit_stare.param.optextract_clip_niter
Maximum number of iterations for cosmics ray hits rejection (long; default: 2) [default=2].
.. py:attribute:: xsh_respon_slit_stare.param.optextract_niter
Number of iterations (long; default: 1) [default=1].
.. py:attribute:: xsh_respon_slit_stare.param.optextract_method
Extraction method GAUSSIAN | GENERAL (str; default: 'GAUSSIAN') [default="GAUSSIAN"].
.. py:attribute:: xsh_respon_slit_stare.param.correct_tellurics
TRUE if during response computation we apply telluric correction (bool; default: True) [default=True].
The following code snippet shows the default settings for the available
parameters.
::
import cpl
xsh_respon_slit_stare = cpl.Recipe("xsh_respon_slit_stare")
xsh_respon_slit_stare.param.keep_temp = "no"
xsh_respon_slit_stare.param.debug_level = "none"
xsh_respon_slit_stare.param.time_stamp = False
xsh_respon_slit_stare.param.decode_bp = 2144337919
xsh_respon_slit_stare.param.pre_overscan_corr = 1
xsh_respon_slit_stare.param.background_edges_margin = 1
xsh_respon_slit_stare.param.background_poly_deg_y = 9
xsh_respon_slit_stare.param.background_poly_deg_x = 9
xsh_respon_slit_stare.param.background_poly_kappa = 10.0
xsh_respon_slit_stare.param.removecrhsingle_sigmalim = 20.0
xsh_respon_slit_stare.param.removecrhsingle_flim = 2.0
xsh_respon_slit_stare.param.removecrhsingle_niter = 4
xsh_respon_slit_stare.param.rectify_kernel = "tanh"
xsh_respon_slit_stare.param.rectify_radius = 2.0
xsh_respon_slit_stare.param.rectify_bin_lambda = -1.0
xsh_respon_slit_stare.param.rectify_bin_slit = -1.0
xsh_respon_slit_stare.param.localize_method = "MANUAL"
xsh_respon_slit_stare.param.localize_chunk_nb = 10
xsh_respon_slit_stare.param.localize_thresh = 0.1
xsh_respon_slit_stare.param.localize_deg_lambda = 0
xsh_respon_slit_stare.param.localize_slit_position = 0.0
xsh_respon_slit_stare.param.localize_slit_hheight = 2.0
xsh_respon_slit_stare.param.localize_kappa = 3.0
xsh_respon_slit_stare.param.localize_niter = 3
xsh_respon_slit_stare.param.localize_use_skymask = False
xsh_respon_slit_stare.param.sky_subtract = True
xsh_respon_slit_stare.param.sky_bspline_nbkpts_first = 3000
xsh_respon_slit_stare.param.sky_bspline_nbkpts_second = 3000
xsh_respon_slit_stare.param.sky_bspline_order = 7
xsh_respon_slit_stare.param.sky_bspline_niter = 20
xsh_respon_slit_stare.param.sky_bspline_kappa = 5.0
xsh_respon_slit_stare.param.sky_method = "MEDIAN"
xsh_respon_slit_stare.param.bspline_sampling = "FINE"
xsh_respon_slit_stare.param.sky_median_hsize = 20
xsh_respon_slit_stare.param.sky_slit_edges_mask = 0.5
xsh_respon_slit_stare.param.sky_position1 = 0.0
xsh_respon_slit_stare.param.sky_hheight1 = 0.0
xsh_respon_slit_stare.param.sky_position2 = 0.0
xsh_respon_slit_stare.param.sky_hheight2 = 0.0
xsh_respon_slit_stare.param.stdextract_interp_hsize = 30
xsh_respon_slit_stare.param.do_optextract = False
xsh_respon_slit_stare.param.optextract_oversample = 5
xsh_respon_slit_stare.param.optextract_box_half_size = 10
xsh_respon_slit_stare.param.optextract_chunk_size = 50
xsh_respon_slit_stare.param.optextract_step_lambda = 0.02
xsh_respon_slit_stare.param.optextract_clip_kappa = 3.0
xsh_respon_slit_stare.param.optextract_clip_frac = 0.4
xsh_respon_slit_stare.param.optextract_clip_niter = 2
xsh_respon_slit_stare.param.optextract_niter = 1
xsh_respon_slit_stare.param.optextract_method = "GAUSSIAN"
xsh_respon_slit_stare.param.correct_tellurics = True
You may also set or overwrite some or all parameters by the recipe
parameter `param`, as shown in the following example:
::
import cpl
xsh_respon_slit_stare = cpl.Recipe("xsh_respon_slit_stare")
[...]
res = xsh_respon_slit_stare( ..., param = {"keep_temp":"no", "debug_level":"none"})
.. seealso:: `cpl.Recipe <http://packages.python.org/python-cpl/recipe.html>`_
for more information about the recipe object.
Bug reports
-----------
Please report any problems to `P.Goldoni, L.Guglielmi, R. Haigron, F. Royer, D. Bramich, A. Modigliani <amodigli@eso.org >`_. Alternatively, you may
send a report to the `ESO User Support Department <usd-help@eso.org>`_.
Copyright
---------
This file is part of the X-shooter Instrument Pipeline
Copyright (C) 2006 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
.. codeauthor:: P.Goldoni, L.Guglielmi, R. Haigron, F. Royer, D. Bramich, A. Modigliani <amodigli@eso.org >
|