Metadata-Version: 2.4
Name: emerge
Version: 0.5.3
Summary: An open source EM FEM simulator in Python
Project-URL: Homepage, https://github.com/FennisRobert/EMerge
Project-URL: Issues, https://github.com/FennisRobert/EMerge/issues
License-File: LICENSE
Requires-Python: <4.0,>=3.10
Requires-Dist: gmsh>=4.13.1
Requires-Dist: joblib>=1.5.1
Requires-Dist: loguru>=0.7.3
Requires-Dist: matplotlib>=3.8.0
Requires-Dist: mkl!=2024.0; platform_machine == 'x86_64' or platform_machine == 'AMD64'
Requires-Dist: numba-progress>=1.1.3
Requires-Dist: numba>=0.57.0
Requires-Dist: numpy<2.3,>=1.24
Requires-Dist: pyvista>=0.45.2
Requires-Dist: scipy>=1.14.0
Provides-Extra: cudss
Requires-Dist: cupy-cuda12x; extra == 'cudss'
Requires-Dist: nvidia-cudss-cu12; extra == 'cudss'
Requires-Dist: nvmath-python[cu12]; extra == 'cudss'
Provides-Extra: umfpack
Requires-Dist: scikit-umfpack; (sys_platform != 'win32') and extra == 'umfpack'
Description-Content-Type: text/markdown

## Introduction

Hello everybody. Thanks for showing interest in this repository.

Feel free to download your version of EMerge and start playing around with it!
If you have suggestions/changes/questions either use the Github issue system or join the Discord using the following link:

**https://discord.gg/7PF4WcS6uA**

## How to install

You can now install the basic version of emerge from PyPi!
```
pip install emerge
```
If you want to install the library with PyPardiso on Intel machines, you can install the optional dependency with EMerge using:
```
pip install emerge[pypardiso]
```
On MacOS and Linux you can install it with the very fast UMFPACK through scikit-umfpack

```
pip install emerge[scikit-umfpack]
```
On linux and MacOS with intel or AMD chips you can also include both:

```
pip install emerge[scikit-umfpack, pypardiso]
```
The `scikit-umfpack` solver can be installed on Windows as well from binaries with conda. This is a bit more complicated and is described in the installation guide.

## Compatibility

As far as I know, the library should work on all systems. PyPARDISO is not supported on ARM but the current SuperLU and UMFPACK solvers work on ARM as well. Both SuperLU and UMFPACK can run on multi-processing implementations as long as you do entry-point protection:
```
import emerge as em

def main():
    # setup simulation

    model.mw.frequency_domain(True, ..., multi_processing=True)

if __name__ == "__main__":
    main()
```
Otherwise, the parallel solver will default to SuperLU which can be slower on larger problems with a very densely connected/compact matrix.

## Required libraries

To run this FEM library you need the following libraries

 - numpy
 - scipy
 - gmsh
 - loguru
 - numba
 - matplotlib (for the matplotlib base display)
 - pyvista (for the PyVista base display)
 - numba-progress

Optional:
 - pypardiso
 - scikit-umfpack

## NOTICE

First time runs will be very slow because Numba needs to generate local C-compiled functions of the assembler and other mathematical functions. These compilations are chached so this should only take time once.
