/usr/share/doc/stilts/sun256/secB.31.2.html is in stilts-doc 3.1.2-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Examples</title>
</head>
<body>
<hr>
<a href="tmatchn.html">Next</a> <a href="tmatch2-usage.html">Previous</a> <a href="tmatch2.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tmatchn.html">tmatchn: Crossmatches multiple tables using flexible criteria</a><br>
<b>Up: </b><a href="tmatch2.html">tmatch2: Crossmatches 2 tables using flexible criteria</a><br>
<b>Previous: </b><a href="tmatch2-usage.html">Usage</a><br>
<hr>
<h3><a name="secB.31.2">B.31.2 Examples</a></h3>
<p>Here are some examples of using <code>tmatch2</code>:
<dl>
<dt><strong><pre>
stilts tmatch2 in1=obs_v.xml in2=obs_i.xml out=obs_iv.xml \
matcher=sky values1="ra dec" values2="ra dec" params="2"
</pre></strong></dt>
<dd>Takes two input catalogues (VOTables), one with observations in
the V band and the other in the I band, and performs a match
to find objects within 2 arcseconds of each other.
The result is a new table containing only rows where a match was found.
</dd>
<dt><strong><pre>
stilts tmatch2 survey.fits ifmt2=csv mycat.csv \
icmd1='addskycoords fk4 fk5 RA1950 DEC1950 RA2000 DEC2000' \
matcher=skyerr \
params=10 values1="RA2000 DEC2000 POS_ERR" values2="RA DEC 0" \
join=2not1 omode=count
</pre></strong></dt>
<dd>Here a comma-separated-values file is being compared with a FITS
catalogue representing some survey results.
Positions in the survey catalogue use the FK4 B1950.0 system,
and so a preprocessing step is inserted to create new position columns
in the first input table using the FK5 J2000.0 system,
which is what the other input table uses.
The survey catalogue contains a POS_ERR column which gives the positional
uncertainty of its entries, so the <code>skyerr</code> matcher is
used, which takes account of this; the third entry in the
<code>values1</code> parameter is the POS_ERR column (in arcsec).
Since the second input table has no positional uncertainty information,
0 is used as the third entry in <code>values2</code>.
The <code>params</code> gives a rough idea of the scale of the object
separations, but its value does not affect the result.
The join type is <code>2not1</code>, which means the output table
will only contain those entries which are in the second input table
but not in the first one.
The output table is not stored, but the number of rows it contains
(the number of objects represented in the CSV file but not the survey)
is written to the screen.
</dd>
<dt><strong><pre>
stilts tmatch2 ifmt1=ascii ifmt2=ascii in1=cat-a.txt in2=cat-b.txt \
matcher=2d values1='X Y' values2='X Y' params=5 join=1and2 \
suffix1=_a suffix2=_b \
ocmd='addcol XDIFF X_a-X_b; addcol YDIFF Y_a-Y_b' \
ocmd'keepcols "XDIFF YDIFF"' omode=stats
</pre></strong></dt>
<dd>Two ASCII-format catalogues are matched, where rows are
considered to match if their X,Y positions are within 5 units of
each other in some Cartesian space.
The result of the matching operation is a table of all the matched rows,
containing columns named X_a, Y_a, X_b and Y_b (along with any others
in the input tables) - the <code>suffix*</code> parameters describe
how the input X and Y columns are to be renamed to avoid duplicate
column names in the output table.
To this result are added two new columns,
representing the X and Y positional
difference between the rows from one input table and those from the other.
The <code>keepcols</code> filter then throws all the other columns away,
retaining only these difference columns.
The final two-column table is not stored anywhere,
but (<code>omode=stats</code>)
statistics including mean and standard deviation
are calculated on its columns and displayed to the screen.
Having done all this, you can examine the average X and Y differences
between the two input tables for matched rows, and if they differ
significantly from zero, you can conclude that there is a systematic
error between the positions in the two input files.
</dd>
<dt><strong><pre>
stilts tmatch2 in1=mgc.fits in2=6dfgs.xml join=1and2 find=all \
matcher=sky+1d params='3 0.5' \
values1='ra dec bmag' values2='RA2000 DEC2000 B_MAG" \
out=pairs.fits
</pre></strong></dt>
<dd>This performs a match with a matcher that combines <code>sky</code>
and <code>1d</code> match criteria. This means that the only
rows which match are those which are
<em>both</em> within 3 arcsec of each other on the sky
<em>and</em> and within 0.5 blue magnitudes.
Note that for both the <code>params</code> and the
<code>values1</code> and <code>values2</code> parameters,
the items for the <code>sky</code> matcher (RA and DEC)
are listed first,
followed by those for the <code>1d</code> matcher (in this case,
blue magnitude).
</dd>
</dl>
</p>
<hr><a href="tmatchn.html">Next</a> <a href="tmatch2-usage.html">Previous</a> <a href="tmatch2.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tmatchn.html">tmatchn: Crossmatches multiple tables using flexible criteria</a><br>
<b>Up: </b><a href="tmatch2.html">tmatch2: Crossmatches 2 tables using flexible criteria</a><br>
<b>Previous: </b><a href="tmatch2-usage.html">Usage</a><br>
<hr><i>STILTS - Starlink Tables Infrastructure Library Tool Set<br>Starlink User Note256<br>STILTS web page:
<a href="http://www.starlink.ac.uk/stilts/">http://www.starlink.ac.uk/stilts/</a><br>Author email:
<a href="mailto:m.b.taylor@bristol.ac.uk">m.b.taylor@bristol.ac.uk</a><br>Mailing list:
<a href="mailto:topcat-user@jiscmail.ac.uk">topcat-user@jiscmail.ac.uk</a><br></i></body>
</html>
|