doc/kstars/wut.docbook

   1 <sect1 id="tool-whatsup">
   2 <title>What's Up Tonight? Tool</title>
   3 <indexterm><primary>Tools</primary>
   4 <secondary>What's Up Tonight? Tool</secondary>
   5 </indexterm>
   6
   7 <screenshot>
   8 <screeninfo>
   9 The What's Up Tonight Tool
  10 </screeninfo>
  11 <mediaobject>
  12   <imageobject>
  13     <imagedata fileref="wut.png" format="PNG"/>
  14   </imageobject>
  15   <textobject>
  16     <phrase>What's Up Tonight?</phrase>
  17   </textobject>
  18 </mediaobject>
  19 </screenshot>
  20
  21 <para>
  22 The <quote>What's Up Tonight?</quote> (WUT) tool displays a list of
  23 objects that will be visible at night from any location, on any date.
  24 By default, the Date and Location are taken from the current settings
  25 in the main window, but you can change either value using the
  26 <guibutton>Change Date</guibutton> and <guibutton>Change
  27 Location</guibutton> buttons at the top of the WUT window.
  28 </para>
  29 <para>
  30 The WUT tool also displays a short almanac of data for the selected
  31 date: the rise and set times for the Sun and moon, the duration of
  32 the night, and the Moon's illumination fraction.
  33 </para>
  34 <para>
  35 Below the almanac is where the object information is displayed.  The
  36 objects are organized into type categories.  Select an object type
  37 in the box labeled <guilabel>Choose a Category</guilabel>, and all
  38 objects of that type which are above the horizon on the selected
  39 night will be displayed in the box labeled <guilabel>Matching
  40 Objects</guilabel>.  For example, in the screenshot, the
  41 <guilabel>Planets</guilabel> category has been selected, and four
  42 planets which are up on the selected night are displayed (Mars,
  43 Neptune, Pluto, and Uranus).  When an object in the list is selected,
  44 its rise, set and transit times are displayed in the lower-right
  45 panel.  In addition, you can press the <guibutton>Object
  46 Details...</guibutton> button to open the <link
  47 linkend="tool-details">Object Details window</link> for that
  48 object.
  49 </para>
  50 <para>
  51 By default, the WUT will display objects which are above the horizon
  52 between sunset and midnight (i.e., <quote>in the evening</quote>).
  53 You can choose to show objects which are up between midnight and dawn
  54 (<quote>in the morning</quote>), or between dusk and dawn (<quote>any
  55 time tonight</quote>) using the combobox near the top of the window.
  56 </para>
  57 </sect1>
  58