stvid setup, configuration code
parent
4b686ffbda
commit
da4124511f
|
@ -11,52 +11,8 @@
|
||||||
|
|
||||||
\section{Overview of Operation}
|
\section{Overview of Operation}
|
||||||
\label{sec:overview-operation}
|
\label{sec:overview-operation}
|
||||||
HOWTO run a SatNOGS Optical ground station.
|
HOWTO run a SatNOGS Optical ground station,
|
||||||
|
after it has been set up and congfigured.
|
||||||
|
|
||||||
\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.
|
|
||||||
|
|
||||||
|
|
||||||
\section{Acquire Data}
|
\section{Acquire Data}
|
||||||
|
|
|
@ -280,6 +280,7 @@ leftmargin=1cm,rightmargin=1cm
|
||||||
\chapterconf{Satellites}{Satellites}{Artificial Satellites}
|
\chapterconf{Satellites}{Satellites}{Artificial Satellites}
|
||||||
\chapterconf{Ground_Stations}{Ground Stations}{Earth Ground Stations}
|
\chapterconf{Ground_Stations}{Ground Stations}{Earth Ground Stations}
|
||||||
\chapterconf{Hardware}{Hardware}{Design and Set Up an Optical Ground Station}
|
\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{Operation}{Operation}{HOWTO Operate a Station}
|
||||||
\chapterconf{Analysis}{Analysis}{More Than Just Starlink and Old Rocket Bodies}
|
\chapterconf{Analysis}{Analysis}{More Than Just Starlink and Old Rocket Bodies}
|
||||||
\chapterconf{Support}{Support}{Help!}
|
\chapterconf{Support}{Support}{Help!}
|
||||||
|
|
|
@ -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}
|
||||||
|
|
Loading…
Reference in New Issue