\ProvidesPackage{neuralnetwork}[2013/07/18 v1.0 Neural network diagrams, Mark Kuckian Cowan, [email protected]]

%
%  Available from github:
%    git clone https://github.com/battlesnake/neuralnetwork
%
%  Distributed under the terms of the GNU General Public License version 2 (GPL2)
%

\NeedsTeXFormat{LaTeX2e}

\RequirePackage{environ}
\RequirePackage{etoolbox}
\RequirePackage{xkeyval}
\RequirePackage{tikz}
\RequirePackage{algorithmicx}
\RequirePackage{mathtools}

\usetikzlibrary{shapes}

\newcommand{\nn@var}[1] {\@ifundefined{c@nn@#1@counter}{\newcounter{nn@#1@counter}}{\nn@set{#1}{0}}}
\newcommand{\nn@set}[2] {\setcounter{nn@#1@counter}{{#2}}}
\newcommand{\nn@get}[1] {\arabic{nn@#1@counter}}
\newcommand{\nn@inc}[1] {\stepcounter{nn@#1@counter}}
\newcommand{\nn@del}[1] {\stepcounter{nn@#1@counter}}

\define@key{network}{nodespacing} {\pgfmathsetlengthmacro\nn@nodespacing{#1}}
\define@key{network}{layerspacing} {\pgfmathsetlengthmacro\nn@layerspacing{#1}}
\define@key{network}{height} {\def\nn@height{#1}}
\define@key{network}{maintitleheight} {\pgfmathsetlengthmacro\nn@maintitleheight{#1}}
\define@key{network}{layertitleheight} {\pgfmathsetlengthmacro\nn@layertitleheight{#1}}
\define@boolkey{network}{toprow} {\ifKV@network@toprow\def\nn@toprow{1}\else\def\nn@toprow{0}\fi}
\define@key{network}{style} {\def\nn@style{#1}}
\define@key{network}{nodesize} {\pgfmathsetlengthmacro\nn@nodesize{#1}}
\define@key{network}{title} {\def\nn@maintitle{#1}}
\define@key{network}{titlestyle} {\def\nn@titlestyle{#1}}

\NewEnviron{neuralnetwork}[1][] {{%
\begingroup
\setkeys{network} {nodespacing=1.0cm, layerspacing=2.5cm, maintitleheight=2.5em, layertitleheight=2.5em, height=5, toprow=false, nodesize=17pt, style={}, title={}, titlestyle={}, #1}
\edef\nn@tikzpic@styled{\noexpand\begin{tikzpicture}[\nn@style]}
\nn@tikzpic@styled
 \tikzstyle{neuron}=[circle,fill=black!25,minimum size=\nn@nodesize,inner sep=0pt]
 \tikzstyle{input neuron}=[neuron, fill=green!50];
 \tikzstyle{output neuron}=[neuron, fill=red!50];
 \tikzstyle{hidden neuron}=[neuron, fill=blue!40];
 \tikzstyle{bias neuron}=[neuron, fill=yellow!50];
 \tikzstyle{layertitle} = [text width=\nn@layerspacing - (1 em), text centered];
 \tikzstyle{layertitlewide} = [layertitle, text width=\nn@layerspacing + (2 em)];
 \tikzstyle{linkstitle} = [text centered, fill=white, text=darkgray, fill opacity=0.45, text opacity=1.0, inner sep=2pt, ellipse];
 \tikzstyle{linklabel} = [rectangle, fill=white, text opacity=1.0, text=black, text centered, inner sep=0pt];
 \tikzstyle{link} = [->, shorten <=0pt, shorten >=1pt, node distance=\nn@layerspacing, thin, draw=black!45];
 \tikzstyle{networktitle} = [rectangle, text=black, text centered, inner sep=0pt];
 \nn@var{layerindex}
 \nn@var{lastlayerstart} \nn@var{thislayerstart}
 \nn@var{lastlayercount} \nn@var{thislayercount}
 \nn@var{lastlayerindex} \nn@var{thislayerindex}
 \def\nnlinkbasestyle{}
 \def\nnlinkextrastyle{}
 \def\nnlinklabelbasestyle{}
 \def\nnlinklabelextrastyle{}
 \newcommand{\nn@layerindex}{\nn@get{layerindex}}
 \hfuzz=\maxdimen
 %\tolerance=10000
 %\hbadness=10000
 \ifx\nn@maintitle\empty \def\nn@maintitleheight{0} \fi
 { \BODY }
 \ifx\nn@maintitle\empty {} \else
   \pgfmathsetlengthmacro{\nn@width} {\nn@layerspacing * (\nn@layerindex - 1)}
   \pgfmathsetlengthmacro{\nn@halfwidth} {\nn@width / 2}
   \edef\nn@gentitle{\noexpand\node[networktitle, \nn@titlestyle] (MAIN-TITLE) at (\nn@halfwidth, 0) {\noexpand\nn@maintitle};}
   \nn@gentitle
 \fi
\end{tikzpicture}
\endgroup
}}

% For some reason latex won't accept this, and spews out a dozen meaningless error messages.
% The Y version needs updating anyway to account for extra titles
%\newcommand{\nnGridX}[1] {\pgfmathsetlength{\temp}{(\nn@layerspacing * #1)}\temp}
%\newcommand{\nnGridY}[1] {\pgfmathsetlength{\temp}{(-\nn@nodespacing * #1 + \nn@titleheight)}\temp}

\newcommand{\nn@if} {\expandafter\ifstrequal\expandafter}

\newcommand{\nn@defaultnodetext}[2] {}
\newcommand{\setdefaultnodetext}[1] {\renewcommand{\nn@defaultnodetext}[2]{#1{##1}{##2}}}
\define@key{layer}{title} {\def\nn@layertitle{#1}}
\define@boolkey{layer}{widetitle} {\ifKV@layer@widetitle\def\nn@widetitle{1}\else\def\nn@widetitle{0}\fi}
\define@key{layer}{count} {\def\nn@nodecount{#1}}
\define@key{layer}{text} {\renewcommand{\nn@nodecaption}[2]{#1{##1}{##2}}}
\define@boolkey{layer}{bias} {\ifKV@layer@bias\def\nn@bias{1}\else\def\nn@bias{0}\fi}
\define@key{layer}{title} {\def\nn@layertitle{#1}}
\define@key{layer}{nodeclass} {\def\nn@nodeclass{#1}}
\define@boolkey{layer}{top} {\ifKV@layer@top\def\nn@top{1}\else\def\nn@top{0}\fi}
\define@key{layer}{biaspos} {\def\nn@biaspos{#1}}
\define@key{layer}{exclude} {\def\nn@exclude{#1}}
\define@key{layer}{titlestyle} {\def\nn@layertitlestyle{#1}}
\newcommand{\layer}[1][] {{%
 \newcommand{\nn@nodecaption}[2]{}
 \setkeys{layer} {title={}, titlestyle={}, count=5, text=\nn@defaultnodetext, nodeclass={hidden neuron}, biaspos=top, top=false, exclude={}, widetitle=false, #1}
 % Linkage stuff
 \nn@set{lastlayercount}{\nn@get{thislayercount}}
 \nn@set{lastlayerstart}{\nn@get{thislayerstart}}
 \nn@set{lastlayerindex}{\nn@get{thislayerindex}}
 % Get start index
 \pgfmathtruncatemacro{\nn@startindex} {1 - \nn@bias}
 % Get y-offset
 \pgfmathsetlengthmacro{\nn@titles} {\nn@maintitleheight + \nn@layertitleheight}
 \if \nn@top 1
   \pgfmathsetlengthmacro{\nn@offset} {\nn@titles}
   \def\nn@biaspos{top}
 \else
   \pgfmathsetlengthmacro{\nn@offset} {\nn@titles + \nn@nodespacing * (\nn@height - (1 + \nn@nodecount - \nn@startindex)) / 2}
 \fi
 % Get x-position
 \pgfmathsetlengthmacro{\nn@node@x} {\nn@layerspacing * \nn@layerindex}
 % Draw bias node if needed
 \pgfmathtruncatemacro{\nn@startindex@draw}{\nn@startindex}
 \if \nn@bias 1
   % Get xy-position of bias node and update position range for other nodes
   \newcommand{\nn@node@xb} {}
   \def\nn@bias@own@row{0}
   \nn@if{\nn@biaspos}{top} {
     \pgfmathsetlengthmacro{\nn@node@y} {-\nn@offset}
     \pgfmathsetlengthmacro{\nn@node@xb} {\nn@node@x}
     \def\nn@bias@own@row{1}
     \if \nn@toprow 1
       \def\nn@biaspos{top row}
     \fi
   }
   \nn@if{\nn@biaspos}{top row} {
     \pgfmathsetlengthmacro{\nn@node@y} {-\nn@titles}
     \pgfmathsetlengthmacro{\nn@node@xb} {\nn@node@x}
     \def\nn@bias@own@row{1}
   }
   % Does the bias node have its own row ("top" or "top row")?
   \nn@if{\nn@bias@own@row}{0} {
     \pgfmathsetlengthmacro{\nn@offset} {\nn@offset - (\nn@nodespacing / 2)}
     \pgfmathsetlengthmacro{\nn@node@y} {-(\nn@nodespacing * ((\nn@nodecount+1)/2 - \nn@startindex@draw) + \nn@offset)}
   }
   % Centered vertical position
   % The "dummy" line is necessary to overcome some LaTeX bug, the first line in the list below always seems to get ignored by the parser.
   \nn@if{\nn@biaspos}{dummy} { \pgfmathsetlengthmacro{\nn@node@xb} {\nn@node@x} }
   \nn@if{\nn@biaspos}{center} { \pgfmathsetlengthmacro{\nn@node@xb} {\nn@node@x} }
   \nn@if{\nn@biaspos}{center right} { \pgfmathsetlengthmacro{\nn@node@xb} {\nn@node@x + (1*\nn@layerspacing / 4)} }
   \nn@if{\nn@biaspos}{center left} { \pgfmathsetlengthmacro{\nn@node@xb} {\nn@node@x - (1*\nn@layerspacing / 4)} }
   \nn@if{\nn@biaspos}{center right right} { \pgfmathsetlengthmacro{\nn@node@xb} {\nn@node@x + (2*\nn@layerspacing / 3)} }
   \nn@if{\nn@biaspos}{center left left} { \pgfmathsetlengthmacro{\nn@node@xb} {\nn@node@x - (2*\nn@layerspacing / 3)} }
   % Error check
   \nn@if{\nn@node@xb}{} {
     \PackageError{neuralnetwork}{Unknown bias node position: "\nn@biaspos"}
   }
   % Draw node
   \node[bias neuron] (L\nn@layerindex-0) at (\nn@node@xb, \nn@node@y) {\nn@nodecaption{\nn@layerindex}{0}};
 \fi
 % Adjust unbiased layer if bias nodes have their own top row
 \if \nn@toprow 1
   \if \nn@bias 0
     \pgfmathsetlengthmacro{\nn@offset}{\nn@offset + \nn@nodespacing/2}
   \fi
 \fi
 % Draw nodes
 \foreach \nn@nodeindex in {1,...,\nn@nodecount} {
   % Get y-position
   \pgfmathsetlengthmacro{\nn@node@y} {-(\nn@nodespacing * (\nn@nodeindex - \nn@startindex@draw) + \nn@offset)}
   % Check if the node is excluded
   \def\nn@dontdraw{0}
   \foreach \nn@excluded in \nn@exclude
     \if \nn@excluded \nn@nodeindex \global\def\nn@dontdraw{1} \breakforeach \fi;
   % Draw node if not excluded
   \if \nn@dontdraw 0
     \node[\nn@nodeclass] (L\nn@layerindex-\nn@nodeindex) at (\nn@node@x, \nn@node@y) {\nn@nodecaption{\nn@layerindex}{\nn@nodeindex}};
   \fi
 }
 % Title
 %\if\relax\detokenize{\nn@layertitle}\relax \else
 \ifx\nn@layertitle\empty {} \else
   \edef\nn@layer@gentitle[##1]{\noexpand\node[##1, \nn@layertitlestyle] (T\nn@layerindex) at (\nn@node@x, \nn@maintitleheight) {\noexpand\nn@layertitle};}
   \if \nn@widetitle 1
     \nn@layer@gentitle[layertitlewide]
   \else
     \nn@layer@gentitle[layertitle]
   \fi
 \fi
 % Linkage stuff
 \nn@set{thislayercount}{\nn@nodecount}
 \nn@set{thislayerstart}{\nn@startindex}
 \nn@set{thislayerindex}{\nn@layerindex}
 \nn@inc{layerindex}
}}
\newcommand{\inputlayer}[1][] { \layer[bias=true,nodeclass={input neuron},#1] }
\newcommand{\hiddenlayer}[1][] { \layer[bias=true,nodeclass={hidden neuron},#1] }
\newcommand{\outputlayer}[1][] { \layer[bias=false,nodeclass={output neuron},#1] }

\define@key{links}{title} {\def\nn@linkstitle{#1}}
\define@key{links}{labels} {\def\nn@linkslabels{#1}}
\define@key{links}{not from} {\def\nn@notfrom{#1}}
\define@key{links}{not to} {\def\nn@notto{#1}}
\define@key{links}{style} {\def\nn@linksstyle{#1}}
\newcommand{\linklayers}[1][] {{%
 \setkeys{links} {title={},labels=\nn@defaultlinklabel,style={},not from={}, not to={},#1}
 % Layer indices
 \edef\lastlayer{\nn@get{lastlayerindex}}
 \edef\thislayer{\nn@get{thislayerindex}}
 % Links
 \foreach \lastnode in {\nn@get{lastlayerstart},...,\nn@get{lastlayercount}}
   \foreach \thisnode in {1,...,\nn@get{thislayercount}} {
     % Draw link if it isn't excluded
     \def\nn@dontdraw{0}
     \foreach \nn@excluded in \nn@notfrom
       \if \nn@excluded \nn@lastnode \global\def\nn@dontdraw{1} \breakforeach \fi;
     \foreach \nn@excluded in \nn@notto
       \if \nn@excluded \nn@thisnode \global\def\nn@dontdraw{1} \breakforeach \fi;
     \if \nn@dontdraw 0
       \link[from layer=\lastlayer, from node=\lastnode, to layer=\thislayer, to node=\thisnode, label=\nn@linkslabels, style=\nn@linksstyle];
     \fi
   }
 % Title
 \ifdefempty{\nn@linkstitle} {} {
   \pgfmathsetlengthmacro{\nn@links@title@x} {\nn@layerspacing * (\thislayer - 0.5)}
   \pgfmathsetlengthmacro{\nn@links@title@y} {-(\nn@maintitleheight + \nn@layertitleheight - (\nn@nodespacing / 6))}
   \node[linkstitle] (TL\lastlayer) at (\nn@links@title@x, \nn@links@title@y) {\nn@linkstitle};
 }
}}

\newcommand{\nn@defaultlinklabel}[4] {\empty}
\newcommand{\setdefaultlinklabel}[1] {\renewcommand{\nn@defaultlinklabel}[4]{#1{##1}{##2}{##3}{##4}}}
\define@key{link}{label} {\renewcommand{\nn@linklabel}[4]{#1{##1}{##2}{##3}{##4}}}
\define@key{link}{from layer} {\def\nn@fromlayer{#1}}
\define@key{link}{from node} {\def\nn@fromnode{#1}}
\define@key{link}{to layer} {\def\nn@tolayer{#1}}
\define@key{link}{to node} {\def\nn@tonode{#1}}
\define@key{link}{labelpos} {\def\nn@labelpos{#1}}
\define@key{link}{style} {\def\nn@linkstyle{#1}}
\newcommand{\link}[1][] {{%
 \newcommand{\nn@linklabel}[4] {}
 \setkeys{link} {style={}, label=\nn@defaultlinklabel, labelpos=midway, #1}
 \edef\nn@label{\nn@linklabel{\nn@fromlayer}{\nn@fromnode}{\nn@tolayer}{\nn@tonode}}
 % Handle necessary expansions
 \def\nn@link@proto##1 { \noexpand\path[\nnlinkbasestyle, link, \nnlinkextrastyle, \nn@linkstyle] (L\nn@fromlayer-\nn@fromnode) edge ##1 (L\nn@tolayer-\nn@tonode) }
 \edef\nn@link@path { \nn@link@proto{} }
 \edef\nn@link@node { \nn@link@proto{[\noexpand\nn@labelpos] node[\nnlinklabelbasestyle, linklabel, \nnlinklabelextrastyle] {\noexpand\nn@label}} }
 \ifdefempty{\nn@label} {
   \nn@link@path;
 } {
   \nn@link@node;
 }
}}

\endinput