SNOUG/src/Identify.tex

146 lines
5.3 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{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}