From 1290ee1dff0191b280558da4afe345094b8a431f Mon Sep 17 00:00:00 2001
From: tth <sigfood@dinorama.fr>
Date: Wed, 20 Feb 2019 16:12:15 +0100
Subject: [PATCH] + exemple gnuplot / + format flatfile

---
 doc/dd2-monitoring.tex | 62 ++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 60 insertions(+), 2 deletions(-)

diff --git a/doc/dd2-monitoring.tex b/doc/dd2-monitoring.tex
index d5ac234..3ae1300 100644
--- a/doc/dd2-monitoring.tex
+++ b/doc/dd2-monitoring.tex
@@ -1,4 +1,3 @@
-
 \documentclass[a4paper,11pt]{article}
 
 % \listfiles              % pour le debug
@@ -50,13 +49,14 @@ de découvrir plein de capteurs différents : température, humidité,
 
 \setlength{\parskip}{0.05cm plus 0.05cm}
 \tableofcontents
-\setlength{\parskip}{0.21cm plus 0.21cm}
+\setlength{\parskip}{0.16cm plus 0.16cm}
 
 \vspace{5cm}
 
 Bonne lecture.
 
 % -------------------------------------------------------------------
+% ===================================================================
 
 \pagebreak
 \section{Présentation générale}
@@ -95,6 +95,7 @@ tentent de s'échapper.
 Pour entreposer toutes ces valeurs numériques, il existe plusieurs
 choix, et nous allons en évaluer quelques uns :
 
+\texttt{flatfile}\index{flatfile} (page \pageref{flatfile}),
 \texttt{rrdb}\index{rrdb} (page \pageref{rrdb}),
 \texttt{influxdb}\index{Influxdb} (page \pageref{influxdb}),
 \texttt{gnocchi}\index{Gnocchi} (page \pageref{gnocchi})
@@ -114,6 +115,7 @@ d'eyecandy\index{eyecandy} ne peut pas faire de mal.
 C'est expliqué à la page \pageref{eyecandy}\index{curses}.
 
 % -------------------------------------------------------------------
+% ===================================================================
 \section{Outils}
 
 \subsection{Simulations}
@@ -128,6 +130,7 @@ Nous avons également un générateur de nombres divers et incohérents
 qui envoie des quadruplets d'entiers 10 bits précédés d'un caractere
 de bonne efficacité.
 
+% -------------------------------------------------------------------
 
 \subsection{Exemples}
 
@@ -142,6 +145,7 @@ par un port série (page \pageref{serialcode}).
 Pour continuer dans une démarche disruptive, des outils
 avancés de visualisation sont proposés dans la rubrique
 \ref{eyecandy} qui parle de \texttt{vt100}\label{vt100}.
+% -------------------------------------------------------------------
 
 \subsection{Analyses}
 
@@ -162,6 +166,7 @@ Générer des formes d'ondes spatialisables ?
 Déplacer des petites \textit{bubulles} colorées ?
 Une histoire pour la section \pageref{detournements} ?
 
+% -------------------------------------------------------------------
 
 \subsection{Archivage} \index{archivage} \label{archivage}
 
@@ -184,6 +189,36 @@ si on lui demande gentiment.
 
 % -------------------------------------------------------------------
 
+\subsection{Affichage}\index{affichage}
+
+Un exemple d'affichage avec Gnuplot\index{gnuplot} d'un fichier
+de température (décrit page \pageref{foo.dat}) :
+
+\begin{verbatim}
+DATAFILE="foo.dat"
+IMAGE="graphe.png"
+
+gnuplot << __EOC__
+set term png    size 4200,640
+set output      "${IMAGE}"
+set grid
+set title       "Temperature dans le Double Dragon 2"
+set xdata       time
+set timefmt     "%s"
+set format x    "%d, %H:%M:%S"
+set yrange [ 0.0 : 30.0]
+plot "${DATAFILE}" using 1:2 title " foo" with lines, \
+     "${DATAFILE}" using 1:3 title " bar" with lines, \
+     "${DATAFILE}" using 1:4 title "quux" with lines, \
+     "${DATAFILE}" using 1:5 title "booz" with lines
+__EOC__
+
+\end{verbatim}
+
+
+
+% ===================================================================
+
 \section{Configuration} \index{configuration} \label{configuration}
 
 Pour adapter cet outil de surveillance aux variations du monde réel,
@@ -208,6 +243,29 @@ eyecandy_banner         s       hacked by tTh
 
 Certains de ces paramètres pourront être surchargé par des options
 de la ligne de commande\index{cli} ou des variables d'environnement.
+% ===================================================================
+
+\section{Flatfile} \label{flatfile}
+
+Parfois, un fichier à plat est bien pratique, parce qu'il est facilement
+machinable avec des outils comme Awk\index{Awk}.
+Après tout, un \textsl{timestamp}\index{timestamp} et quelques valeurs
+numériques peuvent suffire à beaucoup de \textsl{usecases} de la
+vie courante.
+
+Voici un exemple, un format\label{foo.dat} d'enregistrement de
+température facilement  exploitable avec Gnuplot :
+
+\begin{verbatim}
+tth@phytotron:~/DD2-monitor/doc$ tail -3 ../serial/foo.dat
+1550673785 20.215054 20.107527 20.107527 20.215054
+1550673811 20.215054 20.215054 20.215054 20.215054
+1550673836 20.215054 20.107527 20.215054 20.215054
+\end{verbatim}
+
+Prochainement, dès que le premier prototype matériel fournira des
+données, une tentative de visualisation animée sera faite avec 
+POVray\index{POV}.
 
 % -------------------------------------------------------------------
 \section{RRDB} \label{rrdb}