summaryrefslogtreecommitdiff
path: root/doc/average.html
blob: e67ab2d58924f145e7a1533a8de156c955ab3fb5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <title>average</title>
    <meta http-equiv="content-type" content="text/html;
      charset=windows-1252">
    <meta name="author" content="Graeme Gill">
  </head>
  <body>
    <h2><b>spectro/average</b></h2>
    <h3>Summary</h3>
    Average or merge two or more <a href="File_Formats.html#.ti3">.ti3</a>
    measurement files.<br>
    If only one input file is provided, all the patches with the same
    device values will be average together.<br>
    <h3>Usage</h3>
    <small><span style="font-family: monospace;"></span></small><small>
      <span style="font-family: monospace;"></span></small><small><span
        style="font-family: monospace;"></span></small><span
      style="font-family: monospace;">usage: average [-options]
      input1.ti3 input2.ti3 ... output.ti3</span><br style="font-family:
      monospace;">
    <span style="font-family: monospace;">&nbsp;-v&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;



      Verbose</span><br>
    <span style="font-family: monospace;">&nbsp;-e
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
      Median rather than average</span><br>
    <tt>&nbsp;-g&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;

      Geometric Median of PCS in encoded space</tt><tt><br>
    </tt><tt>&nbsp;-L&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;

      Geometric Median of PCS in L*a*b* space</tt><tt><br>
    </tt><tt>&nbsp;-X&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;

      Geometric Median of PCS in XYZ space</tt><br>
    <span style="font-family: monospace;">&nbsp;-m&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Merge



      rather than average</span><br style="font-family: monospace;">
    <span style="font-family: monospace;">&nbsp;input1.ti3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
First



      input file</span><br style="font-family: monospace;">
    <span style="font-family: monospace;">&nbsp;input2.ti3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Second



      input file</span><br style="font-family: monospace;">
    <span style="font-family: monospace;">&nbsp;...&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;



      etc.</span><br style="font-family: monospace;">
    <span style="font-family: monospace;">&nbsp;output.ti3&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
Resulting



      averaged or merged output file</span><br>
    <br>
    <br>
    All keywords and other table data will be taken from the first input
    file. By default the input files are averaged, but they can be
    merged by using the <span style="font-weight: bold;">-m</span>
    flag.<br>
    <br>
    The fields must be the same and in the same order. For averaging,
    the device values must be the same and in the same order.<br>
    <br>
    If the <b>-e</b> option is used, then the independent median (i.e.
    Marginal median) of the field values is used, rather than the
    average. <br>
    <br>
    If the<b> </b><b>-g</b> option is used, then <a
      href="https://en.wikipedia.org/wiki/Geometric_median">Geometric
      Median</a> of PCS values is computed in their encoded space (i.e.
    XYZ or L*a*b*).<br>
    <br>
    If the <b>-L</b> option is used, then Geometric Median of PCS
    values is computed in L*a*b* space.<br>
    <br>
    If the <b>-X</b> option is used, then Geometric Median of PCS
    values is computed in XYZ space.<br>
    <br>
  </body>
</html>