Add to index
parent
fc829b5988
commit
ca37b6b6d0
|
@ -1,4 +1,4 @@
|
|||
# SNOUG
|
||||
# SatNOGS Optical Unofficial Guide
|
||||
|
||||
SatNOGS Optical Unofficial Guide
|
||||
|
||||
|
|
|
@ -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}
|
||||
|
||||
|
||||
|
|
|
@ -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}
|
||||
|
||||
|
|
|
@ -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}
|
||||
|
||||
|
|
|
@ -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 /*}.
|
||||
|
||||
|
|
|
@ -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.
|
||||
|
||||
|
|
|
@ -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,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
|
||||
|
|
|
@ -14,6 +14,7 @@
|
|||
\index{community}
|
||||
\index{support}
|
||||
\index{forum}
|
||||
\index{Matrix}
|
||||
\setlength{\parindent}{0pt}
|
||||
How to get help.
|
||||
|
||||
|
|
Loading…
Reference in New Issue