Updated Stellarium User Guide

29 files changed, 93 insertions, 21 deletions

diff --git a/guide/ch_astronomical_concepts.tex b/guide/ch_astronomical_concepts.tex
index dc1dad35dd..59788f3536 100644
--- a/guide/ch_astronomical_concepts.tex
+++ b/guide/ch_astronomical_concepts.tex
@@ -738,14 +738,14 @@ The following list describes sources and a few details about the models for $\De
   addendum~\citep{2005JHA....36..339M}. Valid range of usage: between
   years -1000 and 2000. $\dot{n}=-26.0''/\cy^2$.
 
-\item[Stephenson, Morrison \& Hohenkerk (2016).] This important new solution was published 
+\item[Stephenson, Morrison \& Hohenkerk (2016, 2021).] This important new solution was published 
   %by F. R. Stephenson,  L. V. Morrison and C. Y. Hohenkerk in the article 
   %``Measurement of the Earth’s rotation: 720 BC to AD 2015''~
   in \citetp{StephensonMorrisonHohenkerk:2016}. 
   The solution combines a spline fit to observations (used between the given limits) 
   with a parabolic fit (used as fallback outside the range, but without smooth transitions at the limits, i.e., 
-  values for 2016 and later deviate notably from current estimates, and should not be used for dates after 2015).
-  Recommended range of usage: between years -720.0 and 2016.0 $\dot{n}=-25.82''/\cy^2$.
+  values for 2016 and later deviate notably from current estimates, and should not be used for dates after 2015). The solution was updated in 2021\citetp{StephensonMorrisonHohenkerk:2021}.
+  Recommended range of usage: between years -720.0 and 2019.0 $\dot{n}=-25.82''/\cy^2$.
   
 \item[Espenak \& Meeus (2006).] This solution by F. Espenak and J. Meeus, based on 
 	\citet{2004JHA....35..327M} and a polynomial fit
diff --git a/guide/ch_interface.tex b/guide/ch_interface.tex
index d7a9c58e82..0ce58f3c67 100644
--- a/guide/ch_interface.tex
+++ b/guide/ch_interface.tex
@@ -184,7 +184,7 @@ the tool button \guibutton[0.35]{2}{btd_config.png} or \key{F2} to open.
 The Main tab in the configuration window (Fig.~\ref{fig:gui:configuration:main}) provides controls for
 changing separately the program and sky culture languages.
 
-The next setting group allows to enable using DE430/DE431 ephemeris files. 
+The next setting group allows to enable using DE430/DE431 and DE440/DE441 ephemeris files. 
 These files have to be installed separately. Most users do not require this. 
 See section~\ref{sec:ExtraData:ephemerides} if you are interested.
 
@@ -1056,16 +1056,10 @@ Example provided in section~\ref{sec:gui:SearchWindow:Object}.
 
 This window \newFeature{0.15.0} provides advanced functionality, some of which is still in an experimental phase.
 You can call it by pressing \key{F10} or the button \guibutton{0.6}{btd_astrocalc.png} on the left menu bar. 
-The Astronomical Calculations window shows six tabs with different functionality.
+The Astronomical Calculations window shows eight tabs with different functionality.
 
 In version 0.18.3 \newFeature{0.18.3} we added exporting the data to XLSX files in addition to CSV files.
 
-\begin{figure}[htbp]
-	\centering\includegraphics[width=0.8\textwidth]{astrocalc_dialog_positions_tab.png}
-	\caption{Astronomical Calculations (AstroCalc): Celestial positions}
-	\label{fig:gui:AstroCalc:Positions}
-\end{figure}
-
 \subsection{The Positions Tab}
 \label{sec:gui:AstroCalc:Positions}
 
@@ -1075,6 +1069,20 @@ lists of celestial objects above the horizon at the simulated time, filtered by
 Double-clicking on an entry brings the object into focus (Fig.~\ref{fig:gui:AstroCalc:Positions}). 
 You may also export the list of positions into an XLSX or CSV file.
 
+\begin{figure}[htbp]
+	\centering\includegraphics[width=0.8\textwidth]{astrocalc_dialog_positions_tab.png}
+	\caption{Astronomical Calculations (AstroCalc): Celestial positions / Seen now}
+	\label{fig:gui:AstroCalc:Positions}
+\end{figure}
+
+In version 0.22.0\newFeature{0.22.0} this tab was splitted onto 2 subtabs: ``Seen now'' and ``Major planets''. The newly added ``Major planets'' subtab (Fig.~\ref{fig:gui:AstroCalc:Positions:MajorPlanets}) has table with heliocentric ecliptic positions of the major planets and graphical representation of these positions (in polar coordinates). You may also export the list of positions into an XLSX or CSV file.
+
+\begin{figure}[htbp]
+	\centering\includegraphics[width=0.8\textwidth]{astrocalc_dialog_positions_mp_tab.png}
+	\caption{Astronomical Calculations (AstroCalc): Celestial positions / Major Planets}
+	\label{fig:gui:AstroCalc:Positions:MajorPlanets}
+\end{figure}
+
 \subsection{The Ephemeris Tab}
 \label{sec:gui:AstroCalc:Ephemeris}
 
@@ -1133,19 +1141,21 @@ Since version 0.20.3\newFeature{0.20.3} we added ability to draw an ephemeris of
 two objects at the same time and define custom time step for the ephemeris 
 (Fig.~\ref{fig:gui:AstroCalc:Ephemeris:Asteroids}).
 
-\subsection{The Transits Tab}
-\label{sec:gui:AstroCalc:Transits}
+\subsection{The ``Rises, Transits and Sets'' (RTS) Tab}
+\label{sec:gui:AstroCalc:RTS}
 
 \begin{figure}[htbp]
 	\centering\includegraphics[width=0.8\textwidth]{astrocalc_dialog_transits_tab.png}
-	\caption{Astronomical Calculations (AstroCalc): Transits of selected celestial object}
-	\label{fig:gui:AstroCalc:Transits}
+	\caption{Astronomical Calculations (AstroCalc): Rises, transits and sets of selected celestial object}
+	\label{fig:gui:AstroCalc:RTS}
 \end{figure}
 
 \noindent This \newFeature{0.19.3} tab allows you to compute meridian transits of selected celestial object 
 (except unnamed stars and artificial satellites) for a specific date range. 
 The tool is proposed for planning observations, and it suggests the best time and conditions 
-for visual observations or astrophotography (Fig.~\ref{fig:gui:AstroCalc:Transits}).
+for visual observations or astrophotography (Fig.~\ref{fig:gui:AstroCalc:RTS}). 
+
+In version 0.22.0\newFeature{0.22.0} we extended this tool by adding time of rise and set and renamed onto RTS.
 
 You may also export the list of transits into an XLSX or CSV file.
 
@@ -1325,6 +1335,66 @@ current date) as graphs.
 \label{fig:gui:AstroCalc:PC:Graphs}
 \end{figure}
 
+\subsection{The Eclipses Tab}
+\label{sec:gui:AstroCalc:Eclipses}
+
+The Eclipses tool\newFeature{0.22.0} has been added in version 0.22.0 and has three subtabs --- ``All Solar Eclipses'', ``Local Solar Eclipses'' and ``Lunar Eclipses''. 
+
+You can export the calculated eclipses into an XLSX or CSV file.
+
+\subsubsection{The ``All Solar Eclipses'' Subtab}
+\label{sec:gui:AstroCalc:Eclipses:AllSolarEclipses}
+
+This subtab (Fig.~\ref{fig:gui:AstroCalc:Eclipses:AllSolarEclipses}) contains data for all solar eclipses on the Earth in defined time range. 
+
+\begin{figure}[htbp]
+\centering\includegraphics[width=0.8\textwidth]{astrocalc_dialog_eclipses_ase.jpg}
+\caption{Astronomical Calculations (AstroCalc): Eclipses / All Solar Eclipses}
+\label{fig:gui:AstroCalc:Eclipses:AllSolarEclipses}
+\end{figure}
+
+Double click on the table row will be going to the location and time of greatest eclipse.
+
+The quantity gamma is the minimum distance from the axis of lunar shadow cone to the center of Earth, in units of Earth’s equatorial radius. This distance is positive or negative, depending on whether the axis of the shadow cone passes north or south of the Earth's center. Path of solar eclipses during thousands of years in the past and future are not reliable due to uncertainty in $\Delta T$ which is caused by fluctuations in Earth's rotation.
+
+\subsubsection{The ``Local Solar Eclipses'' Subtab}
+\label{sec:gui:AstroCalc:Eclipses:LocalSolarEclipses}
+
+This subtab (Fig.~\ref{fig:gui:AstroCalc:Eclipses:LocalSolarEclipses}) contains data for solar eclipses for the current location (on the Earth!) in defined time range. 
+
+\begin{figure}[tbp]
+\centering\includegraphics[width=0.8\textwidth]{astrocalc_dialog_eclipses_lse.jpg}
+\caption{Astronomical Calculations (AstroCalc): Eclipses / Local Solar Eclipses}
+\label{fig:gui:AstroCalc:Eclipses:LocalSolarEclipses}
+\end{figure}
+
+Double click on the table row will be going to the time of greatest eclipse.
+
+Local circumstances for eclipses during thousands of years in the past and future are not reliable due to uncertainty in $\Delta T$ which is caused by fluctuations in Earth's rotation.
+
+\subsubsection{The ``Lunar Eclipses'' Subtab}
+\label{sec:gui:AstroCalc:Eclipses:LunarEclipses}
+
+This subtab (Fig.~\ref{fig:gui:AstroCalc:Eclipses:LunarEclipses}) contains data for all lunar eclipses on the Earth in defined time range.
+
+\begin{figure}[tbp]
+\centering\includegraphics[width=0.8\textwidth]{astrocalc_dialog_eclipses_le.jpg}
+\caption{Astronomical Calculations (AstroCalc): Eclipses / Lunar Eclipses}
+\label{fig:gui:AstroCalc:Eclipses:LunarEclipses}
+\end{figure}
+
+Double click on the table row will be going to the location and time of greatest eclipse.
+
+The quantity gamma is the minimum distance from the center of the Moon to the axis of Earth’s umbral shadow cone, in units of Earth’s equatorial radius. This distance is positive or negative, depending on whether the Moon passes north or south of the shadow cone axis. Local circumstances for eclipses during thousands of years in the past and future are not reliable due to uncertainty in $\Delta T$ which is caused by fluctuations in Earth's rotation.
+
+The visibility conditions are based on the altitude of the Moon at greatest eclipse:
+\begin{description}
+  \item[Invisible] --- the greatest eclipse is invisible in current location (altitude is negative);
+  \item[Not obs.] --- not observable eclipse. Our rule of thumb is that a partial penumbral eclipse is detectable with the unaided eye if penumbral magnitude > 0.7;
+  \item[Bad] --- bad visibility conditions for current location (altitude range is 0---30$\degree$);
+  \item[Good] --- good visibility conditions for current location (altitude range is 30---45$\degree$; e.g. since a ``photometric altitude'');
+  \item[Perfect] --- perfect visibility conditions for current location (altitude range is 45---90$\degree$).
+\end{description}
 
 \section{The Help Window}
 \label{sec:gui:help}
diff --git a/guide/ch_skycultures.tex b/guide/ch_skycultures.tex
index a9bd232a1b..b90d0a6122 100644
--- a/guide/ch_skycultures.tex
+++ b/guide/ch_skycultures.tex
@@ -123,7 +123,10 @@ ending \file{.utf8} indicates that for special characters like ÄÖÜßáé
 you should use UTF8 encoding. If you write only English/ASCII, this may not

 be relevant.

 

-\section{Constellation Names}

+\section{Proper Names}

+\label{sec:skycultures:names}

+

+\subsection{Constellation Names}

 \label{sec:skycultures:constellations}

 

 The native constellations are listed in

@@ -161,7 +164,7 @@ skyculture, please include an English translation to the name given in
 the native language. Else translators will not be able to translate

 the name. See a good example in the Mongolian skyculture.

 

-\section{Star Names}

+\subsection{Star Names}

 \label{sec:skycultures:starnames}

 

 The file \file{star\_names.fab} contains a list of HIP catalog

@@ -185,7 +188,7 @@ with data have the same Hipparcos number of the star --- \textit{Fomalhaut} is
 the well-known name of HIP 113368, and \textit{Thalim} is an additional 

 (not well-known) name of this star.

 

-\section{Planet Names}

+\subsection{Planet Names}

 \label{sec:skycultures:planetnames}

 

 The file \file{planet\_names.fab} contains a list of native names of

@@ -201,7 +204,7 @@ English). Here is an example from the Egyptian skyculture:
 Mars	"Horus-Desher"	_("Red Horus")

 \end{configfile}

 

-\section{Deep-Sky Objects Names}

+\subsection{Deep-Sky Objects Names}

 \label{sec:skycultures:dsonames}

 

 \noindent\newFeature{0.15.1}The file \file{dso\_names.fab} contains a list of native names for

diff --git a/guide/guide.tex b/guide/guide.tex
index dc45d12da9..b01ee1830a 100644
--- a/guide/guide.tex
+++ b/guide/guide.tex
@@ -209,7 +209,6 @@ implying a violation of copyright law.}}\\
 %----------------------------------------------------------------------------------------
 %	PART II
 %----------------------------------------------------------------------------------------
-
 \part{Advanced Use}
 
 %----------------------------------------------------------------------------------------
diff --git a/guide/pictures/astrocalc_dialog_eclipses_ase.jpg b/guide/pictures/astrocalc_dialog_eclipses_ase.jpg
new file mode 100644
index 0000000000..323779ff42
--- /dev/null
+++ b/guide/pictures/astrocalc_dialog_eclipses_ase.jpg
diff --git a/guide/pictures/astrocalc_dialog_eclipses_le.jpg b/guide/pictures/astrocalc_dialog_eclipses_le.jpg
new file mode 100644
index 0000000000..3eefecbbb7
--- /dev/null
+++ b/guide/pictures/astrocalc_dialog_eclipses_le.jpg
diff --git a/guide/pictures/astrocalc_dialog_eclipses_lse.jpg b/guide/pictures/astrocalc_dialog_eclipses_lse.jpg
new file mode 100644
index 0000000000..a03219adc3
--- /dev/null
+++ b/guide/pictures/astrocalc_dialog_eclipses_lse.jpg
diff --git a/guide/pictures/astrocalc_dialog_ephemeris_analemma.png b/guide/pictures/astrocalc_dialog_ephemeris_analemma.png
index 2fd5e5a9b4..a9bb7e1a88 100644
--- a/guide/pictures/astrocalc_dialog_ephemeris_analemma.png
+++ b/guide/pictures/astrocalc_dialog_ephemeris_analemma.png
diff --git a/guide/pictures/astrocalc_dialog_ephemeris_analemma_mars.png b/guide/pictures/astrocalc_dialog_ephemeris_analemma_mars.png
index c4f0ddfb13..6fefde4eea 100644
--- a/guide/pictures/astrocalc_dialog_ephemeris_analemma_mars.png
+++ b/guide/pictures/astrocalc_dialog_ephemeris_analemma_mars.png
diff --git a/guide/pictures/astrocalc_dialog_ephemeris_extra.png b/guide/pictures/astrocalc_dialog_ephemeris_extra.png
index 9e1c2b15fb..6017e7d4e1 100644
--- a/guide/pictures/astrocalc_dialog_ephemeris_extra.png
+++ b/guide/pictures/astrocalc_dialog_ephemeris_extra.png
diff --git a/guide/pictures/astrocalc_dialog_ephemeris_tab.png b/guide/pictures/astrocalc_dialog_ephemeris_tab.png
index 40f04f3fcd..9c727e86c4 100644
--- a/guide/pictures/astrocalc_dialog_ephemeris_tab.png
+++ b/guide/pictures/astrocalc_dialog_ephemeris_tab.png
diff --git a/guide/pictures/astrocalc_dialog_graphs_tab_ad.png b/guide/pictures/astrocalc_dialog_graphs_tab_ad.png
index 70bd0258ad..d9b56cfd29 100644
--- a/guide/pictures/astrocalc_dialog_graphs_tab_ad.png
+++ b/guide/pictures/astrocalc_dialog_graphs_tab_ad.png
diff --git a/guide/pictures/astrocalc_dialog_graphs_tab_altvstime.png b/guide/pictures/astrocalc_dialog_graphs_tab_altvstime.png
index e717ffadb6..ad1f7d916b 100644
--- a/guide/pictures/astrocalc_dialog_graphs_tab_altvstime.png
+++ b/guide/pictures/astrocalc_dialog_graphs_tab_altvstime.png
diff --git a/guide/pictures/astrocalc_dialog_graphs_tab_azivstime.png b/guide/pictures/astrocalc_dialog_graphs_tab_azivstime.png
index 5ec677861e..a67cbefab3 100644
--- a/guide/pictures/astrocalc_dialog_graphs_tab_azivstime.png
+++ b/guide/pictures/astrocalc_dialog_graphs_tab_azivstime.png
diff --git a/guide/pictures/astrocalc_dialog_graphs_tab_graphs.png b/guide/pictures/astrocalc_dialog_graphs_tab_graphs.png
index de8c927358..908e7a48c3 100644
--- a/guide/pictures/astrocalc_dialog_graphs_tab_graphs.png
+++ b/guide/pictures/astrocalc_dialog_graphs_tab_graphs.png
diff --git a/guide/pictures/astrocalc_dialog_graphs_tab_me.png b/guide/pictures/astrocalc_dialog_graphs_tab_me.png
index dae4ea983f..65f0f601d8 100644
--- a/guide/pictures/astrocalc_dialog_graphs_tab_me.png
+++ b/guide/pictures/astrocalc_dialog_graphs_tab_me.png
diff --git a/guide/pictures/astrocalc_dialog_pc_graphs_tab.png b/guide/pictures/astrocalc_dialog_pc_graphs_tab.png
index 284f6c8473..1c3fbff9ea 100644
--- a/guide/pictures/astrocalc_dialog_pc_graphs_tab.png
+++ b/guide/pictures/astrocalc_dialog_pc_graphs_tab.png
diff --git a/guide/pictures/astrocalc_dialog_pc_tab.png b/guide/pictures/astrocalc_dialog_pc_tab.png
index a3441619ed..6e6f5c8d02 100644
--- a/guide/pictures/astrocalc_dialog_pc_tab.png
+++ b/guide/pictures/astrocalc_dialog_pc_tab.png
diff --git a/guide/pictures/astrocalc_dialog_phenomena_tab.png b/guide/pictures/astrocalc_dialog_phenomena_tab.png
index 9ccc4e364c..98c58cc722 100644
--- a/guide/pictures/astrocalc_dialog_phenomena_tab.png
+++ b/guide/pictures/astrocalc_dialog_phenomena_tab.png
diff --git a/guide/pictures/astrocalc_dialog_positions_mp_tab.png b/guide/pictures/astrocalc_dialog_positions_mp_tab.png
new file mode 100644
index 0000000000..b03555e832
--- /dev/null
+++ b/guide/pictures/astrocalc_dialog_positions_mp_tab.png
diff --git a/guide/pictures/astrocalc_dialog_positions_tab.png b/guide/pictures/astrocalc_dialog_positions_tab.png
index 12f6259796..18d45b2b77 100644
--- a/guide/pictures/astrocalc_dialog_positions_tab.png
+++ b/guide/pictures/astrocalc_dialog_positions_tab.png
diff --git a/guide/pictures/astrocalc_dialog_transits_tab.png b/guide/pictures/astrocalc_dialog_transits_tab.png
index c7874892f5..638fa1117d 100644
--- a/guide/pictures/astrocalc_dialog_transits_tab.png
+++ b/guide/pictures/astrocalc_dialog_transits_tab.png
diff --git a/guide/pictures/astrocalc_dialog_wut_tab.png b/guide/pictures/astrocalc_dialog_wut_tab.png
index 50189ccedf..78f72cd9f1 100644
--- a/guide/pictures/astrocalc_dialog_wut_tab.png
+++ b/guide/pictures/astrocalc_dialog_wut_tab.png
diff --git a/guide/pictures/config_dialog_info_tab.png b/guide/pictures/config_dialog_info_tab.png
index 40eec029cd..df3f81c26d 100644
--- a/guide/pictures/config_dialog_info_tab.png
+++ b/guide/pictures/config_dialog_info_tab.png
diff --git a/guide/pictures/config_dialog_main_tab.png b/guide/pictures/config_dialog_main_tab.png
index 103aa4ddd6..a716013b13 100644
--- a/guide/pictures/config_dialog_main_tab.png
+++ b/guide/pictures/config_dialog_main_tab.png
diff --git a/guide/pictures/help_dialog.png b/guide/pictures/help_dialog.png
index 662ed92b17..a1b31d0329 100644
--- a/guide/pictures/help_dialog.png
+++ b/guide/pictures/help_dialog.png
diff --git a/guide/pictures/help_dialog_about.png b/guide/pictures/help_dialog_about.png
index 9792b5d11d..cbc969222e 100644
--- a/guide/pictures/help_dialog_about.png
+++ b/guide/pictures/help_dialog_about.png
diff --git a/guide/pictures/help_dialog_log.png b/guide/pictures/help_dialog_log.png
index e827b00355..b74b473847 100644
--- a/guide/pictures/help_dialog_log.png
+++ b/guide/pictures/help_dialog_log.png
diff --git a/guide/pictures/view_dialog_sso_tab.png b/guide/pictures/view_dialog_sso_tab.png
index 47b4eb9ce2..3497a868f7 100644
--- a/guide/pictures/view_dialog_sso_tab.png
+++ b/guide/pictures/view_dialog_sso_tab.png