<!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>Frame preview window — 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="Dialogs and tools" href="dialogs.html" />
<link rel="next" title="Graph (window)" href="graph_window.html" />
<link rel="prev" title="Flat correction (dialog)" href="flat_correction_dialog.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="graph_window.html" title="Graph (window)"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="flat_correction_dialog.html" title="Flat correction (dialog)"
accesskey="P">previous</a> |</li>
<li><a href="index.html">C-Munipack 2.0.8 documentation</a> »</li>
<li><a href="using_muniwin.html" >Using Muniwin</a> »</li>
<li><a href="dialogs.html" accesskey="U">Dialogs and tools</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="frame-preview-window">
<span id="index-0"></span><span id="id1"></span><h1>Frame preview window<a class="headerlink" href="#frame-preview-window" title="Permalink to this headline">¶</a></h1>
<p>This window is used to display a source frame and all information related to this frame.</p>
<div class="section" id="activating-the-dialog">
<h2>Activating the dialog<a class="headerlink" href="#activating-the-dialog" title="Permalink to this headline">¶</a></h2>
<p>The dialog can be activated:</p>
<ol class="arabic simple">
<li>double left click on an item in the table of source files.</li>
<li>right click on an item in the table of source files, from the context menu
select <em class="guilabel">Open preview</em>.</li>
<li>from the main menu: <em class="menuselection">Project ‣ Show selected frame</em>.</li>
<li>from the main toolbar: <img alt="preview_icon" src="_images/preview.png" /></li>
</ol>
<p>Each file is presented in a separate window.</p>
</div>
<div class="section" id="dialog-controls">
<h2>Dialog controls<a class="headerlink" href="#dialog-controls" title="Permalink to this headline">¶</a></h2>
<div class="figure align-center">
<img alt="Source frame preview" src="_images/preview_couts1.png" />
<p class="caption">Preview window for source frames</p>
</div>
<p>(1) The image and chart are displayed in the preview area. It is possible to switch between
several rendering modes.</p>
<p>(2) You can easily jump to the previous and next frame in the table by means of the
left/right arrow icons on the toolbar. The ordinal number of displayed frame and total number
of frames in the text box as a fraction.</p>
<p>(3) You can zoom the preview in and out by means of the zoom icons on the toolbar.</p>
<p>(4) It is possible to change the current aperture for which the object’s brightness
is displayed in the chart and the information box.</p>
<p>(5) The local menu bar provides following functions:</p>
<ul class="simple">
<li>Menu Frame:<ul>
<li>Show properties - display the further details about the frame. Full header preview
is available in separate window.</li>
<li>Remove from project - remove this frame from the project. It has the same effect as
removing the frame from the main application window.</li>
<li>Close - close this window</li>
</ul>
</li>
<li>Menu View:<ul>
<li>Image only - show only a CCD image and hide objects</li>
<li>Chart only - show only objects and hide a CCD image</li>
<li>Chart and image - show a CCD image on the background and objects as an overlay</li>
<li>Pseudo-color image - switch between rendering of pixel intensities in pseudo-color scale and a gray scale.</li>
<li>Bad pixels - turn on and off the highlighting of pixels on the intensity limits or outside the limits
The limits are set up the “Preferences” dialog.</li>
<li>Original image - show original uncalibrated image instead of a temporary image</li>
<li>Bad stars - turn on and off the rendering of objects that were marked as “bad” in the photometry.</li>
</ul>
</li>
<li>Menu Tools:<ul>
<li>Gray scale - show a gray scale or a pseudo-color scale on the right side of the dialog.</li>
<li>Object inspector - show the Object inspector tool - explained below.</li>
<li>Quick photometry - show the Quick photometry tool - explained below.</li>
</ul>
</li>
</ul>
</div>
<div class="section" id="browsing-the-image">
<h2>Browsing the image<a class="headerlink" href="#browsing-the-image" title="Permalink to this headline">¶</a></h2>
<p>In the local menu, select <em class="menuselection">View ‣ Image only</em> to hide the objects.</p>
<p>When you place a cursor over the image area, the coordinates and the pixel value
are displayed in the status bar.</p>
</div>
<div class="section" id="quick-photometry-tool">
<span id="index-1"></span><h2>Quick Photometry tool<a class="headerlink" href="#quick-photometry-tool" title="Permalink to this headline">¶</a></h2>
<p>The Quick Photometry tool is a tool which computes basic photometric properties
of an object on a frame. The main goal of this tool is to provide an estimation of
the FWHM value (the important input parameter of the photometry process).</p>
<p>Because this tool does simplified version of aperture photometry, the results
are informative only and shouldn’t be used elsewhere. Also, it doesn’t require a proper
calibration to be performed first.</p>
<p>To activate the tool, select <em class="menuselection">Tools ‣ Quick photometry</em>
from the local menu. A new panel on the right side of the preview window appears.</p>
<div class="figure align-center">
<img alt="Quick photometry tool" src="_images/preview_couts3.png" />
<p class="caption">Quick photometry tool</p>
</div>
<p>Using the left mouse button, click on the image (1), close to an object. The program
automatically finds the nearest local maximum, so you don’t need to be accurate. The computation
stars automatically and the results are displayed the the right panel (2).</p>
<p>The following object parameters are presented:</p>
<ul class="simple">
<li>Center - coordinates of the local maximum.</li>
<li>Max - pixel value in local maximum</li>
<li>Background - mean background level, computed as a robust mean of pixels in the sky annulus.</li>
<li>Noise - background noise level, computed as a standard deviation of pixels in the sky annulus.</li>
<li>FWHM - object’s width, computed full width at half maximum.</li>
<li>Aperture - aperture radius used for computing the object’s signal.</li>
<li>Signal - object’s signal, sum of pixels in the aperture, mean background level is subtracted.</li>
<li>S/N ratio - signal to background noise ratio, displayed in decibels: SNR = 10.log(S/N).</li>
<li>(3) Several dimensions are presented in the image area.</li>
<li>Two blue circles show the annulus which is used to estimate the background properties.</li>
<li>A red circle shows the object’s average FWHM.</li>
<li>A green circle shows the size of the aperture.</li>
</ul>
<p>It is also possible to change some parameters:</p>
<ul class="simple">
<li>(4) Aperture radius in pixels</li>
<li>(5) Inner radius of the sky annulus in pixels</li>
<li>(6) Outer radius of the sky annulus in pixels</li>
</ul>
</div>
<div class="section" id="profile-tool">
<span id="index-2"></span><h2>Profile tool<a class="headerlink" href="#profile-tool" title="Permalink to this headline">¶</a></h2>
<p>The Profile tool is used to check the shape of objects. It shows
a curve of pixels values along a line.</p>
<p>To activate the tool, select <em class="menuselection">Tools ‣ Quick photometry</em>
from the local menu. A new panel on the bottom of the preview window appears.</p>
<div class="figure align-center">
<img alt="Profile tool" src="_images/preview_couts2.png" />
<p class="caption">Profile tool</p>
</div>
<p>Using the left mouse button, draw a line on the image (1), crossing the center of an object.
The profile is drawn in the graph (2). You can adjust the graph style (3). The following parameters
are displayed in the information box (4):</p>
<ul class="simple">
<li>Min - minimum pixel value.</li>
<li>Max - maximum pixel value</li>
<li>Mean - mean pixel value of pixels in the profile.</li>
<li>St. dev. - standard deviation of pixels in the profile.</li>
</ul>
</div>
<div class="section" id="histogram-tool">
<span id="index-3"></span><h2>Histogram tool<a class="headerlink" href="#histogram-tool" title="Permalink to this headline">¶</a></h2>
<p>The Histogram tool shows a histogram of pixel values and some related statistics.</p>
<p>To activate the tool, select <em class="menuselection">Tools ‣ Histogram</em> from the local
menu. A new panel on the bottom of the preview window appears.</p>
<div class="figure align-center">
<img alt="Histogram tool" src="_images/preview_couts4.png" />
<p class="caption">Histogram tool</p>
</div>
<p>The histogram is shown in the left part (1) of the tool. The following parameters
are displayed in the text area on its right side (2):</p>
<ul class="simple">
<li>Min - minimum pixel value</li>
<li>Max - maximum pixel value</li>
<li>Mean - mean pixel value of all pixels</li>
<li>St. dev. - standard deviation of all pixels</li>
</ul>
</div>
<div class="section" id="browsing-the-objects">
<h2>Browsing the objects<a class="headerlink" href="#browsing-the-objects" title="Permalink to this headline">¶</a></h2>
<p>In the local menu, select <em class="menuselection">View ‣ Chart only</em> or <em class="guilabel">Image and chart</em>
to show the objects.</p>
<p>When you place a cursor over an object in the image area, its coordinates and
other properties are displayed in the status bar.</p>
<p>Objects that were not identified on the reference frame (see Matching) are rendered
in a gray color.</p>
<p>Objects that were not measured successfully (see Photometry) are drawn in red
color and not filled.</p>
<p>Objects that were not measured and not matched are draw in gray color and not filled.</p>
<p>The brightness for each object is rendered using the selected aperture.</p>
</div>
<div class="section" id="object-inspector-tool">
<span id="index-4"></span><h2>Object inspector tool<a class="headerlink" href="#object-inspector-tool" title="Permalink to this headline">¶</a></h2>
<p>The Object inspector tool is a tool which displays that the program registers about
an object on a frame. The main purpose of this tool is for testing and debugging. Unlike the
Quick Photometry, the Object Inspector shows results, that has been obtained during the “full”
photometry. Because of this, calibration and photometry must be performed first. The results
are more relevant.</p>
<p>To activate the tool:</p>
<ol class="arabic simple">
<li>From the local menu, select <em class="menuselection">View ‣ Chart only</em>
or <em class="guilabel">Image and chart</em> to show the objects.</li>
<li>From the local menu, select <em class="menuselection">Tools ‣ Object inspector</em>.
A new panel on the right side of the preview window appears.</li>
</ol>
<div class="figure align-center">
<img alt="Object Inspector tool" src="_images/phtfile_couts2.png" />
<p class="caption">Object Inspector tool</p>
</div>
<p>Using the left mouse button, click on the image (1), to select an object. The object is
highlighted and its properties are displayed in the right panel (2).</p>
<p>The following object parameters are presented:</p>
<ul class="simple">
<li>Object # - object’s ordinal number on the current frame.</li>
<li>Reference ID - object’s ordinal number on a reference frame.</li>
<li>Center - coordinates of the object’s centroid</li>
<li>Brightness - instrumental brightness of the object in magnitudes.</li>
<li>Error - error estimation of brightness in magnitudes.</li>
</ul>
<p>Several dimensions are presented in the image area (3):</p>
<ul class="simple">
<li>Two blue circles show the annulus which is used to estimate the background properties.</li>
<li>A green circle shows the size of the aperture.</li>
</ul>
<p>(4) Here, you can change the current aperture.</p>
<div class="admonition-see-also admonition seealso">
<p class="first admonition-title">See also</p>
<p class="last"><a class="reference internal" href="main_window.html#main-window"><em>Main window</em></a></p>
</div>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Frame preview window</a><ul>
<li><a class="reference internal" href="#activating-the-dialog">Activating the dialog</a></li>
<li><a class="reference internal" href="#dialog-controls">Dialog controls</a></li>
<li><a class="reference internal" href="#browsing-the-image">Browsing the image</a></li>
<li><a class="reference internal" href="#quick-photometry-tool">Quick Photometry tool</a></li>
<li><a class="reference internal" href="#profile-tool">Profile tool</a></li>
<li><a class="reference internal" href="#histogram-tool">Histogram tool</a></li>
<li><a class="reference internal" href="#browsing-the-objects">Browsing the objects</a></li>
<li><a class="reference internal" href="#object-inspector-tool">Object inspector tool</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="flat_correction_dialog.html"
title="previous chapter">Flat correction (dialog)</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="graph_window.html"
title="next chapter">Graph (window)</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="graph_window.html" title="Graph (window)"
>next</a> |</li>
<li class="right" >
<a href="flat_correction_dialog.html" title="Flat correction (dialog)"
>previous</a> |</li>
<li><a href="index.html">C-Munipack 2.0.8 documentation</a> »</li>
<li><a href="using_muniwin.html" >Using Muniwin</a> »</li>
<li><a href="dialogs.html" >Dialogs and 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>
