summaryrefslogtreecommitdiffstats
path: root/doc/kstars/observinglist.docbook
blob: 7a39610dbf4fbf033990e17f4c66e3df123486bc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
<sect1 id="tool-observinglist">
<title>Observing List Tool</title>
<indexterm><primary>Tools</primary>
<secondary>Observing List Tool</secondary>
</indexterm>

<screenshot>
<screeninfo>
The Observing List Tool
</screeninfo>
<mediaobject>
  <imageobject>
    <imagedata fileref="observinglist.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase>Observing List Tool</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para>
The purpose of the Observing List Tool is to provide convenient 
access to some common functions for a list of objects chosen by 
you.  Objects are added to the list by using the <quote>Add to 
List</quote> action in the <link linkend="popup-menu">popup 
menu</link>, or by simply pressing the <keycap>O</keycap> key 
to add the currently-selected object.
</para>
<para>
Objects in the list can be sorted by any of the data columns 
(Name, Right Ascension, Declination, Magnitude, and Type).  
To perform an action on an object, highlight it in the list, 
and then press one of the Action buttons at the top of the 
window.  Some actions can be performed while multiple objects 
are selected; others only operate when one object is selected.
The available actions are:

<variablelist>
<varlistentry>
<term>Center</term>
<listitem>
<para>
Center the display on the selected object, and begin Tracking 
it.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Scope</term>
<listitem>
<para>
Point your <link linkend="indi">telescope</link> at the 
selected object.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Alt vs. Time</term>
<listitem>
<para>
Open the <link linkend="tool-altvstime">Altitude vs. Time 
Tool</link>, with the selected object(s) preloaded
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Details</term>
<listitem>
<para>
Open the <link linkend="tool-details">Detailed Information 
Window</link> for the selected object.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Remove</term>
<listitem>
<para>
Remove the selected object(s) from the observing list.
</para>
</listitem>
</varlistentry>

</variablelist>
</para>

<note>
<para>
The Observing List tool is a new feature and is still under 
development.  We are planning to add more features, such as 
adding objects to the list by selecting a region in the sky, and 
the ability to save observing lists to disk.  
</para>
</note>
</sect1>