More acronyms, glossary entries

glossary
Jeff Moe 2022-08-27 23:44:59 -06:00
parent 9eb2c1f1d1
commit cc22f2b570
6 changed files with 90 additions and 44 deletions

View File

@ -20,7 +20,7 @@
{LSF}{LSF}{Libre Space Foundation}
\newacronym[
description={Radio frequency is the oscillation rate of an alternating electric current or voltage or of a magnetic, electric or electromagnetic field or mechanical system in the frequency range from around 20 kHz to around 300 \gls{GHz}. This is roughly between the upper limit of audio frequencies and the lower limit of infrared frequencies; these are the frequencies at which energy from an oscillating current can radiate off a conductor into space as radio waves.%
description={Radio frequency is the oscillation rate of an alternating electric current or voltage or of a magnetic, electric or electromagnetic field or mechanical system in the frequency range from around 20 \gls{kHz} to around 300 \gls{GHz}. This is roughly between the upper limit of audio frequencies and the lower limit of infrared frequencies; these are the frequencies at which energy from an oscillating current can radiate off a conductor into space as radio waves.%
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=Radio_frequency&oldid=1104615064}}}
}]
{RF}{RF}{radio frequency}
@ -44,23 +44,26 @@
{ITU}{ITU}{International Telecommunication Union}
\newacronym[
description={$10^9$ \gls{Hz}%
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=Hertz&oldid=1106873799}}}
description={is an extensive collection of free software, which can be used as an operating system or can be used in parts with other operating systems. The use of the completed GNU tools led to the family of operating systems popularly known as \gls{Linux}. Most of GNU is licensed under the GNU Project's own \gls{GPL}. GNU is also the project within which the free software concept originated.%
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=GNU&oldid=1103488294}}}
}]
{GHz}{GHz}{gigahertz}
{GNU}{GNU}{GNU's Not Unix!}
\newacronym[
description={$10^6$ \gls{Hz}%
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=Hertz&oldid=1106873799}}}
description={is a series of widely used free software licenses that guarantee end users the four freedoms to run, study, share, and modify the software. The license was the first copyleft for general use. Historically, the GPL license family has been one of the most popular software licenses in the free and open-source software domain%
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=GNU_General_Public_License&oldid=1106596497}}}
}]
{MHz}{MHz}{megahertz}
{GPL}{GPL}{GNU General Public License}
% XXX not appearing ?
\newacronym[
description={The hertz is the unit of frequency in the \gls{SI}, equivalent to one event (or cycle) per second. The hertz is an \gls{SI} derived unit whose expression in terms of \gls{SI} base units is s1, meaning that one hertz is the reciprocal of one second.%
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=Hertz&oldid=1106873799}}}
}]
{Hz}{Hz}{hertz}
\newacronym{Hz}{Hz}{hertz}
\newacronym{kHz}{kHz}{kilohertz}
\newacronym{MHz}{MHz}{megahertz}
\newacronym{GHz}{GHz}{gigahertz}
\newacronym{DSLR}{DSLR}{digital single-lens reflex}
\newacronym{PoE}{PoE}{Power over Ethernet}
\newacronym{GNSS}{GNSS}{Global Navigation Satellite System}
\newacronym{GPS}{GPS}{Global Positioning System}
\newacronym{IP67}{IP67}{Ingress Protection code 67}
\newacronym[
description={The International System of Units, known by the international abbreviation SI in all languages and sometimes pleonastically as the SI system, is the modern form of the metric system and the world's most widely used system of measurement. Established and maintained by the General Conference on Weights and Measures (CGPM), it is the only system of measurement with an official status in nearly every country in the world, employed in science, technology, industry, and everyday commerce.%
@ -86,10 +89,24 @@ These mounts are used, for example, with telescopes, cameras, and radio antennas
{ name={artificial satellite},
description={Satellite launched by teh hoomans}}
\newglossaryentry{satpredict}
{ name={satpredict},
description={Software application to compute satellite predictions%
\footnote{\scriptsize{\url{https://github.com/cbassa/satpredict}}}
}}
\newglossaryentry{stvid}
{ name={stvid},
description={Satellite tools video application for acquiring and processing
sky images}}
sky images%
\footnote{\scriptsize{\url{https://github.com/cbassa/stvid}}}
}}
\newglossaryentry{hough3d-code}
{ name={hough3d-code},
description={Software application for Iterative Hough Transform for Line Detection in 3D Point Clouds%
\footnote{\scriptsize{\url{https://gitlab.com/pierros/hough3d-code}}}
}}
\newglossaryentry{ground-station}
{ name={ground station},
@ -134,3 +151,34 @@ These mounts are used, for example, with telescopes, cameras, and radio antennas
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=Antenna_rotator&oldid=1064620974}}}
}}
\newglossaryentry{Debian}
{ name={Debian},
description={a \gls{GNU}/\gls{Linux} distribution composed of free and open-source software, developed by the community-supported Debian Project, which was established by Ian Murdock on August 16, 1993. Debian is the basis for many other distributions, notably Ubuntu.
Debian is one of the oldest operating systems based on the Linux kernel.%
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=Debian&oldid=1105900486}}}
}}
\newglossaryentry{Linux}
{ name={Linux},
description={is a free and open-source, monolithic, modular, multitasking, Unix-like operating system kernel. It was originally authored in 1991 by Linus Torvalds for his i386-based PC, and it was soon adopted as the kernel for the \gls{GNU} operating system, which was written to be a free (libre) replacement for Unix.%
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=Linux_kernel&oldid=1105840074}}}
}}
\newglossaryentry{open-source}
{ name={Open Source},
description={is source code that is made freely available for possible modification and redistribution. Products include permission to use the source code, design documents, or content of the product. The open-source model is a decentralized software development model that encourages open collaboration. A main principle of open-source software development is peer production, with products such as source code, blueprints, and documentation freely available to the public. The open-source movement in software began as a response to the limitations of proprietary code. The model is used for projects such as in open-source appropriate technology%
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=Open_source&oldid=1103126225}}}
}}
\newglossaryentry{free-software}
{ name={Free Software},
description={or libre software, is computer software distributed under terms that allow users to run the software for any purpose as well as to study, change, and distribute it and any adapted versions. Free software is a matter of liberty, not price; all users are legally free to do what they want with their copies of a free software (including profiting from them) regardless of how much is paid to obtain the program. Computer programs are deemed ``free'' if they give end-users (not just the developer) ultimate control over the software and, subsequently, over their devices.%
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=Free_software&oldid=1106538260}}}
}}
\newglossaryentry{Matrix}
{ name={Matrix},
description={an open standard and communication protocol for real-time communication
\footnote{\scriptsize{\url{https://en.wikipedia.org/w/index.php?title=Matrix_(protocol)&oldid=1106244486}}}
}}

View File

@ -42,8 +42,8 @@ Cameras being tested:
\begin{itemize}
\item The Imaging Source IMX174 based. \index{The Imaging Source}\index{IMX174}
\item ZWO ASI IMX174 based mono. \index{ZWO ASI}
\item DSLR. \index{DSLR}
\item ZWO ASI IMX174 based monochrome. \index{ZWO ASI}
\item \gls{DSLR} camera. \index{DSLR}
\end{itemize}
\fbox{
@ -81,7 +81,7 @@ Computers, such as Raspberry Pi, that can be used.
\end{itemize}
\subsection{Comparison}
Comparing embedded computers for SatNOGS Optical.
Comparing embedded computers for \gls{SatNOGS-Optical}.
\begin{center}
\hspace*{-1.5cm}\begin{tabular}{||c c c c c||}
@ -97,7 +97,7 @@ Comparing embedded computers for SatNOGS Optical.
\section{Example Tracking Ground Station}
\label{sec:hardware-tracking-ground-station}
This is an example of a tracking ground station.
This is an example of a tracking \gls{ground-station}.
It is a prototype, so there are lots of mis-matched,
overbuilt/underbuilt parts.
The full setup on tripod, can be seen in
@ -106,22 +106,22 @@ The full setup on tripod, can be seen in
A close up of the setup can be seen at
\ref{fig:video-enclosure-mount}, page \pageref{fig:video-enclosure-mount},
showing the Skywatcher telescope tracking mount,
a Bosch PoE camera enclosure,
a Bosch \gls{PoE} camera enclosure,
and through the glass the camera lens.
\index{Skywatcher}\index{telescope}\index{mount}\index{Bosch}\index{PoE}\index{camera}
In the background is a white antenna for GNSS (GPS) and a solar power setup.
\index{GNSS}
In the background is a white antenna for \gls{GNSS} (\gls{GPS}) and a solar power setup.
\index{GNSS}\index{GPS}\index{solar power}
\begin{figure}[h!]
\begin{center}
\includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{video-enclosure-mount-web.png}
\caption{SatNOGS Optical ground station prototype.}
\caption{\gls{SatNOGS-Optical} \gls{ground-station} prototype.}
\label{fig:video-enclosure-mount}
\index{telescope}\index{mount}\index{camera}
\end{center}
\end{figure}
The camera lens is protected by the enclosure glass, which is IP67 (XXX) rated.
The camera lens is protected by the enclosure glass, which is \gls{IP67} (XXX) rated.
See a close up of the front of the enclosure and camera lens in figure
\ref{fig:video-enclosure-front}, page \pageref{fig:video-enclosure-front}.
@ -182,17 +182,17 @@ is:
\begin{itemize}
\item The Imaging Source DMX camera with Sony IMX174 CMOS. \index{The Imaging Source}\index{IMX174}
\item Kowa 50mm f1.4 C-mount lens.\index{Kowa}
\item Odroid N2 running Debian. \index{Odroid}\index{Debian}
\item Odroid N2 running \gls{Debian}. \index{Odroid}\index{Debian}
\item Odroid N2 plastic enclosure, large half, hole drilled for ad-hoc mounting.
\item Blower fan on top, with power cable (came with Bosch enclosure). \index{fan}
\item Fan, maybe not so useful, with power cable (came with Bosch enclosure).
\item Camera mounting plate (came with Bosch enclosure). \index{camera}
\item Camera mounting screws, M6x25 (?).
\item Ethernet cable, internal, short white (came with Bosch enclosure). \index{ethernet}
\item PoE ethernet cable, external, plugged into PoE switch for data and power. \index{PoE}
\item \gls{PoE} ethernet cable, external, plugged into \gls{PoE} switch for data and power. \index{PoE}
\item USB 3 cable, internal, way too long, needs replacing, from Odroid to camera. XXX flat connector
\item USB 3 cable, external, from Odroid to telescope mount. XXX large rectangle connector \index{USB}
\item ``Custom'' 12V DC power cable from Bosch PoE to Odroid.
\item ``Custom'' 12V DC power cable from Bosch \gls{PoE} to Odroid.
\item Assorted nuts, bolts, and washers for an ad-hoc standoff height.
\end{itemize}
\begin{figure}[h!]

View File

@ -12,9 +12,9 @@
\section{Introduction}
\index{Libre Space Foundation}
The SatNOGS Optical Unofficial Guide documents how to set up and run an
optical ground station for the Libre Space Foundation's SatNOGS network.
The Libre Space Foundation supports
``free and accessible space for all, creating Open Source space technologies.''%
\gls{optical-ground-station} for the \gls{LSF}'s \gls{SatNOGS} network.
The \gls{LSF} supports
``free and accessible space for all, creating \gls{open-source} space technologies.''%
\footnote{\scriptsize{\url{https://libre.space}}}
\index{Open Source}

View File

@ -12,13 +12,13 @@
\section{Overview of Operation}
\label{sec:overview-operation}
\index{operation}
HOWTO run a SatNOGS Optical ground station,
HOWTO run a \gls{SatNOGS-Optical} \gls{ground-station},
after it has been set up and congfigured.
\section{Acquire Data with \texttt{stvid}}
\index{stvid}\index{acquire}
Acquire data with \texttt{acquire.py} from \texttt{stvid}.
Acquire data with \texttt{acquire.py} from \texttt{\gls{stvid}}.
Enter \texttt{virtualenv}, if used:
\begin{minted}{sh}
@ -42,10 +42,9 @@ cd stvid/
./acquire.py
\end{minted}
\begin{figure}[h!]
\includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{stvid-acquire-0.png}
\caption{Satellite images acquired by stvid.}
\caption{Satellite images acquired by \gls{stvid}.}
\label{fig:stvid-acquire}
\index{stvid}\index{acquire}
\end{figure}
@ -53,14 +52,13 @@ cd stvid/
\section{Process Data}
\index{stvid}\index{process}
Process data with using stvid. Adjust dated directory to actual directory name.
Process data with using \gls{stvid}. Adjust dated directory to actual directory name.
\begin{minted}{sh}
cd stvid/
./process_new.py -c config_new.ini -d data/obs/20220825_1/020502/
\end{minted}
\begin{figure}[h!]
\includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{stvid-process-0.png}
\caption{Satellite images processed by stvid.}
@ -72,5 +70,5 @@ cd stvid/
\section{Upload Data}
\index{upload}
Push.
The SatNOGS network isn't ready for optical data yet.
The \gls{SatNOGS} network isn't ready for optical data yet.

View File

@ -12,15 +12,15 @@
\section{Setup Optical Ground Station Software}
\label{sec:overview-setup}
\index{software}
HOWTO set up and configure a SatNOGS Optical ground station.
HOWTO set up and configure a \gls{SatNOGS-Optical} \gls{ground-station}.
Setup an embedded computer, such as an Odroid N2, with Debian stable
Setup an embedded computer, such as an Odroid N2, with \gls{Debian} stable
(11/Bullseye) or testing (Bookworm).
\index{computer}\index{Odroid}\index{Debian}
See each repository for latest documentation.
Install dependencies from Debian repository:
Install dependencies from \gls{Debian} repository:
\begin{minted}{sh}
sudo apt update
@ -32,7 +32,7 @@ sudo apt install python3-virtualenv python3-pip python3-dev \
astrometry-data-tycho2-10-19
\end{minted}
Next, install the \texttt{hough3d-code} dependency.
Next, install the \texttt{\gls{hough3d-code}} dependency.
\index{hough3d}
\begin{minted}{sh}
@ -42,7 +42,7 @@ make all
sudo cp -p hough3dlines /usr/local/bin/hough3dlines
\end{minted}
Install \texttt{satpredict} from using either the cbassa or spacecruft repo.
Install \texttt{\gls{satpredict}} from using either the cbassa or spacecruft repo.
\index{satpredict}
\begin{minted}{sh}
@ -93,7 +93,7 @@ numpy in the virtualenv thusly:
pip install --upgrade --ignore-installed numpy
\end{minted}
Debian in bug \texttt{\#941466} changed the name of the
\gls{Debian} in bug \texttt{\#941466} changed the name of the
\texttt{sextractor} dependency to \texttt{source-extractor},
so a symlink is needed for now:
\index{Debian}

View File

@ -19,7 +19,7 @@
How to get help.
\begin{itemize}
\item \texttt{\#satnogs-optical} channel in Matrix --- \url{\#satnogs-optical:matrix.org}
\item Libre Space Foundation Community Forum --- \url{https://community.libre.space}
\item \texttt{\#satnogs-optical} channel in \gls{Matrix} --- \url{\#satnogs-optical:matrix.org}
\item \gls{LSF} Community Forum --- \url{https://community.libre.space}
\end{itemize}