From da4124511fe9f40a8446a19c36078fac731f20e5 Mon Sep 17 00:00:00 2001 From: Jeff Moe Date: Fri, 26 Aug 2022 22:30:31 -0600 Subject: [PATCH] stvid setup, configuration code --- src/Operation.tex | 48 +------------- src/SNOUG.tex | 1 + src/Setup.tex | 155 ++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 158 insertions(+), 46 deletions(-) create mode 100644 src/Setup.tex diff --git a/src/Operation.tex b/src/Operation.tex index 2f2e199..4d2cef4 100644 --- a/src/Operation.tex +++ b/src/Operation.tex @@ -11,52 +11,8 @@ \section{Overview of Operation} \label{sec:overview-operation} -HOWTO run a SatNOGS Optical ground station. - - -\section{Setup Optical Ground Station} -Setup embedded computer, such as an Odroid N2, with Debian stable -(11/Bullseye) or testing (Bookworm). - -See each repository for latest documentation. - -Install dependencies from Debian repository: - -\begin{minted}{sh} -sudo apt update -sudo apt install python3-virtualenv python3-pip python3-dev \ - source-extractor astrometry.net \ - libeigen3-dev giza-dev libx11-dev \ - astrometry-data-tycho2 astrometry-data-tycho2-07 \ - astrometry-data-tycho2-08 astrometry-data-tycho2-09 \ - astrometry-data-tycho2-10-19 -\end{minted} - -Next, install the hough3d-code dependency. - -\begin{minted}{sh} -git clone https://gitlab.com/pierros/hough3d-code -cd hough3d-code -make all -sudo cp -p hough3dlines /usr/local/bin/hough3dlines -\end{minted} - -Install `satpredict` from using either the cbassa or spacecruft repo. - -\begin{minted}{sh} -cd ../ -git clone https://spacecruft.org/spacecruft/satpredict -# Or -#git clone https://github.com/cbassa/satpredict -cd satpredict/ -make -sudo make install -\end{minted} - - - -\section{Configure} -Configure the machine. +HOWTO run a SatNOGS Optical ground station, +after it has been set up and congfigured. \section{Acquire Data} diff --git a/src/SNOUG.tex b/src/SNOUG.tex index 58aca87..b3aa31b 100644 --- a/src/SNOUG.tex +++ b/src/SNOUG.tex @@ -280,6 +280,7 @@ leftmargin=1cm,rightmargin=1cm \chapterconf{Satellites}{Satellites}{Artificial Satellites} \chapterconf{Ground_Stations}{Ground Stations}{Earth Ground Stations} \chapterconf{Hardware}{Hardware}{Design and Set Up an Optical Ground Station} +\chapterconf{Setup}{Setup}{Set up and Configure Software} \chapterconf{Operation}{Operation}{HOWTO Operate a Station} \chapterconf{Analysis}{Analysis}{More Than Just Starlink and Old Rocket Bodies} \chapterconf{Support}{Support}{Help!} diff --git a/src/Setup.tex b/src/Setup.tex new file mode 100644 index 0000000..52320f5 --- /dev/null +++ b/src/Setup.tex @@ -0,0 +1,155 @@ +% +% Setup +% +% 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{Setup Optical Ground Station Software} +\label{sec:overview-setup} +HOWTO set up and confiugre a SatNOGS Optical ground station. + +Setup embedded computer, such as an Odroid N2, with Debian stable +(11/Bullseye) or testing (Bookworm). + +See each repository for latest documentation. + +Install dependencies from Debian repository: + +\begin{minted}{sh} +sudo apt update +sudo apt install python3-virtualenv python3-pip python3-dev \ + source-extractor astrometry.net \ + libeigen3-dev giza-dev libx11-dev \ + astrometry-data-tycho2 astrometry-data-tycho2-07 \ + astrometry-data-tycho2-08 astrometry-data-tycho2-09 \ + astrometry-data-tycho2-10-19 +\end{minted} + +Next, install the \texttt{hough3d-code} dependency. + +\begin{minted}{sh} +git clone https://gitlab.com/pierros/hough3d-code +cd hough3d-code +make all +sudo cp -p hough3dlines /usr/local/bin/hough3dlines +\end{minted} + +Install \texttt{satpredict} from using either the cbassa or spacecruft repo. + +\begin{minted}{sh} +cd ../ +git clone https://spacecruft.org/spacecruft/satpredict +# Or +#git clone https://github.com/cbassa/satpredict +cd satpredict/ +make +sudo make install +\end{minted} + +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. + +\begin{minted}{sh} +cd ../ +git clone https://spacecruft.org/spacecruft/stvid +# Or use upstream: +#git clone https://github.com/cbassa/stvid +\end{minted} + +Optionally, set up a Python virtual environment: + +\begin{minted}{sh} +cd stvid +virtualenv -p python3 env +source env/bin/activate +pip install --upgrade pip +\end{minted} + +Install dependencies. Numpy needs to be installed first, or the +install fails. + +\begin{minted}{sh} +pip install --upgrade numpy +pip install --upgrade -r requirements.txt +\end{minted} + +If the system \texttt{python3-numpy} conflicts, you could try installing +numpy in the virtualenv thusly: + +\begin{minted}{sh} +pip install --upgrade --ignore-installed numpy +\end{minted} + +Debian in bug \texttt{\#941466} changed the name of the +\texttt{sextractor} dependency to \texttt{source-extractor}, +so a symlink is needed for now: + +\begin{minted}{sh} +sudo ln -s /usr/bin/source-extractor /usr/local/bin/sextractor +\end{minted} + + +\section{Configure} +Configure the embedded computer. + +\begin{minted}{sh} +cd stvid/ +cp -p configuration.ini-dist configuration.ini +# Edit +# Note for fields st-username and st-password, *don't* use quotes. +# Set: +vi configuration.ini +\end{minted} + +Edit various \texttt{configuration.ini} fields: +\begin{minted}{sh} +# For example: +observer_cospar = 9999 # COSPAR number of observer's site +observer_name = Jeff Moe # Name of observer +observer_lat = 40.568912 # Latitude of location in decimal degrees +observer_lon = -105.225852 # Longitude of location in decimal degrees +observer_height = 1860 # Elevation of location in meters + +observations_path = ./data/obs # Path for raw acquisitions +tle_path = ./data/tle # Path where TLEs are stored (and updated) +results_path = ./data/results # Path for results of processed obs + +st-username = foo +st-password = bar + +# Path to source-extractor +sex_config = /usr/share/source-extractor/default.sex +\end{minted} + +Store downloads here: + +\begin{minted}{sh} +mkdir -p ./data/obs ./data/tle ./data/results +\end{minted} + +The \texttt{ST\_DATADIR} variable is still used, from \texttt{sattools}. +Maybe set all these in \texttt{~/.bashrc} (suit to fit directory setup): + +\begin{minted}{sh} +export ST_DATADIR=$HOME/sattools +export ST_TLEDIR=$HOME/TLE +export ST_OBSDIR=$HOME/satobs +export ST_LOGIN="identity=foo@no:pass" +\end{minted} + + +Set \texttt{astrometry.net} to run in parallel, assuming you have enough RAM: +(This doesn't appear to work? Breaks?). + +\begin{minted}{sh} +sudo vim /etc/astrometry.cfg +# Uncomment: +inparallel +\end{minted} +