diff --git a/README.md b/README.md index ef70407..abe4232 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# SNOUG +# SatNOGS Optical Unofficial Guide SatNOGS Optical Unofficial Guide diff --git a/src/Analysis.tex b/src/Analysis.tex index de2f4db..900de39 100644 --- a/src/Analysis.tex +++ b/src/Analysis.tex @@ -12,18 +12,20 @@ \section{Overview of Analysis} \label{sec:overview-analysis} Analyze data with applications, such as AstroImageJ. +\index{analysis}\index{AstroImageJ}\index{FITS} AstroImageJ can read FITS format files. See \ref{fig:astroimagej}, page \pageref{fig:astroimagej}, for a screenshot displaying a FITS file generated by \texttt{stvid}. +\index{stvid} \begin{figure}[h!] \begin{center} \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{astroimagej.png} \caption{AstroImageJ screenshot viewing FITS file.} + \index{AstroImageJ}\index{FITS} \label{fig:astroimagej} \end{center} \end{figure} - diff --git a/src/Ground_Stations.tex b/src/Ground_Stations.tex index 5499fd3..836e9e1 100644 --- a/src/Ground_Stations.tex +++ b/src/Ground_Stations.tex @@ -11,31 +11,37 @@ \section{Overview of Ground Stations} \label{sec:overview-groundstations} +\index{ground stations} Ground Stations. \subsection{SatNOGS Ground Stations} +\index{ground stations}\index{Libre Space Foundation} The Libre Space Foundation built the SatNOGS network using distributed, volunteer-run, radio frequency ground stations, such as in figure \ref{fig:spacecruft-rotator}, page \pageref{fig:spacecruft-rotator}.% \footnote{\scriptsize{\url{https://spacecruft.org/assets/i/spacecruft-rotator.png}}} It shows a SatNOGS ground station with VHF (right) and UHF (left) antennas on a mast with Alt/Az rotator. +\index{radio}\index{RF}\index{VHF}\index{UHF}\index{rotator}\index{antenna} \begin{figure}[h!] \begin{center} \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{spacecruft-rotator.png} \caption{SatNOGS ground station with antennas.} \label{fig:spacecruft-rotator} + \index{radio}\index{RF}\index{rotator}\index{antenna} \end{center} \end{figure} \subsection{SatNOGS Optical Ground Stations} +\index{ground stations}\index{Libre Space Foundation} The Libre Space Foundation is developing a system to add optical ground stations to the distributed network. Prototype optical ground stations are being developed. An example setup, using a Skywatcher EQ6-R Pro telescope tripod and tracking mount, +\index{Skywatcher}\index{telescope}\index{tripod}\index{mount}\index{enclosure} can be seen in Figure \ref{fig:video-enclosure-mount-tripod}, page \pageref{fig:video-enclosure-mount-tripod}. @@ -44,6 +50,7 @@ can be seen in Figure \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{video-enclosure-mount-tripod-web.png} \caption{SatNOGS Optical ground station prototype.} \label{fig:video-enclosure-mount-tripod} + \index{telescope}\index{tripod}\index{mount}\index{enclosure} \end{center} \end{figure} diff --git a/src/Hardware.tex b/src/Hardware.tex index 76ef43c..40d384b 100644 --- a/src/Hardware.tex +++ b/src/Hardware.tex @@ -11,25 +11,26 @@ \section{Overview of Hardware} \label{sec:hardware-overview} +\index{hardware} Hardware considerations for a SatNOGS Optical Ground Station. Main hardware components in an optical ground station: \begin{itemize} - \item Lens. - \item Camera. - \item Computer. + \item Lens. \index{lens} + \item Camera. \index{camera} + \item Computer. \index{computer} \end{itemize} Other components: \begin{itemize} - \item Ethernet cable. - \item USB cable. - \item Enclosure - \item Power supply. - \item Tripod. - \item Manual or tracking mount. + \item Ethernet cable. \index{ethernet} + \item USB cable. \index{USB} + \item Enclosure. \index{enclosure} + \item Power supply. \index{power supply} + \item Tripod. \index{tripod} + \item Manual or tracking mount. \index{mount} \item Power source, grid or alternative. \item Internet, wifi or ethernet. \end{itemize} @@ -41,9 +42,9 @@ Other components: Cameras being tested: \begin{itemize} - \item The Imaging Source IMX174 based. - \item ZWO ASI IMC174 based mono. - \item DSLR. + \item The Imaging Source IMX174 based. \index{The Imaging Source}\index{IMX174} + \item ZWO ASI IMX174 based mono. \index{ZWO ASI} + \item DSLR. \index{DSLR} \end{itemize} @@ -51,30 +52,34 @@ Cameras being tested: \parbox{\linewidth}{ \textcolor{red}{NOTICE:} \\ ZWO/ASI cameras require proprietary non-libre software on host computer. + \index{proprietary} } } \section{Lenses} \label{sec:hardware-lenses} +\index{lens} Lenses being tested: \begin{itemize} - \item Kowa 50mm f1.4 C-mount. - \item Canon EF 50mm f1.2 USM. + \item Kowa 50mm f1.4 C-mount. \index{Kowa} + \item Canon EF 50mm f1.2 USM. \index{Canon} \end{itemize} \section{Embedded Computer} \label{sec:hardware-computer} +\index{hardware}\index{computer} Computers, such as Raspberry Pi, that can be used. +\index{Raspberry Pi} \begin{itemize} - \item Odroid N2 --- Confirmed working. + \item Odroid N2 --- Confirmed working. \index{Odroid} \item Odroid M1 --- Testing. \item Raspberry Pi 3 --- ? \item Raspberry Pi 4 --- ? - \item Intel NUC --- ? + \item Intel NUC --- ? \index{Intel} \end{itemize} \subsection{Comparison} @@ -105,17 +110,19 @@ A close up of the setup can be seen at showing the Skywatcher telescope tracking mount, a Bosch PoE camera enclosure, and through the glass the camera lens. +\index{Skywatcher}\index{telescope}\index{mount}\index{Bosch}\index{PoE}\index{camera} In the background is a white antenna for GNSS (GPS) and a solar power setup. +\index{GNSS} \begin{figure}[h!] \begin{center} \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{video-enclosure-mount-web.png} \caption{SatNOGS Optical ground station prototype.} \label{fig:video-enclosure-mount} + \index{telescope}\index{mount}\index{camera} \end{center} \end{figure} - The camera lens is protected by the enclosure glass, which is IP67 (XXX) rated. See a close up of the front of the enclosure and camera lens in figure \ref{fig:video-enclosure-front}, page \pageref{fig:video-enclosure-front}. @@ -125,6 +132,7 @@ See a close up of the front of the enclosure and camera lens in figure \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{video-enclosure-front-web.png} \caption{Camera enclosure, front side, showing glass and lens.} \label{fig:video-enclosure-front} + \index{enclosure}\index{camera} \end{center} \end{figure} @@ -138,6 +146,7 @@ The bottom white component is part of the telescope mount. \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{video-enclosure-left-web.png} \caption{Camera enclosure, left side, showing hinge.} \label{fig:video-enclosure-left} + \index{enclosure}\index{camera} \end{center} \end{figure} @@ -152,6 +161,7 @@ These are unscrewed with a hex head tool (supplied) to open the enclosure. \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{video-enclosure-right-web.png} \caption{Camera enclosure, right side.} \label{fig:video-enclosure-right} + \index{enclosure}\index{camera} \end{center} \end{figure} @@ -163,6 +173,7 @@ The enclosure is opened from the right side, as shown in figure \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{video-enclosure-right-open-web.png} \caption{Camera enclosure, right side, opened.} \label{fig:video-enclosure-right-open} + \index{enclosure}\index{camera} \end{center} \end{figure} @@ -171,18 +182,18 @@ Inside the camera enclosure, as shown in Figure is: \begin{itemize} - \item The Imaging Source DMX camera with Sony IMX174 CMOS. - \item Kowa 50mm f1.4 C-mount lens. - \item Odroid N2 running Debian. + \item The Imaging Source DMX camera with Sony IMX174 CMOS. \index{The Imaging Source}\index{IMX174} + \item Kowa 50mm f1.4 C-mount lens.\index{Kowa} + \item Odroid N2 running Debian. \index{Odroid}\index{Debian} \item Odroid N2 plastic enclosure, large half, hole drilled for ad-hoc mounting. - \item Blower fan on top, with power cable (came with Bosch enclosure). + \item Blower fan on top, with power cable (came with Bosch enclosure). \index{fan} \item Fan, maybe not so useful, with power cable (came with Bosch enclosure). - \item Camera mounting plate (came with Bosch enclosure). + \item Camera mounting plate (came with Bosch enclosure). \index{camera} \item Camera mounting screws, M6x25 (?). - \item Ethernet cable, internal, short white (came with Bosch enclosure). - \item PoE ethernet cable, external, plugged into PoE switch for data and power. + \item Ethernet cable, internal, short white (came with Bosch enclosure). \index{ethernet} + \item PoE ethernet cable, external, plugged into PoE switch for data and power. \index{PoE} \item USB 3 cable, internal, way too long, needs replacing, from Odroid to camera. XXX flat connector - \item USB 3 cable, external, from Odroid to telescope mount. XXX large rectangle connector + \item USB 3 cable, external, from Odroid to telescope mount. XXX large rectangle connector \index{USB} \item ``Custom'' 12V DC power cable from Bosch PoE to Odroid. \item Assorted nuts, bolts, and washers for an ad-hoc standoff height. \end{itemize} @@ -191,6 +202,7 @@ is: \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{video-enclosure-top-open-web.png} \caption{Camera enclosure, opened.} \label{fig:video-enclosure-top-open} + \index{enclosure}\index{camera} \end{center} \end{figure} @@ -202,6 +214,7 @@ See figure \ref{fig:video-enclosure-top}, page \pageref{fig:video-enclosure-top} \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{video-enclosure-top-web.png} \caption{Camera enclosure, top.} \label{fig:video-enclosure-top} + \index{enclosure}\index{camera} \end{center} \end{figure} diff --git a/src/Introduction.tex b/src/Introduction.tex index 38be9c2..905576b 100644 --- a/src/Introduction.tex +++ b/src/Introduction.tex @@ -10,15 +10,13 @@ % \section{Introduction} +\index{Libre Space Foundation} The SatNOGS Optical Unofficial Guide documents how to set up and run an optical ground station for the Libre Space Foundation's SatNOGS network. The Libre Space Foundation supports ``free and accessible space for all, creating Open Source space technologies.''% \footnote{\scriptsize{\url{https://libre.space}}} - -More rocks in space.% -\footnote{\scriptsize{\url{https://starlink.com}}} - +\index{Open Source} \section{Process Overview} SatNOGS Optical Process Overview.% @@ -29,9 +27,6 @@ See figure \ref{fig:snopo}, page \pageref{fig:snopo}. \includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{SNOPO.png} \caption{SatNOGS Optical Process Overview} \label{fig:snopo} + \index{process} \end{figure} - -Run \texttt{acquire.py}, then \texttt{process\_new.py}. -But don't run \textcolor{red}{rm -rf /*}. - diff --git a/src/Operation.tex b/src/Operation.tex index 139a4ec..febe017 100644 --- a/src/Operation.tex +++ b/src/Operation.tex @@ -11,11 +11,13 @@ \section{Overview of Operation} \label{sec:overview-operation} +\index{operation} HOWTO run a SatNOGS Optical ground station, after it has been set up and congfigured. \section{Acquire Data with \texttt{stvid}} +\index{stvid}\index{acquire} Acquire data with \texttt{acquire.py} from \texttt{stvid}. Enter \texttt{virtualenv}, if used: @@ -25,6 +27,7 @@ source env/bin/activate \end{minted} Get the latest TLEs: +\index{TLE} \begin{minted}{sh} ./update_tle.py @@ -32,6 +35,7 @@ Get the latest TLEs: Acquire live data from camera. +\index{camera} \begin{minted}{sh} cd stvid/ @@ -43,10 +47,12 @@ cd stvid/ \includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{stvid-acquire-0.png} \caption{Satellite images acquired by stvid.} \label{fig:stvid-acquire} + \index{stvid}\index{acquire} \end{figure} \section{Process Data} +\index{stvid}\index{process} Process data with using stvid. Adjust dated directory to actual directory name. \begin{minted}{sh} @@ -59,10 +65,12 @@ cd stvid/ \includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{stvid-process-0.png} \caption{Satellite images processed by stvid.} \label{fig:stvid-process} + \index{stvid}\index{process} \end{figure} \section{Upload Data} +\index{upload} Push. The SatNOGS network isn't ready for optical data yet. diff --git a/src/Satellites.tex b/src/Satellites.tex index 2c0c18d..bb52a4a 100644 --- a/src/Satellites.tex +++ b/src/Satellites.tex @@ -11,6 +11,7 @@ \section{Overview of Satellites} \label{sec:overview-satellites} +\index{satellites} Artificial satellites are rocks with modems. \glossary{Artificial satellite}{Satellite launched by teh hoomans.} diff --git a/src/Setup.tex b/src/Setup.tex index fbf1155..faaaf0e 100644 --- a/src/Setup.tex +++ b/src/Setup.tex @@ -11,10 +11,12 @@ \section{Setup Optical Ground Station Software} \label{sec:overview-setup} +\index{software} HOWTO set up and configure a SatNOGS Optical ground station. Setup an embedded computer, such as an Odroid N2, with Debian stable (11/Bullseye) or testing (Bookworm). +\index{computer}\index{Odroid}\index{Debian} See each repository for latest documentation. @@ -31,6 +33,7 @@ sudo apt install python3-virtualenv python3-pip python3-dev \ \end{minted} Next, install the \texttt{hough3d-code} dependency. +\index{hough3d} \begin{minted}{sh} git clone https://gitlab.com/pierros/hough3d-code @@ -40,6 +43,7 @@ sudo cp -p hough3dlines /usr/local/bin/hough3dlines \end{minted} Install \texttt{satpredict} from using either the cbassa or spacecruft repo. +\index{satpredict} \begin{minted}{sh} cd ../ @@ -54,6 +58,7 @@ sudo make install Now install \texttt{stvid}, the main acquisition and processing application. It is written in Python. Either use the spacecruft \texttt{git} repository or the cbassa one. +\index{stvid} \begin{minted}{sh} cd ../ @@ -63,6 +68,7 @@ git clone https://spacecruft.org/spacecruft/stvid \end{minted} Optionally, set up a Python virtual environment: +\index{Python} \begin{minted}{sh} cd stvid @@ -78,6 +84,7 @@ install fails. pip install --upgrade numpy pip install --upgrade -r requirements.txt \end{minted} +\index{numpy} If the system \texttt{python3-numpy} conflicts, you could try installing numpy in the virtualenv thusly: @@ -89,6 +96,7 @@ pip install --upgrade --ignore-installed numpy Debian in bug \texttt{\#941466} changed the name of the \texttt{sextractor} dependency to \texttt{source-extractor}, so a symlink is needed for now: +\index{Debian} \begin{minted}{sh} sudo ln -s /usr/bin/source-extractor /usr/local/bin/sextractor @@ -106,6 +114,7 @@ cp -p configuration.ini-dist configuration.ini # Set: vi configuration.ini \end{minted} +\index{stvid}\index{configuration.ini} Edit various \texttt{configuration.ini} fields: \begin{minted}{sh} @@ -142,10 +151,12 @@ export ST_TLEDIR=$HOME/TLE export ST_OBSDIR=$HOME/satobs export ST_LOGIN="identity=foo@no:pass" \end{minted} +\index{sattools} Set \texttt{astrometry.net} to run in parallel, assuming you have enough RAM: (This doesn't appear to work? Breaks?). +\index{astrometry} \begin{minted}{sh} sudo vim /etc/astrometry.cfg diff --git a/src/Support.tex b/src/Support.tex index 810f038..f5d9a11 100644 --- a/src/Support.tex +++ b/src/Support.tex @@ -14,6 +14,7 @@ \index{community} \index{support} \index{forum} +\index{Matrix} \setlength{\parindent}{0pt} How to get help.