<?xml version='1.0' encoding='UTF-8'?>
<!-- This document was created with Syntext Serna Free. --><sect1 id="tool-obsplanner">
  <sect1info>
    <author>
      <firstname>Kristian</firstname>
      <surname>Ivanov</surname>
    </author>
  </sect1info>
  <title>Observation Planner</title>
  <indexterm>
    <primary>Planner</primary>
  </indexterm>
  <para>Since &kde; SC 4.4, Prakash Mohan&apos;s GSoC work has been released in &kstars;. &kstars; now 
has an awesome observation planner to plan your observation sessions. The execute session option allows 
you to log information about objects as you observe them. Alternately, you may also write a short log 
in the session planner itself. We wish you a lot of fun planning your observations with &kstars;!
  </para>
  <para>You can even add some pictures to the objects. The image list is a Google image search list. 
To add image to an object just press <guibutton>Find Image</guibutton> button on the right and then 
find an image that you like. If you do not have an Internet connection you can open an image from 
your hard drive. Note that images that will be used are going to be cropped to 600x600 pixels.
  </para>
  <para>The first way of doing this is by pressing <keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo> or <keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo> to open the Observation List, then press the <guibutton>Add Object</guibutton> button.</para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="KStars_Neptune.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase/>
      </para>
    </caption>
  </mediaobject>
  <para>The <guibutton>Download all Images</guibutton> button does a search for the SDSS images and displays the DSS image if the requested RA/Dec is out of the SDSS footprint.</para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="sds.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase> This is an SDSS image of a galaxy</phrase>
      </para>
    </caption>
  </mediaobject>
  <mediaobject>
    <imageobject>
      <imagedata fileref="dss.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase> This is an DSS image of the same galaxy</phrase>
      </para>
    </caption>
  </mediaobject>
  <para> The <guibutton>Delete all Images</guibutton> button does the opposite. It deletes all downloaded images.</para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="Delete_all_images.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase> The image for the galaxy is now deleted </phrase>
      </para>
    </caption>
  </mediaobject>
  <para>You can add more objects by pressing the <guibutton>Find Object</guibutton> button. It will open
the <guilabel>Find Object</guilabel> tool which provides two accurate methods for sorting out the items, 
depending on what criteria you want to use. 
You can filter the list by objects type: Any, Stars, Solar System, Clusters (Globular and Open), 
Nebulae (Gaseous and Planetary), Galaxies, Comets, Asteroids, Constellations, Supernovae or Satellites.
You can also filter the objects list by name. Enter the name of desired object 
in the <guilabel>Filter by name</guilabel> text box.
  </para>

  <para>Inside Observation Planner window you can see the <quote>Altitude vs Time</quote> widget (AltvsTime), 
which shows you how the altitude of a selected object varies over time.
  </para>
  <para>Below the AltvsTime widget, there is a text box in that you can add observing notes for current sky object.
  </para>
  <para>Note that the Wish List is not the Session Plan. In the Wish List you can add objects 
that you wish to observe at some point. From there you can add them to the Session Plan.
  </para>
  <para>You can see the pop-up window that comes after right-clicking on an object.</para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="Add_Object_to_Session_plan.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase>Add objects to Session Plan window</phrase>
      </para>
    </caption>
  </mediaobject>
  <para> Here is the second way of adding objects in your Observation Plan, using the Observing List Wizard. You 
just need to press the fourth button on the top-left corner of the Observation Planner window.</para>
  <para>Despite looking differently this way is basically the same as the first one. Although that 
it could be a bit more detailed. Here you can see the same categories of objects.
  </para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="Another_way_to_add.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase/>
      </para>
    </caption>
  </mediaobject>
  <mediaobject>
    <imageobject>
      <imagedata fileref="Another_way_to_add_part3.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase/>
      </para>
    </caption>
  </mediaobject>
  <para>You can choose where these objects to be on the sky. There are four options available for you: All over the sky (which is the default option), by constellation and in a region (rectangular or circular).</para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="Another_way4.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase/>
      </para>
    </caption>
  </mediaobject>
  <para>You can choose the date for the observation and the place you are going to observe from.</para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="Another_way5.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase/>
      </para>
    </caption>
  </mediaobject>
  <para>You can choose the treshold of magnitude for the objects to be shown. In astronomy, absolute magnitude (also known as absolute visual magnitude when measured in the standard V photometric band) measures a celestial object&apos;s intrinsic brightness.</para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="Another_way6.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase/>
      </para>
    </caption>
  </mediaobject>
  <para>You can save your observation plan. And it will save it with a <filename class="extension">.obslist</filename> extension.</para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="Savin_session.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase/>
      </para>
    </caption>
  </mediaobject>
  <para>You can also access the <guilabel>WUT</guilabel> (What&apos;s up tonight), which could be of a great assistance to you. It can give you ideas what to observe on a date, time and place that you specify using the configuration buttons int the top-right corner of the <guilabel>What&apos;s up tonight</guilabel> window.</para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="wut.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase/>
      </para>
    </caption>
  </mediaobject>
  <para>This is how the <guilabel>Execution Session</guilabel> Window look. It can be opened by pressing <keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo>. In it you can also see some information about the selected object and you are able to add observing notes. </para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="execute_session_nt.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase>First Execute Session window</phrase>
      </para>
    </caption>
  </mediaobject>
  <para>By pressing the <guibutton>Next Page</guibutton> button you will access the second page of Session Plan. Here you are able to see information not about your object, but about your equipment.</para>
  <mediaobject>
    <imageobject>
      <imagedata fileref="execute_session_the_nt.png" format="PNG"/>
    </imageobject>
    <caption>
      <para>
        <phrase>Second Execute Session window</phrase>
      </para>
    </caption>
  </mediaobject>
  <para>Pressing the <guibutton>Next Target</guibutton> button will cause the Execute Session to open the first window about the next object.</para>
</sect1>
