Upload stub, web pics, touches

TODO.md

@@ -4,4 +4,5 @@
 * Color highlight blocks (e.g. Notice).
 * Lists/tables in boxes (?).
 * Better tables.
+* See also for acronyms, index, glossary.
 * Content.

src/Acquire.tex

@@ -15,7 +15,8 @@
 HOWTO run a \gls{SatNOGS-Optical} \gls{ground-station},
 after it has been set up and congfigured.
 
-\section{Acquire Data with \texttt{stvid}}
+\section{Setup with \texttt{stvid}}
+\label{sec:stvid-setup}
 \index{stvid}\index{acquire}
 Acquire data with \texttt{acquire.py} from \texttt{\gls{stvid}}.
 Enter \texttt{virtualenv}, if used:
@@ -63,8 +64,3 @@ cd stvid/
 	\index{stvid}\index{process}
 \end{figure}
 
-\section{Upload Data}
-\index{upload}
-Push.
-The \gls{SatNOGS} network isn't ready for optical data yet.
-

src/Appendix.tex

@@ -13,3 +13,5 @@
 \label{sec:appendix}
 For text and data not in the main text.
 
+% XXX Sample plates
+% FAQ

src/Detect.tex

@@ -1,4 +1,4 @@
-%
+
 % Detect.tex
 %
 % SatNOGS Optical Unofficial Guide
@@ -15,3 +15,22 @@
 
 Description of satellite detection processes.
 
+\section{stvid Detection with \texttt{process.py}}
+\index{stvid}\index{process.py}\index{Python}
+To detect satellite in a \gls{FITS} file using the stvid toolchain,
+the \texttt{process.py} or, if it exists, the \texttt{process\_new.py}
+Python script.
+
+\subsection{\texttt{process.py} Operation}
+\index{process.py}
+
+This assumes you have installed \texttt{stvid} as show in \ref{sec:stvid-setup}.
+Adjust dated directory to actual directory name.
+
+\begin{minted}{sh}
+cd stvid/
+# Maybe you need to update TLE
+./update_tle.py
+./process_new.py -c config_new.ini -d data/obs/20220825_1/020502/
+\end{minted}
+

src/Epigraph.tex

@@ -17,9 +17,9 @@
 	\hfill
 	{\epigraph
 	{\fontspec{lmroman12-italic.otf}\fontsize{12pt}{1em}\selectfont
-	{Free software, free space}}
+	{Space should be claimed the libre way.}}
 	{\fontspec{lmroman12-regular.otf}\fontsize{12pt}{1em}\selectfont
-	{Unknown}}
+	{Libre Space Foundation}}
 	}
 \end{vplace}
 

src/Foreward.tex

@@ -17,6 +17,6 @@ Perhaps, a book about pictures of satellites.
 \\
 A foreward stub.
 \hfill
-\emph{--- for sure}
+\emph{--- XXX }
 %%% END FOREWARD %%%
 

src/Glossary.tex

@@ -194,3 +194,8 @@
 			\footnote{\cite{Wiki22:matriprotowikipfreeencyc}}
 		}}
 
+% TO ADD
+% satellite
+% SIDLOC
+% SSA
+

src/Ground_Stations.tex

@@ -13,8 +13,11 @@
 \label{sec:overview-groundstations}
 \index{ground station}
 \Glspl{ground-station}.
+Ground stations are a setup of equipment such as computers, cameras,
+\glspl{SDR}, antennas, and receivers, located on Earth, observing space.
 
-\subsection{SatNOGS Ground Stations}
+
+\section{SatNOGS Ground Stations}
 \index{ground station}\index{Libre Space Foundation}
 The \gls{LSF} built the \gls{SatNOGS} network using distributed,
 volunteer-run, \gls{RF} \glspl{ground-station} using \glspl{SDR}, such as in
@@ -35,7 +38,8 @@ It shows a \gls{SatNOGS} \gls{ground-station} with \gls{VHF} (right) and \gls{UH
 	\end{center}
 \end{figure}
 
-\subsection{SatNOGS Optical Ground Stations}
+
+\section{SatNOGS Optical Ground Stations}
 \index{ground station}\index{Libre Space Foundation}
 The \gls{LSF} is developing \gls{SatNOGS-Optical} to add
 \glspl{optical-ground-station} to the distributed network.

src/Identify.tex

@@ -9,13 +9,46 @@
 % International Public License (CC BY-SA 4.0) by Jeff Moe.
 %
 
-\section{Overview of Analysis}
-\label{sec:overview-analysis}
-\index{analysis}\index{AstroImageJ}\index{FITS}
+\section{Overview of Satellite Identification}
+\label{sec:overview-identify}
+\index{identification}
+\index{SIDLOC}
+The \gls{LSF} is developing a project called SIDLOC,
+for satellite identification and localization. With the
+addition of many more satellites in orbit there is a growing need
+for SSA.
+
+
+\section{\texttt{stvid}'s \texttt{process.py} for Identification}
+\label{sec:process-identify}
+The best tool for identifying satellites is the \texttt{process.py}
+script from \texttt{stvid}, available here:
+
+* \url{https://github.com/cbassa/stvid}
+
+My fork is here:
+
+* \url{https://spacecruft.org/spacecruft/stvid}
+
+
+\section{Identifying Satellites with \texttt{satid}}
+The deprecated C application, \texttt{satid} from the \texttt{sattools}
+package can help identify satellites.
+
+
+* \url{https://github.com/cbassa/sattools}
+
+My fork is here:
+
+* \url{https://spacecruft.org/spacecruft/sattools}
+
+
+\section{AstroImageJ}
+
+\index{identify}\index{AstroImageJ}\index{FITS}
 Analyze data with applications, such as \gls{AstroImageJ}.
 
-
-FITS files are commonly used  in astronomy.%
+\gls{FITS} files are commonly used  in astronomy.%
 \footnote{\cite{Wiki22:fitswikipfreeencyc}}
 \gls{AstroImageJ} can read \gls{FITS} format files.
 See

src/Introduction.tex

@@ -13,11 +13,49 @@
 \index{Libre Space Foundation}
 The SatNOGS Optical Unofficial Guide documents how to set up and run an
 \gls{optical-ground-station} for the \gls{LSF}'s \gls{SatNOGS} network.
+
+
+\section{Libre Space Foundation}
 The \gls{LSF} supports
 ``free and accessible space for all, creating \gls{open-source} space technologies.''%
 \footnote{\url{https://libre.space}}
 \index{Open Source}
 
+\begin{figure}[h!]
+	\includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{lsf-web.png}
+	\caption{Libre Space Foundation Website.}
+	\label{fig:lsf-web}
+	\index{Libre Space Foundation}
+\end{figure}
+
+Select \gls{LSF} projects:
+
+\begin{itemize}
+  \item SatNOGS --- Global network of satellite ground stations \\
+    \url{https://satnogs.org}
+  \item UPSat --- First open source hardware and software satellite in the world \\
+    \url{https://upsat.gr/}
+\end{itemize}
+
+\begin{figure}[h!]
+	\includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{upsat-web.png}
+	\caption{UPSat Website.}
+	\label{fig:upsat-web}
+	\index{UPSat}
+\end{figure}
+
+
+\section{SatNOGS}
+SatNOGS is the \gls{LSF}'s global network of satellite ground stations.
+
+\begin{figure}[h!]
+	\includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{satnogs-web.png}
+	\caption{SatNOGS Website.}
+	\label{fig:satnogs-web}
+	\index{SatNOGS}
+\end{figure}
+
+
 \section{Process Overview}
 SatNOGS Optical Process Overview.%
 \footnote{\url{https://spacecruft.org/spacecruft/SNOPO}}

src/SNOUG.tex

@@ -214,13 +214,13 @@ leftmargin=1cm,rightmargin=1cm
 \frontmatter
 
 %%% HALF TITLE PAGE %%%
-% We want the half title to be on the right hand (recto) page. XXX
-% Needs blank verso page. XXX
+% We want the half title to be on the recto (right/odd) page.
+% Needs blank verso (left/even) page. XXX ?
 \include{Half_Title}
 %%% END HALF TITLE PAGE
 
 %%% FRONTISPIECE PAGE %%%
-% We want the frontispiece to be on the left hand (verso) page. XXX
+% We want the frontispiece to be on the verso (left/even) page. XXX
 \include{Frontispiece}
 %%% END FRONTISPIECE PAGE
 
@@ -228,7 +228,7 @@ leftmargin=1cm,rightmargin=1cm
 \pagenumbering{roman}
 
 %%% TITLE PAGE %%%
-% We want the title to be on the right hand (recto) page. XXX
+% We want the title to be on the recto (right/odd) page. XXX
 % If we pad a page, it gives us two with openright
 \include{Title}
 %%% END TITLE PAGE
@@ -334,12 +334,13 @@ leftmargin=1cm,rightmargin=1cm
 % Comment out a line to not render that chapter
 \chapterconf{Satellites}{Satellites}{Artificial Satellites in Space}
 \chapterconf{Ground_Stations}{Ground Stations}{Looking up from Earth}
-\chapterconf{Software}{Software}{Satellite Software}
 \chapterconf{Hardware}{Hardware}{Design and Set Up Equipment}
+\chapterconf{Software}{Software}{Satellite Software}
 \chapterconf{Acquire}{Acquire}{Pictures of the Sky}
 \chapterconf{Solve}{Solve}{Place from Pixels}
 \chapterconf{Detect}{Detect}{Find Satellites}
 \chapterconf{Identify}{Identify}{More Than Just Starlink and Old Rocket Bodies}
+\chapterconf{Upload}{Upload}{Send Data to the SatNOGS Network}
 \chapterconf{Support}{Support}{Help!}
 \chapterconf{Contact}{Contact}{Email, Chat, Forum}
 %% END MAINMATTER CHAPTERS %%%

src/Upload.tex

@@ -0,0 +1,16 @@
+%
+% Upload.tex
+%
+% SatNOGS Optical Unofficial Guide
+%
+% Copyright (C) 2022, Jeff Moe
+%
+% This document is licensed under the Creative Commons Attribution 4.0
+% International Public License (CC BY-SA 4.0) by Jeff Moe.
+%
+
+\section{Upload Data}
+\index{upload}
+Push.
+The \gls{SatNOGS} network isn't ready for optical data yet.
+