← Back to branch summary

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

« back to all changes in this revision

Viewing changes to prim/help/regrestabl.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/regrestabl.hlq
 
1
% @(#)regrestabl.hlq    19.1 (ESO-IPG) 02/25/03 14:03:40 
 
2
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
3
%.COPYRIGHT  (c)  1990 European Southern Observatory
 
4
%.IDENT      regrestabl.hlq
 
5
%.AUTHOR     JDP, IPG/ESO
 
6
%.KEYWORDS   MIDAS, help files, REGRESSION/TABLE
 
7
%.PURPOSE    On-line help file for the command: REGRESSION/TABLE
 
8
%.VERSION    1.0  28-OCT-1985 : Creation, JDP
 
9
%----------------------------------------------------------------
 
10
\se
 
11
SECTION./TABL
 
12
\es\co
 
13
REGRESSION/TABLE                                        28-OCT-1985  JDP
 
14
\oc\su
 
15
REGRESSION/TABLE table1 x1[,x2] table2 y1[,y2] degree tol [guess]
 
16
        polynomial fit of variables in two tables (not yet implemented)
 
17
\us\pu
 
18
Purpose:    
 
19
            Polynomial fit of one or two variables  between  two tables.
 
20
            The command can be used to find the correspondence between
 
21
            the entries in the two tables.
 
22
            There are two modes of operation:\\
 
23
            1. A initial correspondance between the entries is defined
 
24
               by the REFERENCE columns in both tables.
 
25
               (see command SET/REFERENCE)\\
 
26
            2. Initial guesses for the correspondence are given as a
 
27
               set of coeffs.\\
 
28
            The reference column of the first input table is updated to
 
29
            include the references of the correspondent entries in the
 
30
            second input table.
 
31
\up\sy
 
32
Syntax:     
 
33
            REGRESSION/TABLE table1 x1[,x2] table2 y1[,y2] degree tol [guess]
 
34
\ys\pa
 
35
            table1  = first table name
 
36
\ap\pa
 
37
            x1,[x2] = columns with the values to compare
 
38
\ap\pa
 
39
            table2  = second table name
 
40
\ap\pa
 
41
            y1,[y2] = columns with the values to compare
 
42
\ap\pa
 
43
            degree  = degree of the polynomial used in the
 
44
                      transformation (1D or 2D)
 
45
\ap\pa
 
46
            tol     = tolerance in the correspondance
 
47
\ap\pa
 
48
            guess   = optional guesses for the transformation in
 
49
                      the second mode
 
50
\ap\out
 
51
Output:
 
52
            Output coefficients are listed on terminal and stored in the 
 
53
            following keywords:\\
 
54
            OUTPUTC   - character information\\
 
55
            OUTPUTR(5)- Standard error of the estimate\\
 
56
            OUTPUTI(1)- N,no.of data,\\
 
57
                   (2)- M,no.of ind.var.\\
 
58
                   (4)- col.no. of indep.var.\\
 
59
                   (5)- degree (ND)\\
 
60
            OUTPUTD(i)- Coefficients\\
 
61
                        i=1,...,ND+1
 
62
\tuo\no
 
63
Note:   
 
64
            1.  The main applications are\\
 
65
              - In spectroscopy to compute the dispersion coefficients,
 
66
                by comparing the user table with line positions and initial
 
67
                identifications (table1) with the line catalogue (table2).\\
 
68
              - In astrometry to compare object positions from to tables.\\
 
69
            2.  The coefficients can be saved (SAVE/REGRESSION) and
 
70
                used latter to compute fitted values (COMPUTE/REGRESSION).\\
 
71
            3.  The command requires to set the reference columns in both
 
72
                tables.
 
73
\on\exs
 
74
Examples:
 
75
\ex
 
76
            An application of REGRESSION/TABLE
 
77
            The following sequence will identify entries in mytable
 
78
            and will compute the dispersion coefficients in a 1D
 
79
            application:
 
80
\xe\ex
 
81
            IDENTIFY/GCURSOR mytable :IDENT :X
 
82
\xe\ex
 
83
            SET/REFERENCE    mytable :IDENT
 
84
\xe\ex
 
85
            SET/REFERENCE    lincat  :WAVE
 
86
\xe\ex
 
87
            REGRESSION/TABLE mytable :X LINCAT :WAVE 5 0.1
 
88
\xe\ex
 
89
            SAVE/REGRESSION  mytable DISPCOEF
 
90
            The command is not yet implemented
 
91
\xe \sxe