# mohelper

Draw enhanced MO diagrams. See the manual for further information.

## Web Editor
Access the Web Editor here: 
[https://thevicraft.github.io/modiagram-latex-integration/](https://thevicraft.github.io/modiagram-latex-integration/)

It helps you to create MO diagrams directly in an interactive online editor. It outputs the relevant LaTeX code that you just have to copy into your project.

---

## Features

* **Interactive Editor:** Design MO diagrams visually without writing hundreds of lines of PGF/TikZ code.
* **LaTeX Integration:** Generates ready-to-use code blocks compatible with the provided `mohelper` package.
* **Scientific Accuracy:** Built-in support for Symmetry Groups, Degeneracy, and proper Electron Configuration.

---

## How to use it:

To use the diagrams generated by this tool in your LaTeX project, follow these steps:

### 1. Include the Package:
#### From CTAN
```latex
\usepackage{mohelper}
```
Include this into your preamble. Note that this might not be the newest version. In case you
depend on using a newer version go to 2.1.2.


#### 2. From Local
Download the package and include it into your project.
To do so download the `mohelper.sty` file from
* [Releases](https://github.com/thevicraft/modiagram-latex-integration/releases) (recommended, stable)
* [Repository](https://thevicraft.github.io/modiagram-latex-integration/) (only if you know what you are doing)

and paste the file into your project's root directory.
Ensure you have the `mohelper` package included in your preamble:
```latex
\usepackage{mohelper}
```
If you put `mohelper.sty` into a subdirectory, you must specify its path. Therefore, have this example shown:
```latex
\usepackage{./lib/mohelper.sty}
```

### 3. Configure your Diagram:
Open the [Web Helper](https://thevicraft.github.io/modiagram-latex-integration/) and set up your orbitals, energies, and labels.
    
### Copy & Paste:
Copy the generated LaTeX code and paste it into your `figure` environment or document body.

### 4.
See the manual for further information.

---

## License
Distributed under the GPL-3.0 License.