summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/modiagram/modiagram_doc_de.tex
blob: 385d9d1f3aa3900638e84778516ebee6e9068a77 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% --------------------------------------------------------------------------- %
% - MOdiagram - modiagram_doc_de.tex                                        - %
% - easy creation of molecular orbital diagrams                             - %
% --------------------------------------------------------------------------- %
% - Clemens NIEDERBERGER                                                    - %
% - 2011/09/25                                                              - %
% --------------------------------------------------------------------------- %
% - 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 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[ngerman]{babel}
\usepackage[utf8]{inputenx}
\usepackage[dvipsnames]{xcolor}
  \colorlet{code}{RawSienna}
\usepackage{modiagram,xspace,siunitx,framed,chemfig}
\usepackage{showexpl}
\usepackage[version=3]{mhchem}

\usepackage{showexpl}
\lstset{
  language         = [LaTeX]TeX,
  basicstyle       = {\ttfamily\small\color{code!80}},
  breaklines       = true,
  commentstyle     = {\color[named]{Gray}},
  backgroundcolor  = \color{yellow!20},
  numbers          = left,
  numberstyle      = \tiny,
  numberblanklines = true,
  numbersep        = .3em,
  xleftmargin      = 1em,
  gobble           = 1
}

\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.1\xspace}
\newcommand*\MOdate{2011/09/25}

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

\newcommand*\changefont[3]{\fontfamily{#1}\fontseries{#2}\fontshape{#3}\selectfont}

\DeclareDocumentEnvironment{myquote}{o}
  {\quote\small\changefont{cmss}{m}{sl}}
  {\IfNoValueF{#1}{\par\noindent\parbox{\linewidth}{\raggedleft\normalfont\itshape#1}}\endquote}
\NewDocumentCommand\cmd{v}{{\color{code!80}\ttfamily#1}}

\newcommand*\TikZ{\mbox{Ti\textbf{\textit{k}}Z}\xspace}
\newcommand*\bzw{\mbox{bzw.}\xspace}

\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

\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}}, \paket{amsmath} 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{myquote}
 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{myquote}
Dort wird das Problem mit \TikZ gelöst, da es bis dato noch kein Paket für diese Aufgabe gab. \MOname soll diese Lücke nun füllen.

\section{Basisbefehle}
Alle MO-Diagramme werden mit der Umgebung \cmd=MOdiagram= erzeugt. Innerhalb dieser Umgebung sind zunächst zwei Befehle wichtig.

\subsection{Der \texttt{\textbackslash atom} Befehl}
\begin{framed}
 \cmd=\atom[<name>]{<pos>}{<AO-spec>}=
 \begin{itemize}\small
  \item\cmd=<name>= (o) Beschriftung des Atoms
  \item\cmd=<pos>= (m) links oder rechts im MO-Diagramm
  \item\cmd=<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 \cmd=<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\cmd+1s={<rel. energy>; <el-spec>}+
  \item\cmd+2s={<rel. energy>; <el-spec>}+
  \item\cmd+2p={<rel. energy>; <x el-spec>, <y el-spec>, <z el-spec>}+
 \end{itemize}
\end{framed}
Die \cmd=<el-spec>= können die Werte \cmd=pair=, \cmd=up= und \cmd=down= annehmen oder leer gelassen werden. \cmd=<rel. energy>= ist in etwa mit der $y$-Koordinate gleichzusetzen und verschiebt das AO in vertikaler Richtung um \cmd=<rel. energy>= \si{\centi\metre} auf- (positiv) oder abwärts (negativ).

Das Argument \cmd=<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}
 \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 nächsten Befehl dazu nehmen.

\subsection{Der \texttt{\textbackslash molecule} Befehl}
\begin{framed}
 \cmd=\molecule[<name>]{<MO-spec>}=
 \begin{itemize}\small
  \item\cmd=<name>= (o) Beschriftung des Moleküls
  \item\cmd=<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 \cmd=\molecule= werden die Atom-Orbitale (AO) verbunden und die entsprechenden bindenden und antibindenden Orbitale des Moleküls (MO) gezeichnet. \cmd=\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 \cmd=<MO-spec>= erwartet dabei durch Kommata getrennt folgende Key-Value-Paare:
\begin{framed}
 \begin{itemize}
  \item\cmd+1sMO={<energy gain>; <s el-spec>, <s* el-spec>}+ (verbindet die durch \cmd=1s= spezifizierten AO.)
  \item\cmd+2sMO={<energy gain>; <s el-spec>, <s* el-spec>}+ (verbindet die durch \cmd=2s= spezifizierten AO.)
  \item\cmd+2pMO={<s energy gain>, <p energy gain>; <s el-spec>, <py el-spec>, <pz el- spec>, <py* el-spec>, <pz* el-spec>, <s* el-spec>}+ (verbindet die durch \cmd=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}
 \begin{MOdiagram} 
  \atom{left} { 1s = {  0; } }
  \atom{right}{ 1s = {  0; } }
  \molecule { 2sMO = {.75; , } }
 \end{MOdiagram}
\end{lstlisting}
Der Wert, der für \cmd=<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}
Beachten Sie, dass Sie bei \cmd=2pMO= \emph{zwei} solche Werte 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 = {0;pair},
    2s = {2;pair},
    2p = {5;pair,up,up}
  }
  \atom{right}{
    1s = {0;pair},
    2s = {2;pair},
    2p = {5;pair,up,up}
  }
  \molecule{
    1sMO  = {.5;pair,pair},
    2sMO  = {.5;pair,pair},
    2pMO  = {1.5,.5;pair,pair,pair,up,up,}
  }
 \end{MOdiagram}
\end{LTXexample}

\subsection{Die Namensgebung}\label{Namensgebung}
Da man üblicherweise die AO und MO auch beschriften (können) möchte und sie in der \cmd=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]
 \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 üblich \TikZ-Befehlen zu referenzieren:
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 1s = {0; } }
  \atom{right}{ 1s = {0; } }
  \molecule { 1sMO = {.75; , } }
  \draw[<->,red,semithick] (1sigma) -- (1sigma*) ;
  \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,fill=blue!20,opacity=.5] (1sigma*) circle (8pt);
 \end{MOdiagram}
\end{LTXexample}

\subsection{AOs und MOs 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}{}
 \atom[Xe]{right}{}
 \molecule[\ce{XeF2}]{}
 \AO[a](1cm){s}{0;up}
 \AO[b](1cm){s}{.25;up}
 \AO[c](3cm){s}{-1;pair}
 \AO[d](3cm){s}{0;pair}
 \AO[e](3cm){s}{1.5;}
 \AO[f](5cm){s}{1.25;pair}
 \connect{ a & d , b & c , b & e , c & f , e & f }
 \node[right,xshift=4mm] at (c) {\footnotesize bindend};
 \node[above] at (d.90) {\footnotesize nicht bindend};
 \node[above] at (e.90) {\footnotesize antibindend};
\end{MOdiagram}
\end{center}
Um solche MO-Diagramme erstellen zu können, gibt es folgenden Befehl:
\begin{framed}
 \cmd=\AO[<name>](<xshift>){<type>}{<energy>;<el-spec>}=
 \begin{itemize}\small
  \item\cmd=<name>= (o) Name der Node
  \item\cmd=<xshift>= (o) Vertikale Position des Orbitals, eine \TeX-Länge mit Einheit
  \item\cmd=<type>= (m) \cmd=s= oder \cmd=p=
  \item\cmd=<AO-spec>= (m) Spezifizierung des Atom-Orbitals 
 \end{itemize}
\end{framed}
Je nach \cmd=<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}
Beachten Sie, dass als \cmd=<el-spec>= beim Typ \cmd=s= nur eine Spezifikation erwartet wird, beim Typ \cmd=p= aber drei durch Komma getrennte.

Möchte man ein AO genau an die Position eines Atoms setzen, so muss man deren \cmd=<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;pair}
  \AO(3cm){s}{2;pair}
  \AO(5cm){s}{2;pair}
 \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 \cmd=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;pair}
  \AO(1cm-20pt){s}{  1;up}
  \AO(1cm-40pt){s}{1,5;down}
  % ueber dem rechten:
  \AO(5cm)     {s}{ .5;pair}
  \AO(5cm+20pt){s}{  1;up}
  \AO(5cm+40pt){s}{1.5;down}
 \end{MOdiagram}
\end{LTXexample}

Auch die mit \cmd=\AO= gesetzten Orbitale können mit Linien verbunden werden. Das kann man natürlich mit dem \cmd=\draw=-Befehl machen:
\begin{LTXexample}
 \begin{MOdiagram}
  \AO[a]{s}{0;} \AO[b](2cm){s}{1;}
  \AO[c]{s}{2;} \AO[d](2cm){s}{1.5;}
  \draw (a) -- (b) (c) -- (d);
 \end{MOdiagram}
\end{LTXexample}
Soll die Verbindungslinie aber zu dem Stil der durch \cmd=\molecule= erzeugten Linien\footnote{Dieser Stil kann angepasst werden, siehe Seite \pageref{option:lines}.} passen, dann sollte man den Befehl \cmd=\connect= verwenden.
\begin{framed}
 \cmd=\connect{<AO-connect>}=
 \begin{itemize}\small
  \item\cmd=<AO-connect>= (m) durch Kommata getrennte Liste von durch \cmd=&= verbundenen Node-Paaren, die verbunden werden sollen.
 \end{itemize}
\end{framed}
Dieser Befehl erwartet eine durch Kommata getrennte Liste von durch \cmd=&= verbundenen Paaren von Node-Namen derer Nodes, die verbunden werden sollen:
\begin{LTXexample}
 \begin{MOdiagram}
  \AO[a]{s}{0;} \AO[b](2cm){s}{1;}
  \AO[c]{s}{2;} \AO[d](2cm){s}{1.5;}
  \connect{ a & b, c & d }
 \end{MOdiagram}
\end{LTXexample}
Einige Punkte müssen dabei noch erwähnt werden: \cmd=\connect= fügt der ersten Node den Anker \cmd=east= und der zweiten den Anker \cmd=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 \cmd=<distance>= (\cmd=<dist>=) und \cmd=<AO-width>= (\cmd=<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}[distance=6cm,AO-width=25pt,labels-fs=\tt\footnotesize,labels-style={text width=40pt,align=center}]
 \atom{left}{
   1s={0;},
   2s={3;},
   2p={8;,,},
   label={ 1sleft={1cm}, 2sleft={1cm}, 2pxleft={1cm}, 2pyleft={1cm - 2*<AO>}, 2pzleft={1cm - 4*<AO>} } }
 \atom{right}{
   1s={0;},
   2s={3;},
   2p={8;,,},
   label={ 1sright={1cm + <dist>}, 2sright={1cm + <dist>}, 2pxright={1cm+ <dist>}, 2pyright={1cm + <dist> + 2*<AO>}, 2pzright={1cm + <dist> + 4*<AO>} } }
 \molecule{
   1sMO={.75;,},
   2sMO={.75;,},
   2pMO={3,1;,,,,,},
   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}

\section{Anpassen des Layouts}
\subsection{Umgebungs-Optionen}
Es gibt folgende Optionen, mit denen das Aussehen der MO-Diagramme verändert werden kann.
\begin{itemize}
 \item\cmd+style=<type>+ Verändern des Stils der Orbitale und Verbindungslinien, Abschnitt \ref{option:style}.
 \item\cmd+distance=<dim>+ Der Abstand zwischen linkem und rechtem Atom, Abschnitt \ref{option:distance}.
 \item\cmd+AO-width=<dim>+ Die Größe der Orbitale ändern, Abschnitt \ref{option:AO-width}.
 \item\cmd+lines=<tikz>+ \TikZ-Stil der Verbindungslinien anpassen, Abschnitt \ref{option:lines}.
 \item\cmd+names=<bool>+ Atome und Molekül beschriften, Abschnitt \ref{option:names}.
 \item\cmd+labels=<bool>+ Orbitale mit Default Beschriftung versehen, Abschnitt \ref{option:labels}.
 \item\cmd+labels-fs=<cs>+ Schriftgröße der Label-Beschriftung verändern, Abschnitt \ref{option:labels-fs}.
 \item\cmd+labels-style=<tikz>+ \TikZ-Stil der Label-Beschriftung verändern, Abschnitt \ref{option:labels-style}.
\end{itemize}
Sie alle werden nachfolgend besprochen. Aufgerufen werden sie entweder als Option der Umgebung
\begin{lstlisting}
 \begin{MOdiagram}[<key = value>]
  ...
 \end{MOdiagram}
\end{lstlisting}
oder über den Setup-Befehl
\begin{framed}
 \cmd+\MOsetup{<key = value>}+
 \begin{itemize}\small
  \item\cmd+<key = val>+ (m) komma-separierte Schlüssel-Wert-Liste
 \end{itemize}
\end{framed}

\subsubsection{Option \texttt{style}}\label{option:style}
Es gibt vier verschiedene Stile, aus denen ausgewählt werden kann:
\begin{itemize}
 \item\cmd+style=plain+ \AOinline[style=plain]{pair} (Default)
 \item\cmd+style=square+ \AOinline[style=square]{pair}
 \item\cmd+style=round+ \AOinline[style=round]{pair}
 \item\cmd+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 = {0;up} }
  \atom[H]{right}{ 1s = {0;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair,} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 % use package 'mhchem'
 \begin{MOdiagram}[style=square]
  \atom[H]{left} { 1s = {0;up} }
  \atom[H]{right}{ 1s = {0;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair,} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 % use package 'mhchem'
 \begin{MOdiagram}[style=round]
  \atom[H]{left} { 1s = {0;up} }
  \atom[H]{right}{ 1s = {0;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair,} }
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 % use package 'mhchem'
 \begin{MOdiagram}[style=fancy]
  \atom[H]{left} { 1s = {0;up} }
  \atom[H]{right}{ 1s = {0;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 \cmd+distance=<dim>+ lässt sie sich verändern. Damit wird die Position des rechten Atoms auf \cmd=1cm + <dim>= gesetzt und die Position des Moleküls auf \cmd=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 = {0;up} }
  \atom[H]{right}{ 1s = {0;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair,} }
 \end{MOdiagram}
\end{LTXexample}

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

\subsubsection{Option \texttt{lines}}\label{option:lines}
Der Option \cmd=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 = {0;up} }
  \atom[H]{right}{ 1s = {0;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair,} }
 \end{MOdiagram}
\end{LTXexample}

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

\subsubsection{Option \texttt{labels}}\label{option:labels}
Mit der Option \cmd=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 = {0;up} }
  \atom[H]{right}{ 1s = {0;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair,} }
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Option \texttt{labels-fs}}\label{option:labels-fs}
Per Default werden die Labels mit der Schriftgröße \cmd=\small= gesetzt. Wenn man das ändern möchte, kann man die Option \cmd=labels-fs= verwenden.
\begin{LTXexample}
 % use package 'mhchem'
 \begin{MOdiagram}[labels,labels-fs=\footnotesize]
  \atom[H]{left} { 1s = {0;up} }
  \atom[H]{right}{ 1s = {0;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 = {0;up} }
  \atom[H]{right}{ 1s = {0;up} }
  \molecule[\ce{H2}]{ 1sMO = {.75;pair,} }
 \end{MOdiagram}
\end{LTXexample}

\subsubsection{Option \texttt{labels-style}}\label{option:labels-style}
Mit der Option \cmd=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}]
  \atom[H]{left} { 1s = {0;up} }
  \atom[H]{right}{ 1s = {0;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 ändern möchte oder auch nur einzelne Label verwenden möchte, kann man den Key \cmd=label= einsetzen. Dieser Key wird im \cmd=\atom=- und im \cmd=\molecule=-Befehl bei \cmd=<AO-spec>= \bzw \cmd=<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 = {0;up} }
  \atom[H]{right}{ 1s = {0;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 = {0;up} }
  \atom{right}{ 1s = {0;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}

\subsubsection{Der \texttt{color} Key}\label{key:color}
Analog zum \cmd=label=-Key kann der \cmd=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 = {0;pair},
    color = { 1sleft = blue }
  }
  \atom[H]{right}{
    1s = {0;pair},
    color = { 1sright = red }
  }
  \molecule[\ce{H2}]{
    1sMO  = {.75;pair,pair},
    label = { 1sigma = {bindendes MO} },
    color = { 1sigma = green, 1sigma* = cyan }
  }
 \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 \cmd=\EnergyAxis=
\begin{framed}
 \cmd+\EnergyAxis[<key = val>]+
 \begin{itemize}\small
  \item\cmd+<key = val>+ (o) Schlüssel-Wert-Paare, um die Achse zu modifizieren.
 \end{itemize}
\end{framed}
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 1s = {0;up} }
  \atom{right}{ 1s = {0;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\cmd+title=<title>+ Achsenbeschriftung (Default: \cmd=energy=).
  \item\cmd+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: \cmd=>=).
 \end{itemize}
\end{framed}
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 1s = {0;up} }
  \atom{right}{ 1s = {0;up} }
  \molecule{ 1sMO = {.75;pair,} }
  \EnergyAxis[title]
 \end{MOdiagram}
\end{LTXexample}
\begin{LTXexample}
 \begin{MOdiagram}
  \atom{left} { 1s = {0;up} }
  \atom{right}{ 1s = {0;up} }
  \molecule{ 1sMO = {.75;pair,} }
  \EnergyAxis[title=Energie,head=stealth]
 \end{MOdiagram}
\end{LTXexample}

\subsection{Beispiele}
\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 = {0;pair},
     2s = {2;pair},
     2p = {5;pair,up,up}
   }
   \atom[\ce{O_b}]{right}{
     1s = {0;pair},
     2s = {2;pair},
     2p = {5;pair,up,up}
   }
   \molecule[\ce{O2}]{
     1sMO  = {.5;pair,pair},
     2sMO  = {.5;pair,pair},
     2pMO  = {1.5,.5;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
  \begin{MOdiagram}[style=fancy,distance=7cm,AO-width=15pt,labels]
   \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]
  \end{MOdiagram}
  \caption{Ausschnitt aus dem MO-Diagramm von \protect\Lewis{4.,NO}.}
 \end{figure}
\end{LTXexample}

\end{document}