/usr/share/doc/munipack/man_cone.html is in munipack-doc 0.5.10-1.
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 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 | <!DOCTYPE HTML>
<html lang="en">
<head>
<!-- meta -->
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta name="description" content="A general astronomical image processing software">
<meta name="author" content="Filip Hroch">
<link href="news_feed.xml" type="application/atom+xml" rel="alternate" title="Sitewide ATOM Feed" />
<link type="text/css" rel="stylesheet" href="munipack.css">
<link rel="shortcut icon" href="favicon.ico">
<title>Munipack ‒ Cone Search</title>
</head>
<body>
<header>
<a href="munipack.html"><img src="title_logo.png" alt="Munipack's logo" class="head"></a>
<div class="headhead">
<div class="headtitle">
<a class="headtitle" href="munipack.html">Munipack</a>
<a class="headsubtitle" href="munipack.html">A general astronomical image processing software</a>
</div>
<ul class="menu">
<li class="menu">◈ <a href="docs.html" class="menu">Documents</a></li>
<li class="menu">☺ <a href="guide.html" class="menu">User guide</a></li>
</ul>
</div>
</header>
<h1>Cone Search</h1>
<p class="abstract">
Cone search of catalogues provided by Virtual Observatory.
</p>
<h2>Command</h2>
<pre>
munipack cone [.. options ..] [--] RA DEC
munipack cone [--list-catalogues | --list-servers]
</pre>
<h2>Description</h2>
<p>
Search a selected catalogue provided by Virtual observatory
interface (VO-capable cone search) with following features:
</p>
<ul>
<li>List of available catalogues is prepared.</li>
<li>List of available servers is prepared.</li>
<li>All parameters are in degrees.</li>
<li>Output is stored to VOTable format (XML),
FITS table or a plain text or any format supported by
<a href="man_votable.html">votable</a>.</li>
</ul>
<p>
</p>
<h2>Southern Declinations</h2>
<p>
Negative coordinates starts with minus sign which can be recognised,
by the parsing routine, as an option or a switch. To prevent the confusion,
we must separate options and parameters by double-dash [--]. Than recognition
of the coordinates will work as expected.
</p>
<p>
A typical message when the problem is occurred:
<pre>
$ munipack cone 245.9 -26.5
Unknown option '26'
Usage: munipack cone ...
</pre>
<p>
And can be easy solved as
</p>
<pre>
$ munipack cone -- 245.9 -26.5
</pre>
<h2>Catalogue Servers</h2>
<p>
Central Virtual Observatory catalogue site (VizieR) is maintained by
<a href="http://cdsweb.u-strasbg.fr/">Centre de Données astronomiques de Strasbourg</a>
and provided as a <a href="http://vizier.u-strasbg.fr/viz-bin/VizieR">VizieR</a> service.
The service is mirrored by other sites. The option <samp>--service</samp>
offers possibility to select an appropriate mirror.
</p>
<h2>Network Timeout</h2>
<p>
Sometimes connection can not be established on first attempt or a network
connection is down, in this case, the connection will be repeated for a while.
</p>
<h2>Input And Output</h2>
<p>
On input, no files are expected. Virtual Observatory is connected via network.
</p>
<p>
On output, results of the cone search are saved to a file.
</p>
<h2>Selection Constrains</h2>
<p>
Some servers supports additional parameters for search, output form and etc.
For instance, there is a way how to limit magnitudes in V filter for stars
brighter than eleven:
</p>
<pre>
munipack cone --par 'Vmag=<11' -- 245.9 -26.5
</pre>
<p>
Additional info can be found in <a href="http://vizier.u-strasbg.fr/vizier/doc/vizquery.htx">VizieR</a> query documentation.
</p>
<h2>Parameters</h2>
<dl>
<dt><samp>-c,--cat</samp></dt><dd>catalogue alias (see --list-catalogues)</dd>
<dt><samp>-r</samp></dt><dd>search radius in degrees (default: 0.1)</dd>
<dt><samp>-s</samp></dt><dd>sort by the column</dd>
<dt><samp>--url</samp></dt><dd>use the URL. Following options are ignored:
-c, --cat, --par, -r, --server</dd>
<dt><samp>--id</samp></dt><dd>Full catalogue identifier</dd>
<dt><samp>--par</samp></dt><dd>additional optional parameters (by default maximum
verbosity is used)</dd>
<dt><samp>--type</samp></dt><dd>type of output file: fits,csv,txt,xml
(default by suffix of <samp>-o</samp> option)</dd>
<dt><samp>--vocat</samp></dt><dd>an alternative configuration file (normally, located in
<samp>[/opt]/usr/share/munipack/VOcat_conf.xml</samp>)</dd>
<dt><samp>--server</samp></dt><dd>use VizieR's mirror</dd>
<dt><samp>--list-catalogues</samp></dt><dd>list of predefined catalogues</dd>
<dt><samp>--list-servers</samp></dt><dd>list of available VizieR servers</dd>
<dt><samp>--</samp></dt><dd>Double-dash separates options and switches from
coordinates. One is necessary for negative coordinates (else parsing can be confused
by minus representing of an option).</dd>
</dl>
<p>
See <a href="man_com.html">Common options</a> for input/output filenames.
</p>
<h2>Using Another Catalogue</h2>
<p>
The list of available catalogues is limited. Another required catalogue can
be added by this way:
</p>
<ul>
<li>Go to <a href="http://vizier.u-strasbg.fr/viz-bin/VizieR">VizieR</a>
service and discover your catalogue. We will need ID of the catalogue like
"J/A+A/544/A31" (Ptolemaios catalogue).</li>
<li>
Invoke the cone as
<pre>munipack cone --id 'J/A+A/544/A31' -r 1 -- 104 -16</pre>
</li>
<li>
To use the data, apropriate parameters <samp>--col-ra, --col-dec,
--col-pm-ra, --col-pm-dec</samp> for <samp>astrometry, phcal,</samp> etc
must be specified.
</li>
</ul>
<h2>Examples</h2>
<p>
Search GSC catalogue within Pleiades (α = 92.4°, δ = 24.1°) with cone radius
of 0.2°:
</p>
<code>
$ munipack cone -c GSC -r 0.2 92.4 24.1
</code>
<p>
Cone search for negative coordinates needs separate parameters and
options with double-dash:
</p>
<code>
$ munipack cone -c UCAC5 -r 0.2 -- 245.9 -26.5
</code>
<h2>See Also</h2>
<p><a href="vobs.html">Virtual Observatory</a>,
<a href="man_com.html">Common options</a>,
<a href="http://cdsweb.u-strasbg.fr/vizier/doc/vizquery.htx">vizquery documentation</a>.
</p>
<footer>
<div style="float:left; margin-left:2em;">
Copyright © 1997 – 2018
Filip Hroch (<a style="text-decoration: none" href="mailto:hroch@physics.muni.cz?Subject=Munipack" title="Author's Email">✉</a>), license <a href="http://www.gnu.org/licenses/gpl.html">GPLv3</a>.
</div>
<div style="float:right; margin-right:2em; margin-top:-0.2em;">
<a href="http://monteboo.blogspot.com/search/label/Munipack" title="Munipack on MonteBoo Blog"><img src="favicon-blogger.png" alt="Blogger"></a>
<a href="http://www.muni.cz/?lang=en" title="Masaryk University in Brno, Czech Republic"><img src="mu-logo.png" alt="Masaryk University"></a>
<a href="news_feed.xml" title="Munipack's Releases in Atom Syndication Format"><img src="Feed-icon.png" alt="Atom Feed"></a>
</div>
</footer>
</body>
</html>
|