← Back to branch summary

~ubuntu-branches/debian/jessie/eso-midas/jessie

« back to all changes in this revision

Viewing changes to stdred/mos/help/wldef_mos.hlq

  • Committer: Package Import Robot
  • Author(s): Ole Streicher
  • Date: 2014-04-22 14:44:58 UTC
  • Revision ID: package-import@ubuntu.com-20140422144458-okiwi1assxkkiz39
Tags: upstream-13.09pl1.2+dfsg
Import upstream version 13.09pl1.2+dfsg

Show diffs side-by-side

added added

removed removed

Lines of Context:
stdred/mos/help/wldef_mos.hlq
 
1
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
2
%.COPYRIGHT  (c)  1994 European Southern Observatory
 
3
%.IDENT      wldefmos.hlq
 
4
%.AUTHOR     SM/LSW
 
5
%.KEYWORDS   MIDAS, help files, WLDEF/MOS
 
6
%.PURPOSE    On-line help file for the command: WLDEF/MOS
 
7
%.VERSION    1.0  4-AUG-1994 : Creation, SM
 
8
%----------------------------------------------------------------
 
9
\se
 
10
SECTION./MOS
 
11
\es\co
 
12
WLDEF/MOS                                       04-AUG-1994 SM
 
13
\oc\su
 
14
        WLDEF/MOS [wlc] [t,w] [ybin] [meth] [tol] [wlcord] [wlcmtd] [plotc]
 
15
        
 
16
\us\pu
 
17
Purpose:   
 
18
          Search for lines in MOS slitlets, centers them and fits the
 
19
          dispersion relation   
 
20
\up\sy
 
21
Syntax: 
 
22
          WLDEF/MOS [wlc] [t,w] [ybin] [meth] [tol] [wlcord] [wlcmtd] [plotc]
 
23
\ys\pa
 
24
          wlc = wavelength calibration image. \\
 
25
              Session Keyword: WLC \\
 
26
              Default value: wlc
 
27
          t,w = threshold, window \\.
 
28
              Session Keyword: SEAPAR \\
 
29
              Default value: 200,5   
 
30
          ybin = step, binning factor in y-direction.
 
31
              Session Keyword: YBIN \\
 
32
              Default value: 3,3
 
33
          meth = centering method (gaussian or gravity).  \\
 
34
              Session Keyword: CENTMET \\
 
35
              Default value: gravity
 
36
          tol = tolerance for line identification\\
 
37
              (> 0 pixels, < 0 wavelength units)\\ 
 
38
              Session keyword: TOL\\
 
39
              Default value: 2
 
40
          wlcord = degree of fit to dispersion relation\\
 
41
              Session keyword: WLCORD(1)\\
 
42
              Default value: 2
 
43
          wlcmtd = method of fit\\
 
44
              Session keyword: WLCMTD\\               
 
45
              Default value: FC
 
46
              operation mode:
 
47
              L(inear) central wavelength and dispersion are given
 
48
              F(ors)   mode for FORS observations: grism number,
 
49
                  central wavelength and average linear dispersion
 
50
                  are stored
 
51
              fit mode:
 
52
              C(onstant linelist) - in each slitlet the lines are
 
53
                  identified for the first row and kept for the
 
54
                  whole slitlet. In this mode, the dispersion
 
55
                  relation may gradually evolve throughout the
 
56
                  slitlet, because the dispersion relation from
 
57
                  one row is used to identify the lines in the
 
58
                  next row. But all lines are kept, you cannot
 
59
                  throw out bad lines this way!
 
60
              V(ariable linelist) - for each row the dispersion
 
61
                  relation of the first row is used to identify
 
62
                  the lines and bad lines are thrown out.
 
63
              F(it all)  - This mode is a combination of V and C: the
 
64
                  dispersion relation may evolve gradually along the
 
65
                  slitlet AND bad lines are thrown out. As this mode
 
66
                  may produce rather  unstable fits you should only
 
67
                  use it for  very good-natured data!
 
68
          plotc  = plot of residuals (y or n)\\
 
69
              Session keywords: PLOTC\\
 
70
              Default value: N
 
71
\ap\sa
 
72
See also:
 
73
          SEARCH/MOS, CALIBRATE/MOS
 
74
\as\no
 
75
Note:       
 
76
          This command combines SEARCH/MOS and CALIBR/MOS. At first it
 
77
          searches the frame WLC, using the parameters threshold, window,
 
78
          binning and step in y, and centering method as giving in 
 
79
          parameters 2 -- 4 (or the resp. keywords). The results
 
80
          are written to table given the keyword LINPOS and the
 
81
          slitlet positions are taken from table given keyword MOS.
 
82
          Then it takes either the grism number from the header of
 
83
          WLC (WLCMTD(1) = F) or reads the keywords AVDISP (average 
 
84
          dispersion) and WCENTER (central wavel.) (WLCMTD(1) = L).
 
85
          Using the numbers obtained this way it performs the 
 
86
          identification of the lines and fits the dispersion 
 
87
          relation with a polynomial (type keyword POLTYP) of
 
88
          degree given by parameter 6. The resulting coefficients
 
89
          are stored in the table given by keyword LINFIT and
 
90
          - depending on the last parameter - plotted.
 
91
          For a detailed description of the fitting procedure see
 
92
          on-line help of CALIBRATE/MOS.
 
93
\on\exs
 
94
Examples:
 
95
\ex
 
96
        WLDEF/MOS ? ? 10,3 ? -2 3 FC y
 
97
        Takes the frame name from keyword WLC and does a line search with
 
98
        threshold and width of search window defined by keyword SEAPAR and
 
99
        centers the detected lines with the method defined in keyword
 
100
        CENTMET. It scans every 10th CCD row and averages 3 rows before
 
101
        searching the lines. It takes central wavelength and average
 
102
        dispersion/pixel from the keyword belonging to the grism used
 
103
        (e.g. FORS01 for grism #1) and does not throw out any bad lines
 
104
        during the fit and identification procedure. The tolerance for
 
105
        identification is 2 wavelength units and the fit is a 3rd order
 
106
        polynomial. The residuals are plotted.
 
107
\xe \sxe