From ece478c46b6e2d12084f8e03c82eba21ae574b56 Mon Sep 17 00:00:00 2001 From: Jeff Moe Date: Wed, 31 Aug 2022 15:35:12 -0600 Subject: [PATCH] Use descriptions in place of some itemize/enumerate --- src/Epigraph.tex | 2 +- src/Hardware.tex | 14 ++++----- src/Introduction.tex | 34 ++++++++++----------- src/SatNOGS_Optical.tex | 67 +++++++++++++++++++++-------------------- src/Satellites.tex | 6 ++-- 5 files changed, 62 insertions(+), 61 deletions(-) diff --git a/src/Epigraph.tex b/src/Epigraph.tex index b169b41..7dd5044 100644 --- a/src/Epigraph.tex +++ b/src/Epigraph.tex @@ -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} diff --git a/src/Hardware.tex b/src/Hardware.tex index a667686..5e36a2a 100644 --- a/src/Hardware.tex +++ b/src/Hardware.tex @@ -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} diff --git a/src/Introduction.tex b/src/Introduction.tex index 2d5aa79..97a570b 100644 --- a/src/Introduction.tex +++ b/src/Introduction.tex @@ -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} diff --git a/src/SatNOGS_Optical.tex b/src/SatNOGS_Optical.tex index 87ae541..80b1d77 100644 --- a/src/SatNOGS_Optical.tex +++ b/src/SatNOGS_Optical.tex @@ -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} diff --git a/src/Satellites.tex b/src/Satellites.tex index 2629ecf..5aa9293 100644 --- a/src/Satellites.tex +++ b/src/Satellites.tex @@ -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!]