/usr/share/doc/dpuser-doc/fitsfiles.html is in dpuser-doc 3.3+p1+dfsg-2.
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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="Author" content="Thomas Ott">
<title>DPUSER - The Next Generation: Handling of FITS files</title>
<style type="text/css" title="currentStyle">
@import "dpuser.css";
</style>
<link rel="shortcut icon" href="dpuser.ico" type="image/xicon">
</head>
<body>
<div id="header">DPUSER - The Next Generation</div>
<div id="menu">
<ul>
<li><a href="index.html">Introduction</a></li>
<li><a href="history.html">History</a></li>
<li><a href="syntax.html">Syntax</a></li>
<li><a href="operators.html">Operators</a></li>
<li><a href="ifandloop.html">Structural commands</a></li>
<li><a href="variables.html">Data types</a></li>
<li><a href="plotting.html">Graphics</a></li>
<li><a class="current" href="fitsfiles.html">Fits files</a></li>
<li><a href="category.html">Category index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="procedures.html">Procedure index</a></li>
<li><a href="pgplot.html">Pgplot index</a></li>
<li><a href="examples.html">Examples</a></li>
<hr>
<li><a href="qfitsview.html">QFitsView documentation</a></li>
<hr>
</ul>
<form method="GET" action="search.html">
<input type="text" size=15 name="keywords">
<input type="submit" value="Search">
</form>
</div>
<div id="content">
<h1>Handling of FITS files</h1>
<p>FITS (Flexible Image Transport System) is commonly used in astronomy to
store images. A very simple way to describe the format is that they contain
an ASCII header describing the content of the file and the image itself
in binary format. DPUSER is designed to efficiently handle this kind of
files. The most common things you might want to do is <a href="#readfits">reading
images</a>, <a href="#writefits">writing images</a> and <a href="#hedit">editing
the information in the header</a>.
<br>A <a href="#optimised">set of functions has been optimised</a> to deal
with large files, which probably do not fit in the main memory of your
computer.
<h2>
<a NAME="readfits"></a>Reading FITS files</h2>
DPUSER is able to read in FITS files, including FITS binary tables. The files may be compressed with gzip, uncompressing
is done on the fly. The task of reading in a FITS file can be done in two
ways:
<ol>
<li>
Use the function <a href="function_readfits.html">readfits</a></li>
<li>
Supply the filename in single quotes</li>
<li>
Use the function <a href="function_readfitsextension.html">readfitsextension</a></li>
<li>
Use the function <a href="function_readfitsall.html">readfitsall</a></li>
<li>
Use the function <a href="function_readfitsbintable.html">readfitsbintable</a></li>
</ol>
<h3>
Examples</h3>
Read in a complete FITS file into a variable named <tt>image</tt>:
<br><tt> image = readfits("filename")</tt> or <tt>image
= 'filename'</tt>
<br>Read in the first image of a FITS cube:
<br><tt> image = 'filename'[*,*,1]</tt>
<br>Read in columns 100 to 200 and rows 50 to 150 of a FITS file:
<br><tt> image = 'filename'[100:200, 50:150]</tt>
<h2>
<a NAME="writefits"></a>Writing FITS files</h2>
DPUSER is able to write simple FITS files, including FITS extensions, but it cannot (yet) write
FITS tables. Writing, as reading FITS files can be accomplished using
two methods:
<ol>
<li>
Use the procedure <a href="procedure_writefits.html">writefits</a></li>
<li>
Assign a matrix to a filename in single quotes</li>
</ol>
DPUSER creates a new file in either way. You cannot overwrite part of an
existing file.
<h3>
Examples</h3>
Write a 2-dimensional gaussian to a file named <tt>gauss.fits</tt>:
<br><tt> writefits "gauss.fits", gauss(129,129,10)</tt>
<br>which is equivalent to:
<br><tt> 'gauss.fits' = gauss(129,129,10)</tt>
<h2>
<a NAME="hedit"></a>Editing the FITS header</h2>
Once a FITS file is read into memory, where it is represented by a matrix,
it is possible to edit and display the FITS header information with a set
of FITS header editing functions. These are:
<br>
<table CELLSPACING=0 CELLPADDING=0 WIDTH="100%" >
<tr>
<td><a href="function_header.html">header</a></td>
<td>Returns the FITS header as a string</td>
</tr>
<tr>
<td><a href="function_getfitskey.html">getfitskey</a></td>
<td>Returns the value of a FITS key</td>
</tr>
<tr>
<td><a href="procedure_setfitskey.html">setfitskey</a></td>
<td>Sets the value of a FITS key</td>
</tr>
<tr>
<td><a href="procedure_setwcs.html">setwcs</a></td>
<td>Sets the world coordinate system in the FITS header</td>
</tr>
<tr>
<td><a href="procedure_copyheader.html">copyheader</a></td>
<td>Copy a FITS header to a variable</td>
</tr>
</table>
<h2>
<a NAME="optimised"></a>Optimised routines</h2>
Some data analysis tasks require the handling of huge files. The following
functions have been optimised to deal with large files. To take advantage
of these capabilities, use filenames in single quotes and not the function
readfits.
<br>
<table CELLSPACING=0 CELLPADDING=0 WIDTH="100%" >
<tr>
<td><a href="function_header.html">header</a></td>
<td>Returns the FITS header as a string</td>
</tr>
<tr>
<td><a href="function_cubeavg.html">cubeavg</a></td>
<td>Does an average in the 3rd dimension</td>
</tr>
<tr>
<td><a href="function_cubemedian.html">cubemedian</a></td>
<td>Does a median in the 3rd dimension</td>
</tr>
<tr>
<td><a href="function_ssa.html">ssa</a></td>
<td>Simple Shift-and-Add</td>
</tr>
<tr>
<td><a href="function_ssastat.html">ssastat</a></td>
<td>Simple Shift-and-Add statistics</td>
</tr>
<tr>
<td><a href="function_sssa.html">sssa</a></td>
<td>Simple Shift-and-Add using statistics</td>
</tr>
<tr>
<td><a href="function_wsa.html">wsa</a></td>
<td>Weighted Shift-and-Add</td>
</tr>
<tr>
<td><a href="function_swsa.html">swsa</a></td>
<td>Weighted Shift-and-Add using statistics</td>
</tr>
</table>
</div>
<div id="copyright">
Copyright © Thomas Ott ---- DPUSER - The Next Generation 3.3 (Rev. )
</div>
</body>
</html>
|