.. 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: object_coordinates_dialog.rst,v 1.2 2012/09/01 12:47:00 dmotl Exp $ .. index:: pair: Object coordinates; dialog .. _object-coordinates-dialog: Object coordinates (dialog) =========================== The "Object coordinates" dialog is used to specify the celestial position of the observed object. This information is necessary to compute the heliocentric correction and the air mass coefficient. Sources of coordinates ---------------------- There are several possibilities how to enter the object celestial position: - To enter equatorial coordinates manually to edit fields in the dialog. - To pick out an item from a table predefined positions. A user can add records to the table and edit them. - To search out the position in a catalog of variable stars. The GCVS, NSV, NSVS and BRKA catalogs are supported. They are not included in the installation and must be installed and configured separately. - To get the position from the reference frame, i. e. a source frame or a catalog file that has been used for the matching. Specifying the position manually -------------------------------- .. figure:: images/objcoords_couts1.png :align: center :alt: Object position (manual entry) Specifying the object position manually Select the source of coordinates (1). \(2) Enter object designation here. Although this field is not required, it is recommended to fill in a meaningful object identification. Enter object right ascension to the text box (3) in hours. Use the hexagesimal format, separate the fields by a space character. Enter object declination to the text box (4) in degrees. Use the hexagesimal format, separate the fields by a space character. \(5) Source and Remarks are optional fields. You can enter any information that you find useful. There are no formatting rules for these fields. Click on the "Add" button (6) to add an object into the table of predefined objects (7). Click the "OK" button (8) to save the coordinates. Using the table of predefined position -------------------------------------- .. figure:: images/objcoords_couts2.png :align: center :alt: Table of predefined objects' positions Getting the object coordinates from the table of predefined positions Select the source of coordinates (10). The table of predefined positions is displayed in the table (11). Right-clicking a table opens a context menu. Select an item in the table with a single left click to recall the data. The data are shown in the text boxes above the table (12). Click the "Add" button (13) to make a new item to the table with data filled in the text boxes. Click the "Save" (14) button to update selected record. Click the "Remove" button (15) to remove the selected record from the table. Click the "OK" button (16) to confirm the dialog. Searching in a catalog of variable stars ---------------------------------------- The catalog files are not included in the program's installation package. You have to download and install them separately. .. figure:: images/objcoords_couts3.png :align: center :alt: Catalogs of variable stars Searching the variable star catalogs Select the source of coordinates (20). Enter the variable star designation into the text box (21). The search is not case sensitive. Click the "Search" button (22) to start the search. The records that match are displayed in the table below (23). Select an item in the table with a single left click. Right-clicking a table opens a context menu. Click the "OK" button (24) to save the coordinates. Using position from the reference frame --------------------------------------- This option is available only when the reference frame includes the information about the position of the object. .. figure:: images/objcoords_couts4.png :align: center :alt: Using the position from the reference frame Object coordinates from the reference frame Select the source of coordinates (30). \(31) The equatorial coordinates of the object is displayed in the text boxes. Click the "OK" button (32) to save the coordinates. .. seealso:: :ref:`match-stars-dialog`, :ref:`make-catalog-file-dialog`