/usr/share/doc/stilts/sun256/secB.3.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 120 121 122 123 124 125 126 | <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="coneService.html">Next</a> <a href="coneskymatch-usage.html">Previous</a> <a href="coneskymatch.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="coneService.html">Locating Cone Query Service URLs</a><br>
<b>Up: </b><a href="coneskymatch.html">coneskymatch:
Crossmatches table on sky position against remote cone service</a><br>
<b>Previous: </b><a href="coneskymatch-usage.html">Usage</a><br>
<hr>
<h3><a name="secB.3.2">B.3.2 Examples</a></h3>
<p>Here are some examples of <code>coneskymatch</code>:
<dl>
<dt><strong><pre>
stilts coneskymatch serviceurl=http://archive.stsci.edu/hst/search.php \
in=messier.xml sr=0.05 out=matches.xml
</pre></strong></dt>
<dd>This queries the HST cone search service from Space Telescope for
records within .05 degrees of each Messier object contained in a
local VOTable <code>messier.xml</code>.
The sky positions in the input catalogue are guessed from the available
table metadata.
The result is written to a new VOTable, <code>matches.xml</code>.
Since the <code>servicetype</code> parameter is not given, the
default (cone search) service type is assumed.
</dd>
<dt><strong><pre>
stilts coneskymatch
servicetype=sia \
serviceurl=http://irsa.ipac.caltech.edu/cgi-bin/2MASS/IM/nph-im_sia?type=ql&ds=asky \
in=messier.xml ra=RA dec=DEC \
dataformat=image/fits \
out=fitsimages.xml
</pre></strong></dt>
<dd>This is similar to the previous example, but
instead of querying an HST cone search server for catalogue objects
near the input table positions, it queries a 2MASS Simple Image Access
(SIA) server for images.
It also explicitly names the columns holding the J2000 positions of
reach record in the input catalogue as <code>RA</code> and <code>DEC</code>.
The search radius parameter (<code>sr</code>) is not set here;
for SIA queries the default search radius is zero, which has the
special meaning of including any image which covers the requested position.
Setting <code>dataformat=image/fits</code> (which is the default)
requests only records describing FITS-format images to be returned;
setting it to an empty value might return other formats such as JPEG too.
</dd>
<dt><strong><pre>
stilts coneskymatch \
serviceurl='http://www.nofs.navy.mil/cgi-bin/vo_cone.cgi?CAT=NOMAD' \
in=vizier.xml#7 \
icmd='addskycoords -inunit sex fk4 fk5 RAB1950 DEB1950 RAJ2000 DEJ2000' \
icmd='progress'
ra=RAJ2000 dec=DEJ2000 sr=0.01 \
ocmd='replacecol -units deg RA hmsToDegrees(RA[0],RA[1],RA[2])' \
ocmd='replacecol -units deg DEC dmsToDegrees(DEC[0],DEC[1],DEC[2])' \
omode=topcat
</pre></strong></dt>
<dd>In this example some pre-processing of the input catalogue and
post-processing of the output catalogue is performed as well as the
multiple cone search itself.
<p>The input catalogue, which is the 8th TABLE element in a VOTable file,
contains sky positions in sexagesimal FK4 (B1950) coordinates.
The <code>icmd=addskycoords...</code> parameter specifies a filter which
will add new columns in FK5 (J2000) degrees, which are what the
<code>coneskymatch</code> command requires.
The <code>icmd=progress</code> parameter specifies a filter which
will write progress information to the terminal so you can see how
the queries are progressing.
</p>
<p>The NOMAD service specified by the <code>serviceurl</code> parameter
used here happens to return results with the RA/DEC columns represented
in a rather eccentric format, namely 3-element floating point arrays
representing (hours,minutes,seconds)/(degrees,minutes,seconds).
The two <code>ocmd=replacecol...</code> filters replace the values of
these columns with the scalar equivalents in degrees.
Finally, the <code>omode=topcat</code> parameter causes the result
table to be loaded directly into TOPCAT (if it is available).
</p>
</dd>
<dt><strong><pre>
stilts coneskymatch serviceurl='http://archive.stsci.edu/iue/search.php?' \
in=queries.txt ifmt=ascii \
ra='$1' dec='$2' \
sr='$3' copycols='$4' \
out=found.fits
</pre></strong></dt>
<dd>Here the input is a plain text table with four unnamed columns,
giving in order the right ascension, declination,
positional error and name of target objects.
The command carries out a cone search to the named service for
each one. Note in this case the search radius (<code>sr</code> parameter)
is taken from the table and so varies for each query.
The <code>copycols</code> parameter has the value
'<code>$4</code>',
which means that the value of the fourth column of the input table
will be prepended to each row of the output table for
which it is responsible.
Output is to a FITS table.
</dd>
</dl>
</p>
<hr><a href="coneService.html">Next</a> <a href="coneskymatch-usage.html">Previous</a> <a href="coneskymatch.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="coneService.html">Locating Cone Query Service URLs</a><br>
<b>Up: </b><a href="coneskymatch.html">coneskymatch:
Crossmatches table on sky position against remote cone service</a><br>
<b>Previous: </b><a href="coneskymatch-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>
|