doc/kstars/altvstime.docbook

   1 <sect1 id="tool-altvstime">
   2 <title>Altitude vs. Time Tool</title>
   3 <indexterm><primary>Tools</primary>
   4 <secondary>Altitude vs. Time Tool</secondary>
   5 </indexterm>
   6
   7 <screenshot>
   8 <screeninfo>
   9 The Altitude vs. Time Tool
  10 </screeninfo>
  11 <mediaobject>
  12   <imageobject>
  13     <imagedata fileref="altvstime.png" format="PNG"/>
  14   </imageobject>
  15   <textobject>
  16     <phrase>Altitude vs. Time Plotter</phrase>
  17   </textobject>
  18 </mediaobject>
  19 </screenshot>
  20
  21 <para>
  22 This tool plots the altitude of any objects as a function of time,
  23 for any date and location on Earth.  The top section is a graphical
  24 plot of altitude angle on the vertical axis, and time on the horizontal
  25 axis.  The time is shown both as standard local time along the bottom,
  26 and <link linkend="ai-sidereal">sidereal time</link> along the top.
  27 The bottom half of the graph is shaded green to indicate that points
  28 in this region are below the horizon.
  29 </para>
  30 <para>
  31 There are a few ways to add curves to the plot.  The simplest way to
  32 add the curve of an existing object is to simply type its name in the
  33 <guilabel>Name</guilabel> input field, and press Enter, or the
  34 <guibutton>Plot</guibutton> button.  If the text you enter is found in
  35 the object database, the object's curve is added to the graph.  You
  36 can also press the <guibutton>Browse</guibutton> button to open the
  37 <link linkend="findobjects">Find Object Window</link> to select an
  38 object from the list of known objects.  If you want to add a point
  39 that does not exist in the object database, simply enter a name for
  40 the point, and then fill in the coordinates in the
  41 <guilabel>RA</guilabel> and <guilabel>Dec</guilabel> input fields.
  42 Then press the <guibutton>Plot</guibutton> button to add the curve for
  43 your custom object to the plot (note that you have to pick a name that
  44 does not already exist in the object database for this to work).
  45 </para>
  46 <para>
  47 When you add an object to the plot, its altitude vs. time curve is
  48 plotted with a thick white line, and its name is added to the listbox
  49 at the lower right.  Any objects that were already present are plotted
  50 with a thinner red curve.  You can choose which object is plotted with
  51 the thick white curve by highlighting its name in the listbox.
  52 </para>
  53 <para>
  54 These curves show the objects' Altitude (angle above the <link
  55 linkend="ai-horizon">horizon</link>) as a function of time.  When
  56 a curve passes from the lower half to the upper half, the object has
  57 risen; when it falls back to the lower half, it has set.  For example,
  58 in the screenshot, the minor planet <firstterm>Quaoar</firstterm> is
  59 setting at around 15:00 local time, and is rising at about 04:00 local
  60 time.
  61 </para>
  62 <para>
  63 The Altitude of an object depends on both where you are on Earth, and
  64 on the Date.  By default, the Tool adopts the Location and Date from the
  65 current KStars settings.  You can change these parameters in the
  66 <guilabel>Date &amp; Location</guilabel> Tab.  To change the Location,
  67 you can press the <guibutton>Choose City...</guibutton> button to open
  68 the <link linkend="setgeo">Set Geographic Location</link> Window, or
  69 enter Longitude and Latitude values manually in the input fields, and
  70 press the <guibutton>Update</guibutton> button.  To change the Date,
  71 use the <guilabel>Date</guilabel> picker widget, then press
  72 <guibutton>Update</guibutton>.  Note that any curves you had already
  73 plotted will be automatically updated when you change the Date and/or
  74 Location.
  75 </para>
  76
  77 <tip>
  78 <para>Exercise:</para>
  79 <para>
  80 Plot the Sun's Altitude curve.  Make sure the geographic location is not
  81 near the equator.  Change the Date to some time in June, and then again to
  82 sometime in January.  You can see easily why we have seasons; in the
  83 winter, the Sun is above the horizon for less time (the days are shorter),
  84 and its altitude is never very high.
  85 </para>
  86 </tip>
  87
  88
  89 </sect1>
  90