Debian Codegraph @

stdred/optopus/help/refracopto.hlq

raw
1 % @(#)refracopto.hlq 19.1 (ESO-IPG) 02/25/03 14:27:22
2 %++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
3 %.COPYRIGHT (c) 1991 European Southern Observatory
4 %.IDENT atref.hlq
5 %.AUTHOR A. Gemmo Padova Department of Astronomy
6 %.KEYWORDS MIDAS, help files, REFRACTION/OPTOPUS
7 %.PURPOSE On-line help file for the command: REFRACTION/OPTOPUS
8 %.VERSION 1.0 16-SEP-1991 : Creation, AG
9 %----------------------------------------------------------------------
10 \se
11 SECTION./OPTO
12 \es\co
13 REFRACTION/OPTOPUS 16-SEP-1991 AG
14 \oc\su
15 REFRACTION/OPTOPUS [inp_tab] [out_tab] [year,month,day] [exp] [lambda1,lambda2]
16 [start_st_slot,end_st_slot] [opt_st] [ast_flag]
17 correct for atmospheric refraction X and Y coord. on Optopus plate.
18 \us\pu
19 Purpose:
20 Correct for atmospheric refraction effects X and Y
21 coordinates of objects on Optopus plate. For given
22 plate-center coordinates (they must the same used by
23 the command HOLES/OPTOPUS), specified observation time
24 slot and wavelength range of interest, REFRACTION/OPTOPUS
25 determines: (a) an optimal differential correction vector,
26 (b) an optimal chromatic correction vector for the
27 guidestars.
28 In the end, all the relevant parameters determined by
29 REFRACTION/OPTOPUS are written into descriptors of the
30 output table, so that they can be read by READ/DESCRIPTORS
31 or printed by PRINT/DESCRIPTORS commands.
32 \up\sy
33 Syntax:
34 REFRACTION/OPTOPUS [inp_tab] [out_tab] [year,month,day] [exp]
35 [lambda1,lambda2] [start_st_slot,end_st_slot] [opt_st] [ast_flag]
36 \ys\pa
37 [inp_tab] = table created by the command HOLES/OPTOPUS,
38 which contains X and Y coordinates of
39 positions of holes on Optopus plate. Default
40 name is "opto2.tbl".
41 \ap\pa
42 [out_tab] = output table, with corrected X and Y
43 coordinates and column :NUMBER, which
44 sequentially identifies holes on starplate.
45 Its descriptors contain all relevant
46 parameters created or updated by
47 REFRACTION/OPTOPUS. Default name is
48 "opto3.tbl".
49 \ap\pa
50 [year,month,day] = \\date of the observation. The permitted
51 input formats are:\\
52 (1) YEAR,MONTH(number),DAY or\\
53 (2) YEAR.yyyyy,0,0\\
54 Default value is "1999.,12.,31.".
55 \ap\pa
56 [exp] = Exposure time in minutes of Optopus
57 plate. Default value is "0.".
58 \ap\pa
59 [lambda1,lambda2] = \\Wavelength range to optimize the
60 corrections for atmospheric refraction.
61 Input format must be: LAMBDA1,LAMBDA2
62 both in Angstroem. Default value is:
63 "3800,8000".
64 \ap\pa
65 [st_st_sl,en_st_sl] = \\Sidereal time slot, that is sidereal
66 time interval during which a given
67 Optopus plate will probably be used.
68 Input format must be:
69 ST1.ss,ST2.ss. Default value is:
70 "00.00,00.00".
71 \ap\pa
72 [opt_st] = Optimal sidereal time for correction
73 determinations, that is sidereal time
74 for which the corrections for
75 atmospheric refraction are calculated.
76 Input format must be: ST.ss.
77 Default value is: "00.00".
78 \ap\pa
79 [ast_flag] = Y or y (for yes) and N or n (for no)
80 are the alternatives. An [ast_flag]
81 set to Y enables the automatic
82 determination of the optimal sidereal
83 time for correction determinations
84 (see parameter [opt_st]). An input
85 from the user is otherwise requested.
86 Default value is "Y".
87 \ap\no
88 Note:
89 Any parameter of REFRACTION/OPTOPUS command can be defaulted.
90 It is actually possible to default all of them having
91 previously used the SET/OPTOPUS command (see documentation) to
92 select convenient values which will be stored in keywords
93 initialized in Optopus context.
94 \\
95 To correctly determine the sidereal time slot, it is useful to
96 have a test run of the command REFRACTION/OPTOPUS before
97 actually using it. This way one gets the sidereal times of the
98 beginning and end of the night, that is its duration, which
99 can be divided by 4 or 5, depending on how many Optopus plates
100 one wants to use, to get the 4 (or 5) sidereal time slots
101 (take care to allow for some 15-20 minutes of "warming up" at
102 the beginning of the night, of course).
103 \\
104 It is a good idea always to save all the parameters used in
105 an Optopus session by writing them into the descriptors of
106 the last created table, typically the output table of
107 REFRACTION/OPTOPUS, with the command SAVE/OPTOPUS tablename,
108 (see documentation). It will be possible later to retrieve
109 them by using RESTORE/OPTOPUS tablename (see documentation).
110 \\
111 We consider useful to remind here that it is possible to
112 have a print-out of the descriptors of any table by using the
113 commands:\\
114 (1) ASSIGN/PRINTER FILE filename\\
115 (2) PRINT/DESCRIPTORS table *\\
116 The descriptors values will be in the ASCII file "filename".
117 \on\exs
118 Examples:
119 \ex
120 REFRACTION/OPTOPUS op2 op3
121 \xe\ex
122 REFRACTION/OPTOPUS op2 op3 1991,10,9 60 4000,8000 20,22 21 n
123 \xe\ex
124 REFRACTION/OPTOPUS op2 op3 1991,10,9 60 4000,7500 20,22 ? y
125 \xe\ex
126 REFRACTION/OPTOPUS op2 op3 1991,10,9 60 ? 20,22 ? Y
127 \xe\sxe