← Back to branch summary

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

« back to all changes in this revision

Viewing changes to prim/help/computbary.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:
prim/help/computbary.hlq
 
1
% @(#)computbary.hlq    19.1 (ESO-IPG) 02/25/03 14:03:02 
 
2
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
3
%.COPYRIGHT  (c)  1992 European Southern Observatory
 
4
%.IDENT      computbary.hlq
 
5
%.AUTHOR     DB, IPG/ESO
 
6
%.KEYWORDS   MIDAS, help files, COMPUTE/BARYCORR
 
7
%.PURPOSE    On-line help file for the command: COMPUTE/BARYCORR
 
8
%.VERSION    1.0  02-JUL-1990 : Creation, DB
 
9
%.VERSION    1.1  02-SEP-1992 : Change to eastern longitude, PJG
 
10
%----------------------------------------------------------------
 
11
\se
 
12
SECTION./BARY
 
13
\es\co
 
14
COMPUTE/BARYCORR                                10-OCT-1995  DB
 
15
\oc\su
 
16
COMPUTE/BARYCORR date UT alpha delta [longitude] [latitude]
 
17
COMPUTE/BARYCORR table.tbl [longitude] [latitude]
 
18
COMPUTE/BARYCORR image alpha delta [longitude] [latitude]
 
19
        correct universal times and radial velocities to center of sun or 
 
20
        barycenter of solar system
 
21
\us\pu
 
22
Purpose:     
 
23
             Correct universal times and radial velocities to center of
 
24
             sun or barycenter of solar system .
 
25
\up\sy
 
26
Syntax:      
 
27
             a) COMPUTE/BARYCORR date UT alpha delta [longitude] [latitude]
 
28
             b) COMPUTE/BARYCORR table.tbl [longitude] [latitude]
 
29
             c) COMPUTE/BARYCORR image alpha delta [longitude] [latitude]
 
30
\ys\pa
 
31
             date = year,month,day
 
32
\ap\pa
 
33
             UT = universal time (hour,min,sec)
 
34
\ap\pa
 
35
             alpha = right ascension (hour,min,sec)
 
36
\ap\pa
 
37
             delta = declination (degree,min,sec)
 
38
\ap\pa
 
39
             longitude = EAST longitude of observatory (degree,min,sec),
 
40
\\
 
41
                         default: -70,43,55.35 (= Schmidt telescope, La Silla)
 
42
\\
 
43
                         must be negative !
 
44
                         NOTE: Eastern longitudes are used conforming to IAU.
 
45
\ap\pa
 
46
             latitude = of observatory (degree,min,sec), defaulted to
 
47
                        -29,15,25.8 (= Schmidt telescope, La Silla)
 
48
\ap\pa
 
49
             table = name of table with the following columns:
 
50
\\
 
51
                     :AHR, :MIN, :ASEC     right ascension of object
 
52
\\
 
53
                     :DDEG, :DMIN :DSEC    declination of object
 
54
\\
 
55
                     :YEAR :MONTH :DAY     date of observation
 
56
\\
 
57
                     :UTHR :UTMIN :UTSEC   UT of observation
 
58
\ap\pa
 
59
             image = name of image, then the date is taken from double prec.
 
60
                     descriptor O_TIME(1,2,3) and the UT from O_TIME(5)
 
61
                     of that image
 
62
\ap\pa
 
63
             longitude = EAST longitude of observatory (degree,min,sec)
 
64
                         default: -70,43,35.55 (= Schmidt telescope, La Silla)
 
65
                         NOTE: Eastern longitudes are used conforming to IAU.
 
66
\ap\pa
 
67
             latitude = of observatory (degree,min,sec), defaulted to
 
68
                        -29,15,25.8 (= Schmidt telescope, La Silla)
 
69
 
 
70
\ap\no
 
71
Note:        
 
72
             Reference:  P. Stumpff, A\&A Suppl. Ser. 41, pp. 1-8 (1980)
 
73
\\
 
74
             All times, dates, and coordinates are of type REAL so that,
 
75
             e.g., the date can also be entered as 1987.787,0,0 or just
 
76
             1987.767 . However, parameters must not be combined. That is,
 
77
             in the example given, the fraction of the year may contain
 
78
             only the number of elapsed full days, not also UT. 
 
79
             The same applies to table input, however all input
 
80
             columns must be present even if they contain only zeros. The
 
81
             minus sign for negative values may occur in any field.
 
82
\\
 
83
             a)+ b) Output: will be written to the following keywords:
 
84
\\
 
85
             OUTPUTD/D/1/1  barycentric correction to time (days)\\
 
86
             OUTPUTD/D/2/1  heliocentric correction to time (days)\\
 
87
             OUTPUTR/R/1/1  barycentric correction to radial velocity (km/s)\\
 
88
             OUTPUTR/R/2/1  heliocentric correction to radial velocity (km/s)\\
 
89
\\
 
90
             b) Output: the following table columns will be created or updated:
 
91
\\
 
92
             :BCT        barycentric correction time\\
 
93
             :HCT        heliocentric correction time\\
 
94
             :EBRV       earth's barycentric radial velocity\\
 
95
             :EHRV       earth's heliocentric radial velocity\\
 
96
             :EDV        earth's diurnal velocity (already included in
 
97
                         EBRV and EHRV)\\
 
98
\\
 
99
             (Note that the table option is very slow.)
 
100
\\
 
101
             For the ultimate accuracy, it will be necessary to precess
 
102
             (command COMPUTE/PRECESS) the coordinates to the date of the
 
103
             observation.
 
104
\\
 
105
             In order to correct measured RV's and JD's, the corrections need
 
106
             to be added as they are, i.e. taking into account their signs.
 
107
\\
 
108
             Eastern longitudes are positive and western counted
 
109
             negative conforming to IAU recommendations.
 
110
\\
 
111
             To enable automatic distinction between tables and images by the
 
112
             command, you should enter the name with the file type (extension),
 
113
             e.g. name.tbl or name.bdf. If no file type is given we default to
 
114
             a table, i.e. we use `name.tbl' .
 
115
\on\exs
 
116
Examples:
 
117
\ex
 
118
             COMPUTE/BARYCORR  obslist.tbl  155,28.3 19,49.6
 
119
               Compute corrections to UT's and RV's of observations obtained
 
120
               on Mauna Kea, Hawaii
 
121
\xe\ex
 
122
             COMPUTE/BARY  1987,12,24  1,39,10  6,44,35.8  -16,41,56
 
123
               Compute corrections to UT's and RV's of observations of Sirius
 
124
               obtained at La Silla on Xmas eve 1987
 
125
\xe\ex
 
126
             COMPUTE/BARYCORR  obsfile.bdf 6,44,35.8  -16,41,56
 
127
               Compute corrections to UT's and RV's of observations of Sirius
 
128
               obtained at La Silla; date and UT are taken from descriptor
 
129
               O_TIME of `obsfile.bdf'.
 
130
\xe \sxe