spacecruft
/
SNOUG
1
0
Fork 1
Code Packages Releases 14 Activity

Add to index

glossary
Jeff Moe 2022-08-27 17:01:04 -06:00
parent fc829b5988
commit ca37b6b6d0
9 changed files with 73 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@ -1,4 +1,4 @@
# SNOUG
# SatNOGS Optical Unofficial Guide
SatNOGS Optical Unofficial Guide

4
src/Analysis.tex
View File

@ -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}

7
src/Ground_Stations.tex
View File

@ -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}

63
src/Hardware.tex
View File

@ -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}

11
src/Introduction.tex
View File

@ -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 /*}.

8
src/Operation.tex
View File

@ -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.

1
src/Satellites.tex
View File

@ -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.}

11
src/Setup.tex
View File

@ -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

1
src/Support.tex
View File

@ -14,6 +14,7 @@
\index{community}
\index{support}
\index{forum}
\index{Matrix}
\setlength{\parindent}{0pt}
How to get help.