← Back to branch summary

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

« back to all changes in this revision

Viewing changes to stdred/irspec/help/calibrirsp.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/irspec/help/calibrirsp.hlq
 
1
% @(#)calibrirsp.hlq    19.1 (ESO-IPG) 02/25/03 14:23:15 
 
2
% @(#)
 
3
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
4
%.COPYRIGHT  (c)  1992 European Southern Observatory
 
5
%.IDENT      rectifirsp.hlq
 
6
%.AUTHOR     E.Oliva, Arcetri (Florence)
 
7
%.KEYWORDS   MIDAS, help files, CALIBRATE/IRSPEC
 
8
%.PURPOSE    On-line help file for the command: CALIBRATE/IRSPEC
 
9
%.VERSION    1.0  22-SEP-1992 : Creation, E.Oliva
 
10
%----------------------------------------------------------------
 
11
\se
 
12
SECTION./IRSPEC
 
13
\es\co
 
14
CALIBRATE/IRSPEC                                     22-SEP-1992 EO
 
15
\oc\su
 
16
CALIBRATE/IRSPEC ima
 
17
        Apply on-line (mechanical) wavelength calibration.
 
18
CALIBRATE/IRSPEC ima_ref mode=define
 
19
        Define and store in ima_ref precise calibration from sky/lamp lines
 
20
CALIBRATE/IRSPEC ima ref=ima_ref
 
21
        Apply precise wavelength calibration to frame ima from parameters
 
22
        stored in ima_ref
 
23
\us\pu
 
24
Purpose:    The wavelength dispersion on the IRSPEC array is linear within
 
25
            a small - and totally negligible - fraction of the pixel size.
 
26
            Hence, wavelength calibrating simply means modifying the x-start
 
27
            and x-step values (descriptor) of the image. Another advantage
 
28
            of IRSPEC is that one can very precisely compute (analytically)
 
29
            the pixel size - in wavelength - once the central wavelength of
 
30
            the frame is known. A quite precise - usually within 1 pixel - 
 
31
            estimate of this quantity is available on-line at the instrument 
 
32
            ("mechanical" calibration) and is stored in the original files 
 
33
            in the form of descriptors. You can directly use this information
 
34
            and determine the "mechanical" wavelength calibration as in the
 
35
            first example.
 
36
            This command allows you also to determine more precisely the
 
37
            central wavelength of your frame - and hence to obtain a very 
 
38
            accurate wavelength calibration - if you have a frame containing
 
39
            lines with known wavelengths; up to 2.3 microns the OH lines in
 
40
            the sky frames are a very convenient calibrator (Oliva \& Origlia,
 
41
            1992, A\&A 254, 466). See the 2-nd example and/or use 
 
42
            TUTORIAL/CALIBRATE.
 
43
            Finally, this command can be used to apply a precise calibration
 
44
            to a given image (see third example).
 
45
\up\sy
 
46
Syntax:     CALIBRATE/IRSPEC ima [ref=reference_ima] [mode=calibration_mode] 
 
47
                             [units=wavelength_units]
 
48
\ys\pa
 
49
            ima     =  Frame to wavelength calibrate, it may have any
 
50
                       size in Y (could e.g. be 1D) but must have the 
 
51
                       original size in X. "Untouched" on exit (see last
 
52
                       note below)
 
53
                       If mode=d (definition of precise calibration), 
 
54
                       "ima" is the sky/lamp frame containing lines with 
 
55
                       known wavelengths and must have the original X,Y 
 
56
                       sizes. Untouched on exit.
 
57
\ap\pa
 
58
            ref      = Optional reference image which contains precise 
 
59
                       calibration parameters, determined using CALIB/IRSP
 
60
                       with mode=d
 
61
\ap\pa 
 
62
            mode     = If set to d (define) it interactively defines the
 
63
                       best wavelength calibration parameters using the
 
64
                       lines contained in the frame "ima" (see also
 
65
                       TUTORIAL/CALIB). Use   mode=d   (or just m=d) for
 
66
                       calibration using sky lines (you need a flat and
 
67
                       a dark for this). For lamp lines frames it may be 
 
68
                       more convenient to work on the frame as it is, in
 
69
                       which case use      m=d1    (sorry for the dirty
 
70
                       trick...).
 
71
\ap\pa
 
72
            units    = Wavelengths are given in microns. You can use
 
73
                       units=a (or just u=a) if you prefer to work in
 
74
                       Angstroms.
 
75
\ap\no
 
76
Note:       It is most convenient (and clearer) to apply the wavelength
 
77
            calibration only to "rectified frames" - i.e. with straight 
 
78
            spectral lines (see RECTIFY/IRSPEC). 
 
79
\\
 
80
            The wavelength calibrated frame is identical to the original
 
81
            but has different start and step in X. Therefore, if you want
 
82
            to go back to the uncalibrated image it's enough using
 
83
            WRITE/DESC image_name start 1
 
84
            WRITE/DESC image_name step 1
 
85
\on\exs
 
86
Examples:
 
87
\ex
 
88
            CALIB/IRSP test4
 
89
              apply mechanical calibration to frame test4 
 
90
\xe\ex
 
91
            CALIB/IRSP sky3 mode=d
 
92
              define and store in "sky3" precise calibration parameters
 
93
              from the sky/lamp lines contained in the same frame (see
 
94
              also TUTORIAL/CALIB)
 
95
\xe\ex
 
96
            CALIB/IRSP test4 ref=sky3
 
97
               apply precise parameters (defined above) to frame "test4"
 
98
\xe\sxe
 
99
 
 
100
 
 
101
 
 
102
 
 
103
 
 
104