Warning, /education/kstars/doc/details.docbook is written in an unsupported language. File is not indexed.

0001 <sect1 id="tool-details">
0002 <title>Object Details Window</title>
0003 <indexterm><primary>Tools</primary>
0004 <secondary>Object Details Window</secondary></indexterm>
0005 <indexterm><primary>Objects in the Sky</primary>
0006 <secondary>Details</secondary></indexterm>
0008 <screenshot>
0009 <screeninfo>
0010 The Object Details Window
0011 </screeninfo>
0012 <mediaobject>
0013   <imageobject>
0014     <imagedata fileref="detaildialog.png" format="PNG"/>
0015   </imageobject>
0016   <textobject>
0017     <phrase>Object Details Window</phrase>
0018   </textobject>
0019 </mediaobject>
0020 </screenshot>
0022 <para>
0023 The Object Details Window presents advanced data available about
0024 a specific object in the sky.  To access this tool,
0025 <mousebutton>right</mousebutton>-click on any object, and select the
0026 <guimenuitem>Details...</guimenuitem> item from the popup menu.
0027 </para>
0028 <para>
0029 The window is divided into a number of tabs.  In the
0030 <guilabel>General</guilabel> tab, we present basic data about
0031 the current object.  This includes names and catalog designations,
0032 object type, and <link linkend="ai-magnitude">magnitude</link>
0033 (brightness).  On the <guilabel>Position</guilabel> tab
0034 are the object's Equatorial and Horizontal
0035 coordinates, as well as its rise, set and transit times.
0036 </para>
0037 <para>
0038 <indexterm><primary>Objects in the Sky</primary>
0039 <secondary>Internet Links</secondary>
0040 <tertiary>Customizing</tertiary></indexterm>
0041 In the <guilabel>Links</guilabel> tab, you can manage the internet
0042 links associated with this object.  The Image and Information links
0043 associated with the object are listed.  These are the links that
0044 appear in the popup menu when the object is
0045 <mousebutton>right</mousebutton>-clicked.  You can add custom
0046 links to the object with the <guibutton>Add Link...</guibutton>
0047 button.  This will open a window in which you fill in the &URL; and link
0048 text for the new link (you can also test the &URL; in the web browser
0049 from this window).  Every time you add a custom &URL; to a certain object,
0050 you are able to choose the resource type using the <guibutton>Resource Type</guibutton>
0051 button. Keep in mind that the custom link can easily point
0052 to a file on your local disk, so you can use this feature to index
0053 your personal astronomical images or observing logs.
0054 </para>
0055 <para>
0056 You can also modify or remove any link using the
0057 <guibutton>Edit Link...</guibutton> and
0058 <guibutton>Remove Link...</guibutton> buttons.
0059 </para>
0060 <!-- no Advanced tab for
0061 an unnamed star or
0062 if advinterface file failed loading or
0063 for solar system objects -->
0064 <para>
0065 The <guilabel>Advanced</guilabel> tab (not available for all objects) allows you to query professional
0066 astronomical databases on the internet for information regarding the
0067 current object.  To use these databases, double click on the
0068 desired database in the list to see the results of your query in a web browser window.  The
0069 query is made using the primary name of the object you clicked on to
0070 open the Details Dialog.  The following databases are available for
0071 querying:
0073 <itemizedlist>
0074 <listitem><para><guimenuitem>Set of Identifications, Measurements, and Bibliography
0075 for Astronomical Data (SIMBAD)</guimenuitem>: SIMBAD is similar to NED, except it
0076 provides data about all kinds of objects, not just galaxies.
0077 </para></listitem>
0078 <listitem><para><guimenuitem>SkyView</guimenuitem>: Provides images from All-Sky surveys that have
0079 been performed in dozens of different parts of the spectrum, from
0080 Gamma Rays to the Radio.  The &kstars; interface will retrieve an image
0081 from any of these surveys, centered on the selected object.
0082 </para></listitem>
0083 <listitem><para><guimenuitem>High Energy Astrophysical Archive (HEASARC)</guimenuitem>: Here you
0084 can retrieve data about the current object from a number of
0085 <quote>High-energy</quote> observatories, which covers the
0086 Ultraviolet, X-ray and Gamma Ray portions of the electromagnetic
0087 spectrum.</para></listitem>
0088 <listitem><para><guimenuitem>NASA/IPAC Extragalactic Database (NED)</guimenuitem>: NED provides
0089 encapsulated data and bibliographic links about
0090 extragalactic objects.  You should only use NED if your target is
0091 extragalactic; &ie; if it is itself a galaxy.
0092 </para></listitem>
0093 <listitem><para><guimenuitem>NASA Astrophysical Data System (ADS)</guimenuitem>: This
0094 incredible bibliographic database encompass the entire body of
0095 literature published in international peer-review Journals about
0096 astronomy and astrophysics.  The database is divided into four
0097 general subject areas (Astronomy and Astrophysics, Astrophysics
0098 Preprints, Instrumentation, and Physics and Geophysics).  Each of these
0099 has three sub-nodes that query the database
0100 in different ways.  <quote>Keyword search</quote> will return articles
0101 which listed the object's name as a keyword.  <quote>Title word
0102 search</quote> will return articles which included the object name in
0103 their Title, and the <quote>Title &amp; Keyword search</quote> uses
0104 both options together.
0105 </para></listitem>
0106 <listitem><para><guimenuitem>Multimission Archive at Space Telescope (MAST)</guimenuitem>:
0107 The <ulink url="https://www.stsci.edu/">Space Telescope Science Institute</ulink> provides access to the entire
0108 collection of images and spectra taken with the Hubble Space
0109 Telescope, as well as several other space-based observatories.
0110 </para></listitem>
0111 </itemizedlist>
0112 </para>
0114 <para>
0115 Finally, in the <guilabel>Log</guilabel> tab, you can type in some text
0116 that will remain associated with this object's <guilabel>Details</guilabel> window.
0117 You could use this to attach personal observing notes, for example. Your notes
0118 will be saved, such that you can easily read or use them next time when you will
0119 use &kstars;.
0120 </para>
0121 </sect1>