Add skymap docs

src/Identify.tex

@@ -49,7 +49,6 @@ My fork is here:
 
 * \url{https://spacecruft.org/spacecruft/sattools}
 
-% https://spacecruft.org/spacecruft/sattools/media/branch/spacecruft/img/satid-giza-3.png
 \begin{figure}[h!]
 	\begin{center}
 		\includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{satid-giza-3.png}

src/Software.tex

@@ -182,5 +182,95 @@ inparallel
 
 
 \section{skymap}
-Use \gls{skymap} for viewing \gls{satellite} \gls{orbit} predictions.
+Use \gls{skymap} for viewing \gls{satellite} \glspl{orbit} tracks
+projected on a map of of the sky. Skymap is part of \gls{sattools}.
 
+Source:
+
+* \url{https://github.com/cbassa/sattools}
+
+My fork:
+
+* \url{https://spacecruft.org/spacecruft/sattools}
+
+\begin{figure}[h!]
+        \begin{center}
+                \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{skymap-giza-21.png}
+                \caption{\texttt{skymap} example screenshot.}
+                \index{skymap}\index{sattools}
+                \label{fig:skymap-giza-21}
+        \end{center}
+\end{figure}
+
+\fbox{
+        \parbox{\linewidth}{
+                \textcolor{red}{NOTICE:} \\
+                The main upstream sattools package requires non-\gls{libre} pgplot on host computer.
+                \index{proprietary}
+        }
+}
+
+Described below is how to build and install my fork of \gls{sattools} to use
+\gls{skymap} instead of upstream. Upstream requires non-libre software which
+also happens to be very difficult for most users to compile.
+
+\begin{minted}{sh}
+sudo apt install giza-dev git make dos2unix source-extractor wcslib-dev \
+     libgsl-dev gfortran libpng-dev libx11-dev libjpeg-dev libexif-dev
+
+git clone https://spacecruft.org/spacecruft/sattools
+
+cd sattools/
+
+make
+
+sudo make install
+
+# To clean
+make clean
+
+# To rebuild
+make clean
+make
+
+# To uninstall
+sudo make uninstall
+\end{minted}
+
+See below for \gls{skymap} usage:
+
+\begin{minted}{sh}
+cd bin/
+./tleupdate
+
+# set config in ~/.bashrc XXX
+
+./skymap --help
+Usage: skymap [OPTION]
+Visualize satellites on a map of the sky.
+
+-t, --time    Date/time (yyyy-mm-ddThh:mm:ss.sss) [default: now]
+-c, --catalog    TLE catalog file [default: satnogs.tle]
+-i, --id    Satellite ID (NORAD) [default: all]
+-R, --ra    R.A. [hh:mm:ss.sss]
+-D, --decl    Decl. [+dd:mm:ss.ss]
+-A, --azimuth    Azimuth (deg)
+-E, --elevation    Elevation (deg)
+-w, --width    Screen width (default: 1024). Set height too.
+-g, --height    Screen height (default: 768). Set width too.
+-n, --nmax    nmax line resolution/speed (default 128)
+-S, --all-night    All night
+-Q, --no-stars    No stars
+-a, --all-objects    Show all objects from catalog (default: LEO)
+-h, --help    This help
+-s, --site    Site (COSPAR)
+-d, --iod    IOD observations
+-l, --length    Trail length [default: 60s]
+-P, --planar-id    planar search satellite ID
+-r, --planar-alt    planar search altitude
+-V, --visibility-alt    altitude for visibility contours
+-p, --positions-file    File with xyz positions
+-L, --longitude    manual site longitude (deg)
+-B, --latitude    manual site latitude (deg)
+-H, --elevation    manual site elevation (m)
+\end{minted}