SNOUG-Vel/src/Detect.tex

84 lines
2.5 KiB
TeX

% Detect.tex
%
% 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{Satellite Detection with stvid}
\label{sec:satellite-detection}
\index{detection}\index{stvid}\index{process}\index{Python}
\index{FITS}
This is a description of \gls{satellite} detection processes.
To detect \gls{satellite} in a \gls{FITS} file using the stvid toolchain,
run \texttt{process.py} or, if it exists, the \texttt{process\_new.py}
Python script, if available, or the \texttt{process.py} script.
Note the \texttt{stvid} application's \texttt{process.py} and \texttt{process\_new.py}
will perform both automated detection and identification of satellites.
\index{identification}
\subsection{\texttt{process\_new.py} Usage}
\index{process}
This assumes you have installed \texttt{stvid} as shown in section \ref{sec:stvid-setup}.
Adjust dated directory to actual directory name.
\begin{minted}{sh}
cd stvid/
# Maybe you need to update TLE
./update_tle.py
./process_new.py -c config_new.ini -d data/obs/20220825_1/020502/
\end{minted}
\subsection{\texttt{process.py} Usage}
If there is no \texttt{process\_new.py} it has likely been merged into
\texttt{process.py}. Or perhaps, to use the ``older'' script it would
be run as shown below. Note, the configuration files is between the old
and new script are different.
\begin{minted}{sh}
cd stvid/
./process.py -c configuration.ini -d data/obs/20220825_1/020502/
\end{minted}
\index{stvid}\index{process}
\begin{sidewaysfigure}[p!]
\includegraphics[keepaspectratio=true,height=1.00\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{sidewaysfigure}
\section{AstroImageJ}
\index{identify}\index{AstroImageJ}\index{FITS}
Analyze data with applications, such as \gls{AstroImageJ}.
\gls{FITS} files are commonly used in astronomy.%
\footnote{\cite{Wiki22:fitswikipfreeencyc}}
\gls{AstroImageJ} can read \gls{FITS} format files.
See
\ref{fig:astroimagej}, page \pageref{fig:astroimagej},
for a screenshot displaying a \gls{FITS} file generated by
\texttt{\gls{stvid}}.
\index{stvid}
\begin{sidewaysfigure}[p!]
\begin{center}
\includegraphics[keepaspectratio=true,height=1.00\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{sidewaysfigure}