← Back to branch summary

~ubuntu-branches/ubuntu/wily/eso-midas/wily-proposed

« back to all changes in this revision

Viewing changes to stdred/do/help/createost.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/do/help/createost.hlq
 
1
% @(#)createost.hlq     1.1 (ESO-IPG) 5/11/93 13:32:41
 
2
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
3
%.COPYRIGHT  (c)  1993 European Southern Observatory
 
4
%.IDENT      createost.hlq
 
5
%.AUTHOR     05-MAY-93, IPG/ESO
 
6
%.KEYWORDS   MIDAS, help files, 
 
7
%.PURPOSE    On-line help file for the command: CREATE/OST
 
8
%.VERSION    1.0  MP : Creation, 05-MAY-93
 
9
%----------------------------------------------------------------
 
10
\se
 
11
SECTION./OST
 
12
\es\co
 
13
CREATE/OST                                         MP  05-MAY-93
 
14
\oc\su
 
15
CREATE/OST  file_specs [file_pref] intable outtable flag
 
16
   create an Observation Summary Table   
 
17
\us\pu
 
18
Purpose:    
 
19
            create an Observation Summary Table 
 
20
\up\sy
 
21
Syntax:     
 
22
            CREATE/OST  file_specs [file_pref] intable outtable flag
 
23
\ys\pa
 
24
            file_specs = list of numbers of files to be processed (a) or
 
25
                         file specification as used in the VMS `$ DIRECTORY'
 
26
                         or UNIX `$ ls ' command (b) ( * matches  zero or more
 
27
                         characters, ? matches any single character, [] matches
 
28
                         one of the enclosed characters)
 
29
 \\
 
30
\ap\pa
 
31
            file_pref    = prefix of the files names. Used only with the option 
 
32
                         (a) of file_specs. The filenames will be built by
 
33
                         appending to the prefix the file number and the file
 
34
                         extension specified by "flag"
 
35
 \\
 
36
\ap\pa
 
37
            intable    = name of the input table containing the list of the
 
38
                         MIDAS descriptors to be mapped into the columns of the 
 
39
                         output table.
 
40
\ap\pa
 
41
            outtable   = name of the Observation Summary Table
 
42
 
 
43
\ap\pa
 
44
            flag       = 2-character flag: file format, append
 
45
                       file format flag : 
 
46
                       F(its), the file extension .mt is assumed when the 
 
47
                       option a) is used.
 
48
                       M(idas), the file extension is .bdf is assumed when the
 
49
                       option a) is used.
 
50
                       append flag: A(append to an existing OST) 
 
51
                                    C(reate a new OST)
 
52
                       Default flags are FC.
 
53
   
 
54
\ap\sa
 
55
See also: 
 
56
            CREATE/TABLE
 
57
\as\no
 
58
Note:       
 
59
            1) The Input Table must contain the followings columns:
 
60
\\{\tt
 
61
               DESCR_INAME (Character Column): contains the list of MIDAS  
 
62
\\
 
63
                                               descriptors to be mapped
 
64
\\
 
65
                                               into the columns of the OST.
 
66
\\
 
67
               IPOS        (Integer Column)  : contains for each descriptor 
 
68
\\
 
69
                                               the position of the element
 
70
\\
 
71
                                               to be read.
 
72
\\
 
73
               DESCR_ONAME (Character Column): contains for each descriptor
 
74
\\
 
75
                                               the label of the column of the 
 
76
\\
 
77
                                               OST in which will be stored its 
 
78
\\
 
79
                                               values
 
80
\\
 
81
               OTYPE       (Character Column): contains for each descriptor
 
82
\\
 
83
                                               the type of the column of the 
 
84
\\
 
85
                                               OST in which will be stored its
 
86
\\
 
87
                                               values 
 
88
\\
 
89
                                               I (integer), R(eal), D(double 
 
90
\\
 
91
                                               precision), C*n(character string)
 
92
\\}
 
93
 
 
94
            2) The command maps each of the MIDAS descriptors
 
95
               from the column DESCR_INAME of the Input Table into one column
 
96
               of the Output Table. The values of these descriptors are read  
 
97
               from each of the files of file_spec and are stored into one
 
98
               row of the Output Table. If a descriptor contains more than
 
99
               one element, the one at the position defined in the column :IPOS
 
100
               is taken.\\
 
101
               
 
102
\\
 
103
           3) The way FITS keywords are translated into MIDAS descriptors
 
104
              is decribed in the Chapter 7 of Volume A.
 
105
 \\
 
106
\on\exs
 
107
Examples:
 
108
\ex
 
109
            CREATE/OST ntt3*.mt ? ntt_descr ntt_ost 
 
110
            Process all the FITS files whose names match the pattern ntt3*.mt
 
111
            Read for each of them the values of the descriptors listed in 
 
112
            column :descr_iname of  table ntt_descr and store them in table
 
113
            ntt_ost
 
114
\\            
 
115
\xe\ex
 
116
            CREATE/OST 3-5 ntt ntt_descr ntt_ost MA
 
117
            Process the MIDAS images ntt0003.bdf, ntt0004.bdf, ntt0005.bdf,
 
118
            Read for each of them the values of the descriptors listed in
 
119
            column :descr_iname of the  table ntt_descr and append them
 
120
            in the existing table ntt_ost
 
121
\xe \sxe