Debian Codegraph @

stdred/optopus/help/holes_opto.hlq

raw
1 % @(#)holes_opto.hlq 19.1 (ESO-IPG) 02/25/03 14:27:22
2 %+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
3 %.COPYRIGHT (c) 1991 European Southern Observatory
4 %.IDENT optop.hlq
5 %.AUTHOR A. Gemmo Padova Department of Astronomy
6 %.KEYWORDS MIDAS, help files, HOLES/OPTOPUS
7 %.PURPOSE On-line help file for the command: HOLES/OPTOPUS
8 %.VERSION 1.0 13-SEP-1991 : Creation, AG
9 %-----------------------------------------------------------------------
10 \se
11 SECTION./OPTO
12 \es\co
13 HOLES/OPTOPUS 13-SEP-1991 AG
14 \oc\su
15 HOLES/OPTOPUS [inp_tab] [out_tab] [HH,MM,SS.sss] [+/-DD,AM,AS.ss]
16 [ac_flag] [p_flag] [old_eq,new_eq]
17 detetermine holes positions on Optopus plate.
18 \us\pu
19 Purpose:
20 Calculate X and Y positions of guidestars and scientific
21 targets on Optopus plate from RA and DEC equatorial
22 coordinates using the center provided by the user or
23 calculating it automatically upon request. Checks are made
24 to point out objects falling out of the plate limits or in
25 the so called "forbidden area".
26 Overlaps between big guidestars, big and small guidestars,
27 big guidestars and objects, small guidestars and objects
28 and objects and objects are also notified to the user.
29 \up\sy
30 Syntax:
31 HOLES/OPTOPUS [inp_tab] [out_tab] [HH,MM,SS.sss]
32 [+/-DD,AM,AS.ss] [ac_flag] [p_flag] [old_eq,new_eq]
33 \ys\pa
34 [inp_tab] = table created by the command
35 CREATE/OPTOPUS and containing columns :IDENT,
36 :TYPE, :CHECK, :OLDRA, :OLDDEC, (if the
37 command PRECESS/OPTOPUS has been used),
38 :RA and :DEC. Default name is "opto1.tbl".
39 \ap\pa
40 [out_tab] = output table, with :X, :Y, and :Z columns,
41 instead of :RA and :DEC.
42 Default name is "opto2.tbl".
43 \ap\pa
44 [HH,MM,SS.sss] = \\Right Ascension of center of the plate.
45 If defaulted, it is automatically
46 calculated by taking the mean (see
47 STATISTIC/TABLE command) of column :RA in
48 input table or by reading the value set
49 with the command SET/OPTOPUS CRA=....
50 (see documentation to SET/OPTOPUS).
51 \ap\pa
52 [+/-DD,AM,AS.ss] = \\Declination of center of the plate.
53 If defaulted, it is automatically
54 calculated by taking the mean (see
55 STATISTIC/TABLE command) of column :DEC
56 in input table or by reading the value
57 set with the command SET/OPTO CDEC=...
58 (see documentation to SET/OPTOPUS).
59 \ap\pa
60 [ac_flag] = Character flag which enables or
61 desables the automatic calculation of
62 the center. Default value is "Y" for
63 yes. If [ac_flag] is set to "Y" and RA
64 and DEC of the center are defaulted,
65 then the center is determined by
66 averaging :RA and :DEC columns of
67 input table. If, on the contrary,
68 [ac_flag] is set to "N" and RA and DEC
69 of the center are defaulted, the
70 corresponding values are read from the
71 keywords set with SET/OPTO CRA= CDEC=
72 command (see documentation).
73 \ap\pa
74 [p_flag] = Character flag which enables or
75 desables the automatic precession of
76 the center. Default value is "Y" for
77 yes. [p_flag] should be set to "N" if
78 the user has already precessed the
79 center coordinates to [new_equinox].
80 In case of an automatic determination
81 of the center from an input table
82 already precessed by the command
83 PRECESS/OPTOPUS, [p_flag] is
84 automatically set to "N".
85 \ap\pa
86 [old_eq,new_eq] = \\Old and new epoch (before and after
87 precession) of center coordinates.
88 Default values are 1950.0 for [old_eq]
89 and 2000.0 (or the epoch calculated
90 from year,month,day of the observation
91 if these values have already been set
92 by the command SET/OPTOPUS DATE=...
93 (see documentation)) for [new_eq].
94 \ap\no
95 Note:
96 Any parameter of HOLES/OPTOPUS command can be defaulted.
97 It is actually possible to default all of them having
98 previously used the SET/OPTOPUS command (see documentation)
99 to select convenient values which will be stored in keywords
100 initialized in Optopus context.
101 It is convenient to flip from the command HOLES/OPTOPUS to
102 the command MODIFY/OPTOPUS and viceversa to check that all
103 the objects in "wrong" position have been actually deleted
104 from HOLES/OPTOPUS input table. One can be sure this has
105 happened when no warning messages are displayed after
106 having issued the command HOLES/OPTOPUS. (See also
107 documentation to MODIFY/OPTOPUS command).
108 \on\exs
109 Examples:
110 \ex
111 HOLES/OPTOPUS op1 op2 00,35,43.345 -00,11,53.56 n y 1950,1991.76
112 \xe\ex
113 HOLES/OPTOPUS op1 op2 ? ? y
114 \xe\ex
115 HOLES/OPTOPUS ? ? 00,35,43.345 -00,11,53.56 n y 1950,1991.76776
116 \xe\ex
117 HOLES/OPTOPUS op1 op2 00,35,43.345 -00,11,53.56 Y n
118 \xe\ex
119 HOLES/OPTOPUS op1 op2
120 \xe\sxe