> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/latex/it/specifico-per-argomento/04-molecular-orbital-diagrams.md).

# Diagrammi degli orbitali molecolari

Questo articolo fornisce una breve introduzione alla creazione di [diagrammi degli orbitali molecolari](https://en.wikipedia.org/wiki/Molecular_orbital_diagram) in LaTeX usando il [`modiagram` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://ctan.org/pkg/modiagram?lang=en). Si consiglia vivamente ai lettori di consultare il [`modiagram` documentazione del pacchetto](http://mirrors.ctan.org/macros/latex/contrib/modiagram/modiagram_en.pdf) che contiene numerosi esempi utili per dimostrare le sue molte funzionalità—molte più di quante possiamo trattare in questo breve articolo.

Per informazioni sui più tradizionali *diagrammi di struttura molecolare* consulta la nostra documentazione su [formule di chimica](/latex/it/specifico-per-argomento/02-chemistry-formulae.md).

## Introduzione

I diagrammi molecolari vengono creati usando il [`modiagram` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://ctan.org/pkg/modiagram?lang=en) che importi nel tuo documento aggiungendo la seguente riga al preambolo:

`\usepackage{modiagram}`\[$$\langle$$`opzioni`$$\rangle$$]

L'insieme di $$\langle$$`opzioni`$$\rangle$$ sono elencate e illustrate nella [documentazione del pacchetto](http://mirrors.ctan.org/macros/latex/contrib/modiagram/modiagram_en.pdf).

Per applicare il pacchetto $$\langle$$`opzioni`$$\rangle$$ *globalmente* puoi

* impostarle quando carichi il pacchetto tramite `\usepackage{modiagram}`\[$$\langle$$`opzioni`$$\rangle$$], oppure
* usa il comando di configurazione `\setmodiagram`{$$\langle$$`opzioni`$$\rangle$$}

I diagrammi MO vengono creati usando l' `modiagram` ambiente, che supporta l'uso locale del pacchetto $$\langle$$`opzioni`$$\rangle$$:

`\begin{modiagram}`\[$$\langle$$`opzioni`$$\rangle$$] ...

`\end{modiagram}`

L'esempio seguente mostra un `modiagram` ambiente senza utilizzare alcun $$\langle$$`opzioni`$$\rangle$$:

```latex
\documentclass{article}
\usepackage{modiagram}
\begin{document}

Primi atomi di esempio:

\begin{modiagram}
\atom{left}{1s, 2s, 2p}
\end{modiagram}
\end{document}
```

[Apri questo esempio in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=example+of+molecular+diagram\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmodiagram%7D%0A%5Cbegin%7Bdocument%7D%0A%0AFirst+example+atoms%3A%0A%0A%5Cbegin%7Bmodiagram%7D%0A%5Catom%7Bleft%7D%7B1s%2C+2s%2C+2p%7D%0A%5Cend%7Bmodiagram%7D%0A%5Cend%7Bdocument%7D)

Questo esempio produce il seguente output:

![Esempio di diagramma molecolare prodotto in LaTeX](/files/950c91236becee408b512ddcbd32671b7c84bb6d)

Il comando di base per disegnare diagrammi MO è `\atom` che, come mostrato nell'esempio sopra, accetta due argomenti:

* `sinistra`: l'allineamento dell'atomo.
* `1s, 2s, 2p`: i sottolivelli energetici da disegnare. Questi possono essere ulteriormente personalizzati, come imparerai nella [sezione successiva](#atoms).

## Atomi

Puoi passare alcune informazioni aggiuntive sugli orbitali atomici al comando presentato nell'esempio introduttivo.

```latex
\documentclass{article}
\usepackage{modiagram}
\begin{document}

\begin{modiagram}
 \atom{right}{
    1s = { 0; pair} ,
    2s = { 1; pair} ,
    2p = {1.5; up, down }
 }

 \atom{left}{
    1s = { 0; pair} ,
    2s = { 1; pair} ,
    2p = {1.5; up, down }
 }
 \end{modiagram}
\end{document}
```

[Apri questo esempio in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=example+of+molecular+diagram\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmodiagram%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Bmodiagram%7D%0A+%5Catom%7Bright%7D%7B%0A++++1s+%3D+%7B+0%3B+pair%7D+%2C%0A++++2s+%3D+%7B+1%3B+pair%7D+%2C%0A++++2p+%3D+%7B1.5%3B+up%2C+down+%7D%0A+%7D%0A%0A+%5Catom%7Bleft%7D%7B%0A++++1s+%3D+%7B+0%3B+pair%7D+%2C%0A++++2s+%3D+%7B+1%3B+pair%7D+%2C%0A++++2p+%3D+%7B1.5%3B+up%2C+down+%7D%0A+%7D%0A+%5Cend%7Bmodiagram%7D%0A%5Cend%7Bdocument%7D)

Questo esempio produce il seguente output:

![esempio di orbitali atomici](/files/e8ba832418a899ebaef947405a792351b058a1f0)

In questo esempio, vengono disegnati due atomi identici, allineati rispettivamente a sinistra e a destra.

Seguendo lo stile della `modiagram` documentazione del pacchetto, la sintassi generica per creare atomi può essere scritta come:

`\atom`\[$$\langle$$`nome`$$\rangle$$]{$$\langle$$`sinistra`$$\rangle$$|$$\langle$$`destra`$$\rangle$$}{$$\langle$$`AO-spec`$$\rangle$$}

dove

* $$\langle$$`nome`$$\rangle$$ è un nome opzionale per l'atomo
* $$\langle$$`sinistra`$$\rangle$$ e $$\langle$$`destra`$$\rangle$$ determinano la posizione nel diagramma
* $$\langle$$`AO-spec`$$\rangle$$ è la specifica dell'Orbitale Atomico.

Il $$\langle$$`AO-spec`$$\rangle$$ ha la forma generale

```latex
sottolivello = {energia; specifiche}
```

dove

* `sottolivello` può essere `1s`, `2s` o `2p`
* `energia` è il livello energetico, un numero che determina la spaziatura verticale nel diagramma. Se omesso, viene impostato a 0.
* `specifiche` è un elenco separato da virgole degli spin degli elettroni contenuti in ciascun orbitale. I valori possibili sono `up`, `down`, `pair` ed empty (si digita solo il punto e virgola) per un orbitale vuoto. Se omesso, viene impostato su `pair`.

Ecco una descrizione dei comandi usati nell'esempio precedente:

* `1s = { 0; pair}`. Il sottolivello `1s` è nel `0` livello energetico, l'orbitale contiene due elettroni (appaiati).
* `2s = { 1; pair}`. Il sottolivello `2s` disegnato nel `1` livello energetico, ci sono due elettroni in questo orbitale.
* `2p = {1.5; up, down}`. Il sottolivello `2p` disegnato nel livello energetico `1.5`, cioè nel diagramma la spaziatura verticale è impostata a 1.5; questo sottolivello energetico ha due elettroni: uno con spin `up` nel primo orbitale e un altro con spin `down` nel secondo orbitale.

Gli stessi comandi vengono ripetuti per il secondo atomo a destra.

Per visualizzare il `nome` opzionale di un atomo usa un `modiagram` ambiente con l' `[names]` opzione:

```latex
\documentclass{article}
\usepackage{modiagram}
\begin{document}
\begin{modiagram}[names]
 \atom[Atomo a destra]{right}{
    1s = { 0; pair} ,
    2s = { 1; pair} ,
    2p = {1.5; up, down }
 }

 \atom[Atomo a sinistra]{left}{
    1s = { 0; pair} ,
    2s = { 1; pair} ,
    2p = {1.5; up, down }
 }
\end{modiagram}
\end{document}
```

[Apri questo esempio in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+the+names+option+in+a+molecular+diagram\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmodiagram%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmodiagram%7D%5Bnames%5D%0A+%5Catom%5BAtom+on+the+right%5D%7Bright%7D%7B%0A++++1s+%3D+%7B+0%3B+pair%7D+%2C%0A++++2s+%3D+%7B+1%3B+pair%7D+%2C%0A++++2p+%3D+%7B1.5%3B+up%2C+down+%7D%0A+%7D%0A%0A+%5Catom%5BAtom+on+the+left%5D%7Bleft%7D%7B%0A++++1s+%3D+%7B+0%3B+pair%7D+%2C%0A++++2s+%3D+%7B+1%3B+pair%7D+%2C%0A++++2p+%3D+%7B1.5%3B+up%2C+down+%7D%0A+%7D%0A%5Cend%7Bmodiagram%7D%0A%5Cend%7Bdocument%7D)

Questo esempio produce il seguente output:

![Esempio di orbitale molecolare](/files/e49d09a03326868e68c7c85c1a763033d00a8127)

## Molecole

La sintassi per le molecole è molto simile a quella del [`\atom`](#atoms) e, nello stile della documentazione, può essere scritta come:

`\molecule`\[$$\langle$$`nome`$$\rangle$$]{$$\langle$$`MO-spec`$$\rangle$$}

dove

* $$\langle$$`nome`$$\rangle$$ è una didascalia opzionale della molecola
* $$\langle$$`MO-spec`$$\rangle$$ è la specifica dell'Orbitale Molecolare

I sottolivelli energetici `1s`, `2s` e `2p` diventano `1sMO`, `2sMO` e `2pMO` rispettivamente. Ecco un esempio base:

```latex
\documentclass{article}
\usepackage{modiagram}
\begin{document}
\begin{modiagram}
 \atom{left}{1s}
 \atom{right}{1s={;up}}
 \molecule{
    1sMO={0.75;pair,up}
  }
\end{modiagram}
\end{document}
```

[Apri questo esempio in Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Molecule+example+with+modiagram+package\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmodiagram%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmodiagram%7D%0A+%5Catom%7Bleft%7D%7B1s%7D%0A+%5Catom%7Bright%7D%7B1s%3D%7B%3Bup%7D%7D%0A+%5Cmolecule%7B%0A++++1sMO%3D%7B0.75%3Bpair%2Cup%7D%0A++%7D%0A%5Cend%7Bmodiagram%7D%0A%5Cend%7Bdocument%7D)

Questo esempio produce il seguente output:

![esempio di diagramma molecolare](/files/720f2885feec64f199229361e50d497029e90f27)

Nell'esempio sopra, la specifica dell'orbitale molecolare ($$\langle$$`MO-spec`$$\rangle$$ ) è

```latex
1sMO={0.75;pair,up}
```

dove

* `0.75` ora è il rapporto *(guadagno di energia)/(perdita di energia)*.
* `pair, up` sono gli spin degli elettroni negli orbitali molecolari di legame e antileganti, rispettivamente.

L'esempio successivo, leggermente più elaborato, dovrebbe aiutarti a capire la sintassi:

```latex
\documentclass{article}
\usepackage{modiagram}
\begin{document}
\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{document}
```

[Apri questo esempio in Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=More+elaborate+modiagram+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmodiagram%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmodiagram%7D%0A+%5Catom%7Bleft%7D%7B%0A++++++1s%2C+2s%2C+2p+%3D+%7B%3Bpair%2Cup%2Cup%7D%0A++%7D%0A++%5Catom%7Bright%7D%7B%0A++++++1s%2C+2s%2C+2p+%3D+%7B%3Bpair%2Cup%2Cup%7D%0A++%7D%0A++%5Cmolecule%7B%0A++++++1sMO%2C+2sMO%2C+2pMO+%3D+%7B%3Bpair%2Cpair%2Cpair%2Cup%2Cup%7D%0A++%7D%0A%5Cend%7Bmodiagram%7D%0A%5Cend%7Bdocument%7D)

Questo esempio produce il seguente output:

![esempio elaborato di orbitale molecolare](/files/0d92a8aba03719f084d04a39586f1b65fe652087)

Tre atomi sono posizionati su ciascun lato del diagramma e la molecola corrispondente si trova al centro.

## Schema di denominazione

Il diagramma seguente è riprodotto dalla [`modiagram` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://ctan.org/pkg/modiagram?lang=en) documentazione. Contiene i nomi (etichette) usati per gli orbitali, che sono nodi in un `tikzpicture` e quindi possono essere usati nei normali comandi di disegno TikZ all'interno di un `modiagram` ambiente.

![nomi di modiagram per gli orbitali](/files/790994befd4fc20b9aa538853e058fe7c22d812a)

Ecco un esempio che usa il nome dell'orbitale antilegante `1sigma*` per il posizionamento relativo.

```latex
\documentclass{article}
\usepackage{modiagram}
\begin{document}
\begin{modiagram}
 \atom{left}{1s}
 \atom{right}{1s={;up}}
 \molecule{
    1sMO={;pair,up}
 }
 \draw[<-,shorten <=8pt,shorten >=15pt,blue]
 (1sigma*) --++(2,1) node {MO antilegante};
\end{modiagram}
\end{document}
```

[Apri questo esempio in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+orbital+labels+in+an+modiagram+environment\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bmodiagram%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmodiagram%7D%0A+%5Catom%7Bleft%7D%7B1s%7D%0A+%5Catom%7Bright%7D%7B1s%3D%7B%3Bup%7D%7D%0A+%5Cmolecule%7B%0A++++1sMO%3D%7B%3Bpair%2Cup%7D%0A+%7D%0A+%5Cdraw%5B%3C-%2Cshorten+%3C%3D8pt%2Cshorten+%3E%3D15pt%2Cblue%5D%0A+%281sigma%2A%29+--%2B%2B%282%2C1%29+node+%7Banti-bonding+MO%7D%3B%0A%5Cend%7Bmodiagram%7D%0A%5Cend%7Bdocument%7D)

Questo esempio produce il seguente output:

![esempio di orbitale antilegante](/files/06f2057736d0e2ea284c0fd0f750b0e9ebe458b7)

## Approfondimenti

Per ulteriori informazioni vedi:

* [Formule di chimica](/latex/it/specifico-per-argomento/02-chemistry-formulae.md)
* [Diagrammi di Feynman](/latex/it/specifico-per-argomento/03-feynman-diagrams.md)
* [Pacchetto TikZ](/latex/it/figure-e-tabelle/05-tikz-package.md)
* [Disegnare diagrammi direttamente in LaTeX](/latex/it/figure-e-tabelle/04-picture-environment.md)
* [Inserimento di immagini](/latex/it/altri-argomenti/27-inserting-images.md)
* [Elenco delle lettere greche e dei simboli matematici](/latex/it/matematica/11-list-of-greek-letters-and-math-symbols.md)
* [Il `modiagram` manual](http://mirrors.ctan.org/macros/latex/contrib/modiagram/modiagram_en.pdf)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/latex/it/specifico-per-argomento/04-molecular-orbital-diagrams.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
