← Back to branch summary

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

« back to all changes in this revision

Viewing changes to prim/help/interpti.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/interpti.hlq
 
1
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
2
%.COPYRIGHT  (c)  1990-2005 European Southern Observatory
 
3
%.IDENT      interpti.hlq
 
4
%.AUTHOR     JDP, IPG/ESO
 
5
%.KEYWORDS   MIDAS, help files, INTERPOLATE/TI
 
6
%.PURPOSE    On-line help file for the command: INTERPOLATE/TI
 
7
%.VERSION    1.0  29-MAY-1987 : Creation, JDP
 
8
%----------------------------------------------------------------
 
9
\se
 
10
SECTION./TI
 
11
\es\co
 
12
INTERPOLATE/TI                                          9-NOV-2005 JDP
 
13
\oc\su
 
14
INTERPOLATE/TI outima intab i,d refima [s] [degree]
 
15
        interpolate Image to Image
 
16
\us\pu
 
17
Purpose:    
 
18
           Spline interpolation of 1D data; table to image transformation.
 
19
\up\sy
 
20
Syntax:     
 
21
           INTERPOLATE/TI outima intab i,d refima [s] [degree]
 
22
\ys\pa
 
23
           outima = name of 1-dim output image, will be created by
 
24
                    this command
 
25
\ap\pa
 
26
           intab  = name of input table
 
27
\ap\pa
 
28
           refima = reference image;
 
29
                    this image must have the desired start, step value
 
30
                    in descr. START and STEP
 
31
\ap\pa
 
32
           i = column reference for independent variable
 
33
\ap\pa
 
34
           d = column reference for dependent variable
 
35
\ap\pa
 
36
           s = smoothness parameter (default 1.)
 
37
\ap\pa
 
38
           degree = degree of spline, max. 5
 
39
           (default 3, cubic splines)
 
40
\ap\sa
 
41
See also:  
 
42
           INTERPOLATE/IT, REBIN/TI, CONVERT/TABLE
 
43
\as\no
 
44
Note:       
 
45
           This command should be used, if the new stepsize is NOT larger
 
46
           than the current stepsize in column `i' (i.e. the difference
 
47
           between adjacent rows).
 
48
           If the stepsize is larger, the command REBIN/TI should be used
 
49
           instead, since that is doing an integration.
 
50
 
 
51
           Values in the column used as independent variable must be
 
52
           monotonically increasing or decreasing. Best results are obtained,
 
53
           if they are increasing.
 
54
           The parameter s controls the degree of smoothing. This parameter
 
55
           has to be chosen carefully: too small s-values will result in
 
56
           an overfitting, too large s-values will produce an underfitting
 
57
           of the data. For s very large it returns the least-squares
 
58
           polynomial fit.
 
59
           The number of spline knots and their positions  are determined
 
60
           automatically, taking into account the specific behaviour of
 
61
           the function underlying the data.
 
62
           Ref.: P. Dierckxx, 1982, Computer Graphics and Image Processing,
 
63
           vol. 20, 171-184.
 
64
\on\sxe
 
65
Examples:
 
66
\ex
 
67
           CREATE/IMAGE refima 1,2000 0.123,0.002 NODATA
 
68
             We don't need any data in the ref. frame.
 
69
           INTERPOLATE/TI resima intab :X,:Y refima 1. 3
 
70
             Create image `resima.bdf' from column :Y of table `intab.tbl'
 
71
             corresponding to :X resampled with stepsize 0.002.
 
72
             Smoothness = 1 and we use cubic splines.
 
73
             The delta in :X between adjacent rows is assumed to be
 
74
             larger than (or equal to) 0.002 (otherwise we should have
 
75
             used REBIN/TI instead).
 
76
\xe \sxe