SNOUG/src/Identify.tex

101 lines
2.9 KiB
TeX

%
% Identify.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{Overview of Satellite Identification}
\label{sec:overview-identify}
\index{identification}
\index{SIDLOC}
The \gls{LSF} is developing a project called \gls{SIDLOC},
for \gls{satellite} identification and localization. With the
addition of many more \glspl{satellite} in \gls{orbit} there is a growing need
for \gls{SSA}.
\section{\texttt{stvid}'s \texttt{process.py} for Identification}
\label{sec:process-identify}
The best tool for identifying \glspl{satellite} from \gls{FITS} files
is the \texttt{process.py}
script from \texttt{stvid}, available here:
* \url{https://github.com/cbassa/stvid}
My fork is here:
* \url{https://spacecruft.org/spacecruft/stvid}
\section{Identifying Satellites with \texttt{satid}}
\index{satid}\index{sattools}
The deprecated C application, \texttt{satid} from the \texttt{\gls{sattools}}
package can help identify \glspl{satellite}.
See figure \ref{fig:satid-giza-3}, page \pageref{fig:satid-giza-3}
for output from my Giza port of \texttt{\gls{satid}}.%
\footnote{\url{https://spacecruft.org/spacecruft/sattools/media/branch/spacecruft/img/satid-giza-3.png}}
\index{Giza}
* \url{https://github.com/cbassa/sattools}
My fork is here:
* \url{https://spacecruft.org/spacecruft/sattools}
\begin{figure}[p!]
\begin{center}
\includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{satid-giza-3.png}
\caption{\texttt{satid} example.}
\index{satid}\index{sattools}
\label{fig:satid-giza-3}
\end{center}
\end{figure}
\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}
\section{Process Data with \texttt{stvid}}
\index{stvid}\index{process}
Process data with using \gls{stvid}. Adjust dated directory to actual directory name.
\begin{minted}{sh}
cd stvid/
./process_new.py -c config_new.ini -d data/obs/20220825_1/020502/
\end{minted}
\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}