File: man_backup.html

package info (click to toggle)
munipack 0.6.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 33,104 kB
  • sloc: cpp: 29,677; sh: 4,909; f90: 2,872; makefile: 278; python: 140; xml: 72; awk: 12
file content (112 lines) | stat: -rw-r--r-- 3,439 bytes parent folder | download
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
<!DOCTYPE HTML>
<html lang="en">
<head>
<!-- meta -->
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<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 rel="stylesheet" href="munipack.css">
<link rel="shortcut icon" href="favicon.ico">
<title>Munipack ‒ Backup strategy</title>
</head>
<body>
<header>
  <a href="munipack.html"><img src="big_logo.png" alt="Munipack's logo" class="head"></a>
  <div class="headtitles">
    <p class="head">
      <a class="headtitle" href="munipack.html">Munipack</a>
    </p>
    <p class="head">
      <a class="headsubtitle" href="munipack.html">The astronomical image processing software</a>
    </p>
  </div>
  <div class="buttons">
    <a href="guide.html" class="button">
      <div class="bicon">
	📘
      </div>
      <div class="hide">
	Guide
      </div>
    </a>
    <a href="docs.html" class="button">
      <div class="bicon">
	📁
      </div>
      <div class="hide">
	Documents
      </div>
    </a>
  </div>
</header>
<section>

<h1 id="backup">Backup Strategy</h1>

<p>Munipack modifies the backup strategy of FITS files.
  Both the Unix philosophy, as well as common FITS conventions,
  are modified.
</p>

<h2>The declaration</h2>
<ul>
  <li>All observed data are highly valuable original.
      They are untouchable.</li>
  <!--
  <li>All operations on newly created HDU, like their adding or removing,
    are considered as a reversible action. </li>
  -->
  <li>Any file, created by a processing, can be overwritten without caution.</li>
</ul>

<h2>Practical implications:</h2>
<ul>
  <li>All actions which can potentially modify original image data
    (currently only <samp>phcorr</samp>) refuses actions on its by default.
    The rule can be supressed by <samp>--enable-overwrite</samp> switch
    for <samp>phcorr</samp>, yet strongly discouraged!
  </li>
  <li>
    All processing should be done under a dedicated working directory.
    The file handling is proposed by the way
    (see <samp>-t destination_dir</samp> on the current <samp>"-t ."</samp>
    directory):
    <pre>
$ ls /obs/archive/*.fits
$ mkdir work/
$ cd work/
work$ munipack phcorr [...] -t . /obs/archive/*.fits
    </pre>
  </li>
  <li>
    By default, the label <samp>_proc</samp> is included in filenames
    when the output directory, by <samp>-t</samp> switch, is not specified.
    This is common for <samp>phcorr, astrometry, find, aphot, gphot</samp>.
  </li>
  <li>
    The outputs of <samp>phcal</samp> are expected to be included
    in the working directory so the label <samp>_cal</samp> is added
    to original filenames by default.
  </li>
  <li>
    All newly created files by <samp>bias, dark, flat, cone, kombine,
      colouring, votable, cross, artifical </samp> are silently overwritten
    for convenience. Perhaps, some processing time can only be lost.
  </li>
</ul>

<p>The backup strategy has been changed between versions 0.5.10 and
  0.5.11 (January 2018), revised in 0.5.13 (November 2020)
  and 0.6.2 (January 2025).
</p>

</section>
<footer>
  © 1997 – 2025
  <a href="https://integral.physics.muni.cz/" title="author's homepage"
   class="foot">Filip Hroch</a>
</footer>
</body>
</html>