diff --git a/TODO.md b/TODO.md index 460f4bf..c1ea322 100644 --- a/TODO.md +++ b/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. diff --git a/src/Acquire.tex b/src/Acquire.tex index 415bdf2..13177e5 100644 --- a/src/Acquire.tex +++ b/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. - diff --git a/src/Appendix.tex b/src/Appendix.tex index 160c5b4..b02af59 100644 --- a/src/Appendix.tex +++ b/src/Appendix.tex @@ -13,3 +13,5 @@ \label{sec:appendix} For text and data not in the main text. +% XXX Sample plates +% FAQ diff --git a/src/Detect.tex b/src/Detect.tex index bc025ae..0bfa873 100644 --- a/src/Detect.tex +++ b/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} + diff --git a/src/Epigraph.tex b/src/Epigraph.tex index bf6b618..02c0ac1 100644 --- a/src/Epigraph.tex +++ b/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} diff --git a/src/Foreward.tex b/src/Foreward.tex index e3245b9..2c86729 100644 --- a/src/Foreward.tex +++ b/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 %%% diff --git a/src/Glossary.tex b/src/Glossary.tex index 2279513..58cb887 100644 --- a/src/Glossary.tex +++ b/src/Glossary.tex @@ -194,3 +194,8 @@ \footnote{\cite{Wiki22:matriprotowikipfreeencyc}} }} +% TO ADD +% satellite +% SIDLOC +% SSA + diff --git a/src/Ground_Stations.tex b/src/Ground_Stations.tex index 07bd53f..bda86c3 100644 --- a/src/Ground_Stations.tex +++ b/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. diff --git a/src/Identify.tex b/src/Identify.tex index cb27aa4..a25c869 100644 --- a/src/Identify.tex +++ b/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 diff --git a/src/Introduction.tex b/src/Introduction.tex index e993e74..3cf9cd5 100644 --- a/src/Introduction.tex +++ b/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}} diff --git a/src/SNOUG.tex b/src/SNOUG.tex index 3942273..f49f77c 100644 --- a/src/SNOUG.tex +++ b/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 %%% diff --git a/src/Upload.tex b/src/Upload.tex new file mode 100644 index 0000000..b25cefe --- /dev/null +++ b/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. + diff --git a/src/figures/lsf-web.png b/src/figures/lsf-web.png new file mode 100644 index 0000000..2f26748 Binary files /dev/null and b/src/figures/lsf-web.png differ diff --git a/src/figures/satnogs-web.png b/src/figures/satnogs-web.png new file mode 100644 index 0000000..d171a5f Binary files /dev/null and b/src/figures/satnogs-web.png differ diff --git a/src/figures/upsat-web.png b/src/figures/upsat-web.png new file mode 100644 index 0000000..158aae7 Binary files /dev/null and b/src/figures/upsat-web.png differ