summaryrefslogtreecommitdiffstats
path: root/doc/kstars/jmoons.docbook
diff options
context:
space:
mode:
Diffstat (limited to 'doc/kstars/jmoons.docbook')
-rw-r--r--doc/kstars/jmoons.docbook38
1 files changed, 38 insertions, 0 deletions
diff --git a/doc/kstars/jmoons.docbook b/doc/kstars/jmoons.docbook
new file mode 100644
index 00000000..40a7d7b7
--- /dev/null
+++ b/doc/kstars/jmoons.docbook
@@ -0,0 +1,38 @@
+<sect1 id="tool-jmoons">
+<title>Jupiter Moons Tool</title>
+<indexterm><primary>Tools</primary>
+<secondary>Jupiter Moons Tool</secondary>
+</indexterm>
+
+<screenshot>
+<screeninfo>
+The Jupiter Moons Tool
+</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="jmoons.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Jupiter Moons Tool</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+
+<para>
+This tool displays the positions of Jupiter's four largest
+moons (Io, Europa, Ganymede, and Callisto) relative to Jupiter,
+as a function of time. Time is plotted vertically; the units are days
+and <quote>time=0.0</quote> corresponds to the current simulation time.
+The horizontal axis displays the angular offset from Jupiter's position,
+in arcminutes. The offset is measured along the direction of Jupiter's
+equator. Each moon's position as a function of time traces a sinusoidal
+path in the plot, as the moon orbits around Jupiter. Each track is
+assigned a different color to distinguish it from the others; the name
+labels at the top of the window indicate the color used by each moon.
+</para><para>
+The plot can be manipulated with the keyboard. The time axis can be
+expanded or compressed using the <keycap>+</keycap> and
+<keycap>-</keycap> keys. The time displayed at the center of the window
+can be changed with the <keycap>[</keycap> and <keycap>]</keycap> keys.
+</para>
+</sect1>