/usr/share/doc/stilts/sun256/secB.37.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 | <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="votcopy.html">Next</a> <a href="tskymatch2-usage.html">Previous</a> <a href="tskymatch2.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="votcopy.html">votcopy: Transforms between VOTable encodings</a><br>
<b>Up: </b><a href="tskymatch2.html">tskymatch2: Crossmatches 2 tables on sky position</a><br>
<b>Previous: </b><a href="tskymatch2-usage.html">Usage</a><br>
<hr>
<h3><a name="secB.37.2">B.37.2 Examples</a></h3>
<p>Here are some examples of using <code>tskymatch2</code>:
<dl>
<dt><strong><pre>
stilts tskymatch2 in1=obs_v.xml in2=obs_i.xml out=obs_iv.xml \
ra1=OBS_RA dec1=OBS_DEC ra2=OBS_RA dec2=OBS_DEC error=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 VOTable containing only rows where a match was found.
</dd>
<dt><strong><pre>
stilts tskymatch2 in1=obs_v.xml in2=obs_i.xml out=obs_iv.xml \
error=2
</pre></strong></dt>
<dd>This is the same as the previous example but without explicit
specification of the sky position columns in either table.
It will work only if those columns are identified with appropriate
UCDs, for instance <code>pos.eq.ra;meta.main</code> and
<code>pos.eq.dec:meta.main</code>.
If no suitable UCDs are in place this invocation will fail with an error.
</dd>
<dt><strong><pre>
stilts tskymatch2 in1=virgo1.txt ifmt1=ascii in2=mgc.fits \
ra1='radiansToDegrees(raRad)' dec1='radiansToDegrees(deRad)' \
ra2=MGC_ALPHA_J2000 dec2=MGC_DELTA_J2000 \
error=10 join=2not1 omode=count
</pre></strong></dt>
<dd>Object positions in the text file virgo1.txt are compared to those
in the FITS file mgc.fits. The angles have been recorded in the text file
in radians, so they are converted to degrees here before use.
Use of the <code>join=2not1</code> parameter causes the command to
identify all the objects in the first list
which do not have counterparts within 10 arcsec in the second list.
The number of such objects found is simply output to the terminal.
</dd>
</dl>
</p>
<hr><a href="votcopy.html">Next</a> <a href="tskymatch2-usage.html">Previous</a> <a href="tskymatch2.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="votcopy.html">votcopy: Transforms between VOTable encodings</a><br>
<b>Up: </b><a href="tskymatch2.html">tskymatch2: Crossmatches 2 tables on sky position</a><br>
<b>Previous: </b><a href="tskymatch2-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>
|