/usr/share/doc/munipack/man_intro.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 | <!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 ‒ Introduction</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>Introduction</h1>
<p class="abstract">
An introduction to philosophy of Munipack framework
and a short summary of provided features.
</p>
<h2>Overview</h2>
<p>
Munipack is a general framework intended on processing
of astronomical images. The framework implements
methods for extracting photometry and astrometry information
from the image data. All the implemented methods regards on robust
algorithms, fast and effective processing.
</p>
<p class="indent">
Munipack is intended for processing of very large data by professionals,
with flexibility of use, a wide compatibility with other
astronomical tools (Virtual Observatory) and data formats (data can be accessed
and modified with help of external utilities) in mind.
</p>
<h2>Command line interface</h2>
<p>
Munipack can be used via the user interfaces: a graphical
and a command-line. This manual is focused on the command-line usage
which provides all implemented features. Opposite with this, the graphical interface
is designed to be easy to use. Therefore a true mean of many actions should be obscured,
missed by design or unimplemented yet.
</p>
<p class="indent">
The command-line interface respects Unix conventions.
Munipack can be directly used in shell scripts, core routines can be
wrapped for various (scripting) languages and integrated to a large
processing systems.
</p>
<h2>Actions</h2>
<p>
The command-line interface is provided by only the simple command:
</p>
<code>
$ munipack
</code>
<p>
The command wrappers individual actions and provides an user input data
pre-processing under Unix environment.
The <a href="modules.html">direct access</a> for programmers is also possible.
</p>
<p>
The most typical invocation is in the form:
</p>
<pre>
$ munipack action [options] files
</pre>
<p>
User specifies the <em>action</em>, seldom <em>options</em>
and <em>files</em> to work on its. The <em>action</em> is natural shortcut
of a logical action (for instance, the dark correction). The <em>options</em> modifies
a default parameters and provide a way for fine tune of a processing.
The last argument <em>files</em> specify files to be processed.
Usually, names with wildcards (* or ?) are provided.
To read filenames from its standard input, a dash (-) should be passed too.
</p>
<p class="indent">
The interface is designed in fashion of widely used control version systems
like <a href="http://mercurial.selenic.com">Mercurial</a>
or latest <a href="http://git-scm.com/">Git</a>. The design has been
adopted because regular users (including author) remembers
one (maybe two) command-names to call, but not a huge list of various
names of commands.
</p>
<p>
Actions are naturally grouped on categories:
</p>
<h3>Preprocessing</h3>
<p>
There are actions for averaging of <a href="man_bias.html">biases</a>,
<a href="man_bias.html">dark-frames</a> and <a href="man_flat.html">flat-field</a>
frames and <a href="man_phcorr.html">phcorr</a> tool for batch correction of
all frames.
</p>
<h3>Processing</h3>
<p>
The images can be processed by many ways. The most common is
fully automatic <a href="man_find.html">detection of stars</a>
and providing of <a href="man_aphot.html">aperture photometry</a> on images.
</p>
<p>
Frames with known stars can be <a href="man_astrometry.html">astrometricaly</a>
and <a href="man_phcal.html">photometrically</a> calibrated. To get more
precise calibration by multi-filter observation, the instrumental photometry system
must be <a href="man_phfotran.html">transformed</a> to a standard equivalent
and converted to various photometry quantities like magnitudes (in a filter,
STmag and ABmag) or fluxes (in a filter, per wavelength or frequency unit).
</p>
<h3>Products</h3>
<p>
From calibrated images, one can construct <a href="man_timeseries.html">a time series</a>
(with light curve as a special case) or <a href="man_kombine.html">construct</a>
a mosaic or sum images with more deeper exposure.
</p>
<h3>Colour Images</h3>
<p>
A set of images can be <a href="man_coloring.html">collected</a>
to a Colour image and <a href="man_ctrafo.html">transformed</a>
to a different colour systems to provide natural colours.
</p>
<h3>Virtual Observatory</h3>
<p>
Just only <a href="man_cone.html">cone search</a> is implemented
from the wide offer of services by Virtual Observatory. The
<a href="man_votable.html">conversion</a> from VOTable format
to many another computer formats can be also useful.
</p>
<h3>FITS</h3>
<p>
Munipack <a href="man_fitsut.html">wraps</a> some routines provided
by cFITSIO library for conventional use in shell scripts.
</p>
<h2>Verbose logging</h2>
<p>
Sometimes, one can be difficult to understand error messages.
The option <samp>--verbose</samp> which prints a lot of garbage
can help.
</p>
<h2>Golden Rule</h2>
<p>
Before start to play with Munipack, please remember the golden rule:
<b>Never touch any data without a backup!</b>
</p>
<h2>See Also</h2>
<p>
<a href="guide.html">☺ User Guide</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>
|