Metadata-Version: 2.1
Name: pySIMsalabim
Version: 1
Home-page: https://github.com/kostergroup/pySIMsalabim
Download-URL: https://github.com/kostergroup/pySIMsalabim/v1.tar.gz
Author: Vincent M. Le Corre, Sander Heester, L. Jan Anton Koster
Author-email: 
License: GPLv3
Keywords: Drift-diffusion,semiconductor,solar cells
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy <=2.0,>=1.2
Requires-Dist: pandas >=1.4
Requires-Dist: matplotlib >=3.5
Requires-Dist: jupyterlab >=3.4
Requires-Dist: seaborn >=0.11
Requires-Dist: scipy >=1.0
Requires-Dist: gitpython >=3.1
Requires-Dist: openpyxl >=3.0
Provides-Extra: dev
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: twine ; extra == 'dev'

# pySIMsalabim

## Description
**pySIMsalabim** is a Python package used to interface drift-diffusion simulator [SIMsalabim](https://github.com/kostergroup/SIMsalabim) with Python. It provides many useful tools to set up and run simulations, as well as to analyze and visualize the results.

## Authors
* [Vincent M. Le Corre](https://github.com/VMLC-PV)
* [Sander Heester](https://github.com/sheester)
* [L. Jan Anton Koster](https://github.com/kostergroup)

## Institutions
<img src="./docs/logo/rug_logo.png" alt="RuG logo" width="100px"> Zernike Institute for Advanced Materials, University of Groningen, The Netherlands

<img src="./docs/logo/sdu_logo.png" alt="SDU logo" width="100px"> CAPE - Centre for Advanced Photovoltaics and Thin-film Energy Devices, University of Southern Denmark, Denmark

## Installation

### With pip
To install pySIMsalabim with pip you have two options:

1. Install pySIMsalabim using the [PyPI repository](https://pypi.org/project/pySIMsalabim/)

    ```bash
    pip install pySIMsalabim 
    ```

2. Install pySIMsalabim using the GitHub repository. First, you need to clone the repository and install the requirements. The requirements can be installed with the following command:

    ```bash
    pip install -r requirements.txt
    ```

    Similarly to the conda installation, if you plan on using the BoTorch/Ax optimizer you need to use the `requirements_torch_CPU.txt` file or install PyTorch with the correct version for your system with the `requirements.txt` file.

### With conda
To install pySIMsalabim, you need to clone the repository and install the requirements. The requirements can be installed with the following command:

```bash
conda create -n pySIMsalabim 
conda activate pySIMsalabim
conda install --file requirements.txt
```

If you want, you can also clone your base environment by replacing the first line with:

```bash
conda create -n pySIMsalabim --clone base
```

## Additional necessary installs for the drift-diffusion software

### SIMsalabim
The drift-diffusion simulations are run using the [SIMsalabim](https://github.com/kostergroup/SIMsalabim) package. Therefore, you need to install SIMsalabim prior to running any simulations.

All the details to install SIMsalabim are detailed in the [GitHub repository](https://github.com/kostergroup/SIMsalabim). To make sure that you are running the latest version of SIMsalabim, check the repository regularly. You can also install SIMsalabim by running the following Python script:

```python
import os
import pySIMsalabim
from pySIMsalabim.install.get_SIMsalabim import *

cwd = os.getcwd()
install_SIMsalabim(cwd)
```

### Free Pascal Compiler
SIMsalabim needs the Free Pascal Compiler to compile the Pascal code. In the previous step, you have the option to use the precompiled binaries from the SIMsalabim repository (for Windows and Linux). If you want to compile the code yourself, you need to install the Free Pascal Compiler. The Free Pascal Compiler can be installed on Linux by running the following command:

```bash
sudo apt-get update
sudo apt-get install fp-compiler
```

Running the `install_SIMsalabim` function will also install the Free Pascal Compiler for you if you are on Linux. For Windows, you can download the Free Pascal Compiler from the [Free Pascal website](https://www.freepascal.org/download.html).

You can test if the installation worked by running the following command in the terminal:

```bash
fpc -iV
```

This should return the version of the Free Pascal Compiler. Note that the version of the Free Pascal Compiler should be 3.2.2 or higher.

### Parallel simulations
On Linux, you have the option to run the simulations using the [GNU parallel](https://www.gnu.org/software/parallel/) package instead of the default threading or multiprocessing from Python. To install on Linux, run in the terminal:

```bash
sudo apt-get update
sudo apt-get install parallel
```

You can also use [Anaconda](https://anaconda.org/):

```bash
conda install -c conda-forge parallel
```

To test if the installation worked, run the following command in the terminal:

```bash
parallel --help
```

Alternatively, you can run the following Python script to install GNU parallel:

```python
import os
import pySIMsalabim
from pySIMsalabim.install.get_gnu_parallel import *

install_GNU_parallel_Linux()
```

If you are on Windows, pySIMsalabim will use the default threading or multiprocessing from Python.

## Testing
The physics and implementation of the drift-diffusion simulator are tested in the main SIMsalabim repository. The tests in pySIMsalabim are mainly focused on the interface between SIMsalabim and Python. The tests can be run using the following command:

```bash
pytest pySIMsalabim
```

Note that `pytest` needs to be installed to run the tests. You can install `pytest` by running the following command:

```bash
pip install pytest
```

## Disclaimer
This repository is still under development. If you find any bugs or have any questions, please contact us.

