From f073313088d0130dbb0cda57ef9cb4688ce26f85 Mon Sep 17 00:00:00 2001 From: Jeff Moe Date: Sun, 4 Sep 2022 18:23:21 -0600 Subject: [PATCH] Some tracks are trails. Dab Upload --- src/Glossary.tex | 7 +++++- src/Hardware.tex | 4 +-- src/Identify.tex | 2 +- src/Introduction.tex | 2 +- src/Software.tex | 2 +- src/Upload.tex | 58 +++++++++++++++++++++++++++++--------------- 6 files changed, 48 insertions(+), 27 deletions(-) diff --git a/src/Glossary.tex b/src/Glossary.tex index d7f0d91..b238318 100644 --- a/src/Glossary.tex +++ b/src/Glossary.tex @@ -683,4 +683,9 @@ % IOD % COSPAR % track = tracking mount -% track = satellite black line drawn on PNG... +% trail = satellite black line drawn on PNG... +% RENAME +% sample rate +% frame size +% four frame + diff --git a/src/Hardware.tex b/src/Hardware.tex index c99d037..6657873 100644 --- a/src/Hardware.tex +++ b/src/Hardware.tex @@ -423,14 +423,12 @@ It requires, such as: \end{mdframed} \index{GNSS}\index{TLE}\index{orbit}\index{alignment}\index{track} -% Some skilled amateurs track by hand. - Most tracking equipment for \glspl{telescope}, cameras, and \glspl{antenna} usually has just a few speeds, such as a \gls{slew} speed and a sidereal star tracking speed. Sometimes there will be a few steps of these speeds (e.g. \gls{slew} speeds from 1-9), but not the finely tuned tracking speeds needed to track a satellite. Oftentimes the \gls{telescope} tracking maximum -speed will be too slow for satellite tracks. +speed will be too slow for satellite tracking. \index{track}\index{telescope} Variable speed tracking (XXX phrase?) is needed for tracking satellites if diff --git a/src/Identify.tex b/src/Identify.tex index 6367b7d..3f8d6e6 100644 --- a/src/Identify.tex +++ b/src/Identify.tex @@ -219,7 +219,7 @@ for an example image that is bad due to slewing during acquisition. \begin{sidewaysfigure}[p!] \includegraphics[keepaspectratio=true,height=1.00\textheight,width=1.00\textwidth,angle=0]{stvid/2022-09-04T04\:56\:37.072.fits.png} - \caption{\texttt{stvid} processed image, tracks due to slewing during acquire.} + \caption{\texttt{stvid} processed image, trails due to slewing during acquire.} \label{fig:stvid-process-bad-slew} \index{stvid}\index{TLE} \end{sidewaysfigure} diff --git a/src/Introduction.tex b/src/Introduction.tex index 0254f69..ccfe26e 100644 --- a/src/Introduction.tex +++ b/src/Introduction.tex @@ -53,7 +53,7 @@ The chapters that follow are listed below. \item [Solve] --- Pictures of stars reveal the time and location of the photo. Plate solvers reviewed.\index{plate solver} \item [Detect] --- The plate solver says where the photo is, - now detect if are there moving tracks that aren't \glspl{star trail} that could + now detect if are there moving trails that aren't \glspl{star trail} that could be \glspl{satellite}.\index{star trail} \item [Identify] --- With time, location, \gls{satellite} detection, \glspl{TLE} are overlaid and compared with detected \glspl{satellite}.\index{identify} diff --git a/src/Software.tex b/src/Software.tex index d01b948..a3ab7d3 100644 --- a/src/Software.tex +++ b/src/Software.tex @@ -207,7 +207,7 @@ inparallel \label{sec:skymap} \index{skymap}\index{orbit}\index{sattools} -Use \gls{skymap} for viewing \gls{satellite} \glspl{orbit} tracks +Use \gls{skymap} for viewing \gls{satellite} \glspl{orbit} trails projected on a map of of the sky. Skymap is part of \gls{sattools}. \Gls{skymap} isn't a required part of the \gls{toolchain}, but it is useful to see what \glspl{satellite} are visible at a particular time and diff --git a/src/Upload.tex b/src/Upload.tex index 5d1daf3..81bbcdb 100644 --- a/src/Upload.tex +++ b/src/Upload.tex @@ -19,6 +19,7 @@ development. \section{File Extensions} \label{sec:upload-extensions} \index{formats} +\index{.cal}\index{.cat}\index{.csv}\index{.dat}\index{.fits}\index{.png} The following file extensions are in use: \begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30] @@ -55,6 +56,7 @@ run, files such as below will be generated: 2022-08-23T04:16:26.633_predict.csv 2022-08-23T04:16:26.633_threshold.csv \end{minted} +\index{.cal}\index{.cat}\index{.csv}\index{.dat}\index{.fits}\index{.png} \subsection{\texttt{.fits} FITS Files} @@ -64,6 +66,7 @@ the actual image taken with the camera. \gls{FITS} files will be significantly larger than the other files, at around 8 to 35 megabytes each, depending on sample rate, frame size, and \gls{binning}. \index{FITS}\index{acquire}\index{process} +\index{frame size}\index{sample rate} The \texttt{stvid} program creates it's customized \gls{FITS} format file, which is a stack up of multiple images. @@ -73,14 +76,16 @@ to the program's author, Cees Bassa: \begin{quote} With stvid, I typically store 10 seconds worth of video frames, 100 frames at 10 \gls{Hz} frame rate or 250 frames at 25 \gls{Hz} frame rate into a so-called ``four frame''. Here, for each pixel of the initial 100 or 250 frames, the mean, standard deviation, maximum and argmax are stored, each as its own frame. Objects that move will stand out because they will have a high (max - mean) / standard deviation, which allows me to detect trails. Once a trail is detected, the argmax frame tells me the frame number and hence the motion of the trail, and using the timestamps of the individual 100 or 250 frames, I can reconstruct the pixel position as a function of time during the 10 second exposure, using only 4 frames instead of the 100 or 250 individual video frames. \end{quote} -\index{Bassa, Cees} +\index{Bassa, Cees}\index{stvid}\index{four frame}\index{trail} +\index{.fits} \subsection{\texttt{.cal} CAL Files} +\index{.cal}\index{stvid} Example \texttt{.cal} filename:\\ \texttt{2022-08-23T04:16:26.633.fits.cal}\\ -Sample data from \texttt{.cat} file, just the top select lines of a 577 line file: +Sample data from \texttt{.cal} file, just the top select lines of a 577 line file: \begin{minted}{sh} 1172.876 11.776 7.1775 221.117561 45.185979 6.761 @@ -98,6 +103,7 @@ Sample data from \texttt{.cat} file, just the top select lines of a 577 line fil \subsection{\texttt{.cat} CAT Files} +\index{.cat}\index{stvid}\index{FITS} \texttt{stvid} generates \texttt{.cat} files, generated from \gls{FITS} files, such as:\\ \texttt{2022-08-23T04:16:26.633.fits.cat} \\ @@ -127,6 +133,7 @@ Sample data from \texttt{.cat} file, just the top select lines of a 1,033 line f \subsection{\texttt{.fits.png} FITS PNG Files} \index{FITS}\index{PNG}\index{stvid} +\index{.fits.png} The \texttt{stvid} application can generate multiple \gls{PNG} files, depending how many satellites it finds. In every case it creates at least one \gls{PNG} file, with a name like: @@ -140,13 +147,15 @@ The blue lines are drawn whether no, a few, or many satellites are detected. They are generated by taking data from the \gls{plate-solver} about where the picture \gls{FOV} is, and overlaying satellite \glspl{orbit} that are calculated from \glspl{TLE}. +\index{detect}\index{plate solver}\index{orbit}\index{TLE} The main blue line is slightly offset from where the satellite is calculated to appear. The blue line forms a small \texttt{L} shape. The smaller segment indicates the area where the satellite may pass. Next to the small segment line is the \gls{NORAD ID} for the satellite. -If it is unknown, it will be given the number 90000 or larger. +If it is unknown, it will be given the number \texttt{90000} or larger. +\index{NORAD ID} \begin{figure}[h!] \begin{center} @@ -156,13 +165,15 @@ If it is unknown, it will be given the number 90000 or larger. \index{stvid}\index{PNG}\index{FITS} \end{center} \end{figure} +\index{.fits.png} \subsection{\texttt{catalog.png} catalog PNG Files} \index{FITS}\index{PNG}\index{stvid}\index{NORAD ID} +\index{detect}\index{identify} When \texttt{stvid} identifies a satellite, it creates a new \gls{PNG} file for each satellite detected in the image. A file name example follows, with satellite -NORAID ID 48473 detected, also shown in figure +\gls{NORAD ID} 48473 identified, also shown in figure \ref{fig:stvid-png-48473-catalog}, page \pageref{fig:stvid-png-48473-catalog}. \texttt{2022-08-23T04:16:26.633\_48473\_catalog.png} @@ -170,11 +181,12 @@ NORAID ID 48473 detected, also shown in figure \begin{figure}[h!] \begin{center} \includegraphics[keepaspectratio=true,height=0.85\textheight,width=0.85\textwidth,angle=0]{stvid/data/2022-08-23T04:16:26.633_48473_catalog.png} - \caption{\texttt{stvid} PNG of the satellite track of NORAD ID 48473 identified in red.} + \caption{\texttt{stvid} PNG of the satellite trail of NORAD ID 48473 identified in red.} \label{fig:stvid-png-48473-catalog} \index{stvid}\index{PNG}\index{FITS}\index{NORAD ID} \end{center} \end{figure} +\index{stvid}\index{identify}\index{PNG} If multiple satellites are detected in the image, they will each get a \gls{PNG} file. For the example image, a satellite with \gls{NORAD ID} 52718 was also identified. @@ -185,30 +197,31 @@ The file name is: \begin{figure}[h!] \begin{center} \includegraphics[keepaspectratio=true,height=0.85\textheight,width=0.85\textwidth,angle=0]{stvid/data/2022-08-23T04:16:26.633_52718_catalog.png} - \caption{\texttt{stvid} PNG of the satellite track of NORAD ID 52718 identified in red.} + \caption{\texttt{stvid} PNG of the satellite trail of NORAD ID 52718 identified in red.} \label{fig:stvid-png-52718-catalog} - \index{stvid}\index{PNG}\index{FITS}\index{NORAD ID} + \index{stvid}\index{PNG}\index{FITS}\index{NORAD ID}\index{identify} \end{center} \end{figure} \subsection{\texttt{unid.png} Unidentified PNG Files} \index{FITS}\index{PNG}\index{stvid}\index{NORAD ID} +\index{unidentified} As shown previously, \texttt{stvid} will create a new \gls{PNG} with a red line when it identifies a satellite. -When \texttt{stvid} finds a track it can't identify in the -\gls{TLE} catalogs, it gives it a \gls{NORAD ID} starting with 90000, +When \texttt{stvid} finds a trail it can't identify in the +\gls{TLE} catalogs, it gives it a \gls{NORAD ID} starting with \texttt{90000}, incrementing by one. See figure \ref{fig:stvid-png-90000-unid}, page \pageref{fig:stvid-png-90000-unid}, -for an example of \texttt{stvid} marking an unidentified track red. -In this case, the track was created by an airplane, but \texttt{stvid} would -do the same with an unknown satellite track. +for an example of \texttt{stvid} marking an unidentified trail red. +In this case, the trail was created by an airplane, but \texttt{stvid} would +do the same with an unidentified satellite trail. \index{airplane} \begin{figure}[h!] \begin{center} \includegraphics[keepaspectratio=true,height=0.85\textheight,width=0.85\textwidth,angle=0]{stvid/data/2022-08-23T04:16:26.633_90000_unid.png} - \caption{\texttt{stvid} PNG of an unidentified track in red.} + \caption{\texttt{stvid} PNG of an unidentified trail in red.} \label{fig:stvid-png-90000-unid} \index{stvid}\index{PNG}\index{FITS}\index{NORAD ID} \end{center} @@ -216,15 +229,13 @@ do the same with an unknown satellite track. \subsection{\texttt{.dat} Data Files} -For each track detected as shown in previous sections, such as for which +\index{.dat}\index{PNG} +For each trail detected as shown in previous sections, such as for which a \gls{PNG} file was created, \texttt{stvid} will output a \texttt{.dat} file. The \texttt{.dat} filenames corresponding to the figures at \ref{fig:stvid-png-48473-catalog}, \ref{fig:stvid-png-52718-catalog}, and \ref{fig:stvid-png-90000-unid} are: -%\texttt{2022-08-23T04:16:26.633\_48473\_catalog.dat} -%\texttt{2022-08-23T04:16:26.633\_52718\_catalog.dat} -%\texttt{2022-08-23T04:16:26.633\_90000\_unid.dat} \begin{minted}{sh} 2022-08-23T04:16:26.633_48473_catalog.dat 2022-08-23T04:16:26.633_52718_catalog.dat @@ -233,9 +244,10 @@ and \ref{fig:stvid-png-90000-unid} are: Note, there is no \texttt{.dat} file created corresponding to the \texttt{2022-08-23T04:16:26.633.fits.png} file, since it doesn't show -detected tracks. +detected trails. The \texttt{.dat} file contents look like this, for \gls{NORAD ID} 48473: +\index{NORAD ID} \begin{minted}{sh} 48473 21 040AX 9999 G 20220823041631625 17 25 1533406+483563 37 S @@ -246,14 +258,15 @@ The first field is the \gls{NORAD ID}. The fourth field looks like COSPAR. XXX Large number starting with 2022 is date and time stamp. The \texttt{.dat} file contents look like this, for \gls{NORAD ID} 52718: +\index{.dat} \begin{minted}{sh} 52718 22 056C 9999 G 20220823041631625 17 25 1527277+381243 37 S \end{minted} -The \texttt{.dat} file contents look like this, for the unidentified track +The \texttt{.dat} file contents look like this, for the unidentified trail (the airplane): -\index{airplane} +\index{airplane}\index{unidentified} \begin{minted}{sh} 90000 22 500A 9999 G 20220823041631625 17 25 1457613+535844 37 S @@ -261,6 +274,7 @@ The \texttt{.dat} file contents look like this, for the unidentified track \subsection{\texttt{stvid} \texttt{.csv} Files} +\index{.csv}\index{stvid}\index{hough}\index{predict}\index{threshold} During processing, \texttt{stvid} generates (at least!) three \gls{CSV} files. For the observation discussed above, staring with figure \ref{fig:stvid-png}, the following \gls{CSV} files are generated: @@ -273,6 +287,7 @@ the following \gls{CSV} files are generated: \subsubsection{\texttt{stvid} \texttt{hough.csv} Files} +\index{.csv}\index{stvid}\index{hough} Full contents of the \texttt{2022-08-23T04:16:26.633\_hough.csv} file: \begin{minted}{sh} @@ -283,6 +298,7 @@ ax,ay,az,bx,by,bz,n \end{minted} \subsubsection{\texttt{stvid} \texttt{predict.csv} Files} +\index{.csv}\index{stvid}\index{predict} The \texttt{2022-08-23T04:16:26.633\_predict.csv} is 3,764 lines long. Below is an extract of the lines. I shortened the path, which included the full path to my home directory, for clarity: @@ -307,9 +323,11 @@ satno,cospar,mjd,ra,dec,state,tlefile,age 32706,08010A ,59814.17811171,169.564400,+50.077336,sunlit,/data/tle/inttles.tle,0.624 ... \end{minted} +\index{.csv}\index{NORAD ID}\index{COSPAR}\index{TLE} \subsubsection{\texttt{stvid} \texttt{threshold.csv} Files} +\index{.csv}\index{stvid}\index{threshold} \texttt{stvid} creates a \texttt{threshold.csv} file with a filename like: \texttt{2022-08-23T04:16:26.633\_threshold.csv}