doc/kstars/calc-planetcoords.docbook

   1 <sect2 id="calc-planetcoords">
   2 <title>Planet Coordinates module</title>
   3 <indexterm><primary>Tools</primary>
   4 <secondary>Astrocalculator</secondary>
   5 <tertiary>Planet Coordinates module</tertiary>
   6 </indexterm>
   7
   8 <screenshot>
   9 <screeninfo>
  10 The Planet Coordinates calculator module
  11 </screeninfo>
  12 <mediaobject>
  13   <imageobject>
  14     <imagedata fileref="calc-planetcoords.png" format="PNG"/>
  15   </imageobject>
  16   <textobject>
  17     <phrase>Planet Coordinates</phrase>
  18   </textobject>
  19 </mediaobject>
  20 </screenshot>
  21
  22 <para>
  23 The Planet Coordinates module computes positional data for
  24 any major solar system body, for any time and date and any
  25 geographic location.  Simply select the <guilabel>solar
  26 system body</guilabel> from the drop-down list, and specify
  27 the desired date, time, and geographic coordinates (these
  28 values are preset to the current &kstars; settings).  Then
  29 press the <guibutton>Compute</guibutton> button to determine
  30 the <link linkend="equatorial">Equatorial</link>, <link
  31 linkend="horizontal">Horizontal</link>, and <link
  32 linkend="ecliptic">Ecliptic</link> coordinates of the body.
  33 </para>
  34 <para>
  35 There is a batch mode for this module.  You must construct
  36 an input file in which each line specifies values for the
  37 input parameters (solar system body, date, time, longitude,
  38 and latitude).  You may choose to specify a constant value
  39 for some of the parameters in the calculator window (these
  40 parameters should be skipped in the input file).  You may
  41 also specify which of the output parameters (Equatorial,
  42 Horizontal, and Ecliptic coordinates) should be calculated.
  43 Finally, specify the input and output filenames, and press
  44 the <guibutton>Run</guibutton> button to generate the output
  45 file with the computed values.
  46 </para>
  47 </sect2>