%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% --------------------------------------------------------------------------- %
% - MOdiagram - modiagram_doc_de.tex                                        - %
% - easy creation of molecular orbital diagrams                             - %
% --------------------------------------------------------------------------- %
% - Clemens NIEDERBERGER                                                    - %
% - 2012/01/23                                                              - %
% --------------------------------------------------------------------------- %
% - http://www.mychemistry.eu/                                              - %
% - contact@mychemistry.eu                                                  - %
% --------------------------------------------------------------------------- %
% - If you have any ideas, questions, suggestions or bugs to report, please - %
% - feel free to contact me.                                                - %
% --------------------------------------------------------------------------- %
% - Copyright 2011-2012 Clemens Niederberger                                - %
% -                                                                         - %
% - This work may be distributed and/or modified under the                  - %
% - conditions of the LaTeX Project Public License, either version 1.3      - %
% - of this license or (at your option) any later version.                  - %
% - The latest version of this license is in                                - %
% -   http://www.latex-project.org/lppl.txt                                 - %
% - and version 1.3 or later is part of all distributions of LaTeX          - %
% - version 2005/12/01 or later.                                            - %
% -                                                                         - %
% - This work has the LPPL maintenance status `maintained'.                 - %
% -                                                                         - %
% - The Current Maintainer of this work is Clemens Niederberger.            - %
% -                                                                         - %
% - This work consists of the files modiagram.sty, modiagram_doc_de.tex,    - %
% - modiagram_doc_de.tex, README                                            - %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\documentclass{scrartcl}
\usepackage{fontspec,xltxtra}
\usepackage{polyglossia}
  \setmainlanguage{german}
  \defaultfontfeatures{Scale=MatchLowercase}
  \setmainfont[SmallCapsFont=Linux Libertine Capitals O,SlantedFont=Linux Libertine Slanted O]{Linux Libertine O}
  \setsansfont[SmallCapsFont=Linux Biolinum Capitals O,SlantedFont=Linux Biolinum Slanted O]{Linux Biolinum O}
  \setmonofont{Inconsolata}
\usepackage[dvipsnames]{xcolor}
  \colorlet{code}{RawSienna}
\usepackage{modiagram,xspace,siunitx,framed,chemfig,booktabs}
\usepackage[version=3]{mhchem}

\usepackage{showexpl}
\lstset{
 explpreset={
  language         = [LaTeX]TeX,
  basicstyle       = {\ttfamily\small},
  breaklines       = true,
  commentstyle     = {\color[named]{Gray}},
  backgroundcolor  = \color{yellow!20},
  numbers          = left,
  numberstyle      = \tiny,
  numberblanklines = true,
  numbersep        = .3em,
  xleftmargin      = 1em,
  gobble           = 1,
  keywordstyle     = \color{code},
  morekeywords     =
    {
      AO,
      atom,
      ce,
      connect,
      draw,
      EnergyAxis,
      lewis,
      Lewis,
      molecule,
      MOsetup,
      node,
      textcolor,
      textSigma
    }
 },
  language         = [LaTeX]TeX,
  basicstyle       = {\ttfamily},
  breaklines       = true,
  commentstyle     = {\color[named]{Gray}},
  backgroundcolor  = \color{yellow!20},
  numbers          = left,
  numberstyle      = \tiny,
  numberblanklines = true,
  numbersep        = .3em,
  xleftmargin      = 1em,
  gobble           = 1,
  moredelim        = [is][\color{black}]{|}{|},
  keywordstyle     = \color{code},
  morekeywords     =
    {
      AO,
      atom,
      connect,
      draw,
      EnergyAxis,
      molecule,
      MOsetup,
      usepackage
    }
}

\usepackage{hyperref}
\hypersetup
  {
    colorlinks         = true,
    urlcolor           = blue!80,
    linkcolor          = blue!80,
    plainpages         = false,
    bookmarksopen      = true,
    bookmarksopenlevel = 2,
    bookmarksnumbered  = true,
    pdfauthor          = {Clemens Niederberger},
    pdftitle           = {MOdiagram - Manual},
    pdfsubject         = {Create MO diagrams with LaTeX},
    pdfkeywords        = {MOdiagram},
    pdfcreator         = {LaTeX}
  }

\newcommand*\MOname{\textsf{MOdiagram}\xspace}
\newcommand*\MOversion{0.2a\xspace}
\newcommand*\MOdate{2012/01/23}

\newcommand*\paket[1]{\textsf{#1}\footnote{\url{http://www.ctan.org/pkg/#1}}}

\newcommand*\TikZ{\mbox{Ti\textbf{\textit{k}}Z}\xspace}
\newcommand*\bzw{\mbox{bzw.}\xspace}
\newcommand*\usw{\mbox{usw.}\xspace}
\renewcommand*\dh{\mbox{d.\,h.}\xspace}
\newcommand*\zB{\mbox{z.\,B.}\xspace}

\newlength\marginnotewidth
\NewDocumentCommand\marginnote { sm } {%
  \settowidth\marginnotewidth{\small\color{red}#2}
  \addtolength\marginnotewidth{20pt}
  \noindent\makebox[0cm]{\hskip-\marginnotewidth\small\color{red}#2}%
  \IfBooleanF{#1}{\hspace{\parindent}}%
}

\NewDocumentCommand \AOinline { o m }
  {
    \begingroup
      \IfNoValueTF{#1}
        {\MOsetup{ style=square,AO-width=8pt }}%
        {\MOsetup{ style=square,AO-width=8pt , #1 }}%
      \begin{MOdiagram}
        \AO{s}{0;#2}
      \end{MOdiagram}%
    \endgroup
  }

\begin{document}

\begin{titlepage}
 \centering
 \Huge MOdiagram v\MOversion
 \vskip.5cm
 \Large\MOdate
 \vskip.5cm
 \large Clemens \textsc{Niederberger}
 \vskip.25cm
 \normalsize\url{http://www.mychemistry.eu/}\\
 \href{mailto:contact@mychemistry.eu}{contact@mychemistry.eu}
 \vskip2cm
 \begin{abstract}
  \MOname stellt eine Umgebung und Befehle zur Verfügung, um Molekülorbital-Diagramme zu erstellen.
 \end{abstract}
 \begin{MOdiagram}[style=fancy,distance=7cm,AO-width=15pt,labels,names]
  \atom[N]{left}{
    2p = {0;up,up,up}
  }
  \atom[O]{right}{
    2p = {2;pair,up,up}
  }
  \molecule[NO]{
    2pMO = {1.8,.4;pair,pair,pair,up},
    color = { 2piy*=red }
  }
 \end{MOdiagram}
\end{titlepage}

\tableofcontents

\newpage
\section{Lizenz, Voraussetzungen}
\MOname v\MOversion steht unter der \LaTeX\ Project Public License Version 1.3 oder später.\newline(\url{http://www.latex-project.org/lppl.txt})

\MOname benötigt die Pakete \paket{expl3}, \paket{xparse}, \paket{l3keys2e}, \textsf{tikz}\footnote{\url{http://www.ctan.org/pkg/pgf}} und \paket{textgreek}. Außerdem werden die \TikZ-Libraries \textsf{calc} und \textsf{arrows} geladen.

Kenntnisse des \textsf{pgf}- \bzw des \textsf{tikz}-Paketes sind von Vorteil.

\section{Motivation}
Dieses Paket ist enstanden wegen einer Frage auf \url{http://tex.stackexchange.com/}, genauer gesagt wegen der Frage \href{http://tex.stackexchange.com/questions/13863/molecular-orbital-diagrams-in-latex}{Molecular orbital diagrams in LaTeX}. Dort heißt es
\begin{quote}\small\sffamily
 I'm wondering if anyone has seen a package for drawing (qualitative) molecular orbital splitting diagrams in \LaTeX? Or if there exist any packages that can be easily re-purposed to this task?

 Otherwise, I think I'll have a go at it in \TikZ.
\end{quote}
Dort wird das Problem mit \TikZ gelöst, da es bis dato noch kein Paket für diese Aufgabe gab. Zum einen soll \MOname diese Lücke nun füllen. Zum anderen fand ich es persönlich immer mühsam, aus vorherigem Code mit Copy \&\ Paste ein zweites, drittes, \ldots\ zu erstellen. Das hat sich mit \MOname erledigt.

\section{Befehle}
Alle MO-Diagramme werden mit der Umgebung \lstinline=MOdiagram= erzeugt. Bei den in den folgenden Abschnitten beschriebenen Befehlen werden verschiedene Argumente mit (o) oder mit (m) markiert. Das steht für \emph{optional} \bzw für \emph{mandatory} (also \emph{obligatorisch}).

\subsection{Der \texttt{\textbackslash atom} Befehl}
\begin{framed}
 \lstinline=\atom[<name>]{<pos>}{<|AO|-spec>}=
 \begin{itemize}\small
  \item\lstinline=<name>= (o) Beschriftung des Atoms
  \item\lstinline=<pos>= (m) links oder rechts im MO-Diagramm
  \item\lstinline=<|AO|-spec>= (m) Spezifizierung der Atom-Orbitale (AO)
 \end{itemize}
\end{framed}
Sehen wir uns den Befehl einmal an:
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{right}{
    1s = {  0; pair} ,
    2s = {  1; pair} ,
    2p = {1.5; up, down }
  }
 \end{MOdiagram}
\end{LTXexample}
Wie Sie sehen können, ist die Angabe von \lstinline=<|AO|-spec>= wesentlich für die Ausgabe der Orbital-Niveaus und den enthaltenen Elektronen. Folgende Schüssel-Wert-Paare können durch Kommata getrennt eingegeben werden:
\begin{framed}
 \begin{itemize}
  \item\lstinline+1s={<rel. energy>; <el-spec>}+
  \item\lstinline+2s={<rel. energy>; <el-spec>}+
  \item\lstinline+2p={<rel. energy>; <x el-spec>, <y el-spec>, <z el-spec>}+
 \end{itemize}
\end{framed}
Die \lstinline=<el-spec>= können die Werte \lstinline=pair=, \lstinline=up= und \lstinline=down= annehmen oder leer gelassen werden. \lstinline=<rel. energy>= ist in etwa mit der $y$-Koordinate gleichzusetzen und verschiebt das AO in vertikaler Richtung um \lstinline=<rel. energy>= \si{\centi\metre} auf- (positiv) oder abwärts (negativ).

Das Argument \lstinline=<pos>= wird wichtig, wenn die p-Orbitale verwendet werden. Vergleichen Sie folgendes Beispiel mit dem vorhergehenden:
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left}{
    1s = {  0; pair} ,
    2s = {  1; pair} ,
    2p = {1.5; up, down }
  }
 \end{MOdiagram}
\end{LTXexample}

Verwendet man beide Varianten auf einmal, so sieht man außerdem, dass das rechte Atom gegenüber dem linken nach rechts verschoben ist. Der Betrag, um den das rechte verschoben ist, beträgt per Default \SI{4}{\centi\metre} und kann individuell angepasst werden (siehe Seite \pageref{option:distance}).
\begin{LTXexample}[pos=b]
 \begin{MOdiagram}
  \atom{left}{
    1s = {  0; pair} ,
    2s = {  1; pair} ,
    2p = {1.5; up, down }
  }
  \atom{right}{
    1s = {  0; pair} ,
    2s = {  1; pair} ,
    2p = {1.5; up, down }
  }
 \end{MOdiagram}
\end{LTXexample}
Der Sinn der Verschiebung wird klar, wenn wir den Befehl \lstinline=\molecule= (Abschnitt \ref{ssec:molecule}) dazu nehmen.

\marginnote{NEU}Jedes der Argumente für die AO kann leer bleiben oder weggelassen werden.
\begin{LTXexample}[pos=b]
 Ohne Argument: Default-H\"ohe, gef\"ullt:
 \begin{MOdiagram}
  \atom{left}{1s, 2s, 2p}
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}[pos=b]
 Leeres Argument: Default H\"ohe, leer:
 \begin{MOdiagram}
  \atom{left}{1s=, 2s=, 2p=}
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}[pos=b]
 Einzelne Werte verwendet:\\
 \begin{MOdiagram}
  \atom{left}{1s, 2s=1, 2p={;,up} }
 \end{MOdiagram}
\end{LTXexample}

\subsection{Der \texttt{\textbackslash molecule} Befehl}\label{ssec:molecule}
\begin{framed}
 \lstinline=\molecule[<name>]{<MO-spec>}=
 \begin{itemize}\small
  \item\lstinline=<name>= (o) Beschriftung des Moleküls
  \item\lstinline=<MO-spec>= (m) Spezifizierung der Molekül-Orbitale (MO)
 \end{itemize}
\end{framed}
Zunächst einmal ein Beispiel:
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 1s = {  0; up } }
  \atom{right}{ 1s = {  0; up } }
  \molecule { 1sMO = {.75; pair } }
 \end{MOdiagram}
\end{LTXexample}
Durch den Befehl \lstinline=\molecule= werden die Atom-Orbitale (AO) verbunden und die entsprechenden bindenden und antibindenden Orbitale des Moleküls (MO) gezeichnet. \lstinline=\molecule= kann nur verwendet werden, \emph{nachdem} man bereits \emph{beide} Atome gesetzt hat, da die zu verbindenden Orbitale bekannt sein müssen.

Das Argument \lstinline=<MO-spec>= erwartet dabei durch Kommata getrennt folgende Key-Value-Paare:
\begin{framed}
 \begin{itemize}
  \item\lstinline+1sMO={<energy gain>/<energy loss>; <s el-spec>, <s* el-spec>}+ (verbindet die durch \lstinline=1s= spezifizierten AO.)
  \item\lstinline+2sMO={<energy gain>/<energy loss>; <s el-spec>, <s* el-spec>}+ (verbindet die durch \lstinline=2s= spezifizierten AO.)
  \item\lstinline+2pMO={<s energy gain>/<s energy loss>, <p energy gain>/<p energy loss>; <s el-spec>, <py el-spec>, <pz el- spec>, <py* el-spec>, <pz* el-spec>, <s* el-spec>}+ (verbindet die durch \lstinline=2p= spezifizierten AO.)
 \end{itemize}
\end{framed}
Es ist dabei zu beachten, dass die entsprechenden AO gesetzt sein müssen, um sie verbinden zu können. Folgendes wird nicht funktionieren:
\begin{lstlisting}[basicstyle = {\ttfamily\small}]
 \begin{MOdiagram} 
  \atom{left} { 1s = 0 }
  \atom{right}{ 1s = 0 }
  \molecule { 2sMO = .75 }
 \end{MOdiagram}
\end{lstlisting}
Der Wert, der für \lstinline=<energy gain>= angegeben wird, gibt an, wieviele \si{\centi\metre} das bindende MO unter dem niedrigeren AO \bzw wieviel das antibindende MO über dem höheren AO gesetzt wird.

\begin{LTXexample}[pos=b]
 Gleiche Level:
 \begin{MOdiagram}
  \atom{left} { 1s = {  0; up } }
  \atom{right}{ 1s = {  0; up } }
  \molecule { 1sMO = {.75; pair } }
 \end{MOdiagram}

 Unterschiedliche Level:
 \begin{MOdiagram}
  \atom{left} { 1s = {  0; up } }
  \atom{right}{ 1s = {  1; up } }
  \molecule { 1sMO = {.25; pair } }
 \end{MOdiagram}
\end{LTXexample}
\marginnote{NEU}Wird für \lstinline=<energy loss>= ein eigener Wert angegeben, können auch unsymmetrische Aufspaltungen erzeugt werden. Dann gilt der erste, \lstinline=<energy gain>=, für das bindende und der zweite, \lstinline=<energy loss>=, für das antibindende MO.
\begin{LTXexample}[pos=b]
 \begin{MOdiagram}
  \atom{left} { 1s = {  0; up } }
  \atom{right}{ 1s = {  0; up } }
  \molecule { 1sMO = {.75/.25; pair } }
 \end{MOdiagram}

 \begin{MOdiagram}
  \atom{left} { 1s = {  0; up } }
  \atom{right}{ 1s = {  1; up } }
  \molecule { 1sMO = {.25/.75; pair } }
 \end{MOdiagram}
\end{LTXexample}

Beachten Sie, dass Sie bei \lstinline=2pMO= \emph{zwei} solche Werte (oder Paare) angeben müssen: die Aufspaltung der \textsigma-Orbitale und die Aufspaltung der \textpi-Orbitale.
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 2p = { 0; up, up } }
  \atom{right}{ 2p = { 1; up, up } }
  \molecule { 2pMO = { 1.5, .75; pair, up, up } } 
 \end{MOdiagram}
\end{LTXexample}

Das komplette MO-Diagramm für Triplett-Disauerstoff könnte nun etwa folgendermaßen aussehen:
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left}{
    1s, 2s, 2p = {;pair,up,up}
  }
  \atom{right}{
    1s, 2s, 2p = {;pair,up,up}
  }
  \molecule{
    1sMO, 2sMO, 2pMO = {;pair,pair,pair,up,up}
  }
 \end{MOdiagram}
\end{LTXexample}

\newpage
\subsection{Die Namensgebung}\label{Namensgebung}
Da man üblicherweise die AO und MO auch beschriften (können) möchte und sie in der \lstinline=MOdiagram=-Umgebung \TikZ-Nodes entsprechen, ist die interne Benennung wichtig. Diese folgt eng der tatsächlichen Funktion:
\begin{center}
\begin{MOdiagram}[distance=6cm,AO-width=20pt,labels-fs=\tt\footnotesize,labels-style={yshift=10pt}]
 \atom{left}{
   1s=0,
   2s=2,
   2p=5,
   label={ 1sleft={1sleft}, 2sleft={2sleft}, 2pxleft={2pxleft}, 2pyleft={2pyleft}, 2pzleft={2pzleft} }
 }
 \atom{right}{
   1s=0,
   2s=2,
   2p=5,
   label={ 1sright={1sright}, 2sright={2sright}, 2pxright={2pxright}, 2pyright={2pyright}, 2pzright={2pzright} }
 }
 \molecule{
   1sMO=.5,
   2sMO=.5,
   2pMO={1.5,.5},
   label={ 1sigma={1sigma}, 1sigma*={1sigma*}, 2sigma={2sigma}, 2sigma*={2sigma*}, 2psigma={2psigma}, 2psigma*={2psigma*}, 2piy={2piy}, 2piy*={2piy*}, 2piz={2piz}, 2piz*={2piz*} }
 }
\end{MOdiagram}
\end{center}
Mit diesen Bezeichnungen ist es möglich, sie mit den üblichen \TikZ-Befehlen zu referenzieren:
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 1s = 0 }
  \atom{right}{ 1s = 0 }
  \molecule { 1sMO = .75 }
  \draw[<->,red,semithick] (1sigma.center) -- (1sigma*.center) ;
  \draw[red] (1sigma*) ++ (2cm,.5cm) node {Aufspaltung} ;
 \end{MOdiagram}
\end{LTXexample}

\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 1s = 0 }
  \atom{right}{ 1s = 0 }
  \molecule { 1sMO = .75 }
  \draw[draw=blue,very thick,fill=blue!40,opacity=.5] (1sigma*) circle (8pt);
  \draw[<-,shorten <=8pt,shorten >=15pt,blue] (1sigma*) --++(2,1) node {antibindendes MO};
 \end{MOdiagram}
\end{LTXexample}

\subsection{AOs und MOs irgendwo}\label{ssec:AO_MO_irgendwo}
Nicht immer reichen die Standardorbitale aus, um ein sinnvolles MO-Diagramm zu zeichen. Beispielsweise würde man im MO-Diagramm von \ce{XeF2} wohl folgenden Ausschnitt für die 3Z/2E-Bindung benötigen, der die Wechselwirkung eines Xe-p-Orbitals mit der antibindenden Kombination zweier F-p-Orbitale zeigt:
\begin{center}
 \begin{MOdiagram}[names]
  \atom[\lewis{0.,F}\hspace*{5mm}\lewis{4.,F}]{left}{1s=.2;up,up-el-pos={1sleft=.5}}
  \atom[Xe]{right}{1s=1.25;pair}
  \molecule[\ce{XeF2}]{1sMO={1/.25;pair}}
  \AO(1cm){s}{0;up}
  \AO(3cm){s}{0;pair}
  \connect{ AO1 & AO2 }
  \node[right,xshift=4mm] at (1sigma) {\footnotesize bindend};
  \node[above] at (AO2.90) {\footnotesize nicht bindend};
  \node[above] at (1sigma*.90) {\footnotesize antibindend};
 \end{MOdiagram}
\end{center}
Um solche MO-Diagramme erstellen zu können, gibt es folgenden Befehl:
\begin{framed}
 \lstinline+\AO[<name>](<xshift>){<type>}[<key = val>]{<energy>;<el-spec>}+
 \begin{itemize}\small
  \item\lstinline=<name>= (o) Name der Node, wenn nicht angegeben, dann wird \lstinline=|AO|#= verwendet, wobei \lstinline=#= eine fortlaufende Nummer ist.
  \item\lstinline=<xshift>= (o) Vertikale Position des Orbitals, eine \TeX-Länge mit Einheit
  \item\lstinline=<type>= (m) \lstinline=s= oder \lstinline=p=
  \item\lstinline+<key = val>+ (o) Key-Value Paare, mit denen das Layout angepasst werden kann, siehe Abschnitt \ref{ssec:AO_anpassen}.
  \item\lstinline=<|AO|-spec>= (m) Spezifizierung des Atom-Orbitals 
 \end{itemize}
\end{framed}

\newpage
Je nach \lstinline=<type>= werden damit ein s- oder drei p-Orbitale erzeugt.
\begin{LTXexample}
 \begin{MOdiagram}
  \AO{s}{0;}
  \AO(-20pt){p}{1;pair,up,down}
 \end{MOdiagram}
\end{LTXexample}

Möchte man ein AO genau an die Position eines Atoms setzen, so muss man deren \lstinline=<xshift>= kennen. Die haben per Default folgende Werte (siehe auch Abschnitt \ref{orbital-positionen}):\label{xshift}
\begin{itemize}
 \item atom left: \SI{1}{\centi\metre}
 \item molecule: \SI{3}{\centi\metre}
 \item atom right: \SI{5}{\centi\metre}
\end{itemize}
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} {1s=0}
  \atom{right}{1s=0}
  \molecule {1sMO=1}
  \AO(1cm){s}{2}
  \AO(3cm){s}{2}
  \AO(5cm){s}{2}
 \end{MOdiagram}
\end{LTXexample}
In p-Orbitalen findet pro Orbital per Default eine Verschiebung um \SI{20}{pt} statt, was einer zweifachen Verschiebung um die noch zu besprechende Länge \lstinline=|AO|-width= (siehe Abschnitt \ref{option:AO-width}) entspricht:
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} {2p=0}
  \atom{right}{2p=0}
  % ueber dem linken:
  \AO(1cm)     {s}{ .5}
  \AO(1cm-20pt){s}{  1;up}
  \AO(1cm-40pt){s}{1,5;down}
  % ueber dem rechten:
  \AO(5cm)     {s}{ .5}
  \AO(5cm+20pt){s}{  1;up}
  \AO(5cm+40pt){s}{1.5;down}
 \end{MOdiagram}
\end{LTXexample}

Auch die mit \lstinline=\AO= gesetzten Orbitale können mit Linien verbunden werden. Das kann man natürlich mit dem \lstinline=\draw=-Befehl machen. Dafür können Sie entweder die voreingestellten Node-Namen verwenden \ldots
\begin{LTXexample}
 \begin{MOdiagram}
  \AO{s}{0} \AO(2cm){s}{1}
  \AO{s}{2} \AO(2cm){s}{1.5}
  \draw[red] (AO1.0) -- (AO2.180) (AO3.0) -- (AO4.180);
 \end{MOdiagram}
\end{LTXexample}
\ldots\ oder eigene Node-Namen setzen.
\begin{LTXexample}
 \begin{MOdiagram}
  \AO[a]{s}{0} \AO[b](2cm){s}{1}
  \AO[c]{s}{2} \AO[d](2cm){s}{1.5}
  \draw[red] (a.0) -- (b.180) (c.0) -- (d.180);
 \end{MOdiagram}
\end{LTXexample}
Die voreingestellten Namen lauten \lstinline=AO1=, \lstinline=AO2= \usw beim Typ \lstinline=s= und \lstinline=AO1x=, \lstinline=AO1y=, \lstinline=AO1z=,  \lstinline=AO2x= \usw beim Typ \lstinline=p=. Beim Typ \lstinline=p= bekommt auch der selbstgewählte Name ein \lstinline=x=, \lstinline=y= \bzw ein \lstinline=z= angehängt.
\begin{LTXexample}[pos=b]
 \begin{MOdiagram}
  \AO{p}{0}
  \draw[<-,shorten >=5pt] (AO1y.-90) -- ++ (.5,-1) node {y};
 \end{MOdiagram}
 und
 \begin{MOdiagram}
  \AO[A]{p}{0}
  \draw[<-,shorten >=5pt] (Ay.-90) -- ++ (.5,-1) node {y};
 \end{MOdiagram}
\end{LTXexample}

Soll die Verbindungslinie automatisch zu dem Stil der durch \lstinline=\molecule= erzeugten Linien\footnote{Dieser Stil kann angepasst werden, siehe Seite \pageref{option:lines}.} passen, dann sollte man den Befehl \lstinline=\connect= verwenden.
\begin{framed}
 \lstinline=\connect{<|AO-connect|>}=
 \begin{itemize}\small
  \item\lstinline=<|AO-connect|>= (m) durch Kommata getrennte Liste von durch \lstinline=&= verbundenen Node-Paaren, die verbunden werden sollen.
 \end{itemize}
\end{framed}
Dieser Befehl erwartet eine durch Kommata getrennte Liste von durch \lstinline=&= verbundenen Paaren von Node-Namen derer Nodes, die verbunden werden sollen:
\begin{LTXexample}
 \begin{MOdiagram}
  \AO{s}{0;} \AO(2cm){s}{1;}
  \AO{s}{2;} \AO(2cm){s}{1.5;}
  \connect{ AO1 & AO2, AO3 & AO4 }
 \end{MOdiagram}
\end{LTXexample}
Einige Punkte müssen dabei noch erwähnt werden: \lstinline=\connect= fügt der ersten Node den Anker \lstinline=east= und der zweiten den Anker \lstinline=west= hinzu. Damit funktioniert eine vernünftige Verbindung nur von links nach rechts. Allerdings können nach dem üblichen \TikZ-Schema auch eigene Anker gesetzt werden:
\begin{LTXexample}
 \begin{tikzpicture}
  \draw (0,0) node (a) {a} ++ (1,0) node (b) {b}
        ++ (0,1) node (c) {c} ++ (-1,0) node (d) {d} ;
  \connect{ a.90 & d.-90, c.180 & d.0 }
 \end{tikzpicture}
\end{LTXexample}

\subsection{Die Positionen}\label{orbital-positionen}
In folgender Darstellung sehen Sie die Werte, die die $x$-Positionen der Orbitale annehmen in Abhängigkeit von \lstinline=<distance>= (\lstinline=<dist>=) und \lstinline=<|AO|-width>= (\lstinline=<|AO|>=). Diese Längen -- und wie man sie ändert -- werden in den Abschnitten \ref{option:distance} und \ref{option:AO-width} besprochen.
\begin{center}
\begin{MOdiagram}[AO-width=22pt,labels-fs=\tt\scriptsize,labels-style={text width=40pt,align=center,yshift=11pt}]
 \atom{left}{
   1s=0,
   2s=2,
   2p=5.5,
   label={ 1sleft={1cm}, 2sleft={1cm}, 2pxleft={1cm - 4*<AO>}, 2pyleft={1cm - 2*<AO>}, 2pzleft={1cm} } }
 \atom{right}{
   1s=0,
   2s=2,
   2p=5.5,
   label={ 1sright={1cm + <dist>}, 2sright={1cm + <dist>}, 2pxright={1cm+ <dist>}, 2pyright={1cm + <dist> + 2*<AO>}, 2pzright={1cm + <dist> + 4*<AO>} } }
 \molecule{
   1sMO=.5,
   2sMO=.5,
   2pMO={2,.75},
   label={ 1sigma={.5*<dist> + 1cm}, 1sigma*={.5*<dist> + 1cm}, 2sigma={.5*<dist> + 1cm}, 2sigma*={.5*<dist> + 1cm}, 2psigma={.5*<dist> + 1cm}, 2psigma*={.5*<dist> + 1cm}, 2piy={.5*<dist> + 1cm - <AO>}, 2piy*={.5*<dist> + 1cm - <AO>}, 2piz={.5*<dist> + 1cm + <AO>}, 2piz*={.5*<dist> + 1cm + <AO>} }
 }
\end{MOdiagram}
\end{center}

\newpage
\subsection{Default-Werte}
\marginnote*{NEU}Wenn Sie die Argumente (oder besser: Werte) für die Spezifikation der AO \bzw MO weg- oder leerlassen, werden spezielle Default-Werte verwendet. In der folgenden Tabelle finden Sie eine Übersicht.
\begin{center}\small
\begin{tabular}{l>{\ttfamily}l>{\ttfamily}l>{\ttfamily}l}
 \toprule & \normalfont\bfseries AO / MO & \normalfont\bfseries ohne                & \normalfont\bfseries leer \\\midrule
 Syntax:  &                              & 1s                                       & 1s= \\\midrule
          & 1s                           & \{0;pair\}                               & \{0;\} \\
          & 2s                           & \{2;pair\}                               & \{2;\} \\
          & 2p                           & \{5;pair,pair,pair\}                     & \{5;,,\} \\\midrule
          & 1sMO                         & \{.5;pair,pair\}                         & \{.5;,\} \\
          & 2sMO                         & \{.5;pair,pair\}                         & \{.5;,\} \\
          & 2pMO                         & \{1.5,.5;pair,pair,pair,pair,pair,pair\} & \{1.5,.5;,,,,,\} \\\bottomrule
\end{tabular}
\end{center}
Ganz ähnlich verhält es sich mit dem \lstinline=\AO=-Befehl (Seite \pageref{ssec:AO_MO_irgendwo}), mit dem Unterschied, dass er eine Angabe für \lstinline=<energy>= benötigt.
\begin{center}\small
\begin{tabular}{>{\ttfamily}l>{\ttfamily}l>{\ttfamily}l}
 \toprule\bfseries <type> & \bfseries <el-spec> \\\midrule
 s                        & pair \\
 p                        & pair,pair,pair \\\bottomrule
\end{tabular}
\end{center}
Vergleichen Sie folgende Beispiele:
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 1s={0;pair} }
  \atom{right}{ 1s }
 \end{MOdiagram}

 \hrulefill
 
 \begin{MOdiagram}
  \atom{left}{ 1s=1 }
  \atom{right}{ 1s= }
 \end{MOdiagram}
\end{LTXexample}

\section{Anpassen des Layouts}
Die Optionen des Abschnitts \ref{ssec:umgebungs_optionen} können auch global als Paketoptionen, \dh mit \lstinline+\usepackage[<key = val>]{modiagram}+, oder über den Setup-Befehl \lstinline+\MOsetup{<key = val>}+  eingesetzt werden.

\subsection{Umgebungs-Optionen}\label{ssec:umgebungs_optionen}
Mit folgenden Optionen kann das Aussehen der MO-Diagramme verändert werden.
\begin{itemize}
 \item\lstinline+style=<type>+ Verändern des Stils der Orbitale und Verbindungslinien, Abschnitt \ref{option:style}.
 \item\lstinline+distance=<dim>+ Der Abstand zwischen linkem und rechtem Atom, Abschnitt \ref{option:distance}.
 \item\lstinline+|AO|-width=<dim>+ Die Größe der Orbitale ändern, Abschnitt \ref{option:AO-width}.
 \item\lstinline+el-sep=<num>+ Abstand der Pfeile eines Elektronenpaars, Abschnitt \ref{option:electrons}.
 \item\lstinline+up-el-pos=<num>+ Position des Spin-Up Pfeils, Abschnitt \ref{option:electrons}.
 \item\lstinline+down-el-pos=<num>+ Position des Spin-Down Pfeils, Abschnitt \ref{option:electrons}.
 \item\lstinline+lines=<tikz>+ \TikZ-Stil der Verbindungslinien anpassen, Abschnitt \ref{option:lines}.
 \item\lstinline+names=<bool>+ Atome und Molekül beschriften, Abschnitt \ref{option:names}.
 \item\lstinline+names-style=<tikz>+ \TikZ-Stil der Beschriftungen, Abschnitt \ref{option:names_style}.
 \item\lstinline+names-style-add=<tikz>+ \TikZ-Stil der Beschriftungen, Abschnitt \ref{option:names_style}.
 \item\lstinline+labels=<bool>+ Orbitale mit Default Beschriftung versehen, Abschnitt \ref{option:labels}.
 \item\lstinline+labels-fs=<cs>+ Schriftgröße der Label-Beschriftung verändern, Abschnitt \ref{option:labels-fs}.
 \item\lstinline+labels-style=<tikz>+ \TikZ-Stil der Label-Beschriftung verändern, Abschnitt \ref{option:labels-style}.
\end{itemize}
Sie alle werden nachfolgend besprochen. Wenn sie lokal als Option der Umgebung aufgerufen werden, haben sie nur für diese Auswirkungen.
\begin{lstlisting}
 \begin{MOdiagram}[<key = value>]
  ...
 \end{MOdiagram}
\end{lstlisting}

\subsubsection{Option \texttt{style}}\label{option:style}
Es gibt fünf verschiedene Stile, aus denen ausgewählt werden kann:
\begin{itemize}
 \item\lstinline+style=plain+ \AOinline[style=plain]{pair} (Default)
 \item\lstinline+style=square+ \AOinline[style=square]{pair}
 \item\lstinline+style=circle+ \AOinline[style=circle]{pair}
 \item\lstinline+style=round+ \AOinline[style=round]{pair}
 \item\lstinline+style=fancy+ \AOinline[style=fancy]{pair}
\end{itemize}
Sehen wir uns das MO-Diagramm für \ce{H2} in den verschiedenen Stilen an:
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[style=plain]% Default
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[style=square]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\marginnote*{NEU}\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[style=circle]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[style=round]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[style=fancy]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Option \texttt{distance}}\label{option:distance}
Je nach Label und Beschriftungen können die \SI{4}{\centi\metre}, durch die das linke und das rechte Atom getrennt sind, zu wenig sein. Mit der Option \lstinline+distance=<dim>+ lässt sie sich verändern. Damit wird die Position des rechten Atoms auf \lstinline=1cm + <dim>= gesetzt und die Position des Moleküls auf \lstinline=0.5*(1cm + <dim>)=, siehe auch Seite \pageref{xshift} und Abschnitt \ref{orbital-positionen}.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[distance=6cm]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Option \texttt{AO-width}}\label{option:AO-width}
Die Länge \lstinline=|AO|-width= enstpricht der Länge des waagerechten Strichs eines Orbitals im \lstinline=plain=-Stil und beträgt per Default \SI{10}{pt}.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[AO-width=15pt]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[style=fancy,AO-width=15pt]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
Durch das Verändern von \lstinline=|AO|-width= ändern sich auch die Positionen der p- und \textpi-Orbitale, siehe Abschnitt \ref{orbital-positionen}.

\subsubsection{Optionen \texttt{el-sep}, \texttt{up-el-pos} und \texttt{down-el-pos}}\label{option:electrons}
\marginnote*{NEU}Diese drei Optionen beeinflussen die horizontale Position der Pfeile, die die Elektronen in einem AO/MO repräsentieren. Die Option \lstinline+el-sep=<num>+ erwartet einen Wert zwischen \lstinline=0= und \lstinline=1=. Dabei bedeutet \lstinline=0= \emph{keinen} Abstand voneinander und \lstinline=1= \emph{vollen} Abstand voneinander (bezogen auf die Länge \lstinline=|AO|-width=, Abschnitt \ref{option:AO-width}).
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[el-sep=.2]% default
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[el-sep=0]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[el-sep=1]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
Die Optionen \lstinline+up-el-pos=<num>+ und \lstinline+down-el-pos=<num>+ können alternativ dazu eingesetzt werden, um das Spin-Up- und Spin-Down-Elektron zu platzieren. Wieder werden Werte zwischen \lstinline=0= und \lstinline=1= erwartet. Diesmal bedeutet \lstinline=0= \emph{ganz links} und \lstinline=1= \emph{ganz rechts}
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[up-el-pos=.4,down-el-pos=.6]% default
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[up-el-pos=.333,down-el-pos=.667]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[up-el-pos=.7,down-el-pos=.3]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}

\newpage
\subsubsection{Option \texttt{lines}}\label{option:lines}
Der Option \lstinline=lines= können \TikZ-Keys angegeben werden, um den Stil der Verbindungslinien zu ändern.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[lines={gray,thin}]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Option \texttt{names}}\label{option:names}
Verwendet man die Option \lstinline=names=, werden den Atomen und dem Molekül Beschriftungen hinzugefügt, sofern man die optionalen Argumente von \lstinline=\atom= und/oder \lstinline=\molecule= verwendet hat.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[names]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Optionen \texttt{names-style} und \texttt{names-style-add}}\label{option:names_style}
\marginnote*{NEU}Diese Optionen erlauben die Gestaltung der Beschriftung der Atome und des Moleküls. Per Default wird folgende Einstellung verwendet: \lstinline+\names-style={anchor=base}+\footnote{Zur Bedeutung siehe „\TikZ und PGF \textendash\ Manual for Version 2.10“ S.\,183 Abschnitt 16.4.4 (pgfmanual.pdf)}.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[names,names-style={draw=blue}]
  \atom[p]{left} { 1s = {;up} }
  \atom[b]{right}{ 1s = {;up} }
  \molecule[\ce{X2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
Damit werden die Voreinstellungen überschrieben. Wie Sie erkennen können, zerstört das die vertikale Ausrichtung der Nodes. Um das zu vermeiden, können Sie \zB \lstinline=text height= und \lstinline=text depth= deklarieren \ldots
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[names,names-style={text height=1.5ex, text depth=.25ex, draw=blue}]
  \atom[p]{left} { 1s = {;up} }
  \atom[b]{right}{ 1s = {;up} }
  \molecule[\ce{X2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\ldots, den \lstinline=anchor= wieder hinzufügen \ldots
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[names,names-style={anchor=base, draw=blue}]
  \atom[p]{left} { 1s = {;up} }
  \atom[b]{right}{ 1s = {;up} }
  \molecule[\ce{X2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\ldots\ oder die Option \lstinline=names-style-add= verwenden. Diese überschreibt die Einstellung nicht, sondern fügt die neuen Deklarationen hinzu.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[names,names-style-add={draw=blue}]
  \atom[p]{left} { 1s = {;up} }
  \atom[b]{right}{ 1s = {;up} }
  \molecule[\ce{X2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}[pos=b]
 \MOsetup{names,names-style={text height=2.5ex,text depth=.5ex,draw=blue!80,rounded corners}}
 \begin{MOdiagram}
  \atom[p]{left} { 1s = {;up} }
  \atom[b]{right}{ 1s = {;up} }
  \molecule[\ce{X2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
 \begin{MOdiagram}[names-style-add={fill=blue!20}]
  \atom[p]{left} { 1s = {;up} }
  \atom[b]{right}{ 1s = {;up} }
  \molecule[\ce{X2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Option \texttt{labels}}\label{option:labels}
Mit der Option \lstinline=labels= werden vordefinierte Labels an die Orbitale geschrieben. Diese Labels können auch geändert werden, siehe Abschnitt \ref{key:label}.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[labels]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}

\newpage
\subsubsection{Option \texttt{labels-fs}}\label{option:labels-fs}
Per Default werden die Labels mit der Schriftgröße \lstinline=\small= gesetzt. Wenn man das ändern möchte, kann man die Option \lstinline=labels-fs= verwenden.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[labels,labels-fs=\footnotesize]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}
Damit ist es auch möglich, den Schriftstil zu verändern.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[labels,labels-fs=\sffamily\footnotesize]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Option \texttt{labels-style}}\label{option:labels-style}
Mit der Option \lstinline=labels-style= kann man den \TikZ-Stil der Nodes ändern, in die die Labels geschrieben werden.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[labels,labels-style={blue,yshift=4pt}]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair} }
 \end{MOdiagram}
\end{LTXexample}

\subsection{\texttt{\textbackslash atom} und \texttt{\textbackslash molecule} spezifische Anpassungen}
\subsubsection{Der \texttt{label} Key}\label{key:label}
Wenn man die vordefinierten Label nicht verwenden möchte, also eigene Label einsetzen oder auch nur einzelne Label verwenden möchte, kann man den Key \lstinline=label= einsetzen. Dieser Key wird im \lstinline=\atom=- und im \lstinline=\molecule=-Befehl bei \lstinline=<|AO|-spec>= \bzw \lstinline=<MO-spec>= eingesetzt. Der Key erwartet eine durch Kommata getrennte Schlüssel-Wert-Liste. Als Schlüssel werden die in Abschnitt \ref{Namensgebung} vorgestellten Namen verwendet, mit denen das zu beschriftende Orbital spezifiziert wird.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[labels-fs=\footnotesize]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{
    1sMO  = {.75;pair},
    label = { 1sigma = {bindendes MO} }
  }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 \begin{MOdiagram}[style=square,distance=6cm]
  \atom{left} { 1s = {;up} }
  \atom{right}{ 1s = {;up} }
  \molecule{
    1sMO  = {.75;pair} ,
    label = {
      1sigma  = $\sigma$,
      1sigma* = $\sigma^*$
    }
  }
  \node[right] at (1sigma.-45) {bindend};
  \node[right] at (1sigma*.45) {antibindend};
 \end{MOdiagram}
\end{LTXexample}

Wird der Key zusammen mit der \lstinline=labels=-Option (Seite \pageref{option:labels}) verwendet, dann werden damit einzelne Label überschrieben:
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[labels]
  \atom[H]{left} { 1s = {;up} }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{
    1sMO  = {.75;pair},
    label = { 1sigma = \textcolor{red}{??} }
  }
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Der \texttt{color} Key}\label{key:color}
Analog zum \lstinline=label=-Key kann der \lstinline=color=-Key verwendet werden, um die Elektronen eines Orbitals farbig darzustellen.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}[labels-fs=\footnotesize]
  \atom[H]{left}{
    1s, color = { 1sleft = blue }
  }
  \atom[H]{right}{
    1s, color = { 1sright = red }
  }
  \molecule[\ce{H2}]{
    1sMO,
    label = { 1sigma = {bindendes MO} },
    color = { 1sigma = green, 1sigma* = cyan }
  }
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Die \texttt{up-el-pos} und \texttt{down-el-pos} Keys}\label{key:electrons}
\marginnote*{NEU}Mit den Keys \lstinline=up-el-pos= \bzw \lstinline=down-el-pos= ist es möglich, die Pfeile, die die Elektronen repräsentieren, in einem einzigen AO oder MO zu verschieben. Es können Werte zwischen \lstinline=0= und \lstinline=1= verwendet werden, siehe auch Abschnitt \ref{option:electrons}.
\begin{LTXexample}
 % use package `mhchem'
 \begin{MOdiagram}
  \atom[H]{left}{
    1s        = {;up},
    up-el-pos = { 1sleft=.5 }
  }
  \atom[H]{right}{ 1s = {;up} }
  \molecule[\ce{H2}]{
    1sMO        = {.75;pair} ,
    up-el-pos   = { 1sigma=.15 } ,
    down-el-pos = { 1sigma=.85 }
  }
 \end{MOdiagram}
\end{LTXexample}

\subsection{\texttt{\textbackslash AO} spezifische Anpassungen}\label{ssec:AO_anpassen}
\marginnote*{NEU}Diese Keys erlauben, die mit \lstinline=\AO= erzeugten AOs \bzw MOs anzupassen.

\subsubsection{Der \texttt{label} Key}\label{key:AO_label}
Der Key \lstinline=label[x/y/z]= erlaubt, an ein frei gesetztes AO \bzw MO ein Label zu setzen. Wenn Sie den Typ \lstinline=p= verwenden, können Sie in eckigen Klammern das zu verwendende Orbital auswählen.
\begin{LTXexample}
 \begin{MOdiagram}[style=square]
  \AO{s}[label=s-Orb]{0}
  \AO{p}[label[y]=py,label[z]=pz]{1.5}
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Der \texttt{color} Key}\label{key:AO_color}
Analog zum \lstinline=label=-Key gibt es den Key \lstinline=color[x/y/z]=, der ermöglicht, die Elektronen zu färben. Wenn Sie den Typ \lstinline=p= verwenden, können Sie in eckigen Klammern das zu verwendende Orbital auswählen.
\begin{LTXexample}
 \begin{MOdiagram}[style=square]
  \AO{s}[color=red]{0}
  \AO{p}[color[y]=green,color[z]=cyan]{1.5}
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Die \texttt{up-el-pos} und \texttt{down-el-pos} Keys}\label{key:AO_electrons}
Weiter gibt es noch die Keys \lstinline=up-el-pos[x/y/z]= und \lstinline=down-el-pos[x/y/z]=, mit denen die Elektronen verschoben werden können. Dabei können Sie Werte zwischen \lstinline=0= und \lstinline=1= einsetzen, siehe auch Abschnitt \ref{option:electrons}. Wenn Sie den Typ \lstinline=p= verwenden, können Sie in eckigen Klammern das zu verwendende Orbital auswählen.
\begin{LTXexample}
 \begin{MOdiagram}[style=square]
  \AO{s}[up-el-pos=.15]{0}
  \AO{p}[up-el-pos[y]=.15,down-el-pos[z]=.15]{1.5}
 \end{MOdiagram}
\end{LTXexample}

\subsection{Energie-Achse}
Zuletzt möchte man unter Umständen gerne eine Energie-Achse an das Diagramm zeichnen. Dafür gibt es den Befehl \lstinline=\EnergyAxis=
\begin{framed}
 \lstinline+\EnergyAxis[<key = val>]+
 \begin{itemize}\small
  \item\lstinline+<key = val>+ (o) Schlüssel-Wert-Paare, um die Achse zu modifizieren.
 \end{itemize}
\end{framed}
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 1s = {;up} }
  \atom{right}{ 1s = {;up} }
  \molecule{ 1sMO = {.75;pair} }
  \EnergyAxis
 \end{MOdiagram}
\end{LTXexample}
Es gibt derzeit zwei Keys, mit denen die Achse modifiziert werden kann.
\begin{framed}
 \begin{itemize}
  \item\lstinline+title=<title>+ Achsenbeschriftung (Default: \lstinline=energy=).
  \item\lstinline+head=<tikz-arrow-head>+ Pfeilspitze; hier können die Pfeilspitzen verwendet werden, die in der \TikZ-Library \textsf{arrows} spezifiziert sind (pgf-Manual v2.10 Seiten 256ff.) (Default: \lstinline=>=).
 \end{itemize}
\end{framed}
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 1s = {;up} }
  \atom{right}{ 1s = {;up} }
  \molecule{ 1sMO = {.75;pair} }
  \EnergyAxis[title]
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 1s = {;up} }
  \atom{right}{ 1s = {;up} }
  \molecule{ 1sMO = {.75;pair} }
  \EnergyAxis[title=Energie,head=stealth]
 \end{MOdiagram}
\end{LTXexample}

\section{Beispiele}
Das Beispiel vom Beginn des Abschnitts \ref{ssec:AO_MO_irgendwo}.
\begin{LTXexample}
 % use packages `mhchem' and `chemfig' 
 \begin{MOdiagram}[names]
  \atom[\lewis{0.,F}\hspace*{5mm}\lewis{4.,F}]{left}{1s=.2;up,up-el-pos={1sleft=.5}}
  \atom[Xe]{right}{1s=1.25;pair}
  \molecule[\ce{XeF2}]{1sMO={1/.25;pair}}
  \AO(1cm){s}{0;up}
  \AO(3cm){s}{0;pair}
  \connect{ AO1 & AO2 }
  \node[right,xshift=4mm] at (1sigma) {\footnotesize bindend};
  \node[above] at (AO2.90) {\footnotesize nicht bindend};
  \node[above] at (1sigma*.90) {\footnotesize antibindend};
 \end{MOdiagram}
\end{LTXexample}

\begin{LTXexample}[pos=b]
 % use packages `mhchem' (and `textgreek' loaded by `MOdiagram')
 \begin{figure}
  \centering
  \begin{MOdiagram}[style=square,labels,names,AO-width=8pt,labels-fs=\footnotesize]
   \atom[\ce{O_a}]{left}{
     1s, 2s, 2p = {;pair,up,up}
   }
   \atom[\ce{O_b}]{right}{
     1s, 2s, 2p = {;pair,up,up}
   }
   \molecule[\ce{O2}]{
     1sMO, 2sMO, 2pMO = {;pair,pair,pair,up,up},
     color = { 2piy*=red, 2piz*=red }
   }
   \EnergyAxis
  \end{MOdiagram}
  \caption{MO-Diagramm von $^3$\textSigma-\ce{O2}.}
 \end{figure}
\end{LTXexample}

\begin{LTXexample}[pos=b]
 % use package `chemfig'
 \begin{figure}
  \centering\MOsetup{style = fancy, distance = 7cm, AO-width = 15pt, labels}
  \begin{MOdiagram}
   \atom[N]{left}{
     2p = {0;up,up,up}
   }
   \atom[O]{right}{
     2p = {2;pair,up,up}
   }
   \molecule[NO]{
     2pMO = {1.8,.4;pair,pair,pair,up},
     color = { 2piy*=red }
   }
   \EnergyAxis[title=Energie]
  \end{MOdiagram}
  \caption{Ausschnitt aus dem MO-Diagramm von \protect\Lewis{4.,NO}.}
 \end{figure}
\end{LTXexample}

\end{document}