diff --git a/README.md b/README.md index 3ef1510..993a679 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,10 @@ for download in the Releases section of the source code archive: * https://spacecruft.org/spacecruft/SNOUG/releases -To build the PDF from the LaTeX source code, see the `BUILD.md` document. + +# Build from Source +To build the PDF documentation from the LaTeX source code, +see the `BUILD.md` document. # License diff --git a/TODO.md b/TODO.md index c1ea322..7a50619 100644 --- a/TODO.md +++ b/TODO.md @@ -5,4 +5,6 @@ * Lists/tables in boxes (?). * Better tables. * See also for acronyms, index, glossary. +* Using ps2pdf to resize PDF for web breaks internal links. * Content. +* Tracking. diff --git a/src/Glossary.tex b/src/Glossary.tex index a92a8a7..713c6f8 100644 --- a/src/Glossary.tex +++ b/src/Glossary.tex @@ -211,3 +211,12 @@ % CCD % photon % giza (pgplot?) +% orbit +% decay +% libre +% astrometry.net +% astap +% Source Extractor +% Watney +% WCS +% PiCamera diff --git a/src/Ground_Stations.tex b/src/Ground_Stations.tex index 5c96842..93e6fe2 100644 --- a/src/Ground_Stations.tex +++ b/src/Ground_Stations.tex @@ -31,12 +31,25 @@ It shows a \gls{SatNOGS} \gls{ground-station} with \gls{VHF} (right) and \gls{UH \begin{figure}[h!] \begin{center} \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{spacecruft-rotator.png} - \caption{SatNOGS Ground Station with antennas.} + \caption{SatNOGS ground station with antennas.} \label{fig:spacecruft-rotator} \index{radio}\index{RF}\index{rotator}\index{antenna}\index{ground-station} \end{center} \end{figure} +Ground stations can be viewed on the SatNOGS network website, such as +XXX ref. + +%https://network.satnogs.org/stations/2733/ +\begin{figure}[h!] + \begin{center} + \includegraphics[keepaspectratio=true,height=0.40\textheight,width=1.00\textwidth,angle=0]{satnogs-ground-station-web.png} + \caption{Ground station viewed on SatNOGS website, example.} + \label{fig:satnogs-ground-station-web} + \index{ground-station} + \end{center} +\end{figure} + \section{SatNOGS Optical Ground Stations} \index{ground station}\index{Libre Space Foundation} diff --git a/src/Hardware.tex b/src/Hardware.tex index c1d5cf6..4ac82d1 100644 --- a/src/Hardware.tex +++ b/src/Hardware.tex @@ -49,6 +49,7 @@ Cameras being tested: \item The Imaging Source IMX174 based. \index{The Imaging Source}\index{IMX174} \item ZWO ASI IMX174 based monochrome. \index{ZWO ASI} \item \gls{DSLR} camera. \index{DSLR} + \item PiCamera. \index{PiCamera} \end{itemize} \fbox{ diff --git a/src/Introduction.tex b/src/Introduction.tex index 5f3ad08..5dd123e 100644 --- a/src/Introduction.tex +++ b/src/Introduction.tex @@ -22,15 +22,20 @@ The SatNOGS Optical Unofficial Guide documents how to set up and run an \section{Unofficial Guide Overview} -First, an overview of the this text, then the \gls{LSF}, -some of it's key projects, such as the \gls{SatNOGS} network. - +First, an overview of the this text, then the \gls{LSF} +and some of it's key projects, such as the \gls{SatNOGS} network. +A cursory review of satellites and existing \gls{RF} ground stations +will be followed by a big picture view of acquiring and processing +images of satellites. Hardware is reviewed, then software to run +on it, with many options, including what is best. Finally, +what to do with the data (idk!). +The chapters that follow are listed below. % Perhaps more LaTeXy ref XXX \begin{itemize} \item Satellites --- What are we looking at? \item Ground Stations --- How Earth talks to satellites and back. - \item SatNOGS Optical Process Overview --- 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 for use on the distributed network. \item Hardware --- Details on appropriate hardware configurations, diff --git a/src/SNOUG.tex b/src/SNOUG.tex index 703b3c1..8028548 100644 --- a/src/SNOUG.tex +++ b/src/SNOUG.tex @@ -334,9 +334,9 @@ leftmargin=1cm,rightmargin=1cm % Comment out a line to not render that chapter \chapterconf{Satellites}{Satellites}{Artificial Satellites in Space} \chapterconf{Ground_Stations}{Ground Stations}{Looking up from Earth} -\chapterconf{SatNOGS_Optical}{SatNOGS Optical Process Overview}{Network of Optical Ground Stations for Satellites} +\chapterconf{SatNOGS_Optical}{Toolchain and Process}{Make Old Photons Useful Again} \chapterconf{Hardware}{Hardware}{Design and Set Up Equipment} -\chapterconf{Software}{Software}{Satellite Software} +\chapterconf{Software}{Software}{Satellite Applications on Earth} \chapterconf{Acquire}{Acquire}{Twinkle, Twinkle, Little Starlink} \chapterconf{Solve}{Solve}{Place from Pixels} \chapterconf{Detect}{Detect}{Find Satellites} diff --git a/src/Solve.tex b/src/Solve.tex index 5792cce..dc559d8 100644 --- a/src/Solve.tex +++ b/src/Solve.tex @@ -12,6 +12,80 @@ \section{Plate Solver} \label{sec:plate-solver} \index{plate solver} +A ``plate solver'' will take an image of stars and detect the time and place +of the picture. There are two main steps: -Description of plate solvers to follow. +\begin{enumerate} + \item Extract stars from an image, such as a \gls{FITS} file generated by \texttt{stvid}. + \item ``Solve'' the image of the stars in the image against vast databases of star images. +\end{enumerate} + +See below for a list of software tools that detect/extract stars from +images (e.g. \gls{FITS}). + +\begin{itemize} + \item Source Extractor. + \item XXX Kstars with ekos adds \texttt{Internal SEP}. + \item XXX Kstars with ekos adds \texttt{Builtin method for solver}. +\end{itemize} +\index{Souce Extractor}\index{Kstars}\index{ekos} + +See below for a list of plate solvers than can be used. + +\begin{itemize} + \item astrometry.net locally. + \item astrometry.net Internet. + \item astap. + \item Watney. +\end{itemize} +\index{astrometry.net}\index{astap}\index{Watney} + + +\section{Source Extractor} +\index{Source Extractor} +\texttt{Source Extractor}, formerly \texttt{SExtractor} and some other names, +is an application to extract stars from images. The software has been +widely used for many years. + +\url{https://www.astromatic.net/software/sextractor} + + +\section{astrometry.net} +\index{astrometry.net} +Astrometry.net is a website and software that can be run locally to solve +a plate of stars that has been extracted from \texttt{Source Extractor}. XXX +\index{Source Extractor} + +% https://nova.astrometry.net/ +\begin{figure}[h!] + \includegraphics[keepaspectratio=true,height=1.10\textheight,width=1.00\textwidth,angle=0]{astrometry-web.png} + \caption{nova.astrometry.net website.} + \label{fig:astrometry-web-web} + \index{astrometry.net} +\end{figure} + +\fbox{ + \parbox{\linewidth}{ + \textcolor{red}{NOTICE:} \\ + Using astrometry.net online requires an account with non-libre services. + The astrometry.net software can be installed locally to avoid this. + \index{proprietary} + } +} + + +\section{Star Databases} +\index{star database} +To use a plate solver, you will need star databases. They can get large. +The \texttt{stvid} application includes a basic star database. +XXX The \texttt{4200} series is also recommended. + + +\section{World Coordinate System} +WCS info. XXX + + +\section{Plate Solving with \texttt{stvid}} +Use the \texttt{process.py} scripts described at XXX to solve plates +with \texttt{stvid}. diff --git a/src/figures/astrometry-web.png b/src/figures/astrometry-web.png new file mode 100644 index 0000000..6d5278f Binary files /dev/null and b/src/figures/astrometry-web.png differ diff --git a/src/figures/satnogs-ground-station-web.png b/src/figures/satnogs-ground-station-web.png new file mode 100644 index 0000000..e653481 Binary files /dev/null and b/src/figures/satnogs-ground-station-web.png differ