forked from Stellarium/stellarium
-
Notifications
You must be signed in to change notification settings - Fork 0
/
ch_tour.tex
298 lines (246 loc) · 16 KB
/
ch_tour.tex
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
% Status info:
% M. Gates 2006-2009
% A. Wolf 2011-2014
% B. Gerdes 2013
% Additions inserted from wiki 2015-12-26
% Content OK for 0.12.4.
% 2016-04 GZ started restructuring
% TODO: typo&grammar check
%\chapterimage{chapter-t2-bg} % Chapter heading image (now in guide.tex)
\chapter{A First Tour}
\label{ch:tour}
\begin{figure}[tbh]\centering
\includegraphics[width=0.95\textwidth,trim=0 0 0 30,clip]{001.png}
\caption{Stellarium main view. (Combination of day and night views.)}
\label{fig:001}
\end{figure}
\noindent When Stellarium first starts, we see a green meadow under a
sky. Depending on the time of day, it is either a day or night
scene. If you are connected to the Internet, an automatic lookup will
attempt to detect your approximate position.\footnote{See
section~\ref{sec:gui:location} if you want to switch this off.}
At the bottom left of the screen, you can see the status bar. This shows
the current observer location, vertical field of view (FOV), graphics performance
in frames per second (FPS) and the current simulation date and time.
If you move the mouse over the status bar, it will move up to reveal a
tool bar which gives quick control over the program.
The rest of the view is devoted to rendering a realistic scene including
a panoramic landscape and the sky. If the simulation time and observer
location are such that it is night time, you will see stars, planets and
the moon in the sky, all in the correct positions.
You can drag with the mouse on the sky to look around or use the
cursor keys. You can zoom with the mouse wheel or the \key{Page
\arrowkeyup} or \key{Page \arrowkeydown} keys.
Much of Stellarium can be controlled very intuitively with the
mouse. Many settings can additionally be switched with shortcut keys
(hotkeys). Advanced users will learn to use these shortcut
keys. Sometimes a key combination will be used. For example, you can
quit Stellarium by pressing \key{\ctrl+Q} on Windows and Linux, and
\key{\cmdmac+Q} on Mac OS X. For simplicity, we will show only the
Windows/Linux version. We will present the default hotkeys in this
guide. However, almost all hotkeys can be reconfigured to match your
taste. Note that some listed shortkeys are only available as key
combinations on international keyboard layouts, e.g., keys which
require pressing \key{AltGr} on a German keyboard. These must be
reconfigured, please see~\ref{sec:gui:help:hotkeys} for details.
The way Stellarium is shown on the screen is primarily governed by the
menus. These are accessed by dragging the mouse to the left or bottom
edge of the screen, where the menus will slide out. In case you want
to see the menu bars permanently, you can press the small buttons
right in the lower left corner to keep them visible.
\section{Time Travel}
\label{sec:tour:timeTravel}
When Stellarium starts up, it sets its clock to the same time and date
as the system clock. However, Stellarium's clock is not fixed to the same
time and date as the system clock, or indeed to the same speed. We may
tell Stellarium to change how fast time should pass, and even make time
go backwards! So the first thing we shall do is to travel into the
future! Let's take a look at the time control buttons on the right hand
ride of the tool-bar. If you hover the mouse cursor over the buttons, a
short description of the button's purpose and keyboard shortcut will
appear.
\begin{table}[h]
\centering
\begin{tabular}{ccl}\toprule
\emph{Button} & \emph{Shortcut key} & \emph{Description}\\\midrule
\guibutton[0.75]{2.25}{bt_timerate_decrease.png} & \key{J} & Decrease the rate at which time passes \\
\guibutton[0.75]{2.25}{bt_timerate_normal.png} & \key{K} & Make time pass as normal \\
\guibutton[0.75]{2.25}{bt_timerate_increase.png} & \key{L} & Increase the rate at which time passes \\
\guibutton[0.75]{2.25}{bt_time_normal.png} & \key{8} & Return to the current time \& date \\
\bottomrule
\end{tabular}
\caption{Time Travel}
\end{table}
OK, so lets go see the future! Click the mouse once on the increase time
speed button \guibutton{0.6}{bt_timerate_increase.png}.
Not a whole lot seems to happen. However, take a look at the clock in
the status bar. You should see the time going by faster than a normal
clock! Click the button a second time. Now the time is going by faster
than before. If it's night time, you might also notice that the stars
have started to move slightly across the sky. If it's daytime you might
be able to see the sun moving (but it's less apparent than the movement
of the stars). Increase the rate at which time passes again by clicking
on the button a third time. Now time is really flying!
Let time move on at this fast speed for a little while. Notice how the
stars move across the sky. If you wait a little while, you'll see the
Sun rising and setting. It's a bit like a time-lapse movie.
Stellarium not only allows for moving forward through time -- you can
go backwards too! Click on the real time speed button
\guibutton{0.6}{bt_timerate_normal.png}. The stars and/or the
Sun should stop scooting across the sky. Now press the decrease time
speed button \guibutton{0.6}{bt_timerate_decrease.png} once. Look
at the clock. Time has stopped. Click the decrease time speed button
four or five more times. Now we're falling back through time at quite
a rate (about one day every ten seconds!).
\subsection*{Time Dragging, Time Scrolling}
\label{sec:tour:timeDrag}
Another way to quickly change time is \indexterm{time dragging}. Press
\keys{\ctrl} and slide the mouse along the direction of daily motion to go forward,
or to the other direction to go backward.
\newFeature{v0.15.1}Similarly, pressing \keys{\ctrl} and scrolling the mouse wheel will
advance time by minutes, pressing \keys{\ctrl+\shift} and
scrolling the mouse wheel will advance time by hours, \keys{\ctrl+\Alt} by days,
and finally \keys{\ctrl+\shift+\Alt} by calendar years.
Enough time travel for now. Wait until it's night time, and then click
the real time speed button \guibutton{0.6}{bt_timerate_normal.png}. With a
little luck you will now be looking at the night sky.
\section{Moving Around the Sky}
\label{sec:tour:moving}
\begin{table}[h]
\centering
\begin{tabular}{ll}\toprule
\emph{Key} & \emph{Description}\\\midrule
Cursor keys \keys{\arrowkeyleft} \keys{\arrowkeyright} \keys{\arrowkeyup} \keys{\arrowkeydown} & Pan the view left, right, up and down \\
\keyPageUp{}/\keyPageDown{}, \keys{\ctrl+\arrowkeyup}/\keys{\ctrl+\arrowkeydown} & Zoom in and out \\
Left mouse button & Select an object in the sky \\
Right mouse button & Clear selected object \\
Centre mouse button (wheel press) & Centre selected object and start tracking \\
Mouse wheel & Zoom in and out \\
\key{\space} & Centre view on selected object \\
Forward-slash (\key{/}) & Auto-zoom in to selected object \\
Backslash (\key{\textbackslash{}}) & Auto-zoom out to original field of view \\
\bottomrule
\end{tabular}
\caption{Moving Around the Sky}
\label{tab:tour:moving}
\end{table}
As well as travelling through time, Stellarium lets to look around the
sky freely, and zoom in and out. There are several ways to accomplish
this listed in table~\ref{tab:tour:moving}.
Let's try it. Use the cursors to move around left, right, up and down.
Zoom in a little using the \keyPageUp{} key, and back out again using the
\keyPageDown{}. Press the \key{\textbackslash} key and see how Stellarium returns to the
original field of view (how ``zoomed in'' the view is), and direction of
view.
%% TODO Is this still original behaviour? On German Kbd, this does not work anyways, backslash is a AltGr-combination.
It's also possible to move around using the mouse. If you left-click and
drag somewhere on the sky, you can pull the view around.
Another method of moving is to select some object in the sky (left-click
on the object), and press the \key{Space} key to centre the view on that
object. Similarly, selecting an object and pressing the forward-slash
key \key{/} will centre on the object and zoom right in on it.
The forward-slash \key{/} and backslash \key{\textbackslash} keys auto-zoom in an out to different
zoom levels depending on what is selected. If the object selected is a planet
or moon in a \emph{sub-system} with a lot of moons (e.g.\ Jupiter), the
initial zoom in will go to an intermediate level where the whole
sub-system should be visible. A second zoom will go to the full zoom
level on the selected object. Similarly, if you are fully zoomed in on a
moon of Jupiter, the first auto-zoom out will go to the sub-system zoom
level. Subsequent auto-zoom out will fully zoom out and return the
initial direction of view. For objects that are not part of a
sub-system, the initial auto-zoom in will zoom right in on the selected
object (the exact field of view depending on the size/type of the
selected object), and the initial auto-zoom out will return to the
initial FOV and direction of view.
\section{The Main Tool Bar}
\label{sec:tour:toolbar}
\begin{figure}[htb]
\centering\includegraphics[width=0.9\textwidth]{002.png}
\caption{Night scene with constellation artwork and moon.}
\label{fig:002}
\end{figure}
Stellarium can do a whole lot more than just draw the stars. Figure~\ref{fig:002}
shows some of Stellarium's visual effects including constellation
line and boundary drawing, constellation art, planet hints, and
atmospheric halo around the bright Moon. The controls in the main tool bar
provide a mechanism for turning on and off the visual effects.
When the mouse if moved to the bottom left of the screen, a second
tool bar becomes visible. All the buttons in this side tool bar open
and close dialog boxes which contain controls for further
configuration of the program. The dialogs will be described in the
next chapter.
Table~\ref{tab:tour:buttons} describes the operations of buttons
on the main tool bar and the side tool bar, and gives their default
keyboard shortcuts.
%% TODO: Check default keys!
\newpage
%\begin{longtabu} to \textwidth {llcX}\toprule
\begin{longtable}{lccp{55mm}}\toprule
\emph{Feature} & \emph{Button} & \emph{Key} & \emph{Description}\\\midrule
Constellations & \guibutton[0.75]{2.5}{bt_constellation.png} & \key{C} & Draw constellations as ``stick figures'' \\
Constellation Names & \guibutton[0.75]{2.5}{bt_constellation_name.png}& \key{V} & Draw name of the constellations \\
Constellation Art & \guibutton[0.75]{2.5}{bt_constellation_art.png} & \key{R} & Superimpose artistic representations of the constellations \\
Constellation Boundaries & \guibutton[0.75]{2.5}{bt_constellation_boundaries.png}& \key{B} & Draw boundaries of the constellations \footnotemark[1]\\
Equatorial Grid & \guibutton[0.75]{2.5}{bt_eq_grid.png} & \key{E} & Draw grid lines for the equatorial coordinate system (RA/Dec) \\
Azimuth Grid & \guibutton[0.75]{2.5}{bt_az_grid.png} & \key{Z} & Draw grid lines for the horizontal coordinate system (Alt/Azi) \\
Galactic Grid & \guibutton[0.75]{2.5}{bt_gal_grid.png} & & Draw grid lines for the galactic coordinate system (Long/Lat) \footnotemark[1]\\
Equatorial J2000 Grid & \guibutton[0.75]{2.5}{bt_eq_j2000_grid.png} & & Draw grid lines for the equatorial coordinate system at standard epoch J2000.0 (RA/Dec) \footnotemark[1]\\
Ecliptic Grid & \guibutton[0.75]{2.5}{bt_ecl_grid.png} & & Draw grid lines for the ecliptic coordinate system of date (Long/Lat) \footnotemark[1]\\
Toggle Ground & \guibutton[0.75]{2.5}{bt_ground.png} & \key{G} & Toggle drawing of the ground. Turn this off to see objects that are below the horizon. \\
Toggle Cardinal Points & \guibutton[0.75]{2.5}{bt_cardinal.png} & \key{Q} & Toggle marking of the North, South, East and West points on the horizon. \\
Toggle Atmosphere & \guibutton[0.75]{2.5}{bt_atmosphere.png} & \key{A} & Toggle atmospheric effects. Most notably makes the stars visible in the daytime. \\
Deep-Sky Objects & \guibutton[0.75]{2.5}{bt_nebulae.png} & \key{D} & Toggle marking the positions of Deep-Sky Objects. \\
Planet Hints & \guibutton[0.75]{2.5}{bt_planets.png} & \key{P} & Toggle indicators to show the position of planets. \\
Nebula images & \guibutton[0.75]{2.5}{bt_DSS.png} & \key{I} & Toggle ``nebula images''. \footnotemark[1]\\
Digitized Sky Survey & \guibutton[0.75]{2.5}{bt_ToastSurvey.png} & & Toggle ``Digitized Sky Survey'' (TOAST).\footnotemark[1]\\
Hierarchical Progressive Surveys & \guibutton[1.00]{2.5}{bt_Surveys.png} & \key{\ctrl+Alt+D} & Toggle ``Hierarchical Progressive Surveys''.\footnotemark[1]\\
Coordinate System & \guibutton[0.75]{2.5}{bt_coord_type.png} & \key{\ctrl+M} & Toggle between horizontal (Alt/Azi) \& equatorial (RA/Dec) coordinate systems. \\
Goto & \guibutton[0.75]{2.5}{bt_goto.png} & \key{\Space} & Center the view on the selected object \\
Night Mode & \guibutton[0.75]{2.5}{bt_night_mode.png} & \key{\ctrl+N} & Toggle ``night mode'', which applies a red-only filter to the view to be easier on the dark-adapted eye. \\
Full Screen Mode & \guibutton[0.75]{2.5}{bt_fullscreen.png} & \key{F11} & Toggle full screen mode. \\
Bookmarks & \guibutton[0.75]{2.5}{bt_bookmarks.png} & \key{Alt+B} & Toggle bookmarks window. \footnotemark[1]\\
Flip view (horizontal) & \guibutton[0.75]{2.5}{bt_fliph.png} & \key{\ctrl+Shift+H} & Flip the image in the horizontal plane. \footnotemark[1] \\
Flip view (vertical) & \guibutton[0.75]{2.5}{bt_flipv.png} & \key{\ctrl+Shift+V} & Flip the image in the vertical plane. \footnotemark[1]\\
Quit Stellarium & \guibutton[0.75]{2.5}{bt_quit.png} & \key{\ctrl+Q} & Close Stellarium.\\
Help Window & \guibutton[0.5]{2.5}{btd_help.png} & \key{F1} & Show the help window, with key bindings and other useful information \\
Configuration Window & \guibutton[0.5]{2.5}{btd_config.png} & \key{F2} & Show the configuration window \\
Search Window & \guibutton[0.5]{2.5}{btd_find.png} & \key{F3} or \key{Ctrl+F} & Show the object search window \\
View Window & \guibutton[0.5]{2.5}{btd_view.png} & \key{F4} & Show the view window \\
Time Window & \guibutton[0.5]{2.5}{btd_time.png} & \key{F5} & Show the time window \\
Location Window & \guibutton[0.5]{2.5}{btd_location.png} & \key{F6} & Show the observer location window (map) \\
AstroCalc Window & \guibutton[0.5]{2.5}{btd_astrocalc.png} & \key{F10} & Show the astronomical calculations window \\
\bottomrule
\caption{Stellarium's standard menu buttons. Those marked \protect\footnotemark[1] must be enabled first, see section~\ref{sec:gui:configuration:tools}.}
\label{tab:tour:buttons}
\end{longtable}
\section{Taking Screenshots}
\label{sec:tour:screenshots}
You can save what is on the screen to a file by pressing
\key{\ctrl+S}. Screenshots are taken in PNG format, and
have filenames like \file{stellarium-000.png},
\file{stellarium-001.png} (the number increments to prevent
overwriting existing files).
Stellarium creates screenshots in a directory depending on
your operating system, see section
\ref{sec:Directories} Files and Directories.
\section{Bookmarks}
\label{sec:tour:bookmarks}
You can store your favourite objects or views with a bookmark. Press
\key{Alt+B} or \guibutton[0.75]{2.5}{bt_bookmarks.png}. If date and/or
location are relevant, make sure you activate the respective buttons.
\section{Custom Markers}
\label{sec:tour:markers}
You can set temporary markers anywhere in the screen. These may be useful for various purposes but cannot be stored.
\begin{center}
\begin{tabular}{rl}\toprule
\emph{Actions} & \emph{Description}\\\midrule
\key{Shift} \& left click & Add custom marker \\
\key{Shift} \& right click & Delete the one closest marker to mouse cursor\\
\key{Alt+Shift} \& right click & Delete all custom markers
\\\bottomrule
\end{tabular}
\end{center}
%%% Local Variables:
%%% mode: latex
%%% TeX-master: "guide"
%%% End: