> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/latex/fi/alakohtaiset/04-molecular-orbital-diagrams.md).

# Molekyyliorbitaalikaaviot

Tämä artikkeli tarjoaa lyhyen johdannon luomiseen [molekyyliorbitaalikaavioita](https://en.wikipedia.org/wiki/Molecular_orbital_diagram) LaTeXissa käyttäen [`modiagram` paketti](https://ctan.org/pkg/modiagram?lang=en). Lukijoita kannustetaan vahvasti tutustumaan [`modiagram` pakettidokumentaatio](http://mirrors.ctan.org/macros/latex/contrib/modiagram/modiagram_en.pdf) joka sisältää lukuisia hyödyllisiä esimerkkejä, jotka havainnollistavat sen monia ominaisuuksia — paljon enemmän kuin voimme käsitellä tässä lyhyessä artikkelissa.

Lisätietoja perinteisemmistä *molekyylirakennediagrammeista* katso dokumentaatiostamme [kemian kaavoista](/latex/fi/alakohtaiset/02-chemistry-formulae.md).

## Johdanto

Molekyylikaavioita luodaan käyttäen [`modiagram` paketti](https://ctan.org/pkg/modiagram?lang=en) jonka tuot dokumenttiisi lisäämällä seuraava rivi sen esipuheeseen:

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

Joukko $$\langle$$`asetuksia`$$\rangle$$ luetellaan ja esitellään [pakettidokumentaatio](http://mirrors.ctan.org/macros/latex/contrib/modiagram/modiagram_en.pdf).

Ottaaksesi paketin asetuksen $$\langle$$`asetuksia`$$\rangle$$ *globaalisti* voit

* asettaa ne, kun lataat paketin käyttäen `\usepackage{modiagram}`\[$$\langle$$`asetuksia`$$\rangle$$], tai
* käyttää asetuskomentoa `\setmodiagram`{$$\langle$$`asetuksia`$$\rangle$$}

MO-kaavioita luodaan käyttäen `modiagram` ympäristöä, joka tukee paketin asetusten paikallista käyttöä $$\langle$$`asetuksia`$$\rangle$$:

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

`\end{modiagram}`

Seuraava esimerkki havainnollistaa minimaalisen `modiagram` ympäristön ilman mitään $$\langle$$`asetuksia`$$\rangle$$:

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

Ensimmäiset esimerkkiatomit:

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

[Avaa tämä esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Esimerkki LaTeXissa tuotetusta molekyyliorbitaalikaaviosta](/files/09e38733f575b2e20c21224934c038a7e87d26bf)

Peruskomento MO-kaavioiden piirtämiseen on `\atom` joka, kuten yllä olevassa esimerkissä osoitetaan, ottaa kaksi argumenttia:

* `left`: atomin kohdistus.
* `1s, 2s, 2p`: piirrettävät energia-alatasot. Näitä voidaan edelleen mukauttaa, kuten opit [seuraava osa](#atoms).

## Atomit

Voit antaa komennolle, joka esiteltiin johdantoesimerkissä, joitakin lisätietoja atomiorbitaaleista.

```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}
```

[Avaa tämä esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![esimerkki atomiorbitaaleista](/files/14f0387ec9d71ac9ab9c04b9c7c9753de6359d9a)

Tässä esimerkissä piirretään kaksi identtistä atomia, vasemmalle ja oikealle tasattuna.

Seuraamalla `modiagram` paketin dokumentaation tyyliä, atomien yleinen syntaksi voidaan kirjoittaa näin:

`\atom`\[$$\langle$$`nimi`$$\rangle$$]{$$\langle$$`left`$$\rangle$$|$$\langle$$`right`$$\rangle$$}{$$\langle$$`AO-spec`$$\rangle$$}

jossa

* $$\langle$$`nimi`$$\rangle$$ on atomille valinnainen nimi
* $$\langle$$`left`$$\rangle$$ ja $$\langle$$`right`$$\rangle$$ määrittää sijainnin kaaviossa
* $$\langle$$`AO-spec`$$\rangle$$ on atominorbitaalin määritys.

Se $$\langle$$`AO-spec`$$\rangle$$ on yleisessä muodossa

```latex
alataso = {energia; määritykset}
```

jossa

* `alataso` voi olla `1s`, `2s` tai `2p`
* `energia` on energiataso, luku, joka määrittää pystysuuntaisen välin kaaviossa. Jos se jätetään pois, se asetetaan arvoon 0.
* `määritykset` on pilkuilla eroteltu lista kunkin orbitaalin sisältämien elektronien spinitiloista. Mahdolliset arvot ovat `ylös`, `alas`, `pari` ja tyhjä (kirjoitetaan vain puolipiste) tyhjälle orbitaalille. Jos se jätetään pois, se asetetaan arvoon `pari`.

Tässä on kuvaus edellisessä esimerkissä käytetyistä komennoista:

* `1s = { 0; pair}`. Alataso `1s` on `0` energiatasolla, orbitaali sisältää kaksi (paritettua) elektronia.
* `2s = { 1; pair}`. Alataso `2s` piirretään `1` energiatasolla, tässä orbitaalissa on kaksi elektronia.
* `2p = {1.5; up, down}`. Alataso `2p` piirretään energiatasolla `1.5`, ts. kaaviossa pystysuora väli on asetettu arvoon 1.5; tällä alatasolla on kaksi elektronia: yksi spinillä `ylös` ensimmäisessä orbitaalissa ja toinen spinillä `alas` toisessa orbitaalissa.

Samat komennot toistetaan oikealla olevan toisen atomin kohdalla.

Näyttääksesi atomin (valinnaisen) `nimi` nimen, käytä `modiagram` ympäristöä, jossa on `[names]` asetus:

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

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

[Avaa tämä esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Esimerkki molekyyliorbitaalista](/files/7a2c6d61b33d09432e58912be0a38e1f12ac6ac1)

## Molekyylit

Molekyylien syntaksi on hyvin samankaltainen kuin [`\atom`](#atoms) ja dokumentaation tyyliin voidaan kirjoittaa näin:

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

jossa

* $$\langle$$`nimi`$$\rangle$$ on molekyylin valinnainen kuvateksti
* $$\langle$$`MO-spec`$$\rangle$$ on molekyyliorbitaalin määritys

Energia-alatasot `1s`, `2s` ja `2p` muuttuvat `1sMO`, `2sMO` ja `2pMO` vastaavasti. Tässä on perusesimerkki:

```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}
```

[Avaa tämä esimerkki Overleafissa](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![esimerkki molekyylikaaviosta](/files/dd65a0ef9e0e1d5ba97766eb48ea55d346808b90)

Yllä olevassa esimerkissä molekyyliorbitaalin määritys ($$\langle$$`MO-spec`$$\rangle$$ ) on

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

jossa

* `0.75` on nyt suhdeluku *(energian nousu)/(energian lasku)*.
* `pari, ylös` ovat sitovien ja vastasitovien molekyyliorbitaalien elektronien spinit, vastaavasti.

Seuraavan, hieman yksityiskohtaisemman, esimerkin pitäisi auttaa sinua ymmärtämään syntaksia:

```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}
```

[Avaa tämä esimerkki Overleafissa](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![yksityiskohtaisempi esimerkki molekyyliorbitaalista](/files/0d2a149e99cbc9ddaf3b396bc1806c92d20d7d9a)

Kolme atomia asetetaan kaavion kummallekin puolelle ja vastaava molekyyli on keskellä.

## Nimeämiskäytäntö

Seuraava kaavio on toistettu [`modiagram` paketti](https://ctan.org/pkg/modiagram?lang=en) dokumentaatiosta. Se sisältää orbitaaleissa käytetyt nimet (selitteet), jotka ovat solmuja `tikzpicture` ja joita voidaan siten käyttää tavallisissa TikZ-piirtokomennoissa `modiagram` ympäristössä.

![modiagramin orbitaalien nimet](/files/67db0ed2288aa27d989f877c18815ee9fef60c98)

Tässä on esimerkki, jossa käytetään sitovan vastaisen orbitaalin nimeä `1sigma*` suhteelliseen sijoitteluun.

```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 {vastasitova MO};
\end{modiagram}
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![esimerkki orbitaalista, jossa on vastasitova](/files/5eb8d5c92c3523b637fc4b6f57ef80c755a07548)

## Lisälukemista

Lisätietoja löydät:

* [Kemian kaavat](/latex/fi/alakohtaiset/02-chemistry-formulae.md)
* [Feynman-diagrammit](/latex/fi/alakohtaiset/03-feynman-diagrams.md)
* [TikZ-paketti](/latex/fi/kuvat-ja-taulukot/05-tikz-package.md)
* [Kaavioiden piirtäminen suoraan LaTeXissä](/latex/fi/kuvat-ja-taulukot/04-picture-environment.md)
* [Kuvien lisääminen](/latex/fi/lisaa-aiheita/27-inserting-images.md)
* [Luettelo kreikkalaisista kirjaimista ja matemaattisista symboleista](/latex/fi/matematiikka/11-list-of-greek-letters-and-math-symbols.md)
* [Se `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://overleaf-pro.ayaka.space/latex/fi/alakohtaiset/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.