/usr/share/doc/dpuser-doc/function_find.html is in dpuser-doc 3.3+p1+dfsg-2build1.
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 | <html>
<head>
<meta name="Author" content="Thomas Ott">
<title>DPUSER - The Next Generation: Function find</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 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 class="declaration">function find</h1>
<p>
[This documentation is copied literally from IDL's astrolib]
<br><p>
Find positive brightness perturbations (i.e stars) in an image. Also returns centroids and shape parameters (roundness & sharpness). Adapted from 1986 STSDAS version of DAOPHOT.
<br><br><b><font size=+2>Syntax</font></b><br>
<i>result</i> = find(image, hmin, fwhm [, roundlim [, sharplim]] [, /silent])
<br><br><b><font size=+2>Arguments</font></b><br>
<table CELLSPACING=0 CELLPADDING=0>
<tr VALIGN=TOP><td nowrap>image: </td>
<td> 2 dimensional image array for which one wishes to identify the stars present.</td></tr>
<tr VALIGN=TOP><td nowrap>hmin: </td>
<td> Threshold intensity for a point source - should generally be 3 or 4 sigma above background.</td></tr>
<tr VALIGN=TOP><td nowrap>fwhm: </td>
<td> FWHM to be used in the convolve filter.</td></tr>
<tr VALIGN=TOP><td nowrap>sharplim: </td>
<td> 2 element vector giving low and high cutoff for the sharpness statistic (Default: [0.2,1.0]). Change this default only if the stars have significantly larger or or smaller concentration than a Gaussian.</td></tr>
<tr VALIGN=TOP><td nowrap>roundlim: </td>
<td> 2 element vector giving low and high cutoff for the roundness statistic (Default: [-1.0,1.0]). Change this default only if the stars are significantly elongated.</td></tr>
</table>
<br><br><b><font size=+2>Switches</font></b><br>
<table CELLSPACING=0 CELLPADDING=0>
<tr VALIGN=TOP><td nowrap>silent: </td>
<td> Normally, FIND will write out each star that meets all selection criteria. If the SILENT keyword is set then this printout is suppressed.</td></tr>
</table>
<br><br><b><font size=+2>Returns</font></b><br>
The find function returns an array of size 5xnstars with the following entries:<br>
x: vector containing x position of all stars identified by FIND<br>
y: vector containing y position of all stars identified by FIND<br>
flux: vector containing flux of identified stars as determined by a gaussian fit. Fluxes are NOT converted to magnitudes.<br>
sharp: vector containing sharpness statistic for identified stars<br>
round: vector containing roundness statistic for identified stars
<br><br><b><font size=+2>Notes</font></b><br>
The sharpness statistic compares the central pixel to the mean of the surrounding pixels. If this difference is greater than the originally estimated height of the Gaussian or less than 0.2 the height of the Gaussian (for the default values of SHARPLIM) then the star will be rejected.
</div>
<div id="copyright">
Copyright © Thomas Ott ---- DPUSER - The Next Generation 3.3 (Rev. )
</div>
</body>
</html>
|