/usr/share/doc/stilts/sun256/coneskymatch.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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>coneskymatch:
Crossmatches table on sky position against remote cone service
</title>
</head>
<body>
<hr>
<a href="coneskymatch-usage.html">Next</a> <a href="secB.2.2.html">Previous</a> <a href="cmdUsage.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="coneskymatch-usage.html">Usage</a><br>
<b>Up: </b><a href="cmdUsage.html">Command Reference</a><br>
<b>Previous: </b><a href="secB.2.2.html">Examples</a><br>
<hr>
<hr>
<h2><a name="coneskymatch">B.3 <code>coneskymatch</code>:
Crossmatches table on sky position against remote cone service</a></h2>
<p><em>Note: this command is very inefficient for large tables,
and in most cases
<a href="cdsskymatch.html"><code>cdsskymatch</code></a> or
<a href="tapskymatch.html"><code>tapskymatch</code></a>
provide better alternatives.
</em></p>
<p><code>coneskymatch</code> is a utility which performs a
cone search-like
query to a remote server for each row of an input table.
Each of these queries returns a table with one row for each
item held by the server in the region of sky represented by
the input row.
The results of all the queries are then concatenated into one big
output table which is the output of this command.
</p>
<p>The type of virtual observatory service queried is determined by the
<code>servicetype</code> parameter.
Typically it will be a
<a href="http://www.ivoa.net/Documents/latest/ConeSearch.html">Cone Search</a> service,
which queries a remote catalogue for astronomical objects or sources
in a particular region.
However, you can also query
<a href="http://www.ivoa.net/Documents/latest/SIA.html">Simple Image Access</a> and
<a href="http://www.ivoa.net/Documents/latest/SSA.html">Simple Spectral Access</a> services
in just the same way, to return tables of available
image and spectral resources in the relevant regions.
</p>
<p>The identity of the server to query is given by the
<code>serviceurl</code> parameter.
Some advice about how to locate URLs for suitable services is given
in <a href="coneService.html">Appendix B.3.3</a>.
</p>
<p>The effect of this command is like doing a positional crossmatch
where one of the catalogues is local and the other is remote and
exposes its data via a cone search/SIA/SSA service.
Because of both the network communication and the necessarily naive
crossmatching algorithm (which scales linearly with the size of the
local catalogue) however,
it is only suitable if the local catalogue has a reasonably small
number of rows, unless you are prepared to wait a long time.
</p>
<p>The <code>parallel</code> parameter allows you to perform multiple
cone searches concurrently, so that instead of completing the
first cone search, then the second, then the third,
the program can be executing a number of them at once.
This can speed up operation considerably, especially
in the face of network latency, but beware that submitting a very large
number of queries simultaneously to the same server may overload it,
resulting in some combination of failed queries, ultimately slower runtimes,
and unpopularity with server admins.
Best to start with a low parallelism and cautiously increase it to
see whether there are gains in performance.
</p>
<p>Note that when running, <code>coneskymatch</code> can generate a lot
of WARNING messages. Most of these are complaining about badly formed
VOTables being returned from the cone search services. STILTS does its
best to work out what the service responses mean in this case,
and usually makes a good enough job of it.
</p>
<p><em>Note: this task was known as <code>multicone</code> in its experimental
form in STILTS v1.2 and v1.3.</em>
</p>
<ul>
<li><a href="coneskymatch-usage.html">B.3.1 Usage</a></li>
<li><a href="secB.3.2.html">B.3.2 Examples</a></li>
<li><a href="coneService.html">B.3.3 Locating Cone Query Service URLs</a></li>
</ul>
<hr><a href="coneskymatch-usage.html">Next</a> <a href="secB.2.2.html">Previous</a> <a href="cmdUsage.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="coneskymatch-usage.html">Usage</a><br>
<b>Up: </b><a href="cmdUsage.html">Command Reference</a><br>
<b>Previous: </b><a href="secB.2.2.html">Examples</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>
|