vel
/
SNOUG-Vel
forked from spacecruft/SNOUG
1
0
Fork 0
Code Issues Pull Requests Releases 1 Activity

Use descriptions in place of some itemize/enumerate

main
Jeff Moe 2022-08-31 15:35:12 -06:00
parent 48bbd344ba
commit ece478c46b
5 changed files with 62 additions and 61 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/Epigraph.tex
View File

@ -19,7 +19,7 @@
\epigraphsourceposition{center}
\epigraphtextposition{center}
{\epigraph
{\itshape{Space should be claimed\\the libre way.}}
{\itshape{Space should be claimed the libre way.}}
{Libre Space Foundation}
}
\end{vplace}

14
src/Hardware.tex
View File

@ -90,13 +90,13 @@ Computers, such as Raspberry Pi, that can be used.
%\begin{lstlisting}[caption={Embedded computer options}]
%\end{lstlisting}
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize}
\item Odroid N2 --- Confirmed working. \index{Odroid}
\item Odroid M1 --- Testing.
\item Raspberry Pi 3 --- ?
\item Raspberry Pi 4 --- ?
\item Intel NUC --- ? \index{Intel}
\end{itemize}
\begin{description}
\item [Odroid N2] --- Confirmed working. \index{Odroid}
\item [Odroid M1] --- Testing.
\item [Raspberry Pi 3] --- ?
\item [Raspberry Pi 4] --- ?
\item [Intel NUC] --- ? \index{Intel}
\end{description}
\end{mdframed}
\subsection{Comparison}

34
src/Introduction.tex
View File

@ -36,29 +36,29 @@ The chapters that follow are listed below.
% Perhaps more LaTeXy ref XXX
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize}
\item \Glspl{satellite} --- What are we looking at?
\item Ground Stations --- How Earth talks to \glspl{satellite} and back.
\item Toolchain and Process --- The big picture of what
\begin{description}
\item [\Glspl{satellite}] --- What are we looking at?
\item [Ground Stations] --- How Earth talks to \glspl{satellite} and back.
\item [Toolchain and Process] --- The big picture of what
hardware and software is needed to set up an optical ground station
for use on the distributed network.
\item Hardware --- Details on appropriate hardware configurations,
\item [Hardware] --- Details on appropriate hardware configurations,
and example setups.
\item Software --- A look at the myriad software related to \glspl{satellite},
\item [Software] --- A look at the myriad software related to \glspl{satellite},
and what works best at present for SatNOGS Optical.
\item Acquire --- Convert photons to bits. Pointing a camera at the
\item [Acquire] --- Convert photons to bits. Pointing a camera at the
sky works.
\item Solve --- Pictures of stars reveal the time and location of
\item [Solve] --- Pictures of stars reveal the time and location of
the photo. Plate solvers reviewed.
\item Detect --- The plate solver says where the photo is,
\item [Detect] --- The plate solver says where the photo is,
now detect if are there moving tracks that aren't stars that could
be \glspl{satellite}.
\item Identify --- With time, location, \gls{satellite} detection, \glspl{TLE}
\item [Identify] --- With time, location, \gls{satellite} detection, \glspl{TLE}
are overlaid and compared with detected \glspl{satellite}.
\Gls{satellite} identification by computers and humans.
\item Upload --- When ready, data will be pushed to the SatNOGS network.
\item Support --- Where development is occurring and questions answered!
\end{itemize}
\item [Upload] --- When ready, data will be pushed to the SatNOGS network.
\item [Support] --- Where development is occurring and questions answered!
\end{description}
\end{mdframed}
@ -82,12 +82,12 @@ Select \gls{LSF} projects:
\index{UPSat}
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize}
\item SatNOGS --- Global network of \gls{satellite} ground stations \\
\begin{description}
\item [SatNOGS] --- Global network of \gls{satellite} ground stations \\
\url{https://satnogs.org}
\item UPSat --- First \gls{OSH} and \gls{OSS} \gls{satellite} in the world \\
\item [UPSat] --- First \gls{OSH} and \gls{OSS} \gls{satellite} in the world \\
\url{https://upsat.gr/}
\end{itemize}
\end{description}
\end{mdframed}

67
src/SatNOGS_Optical.tex
View File

@ -22,14 +22,14 @@ software to build an operating optical ground station.
See figure \ref{fig:snopo}, page \pageref{fig:snopo}, described below.
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{enumerate}
\item Hardware --- Hardware, such as cameras and computers, is to be selected and set up.
\item Software --- The best currently available software is to be downloaded, installed, and configured.
\item Acquire --- Data samples, typically in the form of \gls{FITS} file photographs, need to be acquired by running a camera outside at night taking pictures of the sky.
\item \Gls{plate-solver} --- Acquired data samples need to be processed by a \gls{plate-solver}. See \ref{sec:plate-solver}, page \pageref{sec:plate-solver}.
\item Detect \glspl{satellite} --- Using \glspl{TLE} and the ``solved'' plates, detect \glspl{satellite}. See \ref{sec:satellite-detection}, page \pageref{sec:satellite-detection}.
\item Identify \glspl{satellite} --- With \glspl{satellite} detected in the previous step, identify what they are. See \ref{sec:overview-identify}, page \pageref{sec:overview-identify}.
\end{enumerate}
\begin{description}
\item [Hardware] --- Hardware, such as cameras and computers, is to be selected and set up.
\item [Software] --- The best currently available software is to be downloaded, installed, and configured.
\item [Acquire] --- Data samples, typically in the form of \gls{FITS} file photographs, need to be acquired by running a camera outside at night taking pictures of the sky.
\item [\Gls{plate-solver}] --- Acquired data samples need to be processed by a \gls{plate-solver}. See \ref{sec:plate-solver}, page \pageref{sec:plate-solver}.
\item [Detect \glspl{satellite}] --- Using \glspl{TLE} and the ``solved'' plates, detect \glspl{satellite}. See \ref{sec:satellite-detection}, page \pageref{sec:satellite-detection}.
\item [Identify \glspl{satellite}] --- With \glspl{satellite} detected in the previous step, identify what they are. See \ref{sec:overview-identify}, page \pageref{sec:overview-identify}.
\end{description}
\end{mdframed}
\begin{figure}[h!]
@ -53,11 +53,11 @@ category of equipment is selected, it impacts everything else, such as the
software used. Main categories:
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize}
\item Motion video cameras --- Moving images.
\item Still camera --- Still photos.
\item Allsky cameras --- Views of all, or nearly all of the sky.
\end{itemize}
\begin{description}
\item [Motion video cameras] --- Moving images.
\item [Still camera] --- Still photos.
\item [Allsky cameras] --- Views of all, or nearly all of the sky.
\end{description}
\end{mdframed}
Different types of equipment can be used in different categories.
@ -67,21 +67,21 @@ detecting \glspl{satellite} with the developing \gls{SatNOGS} toolchain.
Examples of motion video camera sources that could be used:
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize}
\item The Imaging Source Cameras based on IMX174 --- Known to work. Recommended.
\begin{description}
\item [The Imaging Source Cameras based on IMX174] --- Known to work. Recommended.
High quality cameras, believed to be usable following \gls{DFSG}.
\item ZWO ASI based on IMX174 --- Known to work. Not \gls{DFSG} compatible.
\item [ZWO ASI based on IMX174] --- Known to work. Not \gls{DFSG} compatible.
Uses proprietary SDK. Currently in prototype development.
\item UVC/Video4Linux2 --- ``Any'' video camera that works with the \gls{Linux} kernel.
\item [UVC/Video4Linux2] --- ``Any'' video camera that works with the \gls{Linux} kernel.
Typically, the device will appear similar to \texttt{/dev/video0}. A camera
that works with the software isn't necessarily sensitive enough to detect
satellites, however, as most are designed for bright environments.
\item OpenCV --- Devices that work with OpenCV can be used.
\item [OpenCV] --- Devices that work with OpenCV can be used.
To work well, they need to be sensitive.
\item Raspberry Pi --- The PiCamera can be used. A good lower cost option.
\item [Raspberry Pi] --- The PiCamera can be used. A good lower cost option.
Recommended. Many non-Raspberry Pi devices are also compatible with the Pi
MIPI interface.
\end{itemize}
\end{description}
\end{mdframed}
Still cameras can also be used productively. The current \gls{Python} toolchain
@ -90,14 +90,14 @@ is in very early development and not completely usable yet.
See the list below for still camera options:
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize}
\item \Glspl{telescope} --- Can definitely take images of \glspl{satellite}.
\begin{description}
\item [\Glspl{telescope}] --- Can definitely take images of \glspl{satellite}.
Not the best tool at present, as it isn't well integrated into the toolchain.
The \gls{FOV} is generally too small. The mounts are optimized for
different types of tracking than satellites. This is changing, and longer
term could be well-supported. Using \gls{RASA} style \glspl{astrograph}
is likely the best option.
\item \gls{INDI} --- Typically used for control of \glspl{telescope} and
\item [\gls{INDI}] --- Typically used for control of \glspl{telescope} and
associated instrumentation, such as tracking mounts and cameras.
Cannot be used directly with the current developing \gls{SatNOGS} toolchain.
It is not seen as the future path forward as it isn't well optimized for
@ -105,12 +105,12 @@ See the list below for still camera options:
running a tracking mount with KStars and Ekos, for example,
in lieu of a better option. Camera software in the \gls{INDI} platform typically
produce image \gls{FITS} files.
\item gphoto --- The \gls{Linux} kernel recognizes many cameras that can be
\item [gphoto] --- The \gls{Linux} kernel recognizes many cameras that can be
used with gphoto tools and drivers, available in \gls{Debian}.
This is the recommended option at present for still cameras.
\gls{DSLR} cameras, such as from major manufacturers Canon and Nikon, are
used with gphoto.
\end{itemize}
\end{description}
\end{mdframed}
Considering the hardware options above, they need to be matched with
@ -120,31 +120,32 @@ easily used to perform all steps needed.
There are also broader ``paths'' that need to be considered:
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize}
\item \gls{sattools} --- Deprecated because it is in \gls{C}, and the
\begin{description}
\item [\gls{sattools}] --- Deprecated because it is in \gls{C}, and the
decision was made to move forward with applications primarily
written in \gls{Python}. \Gls{sattools} is the most complete toolkit,
however, so no matter what path is chosen, some parts of it will likely
be used for now. It can be used with motion video cameras and
still cameras. It includes many other software tools related to
\glspl{satellite}.
\item \gls{stvid} --- This is the best path if a motion video camera
\item [\gls{stvid}] --- This is the best path if a motion video camera
is available. It is in \gls{Python} and is the tool the
\gls{SatNOGS-Optical} project is using as the basis for future development.
It still depends on some \gls{C} tools from \gls{sattools}.
\item \texttt{stphot} --- Written in \gls{Python} this is what the
\gls{SatNOGS-Optical} project will likely use in the future.
\item [\texttt{stphot}] --- Written in \gls{Python} this is what the
\gls{SatNOGS-Optical} project will likely use in the future
for still cameras.
It is in very early development, but can acquire data (take photos)
with gphoto-compatible cameras.
\item \texttt{asm} --- All Sky Monitor for taking pictures of all, or nearly all
\item [\texttt{asm}] --- All Sky Monitor for taking pictures of all, or nearly all
of the sky, such as with a 150 or 180 degree view. The \texttt{asm}
application is in pre-development, but is in \gls{Python} and could be
the basis for future \gls{SatNOGS-Optical} development.
The difficulty with all sky cameras is the \gls{plate-solver} isn't
written to use images from the ``fish-eye'' view of an all sky camera.
\item Other --- There are many other satellite and telescope software
\item [Other] --- There are many other satellite and telescope software
packges freely available on the Internet. Many could be adapted for
usage.
\end{itemize}
\end{description}
\end{mdframed}

6
src/Satellites.tex
View File

@ -64,11 +64,11 @@ See the RamSat \gls{telemetry} dashboard.
Select \gls{libre} \glspl{satellite}:
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize}
\item UPSat --- First \gls{libre} \gls{OSH} and software \gls{satellite} in the world.
\begin{description}
\item [UPSat] --- First \gls{libre} \gls{OSH} and software \gls{satellite} in the world.
Created by the \gls{LSF}. \\
\url{https://upsat.gr/}
\end{itemize}
\end{description}
\end{mdframed}
\begin{figure}[h!]