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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
|
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.0//EN" "dtd/kdex.dtd" [
<!ENTITY kappname "&kstars;">
<!ENTITY package "kdeedu">
<!ENTITY astroinfo SYSTEM "astroinfo.docbook">
<!ENTITY blackbody SYSTEM "blackbody.docbook">
<!ENTITY calc-angdist SYSTEM "calc-angdist.docbook">
<!ENTITY calc-apcoords SYSTEM "calc-apcoords.docbook">
<!ENTITY calc-ecliptic SYSTEM "calc-ecliptic.docbook">
<!ENTITY calc-eqgal SYSTEM "calc-eqgal.docbook">
<!ENTITY calc-equinox SYSTEM "calc-equinox.docbook">
<!ENTITY calc-horiz SYSTEM "calc-horizontal.docbook">
<!ENTITY calc-planetcoords SYSTEM "calc-planetcoords.docbook">
<!ENTITY calc-precess SYSTEM "calc-precess.docbook">
<!ENTITY calc-geodetic SYSTEM "calc-geodetic.docbook">
<!ENTITY calc-dayduration SYSTEM "calc-dayduration.docbook">
<!ENTITY calc-julian SYSTEM "calc-julianday.docbook">
<!ENTITY calc-sidereal SYSTEM "calc-sidereal.docbook">
<!ENTITY calculator SYSTEM "calculator.docbook">
<!ENTITY cequator SYSTEM "cequator.docbook">
<!ENTITY colorandtemp SYSTEM "colorandtemp.docbook">
<!ENTITY commands SYSTEM "commands.docbook">
<!ENTITY config SYSTEM "config.docbook">
<!ENTITY contents SYSTEM "ai-contents.docbook">
<!ENTITY cpoles SYSTEM "cpoles.docbook">
<!ENTITY credits SYSTEM "credits.docbook">
<!ENTITY csphere SYSTEM "csphere.docbook">
<!ENTITY darkmatter SYSTEM "darkmatter.docbook">
<!ENTITY dumpmode SYSTEM "dumpmode.docbook">
<!ENTITY ecliptic SYSTEM "ecliptic.docbook">
<!ENTITY ellipgal SYSTEM "ellipticalgalaxies.docbook">
<!ENTITY equinox SYSTEM "equinox.docbook">
<!ENTITY faq SYSTEM "faq.docbook">
<!ENTITY flux SYSTEM "flux.docbook">
<!ENTITY geocoords SYSTEM "geocoords.docbook">
<!ENTITY greatcircle SYSTEM "greatcircle.docbook">
<!ENTITY horizon SYSTEM "horizon.docbook">
<!ENTITY hourangle SYSTEM "hourangle.docbook">
<!ENTITY indi SYSTEM "indi.docbook">
<!ENTITY install SYSTEM "install.docbook">
<!ENTITY julianday SYSTEM "julianday.docbook">
<!ENTITY leapyear SYSTEM "leapyear.docbook">
<!ENTITY lightcurves SYSTEM "lightcurves.docbook">
<!ENTITY luminosity SYSTEM "luminosity.docbook">
<!ENTITY magnitude SYSTEM "magnitude.docbook">
<!ENTITY meridian SYSTEM "meridian.docbook">
<!ENTITY parallax SYSTEM "parallax.docbook">
<!ENTITY precession SYSTEM "precession.docbook">
<!ENTITY quicktour SYSTEM "quicktour.docbook">
<!ENTITY retrograde SYSTEM "retrograde.docbook">
<!ENTITY sidereal SYSTEM "sidereal.docbook">
<!ENTITY skycoords SYSTEM "skycoords.docbook">
<!ENTITY spiralgal SYSTEM "spiralgalaxies.docbook">
<!ENTITY stars SYSTEM "stars.docbook">
<!ENTITY timezones SYSTEM "timezones.docbook">
<!ENTITY tool-aavso SYSTEM "lightcurves.docbook">
<!ENTITY tool-altvstime SYSTEM "altvstime.docbook">
<!ENTITY tool-calculator SYSTEM "calculator.docbook">
<!ENTITY tool-details SYSTEM "details.docbook">
<!ENTITY tool-whatsup SYSTEM "wut.docbook">
<!ENTITY tool-scriptbuilder SYSTEM "scriptbuilder.docbook">
<!ENTITY tool-solarsys SYSTEM "solarsys.docbook">
<!ENTITY tool-jmoons SYSTEM "jmoons.docbook">
<!ENTITY tools SYSTEM "tools.docbook">
<!ENTITY utime SYSTEM "utime.docbook">
<!ENTITY zenith SYSTEM "zenith.docbook">
<!ENTITY % addindex "INCLUDE">
<!ENTITY % British-English "INCLUDE"
><!-- change language only here -->
]>
<book lang="&language;">
<title
>The &kstars; Handbook</title>
<bookinfo>
<authorgroup>
<author
><firstname
>Jason</firstname
> <surname
>Harris</surname
> <affiliation
> <address
><email
>kstars@30doradus.org</email
></address>
</affiliation>
</author>
<othercredit role="developer"
><firstname
>Heiko</firstname
> <surname
>Evermann</surname
> <affiliation
> <address
><email
>heiko@evermann.de</email
></address>
</affiliation>
<contrib
>Core Developer</contrib>
</othercredit>
<othercredit role="developer"
><firstname
>Thomas</firstname
> <surname
>Kabelmann</surname
> <affiliation
> <address
><email
>tk78@gmx.de</email
></address>
</affiliation>
<contrib
>Core Developer</contrib>
</othercredit>
<othercredit role="developer"
><firstname
>Pablo</firstname
> <surname
>de Vicente</surname
> <affiliation
> <address
><email
>pvicentea@wanadoo.es</email
></address>
</affiliation>
<contrib
>Core Developer</contrib>
</othercredit>
<othercredit role="developer"
><firstname
>Jasem</firstname
> <surname
>Mutlaq</surname
> <affiliation
> <address
><email
>mutlaqja@ikarustech.com</email
></address>
</affiliation>
<contrib
>Core Developer</contrib>
</othercredit>
<othercredit role="developer"
><firstname
>Carsten</firstname
> <surname
>Niehaus</surname
> <affiliation
> <address
><email
>cniehaus@gmx.de</email
></address>
</affiliation>
<contrib
>Core Developer</contrib>
</othercredit>
<othercredit role="developer"
><firstname
>Mark</firstname
> <surname
>Holloman</surname
> <affiliation
> <address
><email
>mhh@mindspring.com</email
></address>
</affiliation>
<contrib
>Core Developer</contrib>
</othercredit>
</authorgroup>
<othercredit role="translator"
><firstname
>Andrew</firstname
><surname
>Coles</surname
><affiliation
><address
><email
>andrew_coles@yahoo.co.uk</email
></address
></affiliation
><contrib
>Conversion to British English</contrib
></othercredit
>
<copyright>
<year
>2001</year
><year
>2002</year
><year
>2003</year>
<holder
>Jason Harris and the KStars Team</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>
<date
>2002-10-08</date>
<releaseinfo
>1.0</releaseinfo>
<abstract>
<para
>&kstars; is a graphical desktop planetarium for KDE. It depicts an accurate simulation of the night sky, including stars, constellations, star clusters, nebulae, galaxies, all planets, the Sun, the Moon, comets and asteroids. You can see the sky as it appears from any location on Earth, on any date. The user interface is highly intuitive and flexible; the display can be panned and zoomed with the mouse, and you can easily identify objects and track their motion across the sky. &kstars; includes many powerful features, yet the interface is clean and simple, and fun to use. </para>
</abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>Astronomy</keyword>
<keyword
>KStars</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title
>Introduction</title>
<para
>&kstars; lets you explore the night sky from the comfort of your computer chair. It provides an accurate graphical representation of the night sky for any date, from any location on Earth. The display includes 126,000 stars to 9th magnitude (well below the naked-eye limit), 13,000 deep-sky objects (Messier, NGC, and IC catalogs), all planets, the Sun and Moon, hundreds of comets and asteroids, the Milky Way, 88 constellations, and guide lines such as the <link linkend="ai-cequator"
>celestial equator</link
>, the <link linkend="ai-horizon"
>horizon</link
> and the <link linkend="ai-ecliptic"
>ecliptic</link
>. </para>
<para
>However, &kstars; is more than a simple night-sky simulator. The display provides a compelling interface to a number of tools with which you can learn more about astronomy and the night sky. There is a customised <link linkend="popup-menu"
>popup menu</link
> attached to each displayed object, which displays object-specific information and actions. Hundreds of objects provide links in their popup menus to informative webpages and beautiful images taken by the Hubble Space Telescope and other observatories. </para
><para
>From an object's popup menu, you can open its <link linkend="tool-details"
>Detailed Information Window</link
>, where you can examine positional data about the object, and query a huge treasury of online databases for professional-grade astronomical data and literature references about the object. You can even attach your own internet links, images and text notes, making &kstars; a graphical front-end to your observing logs and your personal astronomical notebook. </para>
<para
>Our <link linkend="tool-calculator"
>Astrocalculator</link
> tool provides direct access to many of the algorithms the program uses behind the scenes, including coordinate converters and time calculators. The <link linkend="tool-aavso"
>AAVSO Lightcurve Generator</link
> tool will download a lightcurve for any of the 6000+ variable stars monitored by the American Association of Variable Star Observers (AAVSO). The lightcurves are generated <quote
>on the fly</quote
> by querying the AAVSO server directly, ensuring that you have the very latest data points. </para>
<para
>You can plan an observing session using our <link linkend="tool-altvstime"
>Altitude vs. Time</link
> tool, which will plot curves representing the Altitude as a function of time for any group of objects. If that is too much detail, we also provide a <link linkend="tool-whatsup"
>What's Up Tonight?</link
> tool that summarises the objects that you will be able to see from your location on any given night. </para>
<para
>&kstars; also provides a <link linkend="tool-solarsys"
>Solar System Viewer</link
>, which shows the current configuration of the major planets in our solar system. There is also a <link linkend="tool-jmoons"
>Jupiter Moons Tool</link
> which shows the positions of Jupiter's four largest moons as a function of time. </para>
<para
>Our primary goal is to make &kstars; an interactive educational tool for learning about astronomy and the night sky. To this end, the &kstars; Handbook includes the <link linkend="astroinfo"
>AstroInfo Project</link
>, a series of short, hyperlinked articles on astronomical topics that can be explored with &kstars;. In addition, &kstars; includes DCOP functions that allow you to <link linkend="tool-scriptbuilder"
>write complex scripts</link
>, making &kstars; a powerful "demo engine" for classroom use or general illustration of astronomical topics. </para>
<para
>You can even control telescopes with &kstars;, using the elegant and powerful <link linkend="indi"
>INDI</link
> hardware interface. &kstars; supports several popular telescopes including Meade's LX200 family and Celestron GPS. Several popular CCD cameras, webcams and computerised focusers are also supported. Simple slew/track commands are integrated directly into the main window's popup menu, and the INDI Control Panel provides full access to all of your telescope's functions. INDI's Client/Server architecture allows for seamless control of any number of <link linkend="indi-kstars-setup"
>local</link
> or <link linkend="indi-remote-control"
>remote</link
> telescopes using a single &kstars; session. </para>
<para
>We are very interested in your feedback; please report bugs or feature requests to the &kstars; development mailing list: <email
>kstars-devel@kde.org</email
>. You can also use the automated bug reporting tool, accessible from the Help menu. </para>
</chapter>
&quicktour; <!--A Quick Tour of KStars-->
&config; <!--Configuring KStars-->
&commands; <!--Command Reference-->
&astroinfo; <!--AstroInfo Articles-->
&tools; <!--KStars Tools-->
&dumpmode; <!--Command-line image-dump mode-->
&indi; <!-- INDI-->
&faq; <!--Questions and Answers-->
&credits; <!--Credits and License-->
&install; <!--Installation-->
<index id='doc-index'
></index>
<!-- For DocBook 4.2, remove the above line and use this instead
&documentation.index;
-->
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
|