diff --git a/src/Appendix.tex b/src/Appendix.tex index b02af59..706a834 100644 --- a/src/Appendix.tex +++ b/src/Appendix.tex @@ -15,3 +15,4 @@ For text and data not in the main text. % XXX Sample plates % FAQ +% Quick & dirty setup diff --git a/src/Dedication.tex b/src/Dedication.tex index 9fe4f8e..62dcb57 100644 --- a/src/Dedication.tex +++ b/src/Dedication.tex @@ -13,7 +13,7 @@ \thispagestyle{empty} \begin{vplace} \centering - \fontspec{lmroman12-regular.otf}\fontsize{12pt}{1em}\selectfont{Dedicated to libre users} + \fontspec{lmroman12-regular.otf}\fontsize{12pt}{1em}\selectfont{Dedicated to free users} \end{vplace} %%% END DEDICATION %%% diff --git a/src/Glossary.tex b/src/Glossary.tex index 58cb887..a92a8a7 100644 --- a/src/Glossary.tex +++ b/src/Glossary.tex @@ -198,4 +198,16 @@ % satellite % SIDLOC % SSA - +% SatNOGS DB +% CubeSat +% RamSat +% telemetry +% astrograph +% RASA +% Grafana +% Dashboard +% Python, C, Unix, etc ? +% CMOS +% CCD +% photon +% giza (pgplot?) diff --git a/src/Ground_Stations.tex b/src/Ground_Stations.tex index bda86c3..5c96842 100644 --- a/src/Ground_Stations.tex +++ b/src/Ground_Stations.tex @@ -12,8 +12,7 @@ \section{Overview of Ground Stations} \label{sec:overview-groundstations} \index{ground station} -\Glspl{ground-station}. -Ground stations are a setup of equipment such as computers, cameras, +\Glspl{ground-station} are a setup of equipment such as computers, cameras, \glspl{SDR}, antennas, and receivers, located on Earth, observing space. diff --git a/src/Identify.tex b/src/Identify.tex index a25c869..de5065c 100644 --- a/src/Identify.tex +++ b/src/Identify.tex @@ -21,7 +21,8 @@ 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} +The best tool for identifying satellites from \gls{FITS} files +is the \texttt{process.py} script from \texttt{stvid}, available here: * \url{https://github.com/cbassa/stvid} @@ -34,6 +35,7 @@ My fork is here: \section{Identifying Satellites with \texttt{satid}} The deprecated C application, \texttt{satid} from the \texttt{sattools} package can help identify satellites. +See figure XXX of output from my Giza port of \texttt{satid}. * \url{https://github.com/cbassa/sattools} @@ -42,6 +44,16 @@ 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} + \caption{\texttt{satid} example.} + \index{satid}\index{sattools} + \label{fig:satid-giza-3} + \end{center} +\end{figure} + \section{AstroImageJ} diff --git a/src/Introduction.tex b/src/Introduction.tex index 50836a9..f1f1755 100644 --- a/src/Introduction.tex +++ b/src/Introduction.tex @@ -9,11 +9,40 @@ % International Public License (CC BY-SA 4.0) by Jeff Moe. % -\section{Overview} -\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{Unofficial Guide Overview} +First, an overview of the this text, then the \gls{LSF}, +some of it's key projects, such as the \gls{SatNOGS} network. + +Chapters: + +% Perhaps more LaTeXy ref XXX +\begin{itemize} + \item Satellites --- What are we looking at? + \item Ground Stations --- How Earth talks to satellites and back. + \item SatNOGS Optical Process Overview --- The big picture of what + hardware and software is needed to set up an optical ground station + for use on the distributed network. + \item Hardware --- Details on appropriate hardware configurations, + and example setups. + \item Software --- A look at the myriad software related to satellites, + and what works best at present for SatNOGS Optical. + \item Acquire --- Convert photons to bits. Pointing a camera at the + sky works. + \item Solve --- Pictures of stars reveal the time and location of + the photo. Plate solvers reviewed. + \item Detect --- The plate solver says where the photo is, + now detect if are there moving tracks that aren't stars that could + be satellites. + \item Identify --- With time, location, satellite detection, \glspl{TLE} + are overlaid and compared with detected satellites. + Satellite identification by computers and humans. + \item Upload --- When ready, data will be pushed to the SatNOGS network. + \item Support --- Where development is occurring and questions answered! +\end{itemize} + \section{Libre Space Foundation} The \gls{LSF} supports @@ -29,6 +58,7 @@ The \gls{LSF} supports \end{figure} Select \gls{LSF} projects: +\index{UPSat} \begin{itemize} \item SatNOGS --- Global network of satellite ground stations \\ @@ -37,15 +67,8 @@ Select \gls{LSF} projects: \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} +\section{SatNOGS Network} SatNOGS is the \gls{LSF}'s global network of satellite ground stations. \begin{figure}[h!] @@ -55,3 +78,14 @@ SatNOGS is the \gls{LSF}'s global network of satellite ground stations. \index{SatNOGS} \end{figure} + +\section{Network Status} +The SatNOGS \gls{RF} network has been running successfully for years. +Adding an optical network is a new development. At present there +are zero nodes on the network. + +Some software already exists, +some is being ported from C to Python, and other parts remain to be done. +There is software available for acquiring optical data of satellites. +There is no facility at present for pushing data back to the network. + diff --git a/src/SNOUG.tex b/src/SNOUG.tex index ea67c97..703b3c1 100644 --- a/src/SNOUG.tex +++ b/src/SNOUG.tex @@ -334,13 +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{SatNOGS_Optical}{SatNOGS Optical}{Network of Optical Ground Stations for Satellites} +\chapterconf{SatNOGS_Optical}{SatNOGS Optical Process Overview}{Network of Optical Ground Stations for Satellites} \chapterconf{Hardware}{Hardware}{Design and Set Up Equipment} \chapterconf{Software}{Software}{Satellite Software} -\chapterconf{Acquire}{Acquire}{Pictures of the Sky} +\chapterconf{Acquire}{Acquire}{Twinkle, Twinkle, Little Starlink} \chapterconf{Solve}{Solve}{Place from Pixels} \chapterconf{Detect}{Detect}{Find Satellites} -\chapterconf{Identify}{Identify}{More Than Just Starlink and Old Rocket Bodies} +\chapterconf{Identify}{Identify}{More Than Just Old Rocket Bodies} \chapterconf{Upload}{Upload}{Send Data to the SatNOGS Network} \chapterconf{Support}{Support}{Help!} \chapterconf{Contact}{Contact}{Email, Chat, Forum} diff --git a/src/SatNOGS_Optical.tex b/src/SatNOGS_Optical.tex index 6a25941..510fb73 100644 --- a/src/SatNOGS_Optical.tex +++ b/src/SatNOGS_Optical.tex @@ -8,12 +8,15 @@ % This document is licensed under the Creative Commons Attribution 4.0 % International Public License (CC BY-SA 4.0) by Jeff Moe. % -\section{SatNOGS Optical} +\section{SatNOGS Optical HOWTO} SatNOGS Optical is the nascent distributed network of optical ground stations. +This chapter reviews what is needed in terms of hardware and +software to build an operating optical ground station. -\section{Process Overview} + +\section{Toolchain} SatNOGS Optical Process Overview.% \footnote{\url{https://spacecruft.org/spacecruft/SNOPO}} See figure \ref{fig:snopo}, page \pageref{fig:snopo}. diff --git a/src/Satellites.tex b/src/Satellites.tex index 6a98072..a8c48b0 100644 --- a/src/Satellites.tex +++ b/src/Satellites.tex @@ -15,3 +15,76 @@ \Glspl{artificial satellite} are rocks with modems. +\section{SatNOGS DB} +The SatNOGS DB is a database that lists satellites, +many of which can be tracked by network operators. + +\begin{figure}[h!] + \includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{satnogs-db-web.png} + \caption{SatNOGS DB website.} + \label{fig:satnogs-db-web} + \index{SatNOGS DB} +\end{figure} + +Individual satellites can be viewed, such as the RamSat CubeSat. +\index{RamSat}\index{CubeSat} + +% https://db.satnogs.org/satellite/YJWC-7364-7085-7563-0113 +\begin{figure}[h!] + \includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{satnogs-db-ramsat-web.png} + \caption{SatNOGS DB RamSat CubeSat web page.} + \label{fig:satnogs-db-ramsat-web} + \index{RamSat} +\end{figure} + + +For some satellites, telemetry is available in a Grafana dashboard. +See the RamSat telemetry dashboard. +\index{RamSat}\index{telemetry}\index{Grafana}\index{dashboard} + +% https://dashboard.satnogs.org/d/XZQTCYznz/ramsat?orgId=1&refresh=30s&var-suid=48850 +\begin{figure}[h!] + \includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{satnogs-telemetry-ramsat-web.png} + \caption{SatNOGS DB RamSat CubeSat telemetry web page.} + \label{fig:satnogs-telemetry-ramsat-web} + \index{RamSat} +\end{figure} + +\section{Libre Satellites} +Satellites in orbit, decayed, or designs on Earth that generally support the libre way. +Select libre satellites: + +\begin{itemize} + \item UPSat --- First libre open source hardware and software satellite in the world. + Created by the \gls{LSF}. \\ + \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} + +% https://network.satnogs.org/observations/?future=0&norad=48850&observer=&station=&start=&end=&transmitter_mode=&page=2 +\Gls{RF} Observations can be scheduled on the SatNOGS network. +See XXX for a sample list of observations of the RamSat CubeSat. + +\begin{figure}[h!] + \includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{satnogs-obs-list-ramsat-web.png} + \caption{List of observations of the RamSat CubeSat, example.} + \label{fig:satnogs-obs-list-ramsat-web} + \index{RamSat}\index{observation}\index{CubeSat} +\end{figure} + +Individual \gls{RF} observations are uploaded to the SatNOGS network, +as can be seen in the example observation of the RamSat by SatNOGS +ground station ``2380 - Piszkesteto UHF'' run by volunteer bcsak (username). + +\begin{figure}[h!] + \includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{satnogs-obs-6401760-web.png} + \caption{Sample observation of RamSat CubeSat on SatNOGS website.} + \label{fig:satnogs-obs-6401760-web} + \index{RamSat}\index{observation}\index{CubeSat} +\end{figure} diff --git a/src/figures/satid-giza-3.png b/src/figures/satid-giza-3.png new file mode 100644 index 0000000..98e37b3 Binary files /dev/null and b/src/figures/satid-giza-3.png differ diff --git a/src/figures/satnogs-db-ramsat-web.png b/src/figures/satnogs-db-ramsat-web.png new file mode 100644 index 0000000..66519ba Binary files /dev/null and b/src/figures/satnogs-db-ramsat-web.png differ diff --git a/src/figures/satnogs-db-web.png b/src/figures/satnogs-db-web.png new file mode 100644 index 0000000..765328b Binary files /dev/null and b/src/figures/satnogs-db-web.png differ diff --git a/src/figures/satnogs-obs-6401760-web.png b/src/figures/satnogs-obs-6401760-web.png new file mode 100644 index 0000000..9cc8b8f Binary files /dev/null and b/src/figures/satnogs-obs-6401760-web.png differ diff --git a/src/figures/satnogs-obs-list-ramsat-web.png b/src/figures/satnogs-obs-list-ramsat-web.png new file mode 100644 index 0000000..7603bda Binary files /dev/null and b/src/figures/satnogs-obs-list-ramsat-web.png differ diff --git a/src/figures/satnogs-telemetry-ramsat-web.png b/src/figures/satnogs-telemetry-ramsat-web.png new file mode 100644 index 0000000..60d3c84 Binary files /dev/null and b/src/figures/satnogs-telemetry-ramsat-web.png differ