/usr/share/doc/stilts/sun256/secB.23.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 | <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="tcat.html">Next</a> <a href="tapskymatch-usage.html">Previous</a> <a href="tapskymatch.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tcat.html">tcat: Concatenates multiple similar tables</a><br>
<b>Up: </b><a href="tapskymatch.html">tapskymatch:
Crossmatches table on sky position against TAP table</a><br>
<b>Previous: </b><a href="tapskymatch-usage.html">Usage</a><br>
<hr>
<h3><a name="secB.23.2">B.23.2 Examples</a></h3>
<p>Here are some examples of <code>tapskymatch</code>:
<dl>
<dt><strong><pre>
stilts tapskymatch tapurl=http://dc.g-vo.org/tap
taptable=twomass.data taplon=raj2000 taplat=dej2000
in=dr5qso.fits inlon=RA inlat=DEC sr=0.00027 find=all
out=qso_2mass.fits
</pre></strong></dt>
<dd>Matches a local catalogue <code>dr5qso.fits</code> against the
table named <code>twomass.data</code> in the GAVO TAP service.
The search radius is 1/3600 degrees (1 arcsecond) and all 2MASS
sources within the radius of each input source are returned.
<p>If you run the command with "<code>stilts -verbose ...</code>"
the text of the ADQL query submitted to the TAP service will
(amongst other things) be logged on the console, and you will also
see the number of rows uploaded and matched in each chunk.
</p>
</dd>
<dt><strong><pre>
stilts tapskymatch tapurl=http://dc.g-vo.org/tap
taptable=rave.dr3 taplon=raj2000 taplat=dej2000
tapcols=name,raj2000,dej2000,pmra,pmde
in=hip_main.fits inlon=RAdeg inlat=DEdeg
icmd='keepcols "HIP RAdeg DEdeg pmra pmde"'
sr=0.00027
icmd='select nearMoc(\"III/265/ravedr3\",RAdeg,DEdeg,.00027)'
icmd=cache icmd=progress
blocksize=5000
fixcols=all suffixin=_hip suffixremote=_rave
find=best
omode=topcat
</pre></strong></dt>
<dd>This matches a local copy of the Hipparcos survey against
a remote copy of the RAVE survey with a 1-arcsecond radius.
The output table contains only the identifier, position and proper
motion columns from
both the input table (by using the <code>keepcols</code> filter)
and the remote table (by specifying <code>tapcols</code>);
the other columns are discarded.
The <code>fixcols</code> and <code>suffix</code>* parameters
ensure that a suffix is added to all the output column names,
<code>_hip</code> for the input (Hipparcos) columns and
<code>_rave</code> for the remote (RAVE) ones.
<p>Before uploading, the input table is preprocessed by selecting only
those rows that fall within the actual footprint of the RAVE survey,
by filtering with a MOC giving RAVE coverage
(the RAVE dr3 MOC is also available at
<a href="http://alasky.u-strasbg.fr/footprints/tables/vizier/III_265_ravedr3/MOC">this URL</a>).
This step reduces the amount of data that needs to be uploaded,
since only those rows in the given coverage region stand a chance of
having a match in the remote table.
Note use of the <code>nearMoc</code> function with the value of the
match radius as the fourth parameter; this includes those objects
which may be outside the actual MOC region but close enough that
a match could still result.
</p>
<p>The <code>blocksize</code> parameter determines the number of rows
uploaded at a time. If you receive warnings that the output has
been truncated, you should decrease this number.
</p>
<p>Progress is displayed as the match continues.
The <code>cache</code> filter must be applied upstream of (before)
the <code>progress</code> filter itself for this to work,
since otherwise the match processing reads all the input rows
before the actual work is done, and the progress monitor completes
before the match actually starts.
</p>
</dd>
</dl>
</p>
<hr><a href="tcat.html">Next</a> <a href="tapskymatch-usage.html">Previous</a> <a href="tapskymatch.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tcat.html">tcat: Concatenates multiple similar tables</a><br>
<b>Up: </b><a href="tapskymatch.html">tapskymatch:
Crossmatches table on sky position against TAP table</a><br>
<b>Previous: </b><a href="tapskymatch-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>
|