<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Batch processing — C-Munipack 2.0.8 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '',
VERSION: '2.0.8',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="top" title="C-Munipack 2.0.8 documentation" href="index.html" />
<link rel="up" title="Command line tools" href="command_line_tools.html" />
<link rel="next" title="Toolkit reference" href="toolkit_reference.html" />
<link rel="prev" title="Using configuration files" href="using_configuration_files.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="toolkit_reference.html" title="Toolkit reference"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="using_configuration_files.html" title="Using configuration files"
accesskey="P">previous</a> |</li>
<li><a href="index.html">C-Munipack 2.0.8 documentation</a> »</li>
<li><a href="command_line_tools.html" accesskey="U">Command line tools</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<span class="target" id="index-0"></span><div class="section" id="batch-processing">
<h1>Batch processing<a class="headerlink" href="#batch-processing" title="Permalink to this headline">ΒΆ</a></h1>
<p>Repetitive challenge with reduction of CCD observation is in treating
a large number of files. To do this job effectively, it is necessary to
execute each reduction step for all frames in subsequent manner. This issue
is inconsiderable namely for calibration of CCD frames - the calibration data
should be fetched into the memory only once and then applied to all frames.
Thus one need to execute an user command for a large set of input files.</p>
<p>One straightforward way in processing large batch of frames is writing
the names of input files as separate command-line arguments. More shrewd users
would use the wild-card notation, but it doesn’t work in more complicated situation.
There is yet another way - using directory files.</p>
<p>The directory file is a simple text file. Each line consists of a file
path or name. Such file can be obtained using simple command.</p>
<p>On GNU/Linux:</p>
<div class="highlight-python"><pre>ls ??? &gt; dirfile.txt</pre>
</div>
<p>On Windows:</p>
<div class="highlight-python"><pre>dir /b *.st7 &gt; dirfile.txt</pre>
</div>
<p>If the files are placed not in the current working directory, you have to
specify the proper path in full or shortened form relative to the current working
directory. It is not allowed to use the wild-card notation here. Use the <em class="xref std std-option">-i</em>
option to instruct the program to read the file.</p>
<p>When a program produces a number of files, it is also necessary to assign
a distinct name for each output file. By default, the output files are stored to
the current working directory. Their names are derived from the command name followed
by a sequential number starting by 1. By means of the command-line options, it is
possible to override this behavior.</p>
<p>The <em class="xref std std-option">-o</em> option sets the format string; it may contain a path where
the files shall be stored to. Special meaning has a sequence of question marks, it
is replaced by the ordinal number of a file indented by leading zeros to at least the
same number of decimal places as the number of the question marks. By means of the
<em class="xref std std-option">-i</em> option, you can modify the ordinal number of the first frame.</p>
<p>The following command writes its output to files <tt class="file docutils literal"><span class="pre">out010.fts</span></tt>,
<tt class="file docutils literal"><span class="pre">out011.fts</span></tt> and <tt class="file docutils literal"><span class="pre">out012.fts</span></tt>:</p>
<div class="highlight-python"><pre>darkbat -o out???.fts -i 10 dark.fts in001.fts in002.fts in003.fts</pre>
</div>
<p>If you are going to use the files produced by one command as the input files
of the subsequent operation, you can ask the former to make a directory file for you
by including the <em class="xref std std-option">-g</em> option followed by a file name.</p>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="using_configuration_files.html"
title="previous chapter">Using configuration files</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="toolkit_reference.html"
title="next chapter">Toolkit reference</a></p>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="toolkit_reference.html" title="Toolkit reference"
>next</a> |</li>
<li class="right" >
<a href="using_configuration_files.html" title="Using configuration files"
>previous</a> |</li>
<li><a href="index.html">C-Munipack 2.0.8 documentation</a> »</li>
<li><a href="command_line_tools.html" >Command line tools</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2012, David Motl.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
</div>
</body>
</html>
