| 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 |