\ProvidesPackage{neuralnetwork}[2013/07/18 v1.0 Neural network diagrams, Mark Kuckian Cowan, mark@battlesnake.co.uk] % % 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