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

View File

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

View File

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

View File

@ -36,29 +36,29 @@ The chapters that follow are listed below.
% Perhaps more LaTeXy ref XXX % Perhaps more LaTeXy ref XXX
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30] \begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize} \begin{description}
\item \Glspl{satellite} --- What are we looking at? \item [\Glspl{satellite}] --- What are we looking at?
\item Ground Stations --- How Earth talks to \glspl{satellite} and back. \item [Ground Stations] --- How Earth talks to \glspl{satellite} and back.
\item Toolchain and Process --- The big picture of what \item [Toolchain and Process] --- The big picture of what
hardware and software is needed to set up an optical ground station hardware and software is needed to set up an optical ground station
for use on the distributed network. for use on the distributed network.
\item Hardware --- Details on appropriate hardware configurations, \item [Hardware] --- Details on appropriate hardware configurations,
and example setups. 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. 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. 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. 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 now detect if are there moving tracks that aren't stars that could
be \glspl{satellite}. 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}. are overlaid and compared with detected \glspl{satellite}.
\Gls{satellite} identification by computers and humans. \Gls{satellite} identification by computers and humans.
\item Upload --- When ready, data will be pushed to the SatNOGS network. \item [Upload] --- When ready, data will be pushed to the SatNOGS network.
\item Support --- Where development is occurring and questions answered! \item [Support] --- Where development is occurring and questions answered!
\end{itemize} \end{description}
\end{mdframed} \end{mdframed}
@ -82,12 +82,12 @@ Select \gls{LSF} projects:
\index{UPSat} \index{UPSat}
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30] \begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize} \begin{description}
\item SatNOGS --- Global network of \gls{satellite} ground stations \\ \item [SatNOGS] --- Global network of \gls{satellite} ground stations \\
\url{https://satnogs.org} \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/} \url{https://upsat.gr/}
\end{itemize} \end{description}
\end{mdframed} \end{mdframed}

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. See figure \ref{fig:snopo}, page \pageref{fig:snopo}, described below.
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30] \begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{enumerate} \begin{description}
\item Hardware --- Hardware, such as cameras and computers, is to be selected and set up. \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 [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 [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 [\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 [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}. \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} \end{description}
\end{mdframed} \end{mdframed}
\begin{figure}[h!] \begin{figure}[h!]
@ -53,11 +53,11 @@ category of equipment is selected, it impacts everything else, such as the
software used. Main categories: software used. Main categories:
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30] \begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize} \begin{description}
\item Motion video cameras --- Moving images. \item [Motion video cameras] --- Moving images.
\item Still camera --- Still photos. \item [Still camera] --- Still photos.
\item Allsky cameras --- Views of all, or nearly all of the sky. \item [Allsky cameras] --- Views of all, or nearly all of the sky.
\end{itemize} \end{description}
\end{mdframed} \end{mdframed}
Different types of equipment can be used in different categories. 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: Examples of motion video camera sources that could be used:
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30] \begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize} \begin{description}
\item The Imaging Source Cameras based on IMX174 --- Known to work. Recommended. \item [The Imaging Source Cameras based on IMX174] --- Known to work. Recommended.
High quality cameras, believed to be usable following \gls{DFSG}. 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. 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 Typically, the device will appear similar to \texttt{/dev/video0}. A camera
that works with the software isn't necessarily sensitive enough to detect that works with the software isn't necessarily sensitive enough to detect
satellites, however, as most are designed for bright environments. 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. 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 Recommended. Many non-Raspberry Pi devices are also compatible with the Pi
MIPI interface. MIPI interface.
\end{itemize} \end{description}
\end{mdframed} \end{mdframed}
Still cameras can also be used productively. The current \gls{Python} toolchain 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: See the list below for still camera options:
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30] \begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize} \begin{description}
\item \Glspl{telescope} --- Can definitely take images of \glspl{satellite}. \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. 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 The \gls{FOV} is generally too small. The mounts are optimized for
different types of tracking than satellites. This is changing, and longer different types of tracking than satellites. This is changing, and longer
term could be well-supported. Using \gls{RASA} style \glspl{astrograph} term could be well-supported. Using \gls{RASA} style \glspl{astrograph}
is likely the best option. 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. associated instrumentation, such as tracking mounts and cameras.
Cannot be used directly with the current developing \gls{SatNOGS} toolchain. 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 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, running a tracking mount with KStars and Ekos, for example,
in lieu of a better option. Camera software in the \gls{INDI} platform typically in lieu of a better option. Camera software in the \gls{INDI} platform typically
produce image \gls{FITS} files. 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}. used with gphoto tools and drivers, available in \gls{Debian}.
This is the recommended option at present for still cameras. This is the recommended option at present for still cameras.
\gls{DSLR} cameras, such as from major manufacturers Canon and Nikon, are \gls{DSLR} cameras, such as from major manufacturers Canon and Nikon, are
used with gphoto. used with gphoto.
\end{itemize} \end{description}
\end{mdframed} \end{mdframed}
Considering the hardware options above, they need to be matched with 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: There are also broader ``paths'' that need to be considered:
\begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30] \begin{mdframed}[backgroundcolor=blue!10,linecolor=blue!30]
\begin{itemize} \begin{description}
\item \gls{sattools} --- Deprecated because it is in \gls{C}, and the \item [\gls{sattools}] --- Deprecated because it is in \gls{C}, and the
decision was made to move forward with applications primarily decision was made to move forward with applications primarily
written in \gls{Python}. \Gls{sattools} is the most complete toolkit, 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 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 be used for now. It can be used with motion video cameras and
still cameras. It includes many other software tools related to still cameras. It includes many other software tools related to
\glspl{satellite}. \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 is available. It is in \gls{Python} and is the tool the
\gls{SatNOGS-Optical} project is using as the basis for future development. \gls{SatNOGS-Optical} project is using as the basis for future development.
It still depends on some \gls{C} tools from \gls{sattools}. It still depends on some \gls{C} tools from \gls{sattools}.
\item \texttt{stphot} --- Written in \gls{Python} this is what the \item [\texttt{stphot}] --- Written in \gls{Python} this is what the
\gls{SatNOGS-Optical} project will likely use in the future. \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) It is in very early development, but can acquire data (take photos)
with gphoto-compatible cameras. 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} 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 application is in pre-development, but is in \gls{Python} and could be
the basis for future \gls{SatNOGS-Optical} development. the basis for future \gls{SatNOGS-Optical} development.
The difficulty with all sky cameras is the \gls{plate-solver} isn't 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. 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 packges freely available on the Internet. Many could be adapted for
usage. usage.
\end{itemize} \end{description}
\end{mdframed} \end{mdframed}

View File

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