.. C-Munipack - User's manual

   Copyright 2012 David Motl

   Permission is granted to copy, distribute and/or modify this document under the
   terms of the GNU Free Documentation License, Version 1.2 or any later version published
   by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and
   no Back-Cover Texts.

   $Id: catalog_file_window.rst,v 1.2 2012/09/01 12:47:00 dmotl Exp $

.. index::
   pair: Catalog file; window

.. _catalog-file-window:

Catalog file (window)
=====================

This preview window is used to display the content of a catalog file.


Activating the dialog
---------------------

The dialog can be activated:

#. from the main menu: :menuselection:`Tools --> Open file`.

When a file is opened, the program checks its content and decides which kind of
preview window will be activated. Each file is presented in a separate window.


Dialog controls
---------------

If the catalog file is accompanied by a CCD image, the program may present it on the background.
The image file must have the same file name except the extension 'fts'.

.. figure:: images/phtfile_couts1.png
   :align: center
   :alt: Catalog file preview
   
   Preview window for catalog files
   
\(1) The chart is displayed in the preview area. It is possible to switch between
several rendering modes.

\(2) When you place a cursor over an object, the position and brightness (if available)
is displayed in the status bar.

\(3) You can zoom the preview in and out by means of the zoom icons on the toolbar.
The actual magnification is shown here.

\(4) You can change the aperture for which brightness of objects are rendered.

\(5) The local menu bar provides following functions:

- Menu File:

  - Show properties - display the further details about the file. Full header preview
    is available in separate window.
    
  - Close - close this window
  
- Menu View:

  - Image only - show only CCD image (if available) and hide objects.
  
  - Chart only - show only objects and hide the CCD image.
  
  - Chart and image - show CCD image on the background and objects as an overlay.
  
- Menu Tools:

  - Object inspector - if this tool is activated, left-click an object to display
	its properties. The information is presented in the right part of the dialog.
	
.. index::
   pair: Object inspector; tool

Object inspector tool
---------------------

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.

To activate the tool:

#. From the local menu, select :menuselection:`View --> Chart only`
   or :guilabel:`Image and chart` to show the objects.

#. From the local menu, select :menuselection:`Tools --> Object inspector`.
   A new panel on the right side of the preview window appears.
   
.. figure:: images/phtfile_couts2.png
   :align: center
   :alt: Object Inspector tool
   
   Object Inspector tool
   
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).

The following object parameters are presented:

- Object # - object's ordinal number on the current frame.

- Reference ID - object's ordinal number on a reference frame.

- Center - coordinates of the object's centroid

- Brightness - instrumental brightness of the object in magnitudes.

- Error - error estimation of brightness in magnitudes.

Several dimensions are presented in the image area (3):

- Two blue circles show the annulus which is used to estimate the background properties.

- A green circle shows the size of the aperture.

\(4) Here, you can change the current aperture.


.. seealso:: :ref:`open-file-dialog`