SNOUG/src/Identify.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{identify}\index{SIDLOC}\index{orbit}
\index{SSA}

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}
\index{identify}\index{FITS}\index{stvid}\index{process}

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}\index{identify}
\index{C}\index{Giza}

The deprecated \gls{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{Identification with stvid}
\index{identify}\index{stvid}
See section \ref{sec:satellite-detection}, page \pageref{sec:satellite-detection}
for details on identification with stvid.
The detection and identification steps are both done in one script.

See figure \ref{fig:stvid-process}, page \pageref{fig:stvid-process}
for an example of from \gls{stvid} automated processing of an input \gls{FITS}
file. The output image is in \gls{PNG} format.
\gls{stvid} will also output other files with results, such as \gls{CSV} files.
\index{stvid}\index{FITS}\index{PNG}\index{CSV}\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{Review of Images}
\index{stvid}
See the following subsections for example output from \gls{stvid}.


\subsection{Unidentified Satellites}
\index{unidentified}\index{identify}\index{FITS}\index{stvid}
When \gls{stvid} runs the \texttt{process.py} (or new) script and
it encounters a satellite it cannot identify, it gives it the 
\gls{NORAD ID} \texttt{90000}. If more unidentified satellites are
detected in the same image, each detection is incremented by one.

See figure \ref{fig:stvid-unidentified}, page \pageref{fig:stvid-unidentified},
 for an example image, with three unidentified satellites.
One is on the left, the other two on the right, next to each other.


\begin{sidewaysfigure}[p!]
        \includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{id-new-sats/2022-08-23T11:18:12.531.fits.png}
        \caption{stvid processed image, with three unidentified satellites.}
        \label{fig:stvid-unidentified}
        \index{stvid}\index{unidentified}
\end{sidewaysfigure}


\subsection{Airplanes}
\index{airplane}\index{FITS}\index{noise}\index{stvid}
Airplanes are noise in the data.

Airplanes will appear not infrequently in images.
See figure \ref{fig:stvid-airplane1}, page \pageref{fig:stvid-airplane1}
for an example with an airplane in the left side, forming two parallel
lines from the aircrafts' lights.

In figure \ref{fig:stvid-airplane2}, page \pageref{fig:stvid-airplane2},
is shown an example image with an airplane with a very distinct blinking light.
 
In figure \ref{fig:stvid-airplane3}, page \pageref{fig:stvid-airplane3},
airplane solid parallel lights can be seen with blinking lights.
 
\begin{sidewaysfigure}[p!]
        \includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{airplane/2022-08-23T04:17:27.161.fits.png}
        \caption{Airplane, bold left side, in stvid processed image.}
        \label{fig:stvid-airplane1}
        \index{stvid}\index{airplane}
\end{sidewaysfigure}

\begin{sidewaysfigure}[p!]
        \includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{airplane/2022-08-24T03:05:30.370.fits.png}
        \caption{Airplane, blinking, in stvid processed image.}
        \label{fig:stvid-airplane2}
        \index{stvid}\index{airplane}
\end{sidewaysfigure}

\begin{sidewaysfigure}[p!]
        \includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{airplane/2022-08-24T09:18:02.277.fits.png}
        \caption{Airplane, two solid lights plus blinking, in stvid processed image.}
        \label{fig:stvid-airplane3}
        \index{stvid}\index{airplane}
\end{sidewaysfigure}