/usr/share/doc/munipack/vobs.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 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 | <!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 ‒ Virtual Observatory</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 class="noindent">Virtual Observatory</h1>
<p class="abstract">
How to get an information about astronomical objects by using of Virtual Observatory.
</p>
<h2>Introduction</h2>
<p>
<a href="http://en.wikipedia.org/wiki/Virtual_Observatory">Virtual observatory⤴</a>
(VO) is a network infrastructure developed by astronomers which standardizes access
for observational data, object catalogs and bibliographic sources.
Any astronomical data (as images, spectra, catalogs, …) are directly accessible
from VO without filling of web forms in browsers or hardly understanding data
stored in a home-made format. Moreover,
the data access should be easy automatized, the data can be preprocessed,
different network sources could be merged, etc.
</p>
<p>
VO is using <a href="http://www.ivoa.net/Documents/VOTable/">VO Table⤴</a>
for data exchange (for
data list, data serialization and as a control data). The VOTable
is basically <a href="http://en.wikipedia.org/wiki/XML">XML</a>
with exactly defined structure, keywords, status
codes etc. VOTables are mutually convertible to FITS tables.
VOTable is primary designed as a machine to a machine communications
format.
</p>
<p>
<em>Have in mind:</em> Munipack support for VO is unfinished and also unmatured.
Just only cone search and limited VO table parsing is implemented.
</p>
<h2>Cone search</h2>
<p>
Cone search is a simple search in a catalog around specified
point in spherical coordinates in a given solid angle.
</p>
<p>
The functionality is activated when <samp>cone</samp> is passed as
an argument. Equatorial spherical coordinates are specified as <samp>ra,dec</samp> and
search radius by <samp>-r</samp> switch. All quantities must be specified
in degrees (sexadecimal notation or radians are not supported).
The ICRS is used as the coordinate frame.
</p>
<p>
The simplest form is search specified catalgue passing just only angular
coordinates Right Ascension
and Declination in degrees separated by colon: the example below shows
query for Pleiades on roughly coordinates α = 92.4°, δ = 24.1°.
The objects are scanned within cone (radius) of 0.2° around the position.
</p>
<pre>
$ munipack cone -c Hipparcos -r 0.2 92.4 24.1
$ xmunipack cone.fits
</pre>
<p>
The switch <samp>-o</samp> can be used to store output in another
named file and the switch <samp>-t</samp> chooses format of the output
file (see details <a href="#votable">below</a>).
</p>
<p>
The sort of output table by a column can be useful when we got
a lot of data. The most common example is the astrometry, where it is
convenient put
bright stars on begin of the table. The sort option requires an exact column
designation. The designation is (cataloue) site-specific and there is no way
how to get the designations before a part of a table is transferred.
</p>
<h3>Data sources</h3>
<p>
When cone search (or another VO request) is performed, the default source
(<a href="http://simbad.u-strasbg.fr/simbad/">Simbad⤴</a>)
is connected. Another sources can be selected with <samp>--cat</samp> switch
for a set of predefined catalogs or <samp>--url</samp> and <samp>--par</samp> switches
for any available cone-search capable service.
</p>
<p>
Available
data catalogs can be listed by using <samp>--list</samp> option:
</p>
<pre>
$ munipack cone --list
Available catalogues (use --url to specify another):
Alias URL --------------------------
UCAC5 http://vizier.u-strasbg.fr/viz-bin/votable/-A?-source=I/340&
...
</pre>
<p>
Just for example, the astrometric catalog UCAC5 is selected by
</p>
<pre>
$ munipack --cat=UCAC5 cone 92.4 24.1
...
</pre>
<p>
Any cone-search service must support CGI get method, parameters for
coordinates and (optionally) some site-specific parameters. Generally,
the cone search has the form
</p>
<pre>
http://some.place.suffix/dir/cone-script.cgi?RA=92.4&DEC=24.1&parX=X
</pre>
<p>
where the first part (up to question mark <samp>?</samp>) points to Internet
address of the service along with a service script and the second part
specifies parameters for the search. More detailed description offers
<a href="http://www.ivoa.net/Documents/latest/ConeSearch.html">Cone Search
specification ⤴</a> document.
</p>
<p>
To access of an arbitrary cone-search server, simply set <samp>--url</samp>
switch to a value, as here:
</p>
<pre>
$ munipack --url="http://some.place.suffix/dir/cone-script.cgi?" cone 92.4 24.1
</pre>
<p>
Note use of quotes (or apostrophes) to prevent a possible shell expansion
and ending URL with question mark <samp>?</samp>. The cone search position
and radius are added, to the query, automatically.
</p>
<p>
Some services supports generic parameters for the search. Usually
ones sets limits for number of object search, limiting magnitude, etc.
The parameters can be passed as <samp>--par</samp> (multiple parameters are allowed):
</p>
<pre>
$ munipack --par="max=666" cone 92.4 24.1
</pre>
<h2><a id="votable">VOTable</a></h2>
<p>
VOTable is a basic format for data provided by VO. The VOTable
is supposed to be internal format for any data exchange. Therefore
any manipulation with data in VOTable is non-trivial (requires
XML parser). Munipack offers utility for conversion of VOTables
to another formats which ones can find useful.
</p>
<p>
Available formats for conversion:
</p>
<ul>
<li><samp>fits</samp> table</li>
<li><samp>csv</samp> (comas separated) for spreadsheet applications</li>
<li><samp>txt</samp> for both human or machine processing</li>
<li><samp>svg</samp> for drawing of star charts</li>
<li><samp>xml</samp> just reformat of its input</li>
</ul>
<p>
A plain text representation of VOTable is generated as
</p>
<pre>
$ munipack votable -t txt pleiades.xml
</pre>
<p>
The similar way can be used for conversion to FITS and CVS formats.
</p>
<p>
The convert to SVG is the most useful for drawing of star charts
from VOTable (see <a href="ngc637.svg">output</a>).
</p>
<pre>
$ munipack votable -t svg -pa 92.4 -pd 24.1 -ps 500 -ml 2 -mk R
-o pleiades.svg pleiades.xml
</pre>
<h2>Advanced features</h2>
<p>
The cone search is implemented as a simple HTTP downloader with additional
VOTable processing. Alternative to the way is downloading by the hand with
an utility like wget or cURL followed by using of the votable
to process of their output.
</p>
<h2>See Also</h2>
<ul>
<li><a href="man_votable.html">VOTable</a></li>
<li><a href="man_cone.html">Cone Search</a></li>
</ul>
<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>
|