+++
title = "Run a first simulation"
weight = 40
+++

## Run a first simulation

This section explains how to run a first simulation.

* [Post installation steps](#post-installation-steps")
* [Running the first Python simulation](#running-the-first-python-simulation")

#### Post installation steps

If a Python package is produced in the build phase, then after installation, the
Python package ("wheel") can be found under the folder
`<install_dir>/share/BornAgain/wheel`.
The wheel can be installed via `pip`; for instance
```bash
python3 -m pip install <install_dir>/share/BornAgain/wheel/bornagain-*.whl
```

#### Running the first Python simulation

In your installation directory you will find the following directory structure:

```
|-- lib               - BornAgain libraries
|-- share
|   |-- BornAgain
|       |-- Examples - Example scripts
|       |-- wheel    - Python wheel
|       |-- bornagain_build.log
```

Run an example and enjoy your first BornAgain simulation plot.

```bash
python <install_dir>/share/BornAgain/Examples/scatter2d/CylindersAndPrisms.py
```
