/usr/share/doc/munipack/man_votable.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 | <!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 ‒ VOTable</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>VOTable Utility</h1>
<p class="abstract">
VOTable utility converts data in VOTable format
to other file-formats: FITS (processing),
CSV (spreadsheet), plain text (processing), SVG (charts), XML (XUL).
</p>
<h2>Command</h2>
<code>
munipack votable [..] file
</code>
<h2>Description</h2>
<p>
<a href="http://www.ivoa.net/Documents/VOTable/">VOTable</a> file format is
a kind of <a href="http://en.wikipedia.org/wiki/XML">XML format</a>. One is used
as the primary data exchange format within
<a href="http://en.wikipedia.org/wiki/Virtual_observatory">Virtual Observatory</a>.
VOTable file is a text file with defined marks. The marks provides a tool
for describe of a structure of data (tables, for example). VOTable
format is designed for inter-process communication (in client — server model).
</p>
<p>
This routine is a converter between VOTable format provided by Virtual Observatory (XML
with any defined structure) and another formats:
</p>
<ul>
<li>The primary goal is conversion of VO catalogues to FITS tables</li>
<li>Conversion to the plain text format can be very useful for any additional
processing by using conventional tools (text editors, utilities like awk, etc.).</li>
<li>Conversion to <a href="http://en.wikipedia.org/wiki/Comma-separated_values">CSV</a>
format can be useful for users familiar with a spreadsheet-like utilities.</li>
<li>VOTable as a XML can be easy converted to
<a href="http://en.wikipedia.org/wiki/Scalable_Vector_Graphics">SVG</a>
(another XML based file format)
for drawing. Specially, it is for drawing of star charts.</li>
</ul>
<h2>Input And Output</h2>
<p>
On input, a single file is expected.
</p>
<p>
On output, a single file of various type is created.
</p>
<h2>Parameters</h2>
<dl>
<dt><samp>-s</samp></dt><dd>sort by the column</dd>
<dt><samp>-pt</samp></dt><dd>select projection: gnomonic</dd>
<dt><samp>-pa</samp></dt><dd>Right Ascension of projection centre [deg]</dd>
<dt><samp>-pd</samp></dt><dd>Declination of projection centre [deg]</dd>
<dt><samp>-pw</samp></dt><dd>Canvas width [pix]</dd>
<dt><samp>-ph</samp></dt><dd>Canvas height [pix]</dd>
<dt><samp>-ps</samp></dt><dd>scale of projection [pix/deg]</dd>
<dt><samp>-ml</samp></dt><dd>magnitude limit</dd>
<dt><samp>--col-mag</samp></dt><dd>magnitude field key</dd>
<dt><samp>--col-ra</samp></dt><dd>Right Ascension field key</dd>
<dt><samp>--col-dec</samp></dt><dd>Declination field key</dd>
<dt><samp>--type</samp></dt><dd>type of output file: fits,csv,txt,svg,xml</dd>
</dl>
<p>
See <a href="man_com.html">Common options</a> for
input/output filenames.
</p>
<h2>Examples</h2>
<p>
As a preparation step, download VOTable from Virtual Observatory
(use <a href="man_cone.html">cone search</a>):
</p>
<code>
$ munipack cone -c Hipparcos -o pleiades.xml -r 3 57 24
</code>
<p>
A text table:
</p>
<code>
$ munipack votable -o subaru.txt pleiades.xml
</code>
<p>
FITS table:
</p>
<pre>
$ munipack votable -o subaru.fits pleiades.xml
$ xmunipack subaru.fits
</pre>
<p>
CSV table:
</p>
<pre>
$ munipack votable -o pleiades.csv pleiades.xml
$ gnumeric pleiades.csv
</pre>
<figure>
<img class="figure" src="Screenshot-gnumeric.png" alt="Screenshot-gnumeric.png" title="csv">
<figcaption>In GNUmeric</figcaption>
</figure>
<h2>See Also</h2>
<p><a href="vobs.html">Virtual Observatory</a>,
<a href="chart.html">Star Charts</a>,
<a href="man_com.html">Common options</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>
|