From d712103a75184d3f761719f7daf0fccedbfd7a96 Mon Sep 17 00:00:00 2001
From: Jan Grewe <jan.grewe@g-node.org>
Date: Wed, 8 Nov 2017 17:37:58 +0100
Subject: [PATCH] [plotting] subplots done

---
 .../lecture/images/irregular_subplots.pdf     | Bin 2081 -> 0 bytes
 plotting/lecture/plotting.tex                 |  65 ++++++++++++++++--
 2 files changed, 58 insertions(+), 7 deletions(-)
 delete mode 100644 plotting/lecture/images/irregular_subplots.pdf

diff --git a/plotting/lecture/images/irregular_subplots.pdf b/plotting/lecture/images/irregular_subplots.pdf
deleted file mode 100644
index b4daf2d73407e19c910df599ac116d2e53770716..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2081
zcmbtVYfuwc6jo5NTd+<m^@Vz62rt3x=1DYSA<HV_140CpGG$2?SV(qZlkiYzYf&Cr
z90eb>Q0+KS8S#w|#0pw<bflohqE%EtsUV7oRBa&G?jles&a^Y#Kbia8bMJS~cXGbV
z3q&zbWVQ(6?JeE6A3^{O=%_eIE{FJm46QM$2?n_OB;e{;0$|GmK?uR<NtyzJ*@D@y
zXYf*=z~F_;RC54(4N9wxI)XARVDN-kQmq%DZV+F=5V(OofZ_%MxT13eFd{_|SSk=A
z5`ot&7;%AN7dOb;8zLwT$1E7k0Pq(RRE!}O2w6x8_!y}*u-Wi2EqfPAsA&xW*mHUV
zOQC~O3XgrWgr0!dW_FnEWnTp<o}_iJM>o4CmW1Uf>OQ&}QnEoc+mc?Wan8T1%la<w
z=-&JO$z4td+t2TC8L8~*@QWLtVL3i=<;aRVr^4>^I_);y9@Sow=HluIPNX@CSL52a
z8TtY&Z9+gn_l)zQof{6nvRK?+)$FqLD(>Yx7Jd>@son2X>TqS!rydX0l9@GI|17At
zNxWC$v9(xUygE@|o!&6|@~q6>=BoKtM=ch4XTX)F)XP1DT}0N-=$#%)`IMl9%2}gC
zs`NY=B#fVb5+5J^5{nC3aW1=cN%GnC7xNKFxtoMaeKuwM(dKY!!RzVUCTD)E!<vul
z-5vCc8nO@R+^nbF4>~F9so1dXld?FQqSr?}SD2W+2_1Zy&oL8|eDRE+v9~(%Yb@1f
z%<23!E*ml(zU(9=Gm@$|r#BVjHA$;eyRfRQCzxcO_tWRQCCEOboP@_+I)F6JpCqri
zA8F;A6>qDZ%-+|nt<&Y&J03h+5Sfuv`o8J8xvnr=S~Rm|%gr_QZdA1*DYbjytF|T{
zbrJj^GjA{ceOmg`)$YsJ)>#z4+Gi}?)4X$G*L4u~AiHg=Pf1&$_L=O7a4nX-T~;=4
z>~i(K%zAJ&=#Ft?Ta065<UQ1Vig|?ER5g9OCwV4uMaIeBY>jqVp|#bm+AkhKdqZM9
zORG|J504gMm38?ax~^O|-kOZ5o$KCdT)>-{Uvk(PJMvhTbHT>EO7(MXXnQcz;6C{S
zX1a~aLX5sO7P3BdE2`x*uesIZ`)+vb@$#s|YM^?sOJkMzUd<%+oT^2x>uXBPi4zXk
z9h;J}=TPo;y9a@5q~9jvd5vn-jUZ9cIsYBC7s@}stFzws((FFMIkU{IpkwNd468~H
zb7SwVEx85tH=5h4#D&hLGwl~q`%N8X%}+Mzewn)NX|~X~@%G_xQ&`KhP6v6Alil45
z1@g~c#ILX(CBL0EF4o5J_1pmKdhap0kM8ER^vr9xy+5hE`zhYllWV>HT8O#zT19#H
zOT262b!GPBMcdE?RTX(RE1O2xhWM2tj^!_SbwAZyN;Vz;F}`zRDhAEr2CaW)`bUnN
zFK+a_VA;SFiu$2&ZXA^n1F*OsX6*q0zLL<>Mn+BOfrN|VAXRDt0r-J<48g6I5E>Hq
zrBgsS%mxTWFc1i&5!{Y~p%dP@;j1MG%{zBg45@qPMj+0xt^=e4IVfn#zyf-}6`>qr
zEne)p-`oaM#n@mjp<rW_p)Yr?0)#_+aXrE90{%imn?x8$HO|3)6l**r6$AL8B;`Zt
z$pK&pk?j8xdHT{?&3|R%3V&19Q2q6+_tHi-eFWkMkQzM*=bEPk5u9iCHy+{I^0p!h
z+<<H87>=FmqyBGU7vpT%t|^{IDxRW~siCgT{Q(AY=o3vYXN?*GoaCH!3jwEzlI3P^
zWoUIUVF2NL_R#=*e;v!>+yARzOCVAVLz7Hlh-e4~2m--_ACQQ}LNSO2gBZeA$9;er
z#1PRi41on~M*oaMU=gd}+nAJ<<}FMD504W`hjR!d!_NvO!{fw4cJKx`3=B?c35I)k
zS>cs5%{GqfPTy4dQ_(cwp5`|z6okutMM8;Gh+<+Xih7Aqu>w<IB7s1NN`!tgKN;c;
g{yn5`5`)QA1Sf9aONujwKDiNz%nRc2{FY(RUz)b(`2YX_

diff --git a/plotting/lecture/plotting.tex b/plotting/lecture/plotting.tex
index b66c39a..b42994b 100644
--- a/plotting/lecture/plotting.tex
+++ b/plotting/lecture/plotting.tex
@@ -434,20 +434,71 @@ the last one defines the output format (box\,\ref{graphicsformatbox}).
   efficient.
 \end{ibox}
 
-\lstinputlisting[caption={Skript zur Erstellung des Plots in
+\lstinputlisting[caption={Script for creating the plot shown in
     \figref{spikedetectionfig}.},
   label=niceplotlisting]{automatic_plot.m}
 
-Next to the standard line plots there are many more options to display
-scientific data. Mathworks shows various examples and the respective
-code on their website
-\url{http://www.mathworks.de/discovery/gallery.html}.
-
 
 \section{Plot examples}
-So far we have introduced the simple line plots. 
+
+So far we have introduced the standard line plots. Next to these there
+are many more options to display scientific data. Mathworks shows
+various examples and the respective code on their website
+\url{http://www.mathworks.de/discovery/gallery.html}.
+
+For some types of plots we present examples in the following sections.
 
 \subsection{Line plot, subplots}
+A very common scenario is to combine several plots in the same
+figure. To do this we create so-called subplots
+figures\,\ref{regularsubplotsfig},\,\ref{irregularsubplotsfig}. The
+\code[subplot()]{subplot()} command allows to place multiple axes onto
+a single paper. Generally, \varcode{subplot} expects three argument
+defining the number of rows, column, and the currently active
+plot. The currently active plot number starts with 1 and goes up to
+$rows \cdot columns$ (numbers in the subplots in
+figures\,\ref{regularsubplotsfig}, \ref{irregularsubplotsfig}).
+
+\begin{figure}[t]
+  \includegraphics[width=0.5\linewidth]{regular_subplot}
+  \titlecaption{Subplots placed on a regular grid.}{By default all
+    subplots have the same size. See
+    listing\,\ref{regularsubplotlisting}. Subplot labeling has been
+    created using the \code[text()]{text()} annotation function (see
+    also below).}\label{regularsubplotsfig}
+\end{figure}
+
+\lstinputlisting[caption={Script for creating subplots in a regular
+    grid \figref{regularsubplotsfig}.}, label=regularsubplotlisting,
+  basicstyle=\ttfamily\scriptsize]{regular_subplot.m}
+
+By default, all suplots have the same size, if something else is
+desired, e.g., one suplot should span a whole row, while two others
+are smaller and placed side by side in the same row, the third
+argument of \varcode{subplot} can be a vector or numbers that should
+be joined. These have, of course, be adjacent numbers
+(\figref{irregularsubplotsfig},
+listing\,\ref{irregularsubplotslisting}).
+
+\begin{figure}[ht]
+  \includegraphics[width=0.5\linewidth]{irregular_subplot}
+  \titlecaption{Subplots of different size.}{The third argument of
+    \varcode{subpot} may be a vector of cells that should be joined
+    into the same subplot. See
+    listing\,\ref{irregularsubplotslisting}}\label{irregularsubplotsfig}
+\end{figure}
+
+Not all cells of the grid, defined by the number of rows and
+columns, need to be used in a plot. If you want to create something
+more elaborate, or have more spacing between the subplots one can
+create a grid with larger numbers of columns and rows, and specify the
+used cells of the grid by passing a vector as the third argument to
+\varcode{subplot}.
+
+\lstinputlisting[caption={Script for creating subplots of different
+    sizes \figref{irregularsubplotsfig}.},
+  label=irregularsubplotslisting,
+  basicstyle=\ttfamily\scriptsize]{irregular_subplot.m}
 
 \subsection{Annotations, text}