# SimPhoNy-Catalytic
SimPhoNy-Catalytic is a Python package developed by Fraunhofer IWM that provides a convenient interface for running [catalyticFOAM simulations](https://github.com/multiscale-catalysis-polimi/catalyticFoam) using OpenFOAM.
The wrappers of this repository are the driver for running the catalyticFOAM solver, which was developed by Polimi and which is *NOT* included into the code here.
The SimPhoNy-Cataltic interface hosts the code and resources required to set up and run simulations of catalytic reactions in fluid flow systems.
The package is a plugin for [osp-core](https://github.com/simphony/simphony-osp) and hence is a semantic framework based on the [EMMO-ontology](https://github.com/emmo-repo).
## Authors
[Matthias Büschelberger](mailto:matthias.bueschelberger@iwm.fraunhofer.de) (Fraunhofer Institute for Mechanics of Materials IWM)
## Features
* Simulate laminar or turbulent flow with catalytic reactions.
* Define chemical species and their composition within the mixture.
* Specify boundary conditions for velocity, pressure, and temperature.
* Choose from a range of diffusivity and turbulence models.
* Set up and control simulation parameters such as maximum simulation time, time step length, and more.
## Installation
### Simulation engine
Make sure you have OpenFOAM installed on your system. Refer to the OpenFOAM documentation for installation instructions.
More important, make sure that you have the catalyticFOAM-solver installed on your machine. For the installation procedure, please refer to the [README from polimi](https://github.com/multiscale-catalysis-polimi/catalyticFoam/blob/master/README.md).
### Python dependencies
First of all, you will need to install OSP-core, plams, AdaptiveDesignProcedure and pyZacros (all except osp-core are not on PyPI yet unfortunately):
```shell
(env) user@computer:~/reaxpro-wrappers$ pip install osp-core https://github.com/SCM-NV/pyZacros/archive/refs/tags/v.1.2.zip https://github.com/mbracconi/adaptiveDesignProcedure/archive/refs/tags/v1.4.0.zip git+https://github.com/SCM-NV/PLAMS@7661960a9db53249a0b77935dacc8a7668c2489b
```
Then, install the wrapper. Simply type:
```shell
(env) user@computer:~/reaxpro-wrappers$ pip install simphony-catalytic
```
... or if you are installing from source (cloning of the repository needed before):
```shell
(env) user@computer:~/reaxpro-wrappers$ pip install .
```
## Usage
For detailed examples and usage instructions, refer to the [documentation](https://reaxpro.pages.fraunhofer.de/docs/usecases.html#co-catalyticfoam-use-case-laminar-2d-flow-through-a-pipe-with-catalytic-wall) and example files in the examples directory of this repository.
## License
This project is licensed under the GPL-3 License. See the LICENSE file for more information.
## Disclaimer
Copyright (c) 2014-2023, Fraunhofer-Gesellschaft zur Förderung der angewandten Forschung e.V. acting on behalf of its Fraunhofer IWM.
This offering is not approved or endorsed by OpenCFD Limited, producer and distributor of the OpenFOAM software via www.openfoam.com, and owner of the OPENFOAM® and OpenCFD® trade marks.
The catalyticFoam solver itself has been developed in the Multiscale Catalysis Group of the [Laboratory of Catalysis and Catalytic Processes of Politecnico di Milano](https://www.lccp.polimi.it/) and hence is not authored by Fraunhofer IWM.
Contact: [SimPhoNy](mailto:simphony@iwm.fraunhofer.de)
Raw data
{
"_id": null,
"home_page": "",
"name": "simphony-catalytic",
"maintainer": "",
"docs_url": null,
"requires_python": "<3.11,>3.7",
"maintainer_email": "",
"keywords": "simphony,cuds,OpenFOAM,CatalyticFoam,ReaxPro",
"author": "Matthias B\u00fcschelberger",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/dd/99/bb4fc546833a9f73c055e125673849186fc70ebec38a31652a24e49b545f/simphony-catalytic-1.4.0.tar.gz",
"platform": null,
"description": "# SimPhoNy-Catalytic\n\nSimPhoNy-Catalytic is a Python package developed by Fraunhofer IWM that provides a convenient interface for running [catalyticFOAM simulations](https://github.com/multiscale-catalysis-polimi/catalyticFoam) using OpenFOAM.\n\nThe wrappers of this repository are the driver for running the catalyticFOAM solver, which was developed by Polimi and which is *NOT* included into the code here.\n\nThe SimPhoNy-Cataltic interface hosts the code and resources required to set up and run simulations of catalytic reactions in fluid flow systems.\n\nThe package is a plugin for [osp-core](https://github.com/simphony/simphony-osp) and hence is a semantic framework based on the [EMMO-ontology](https://github.com/emmo-repo).\n\n## Authors\n\n[Matthias B\u00fcschelberger](mailto:matthias.bueschelberger@iwm.fraunhofer.de) (Fraunhofer Institute for Mechanics of Materials IWM)\n\n## Features\n\n* Simulate laminar or turbulent flow with catalytic reactions.\n* Define chemical species and their composition within the mixture.\n* Specify boundary conditions for velocity, pressure, and temperature.\n* Choose from a range of diffusivity and turbulence models.\n* Set up and control simulation parameters such as maximum simulation time, time step length, and more.\n\n## Installation\n\n### Simulation engine\n\nMake sure you have OpenFOAM installed on your system. Refer to the OpenFOAM documentation for installation instructions.\n\nMore important, make sure that you have the catalyticFOAM-solver installed on your machine. For the installation procedure, please refer to the [README from polimi](https://github.com/multiscale-catalysis-polimi/catalyticFoam/blob/master/README.md).\n\n### Python dependencies\n\nFirst of all, you will need to install OSP-core, plams, AdaptiveDesignProcedure and pyZacros (all except osp-core are not on PyPI yet unfortunately):\n\n```shell\n(env) user@computer:~/reaxpro-wrappers$ pip install osp-core https://github.com/SCM-NV/pyZacros/archive/refs/tags/v.1.2.zip https://github.com/mbracconi/adaptiveDesignProcedure/archive/refs/tags/v1.4.0.zip git+https://github.com/SCM-NV/PLAMS@7661960a9db53249a0b77935dacc8a7668c2489b\n```\n\nThen, install the wrapper. Simply type:\n\n```shell\n(env) user@computer:~/reaxpro-wrappers$ pip install simphony-catalytic\n```\n\n... or if you are installing from source (cloning of the repository needed before):\n\n\n```shell\n(env) user@computer:~/reaxpro-wrappers$ pip install .\n```\n\n## Usage\n\nFor detailed examples and usage instructions, refer to the [documentation](https://reaxpro.pages.fraunhofer.de/docs/usecases.html#co-catalyticfoam-use-case-laminar-2d-flow-through-a-pipe-with-catalytic-wall) and example files in the examples directory of this repository.\n\n## License\n\nThis project is licensed under the GPL-3 License. See the LICENSE file for more information.\n\n## Disclaimer\n\nCopyright (c) 2014-2023, Fraunhofer-Gesellschaft zur F\u00f6rderung der angewandten Forschung e.V. acting on behalf of its Fraunhofer IWM.\n\nThis offering is not approved or endorsed by OpenCFD Limited, producer and distributor of the OpenFOAM software via www.openfoam.com, and owner of the OPENFOAM\u00ae and OpenCFD\u00ae trade marks.\n\nThe catalyticFoam solver itself has been developed in the Multiscale Catalysis Group of the [Laboratory of Catalysis and Catalytic Processes of Politecnico di Milano](https://www.lccp.polimi.it/) and hence is not authored by Fraunhofer IWM.\n\nContact: [SimPhoNy](mailto:simphony@iwm.fraunhofer.de)\n",
"bugtrack_url": null,
"license": "GPL-3",
"summary": "SimPhoNy wrapper for CatalyticFoam",
"version": "1.4.0",
"project_urls": null,
"split_keywords": [
"simphony",
"cuds",
"openfoam",
"catalyticfoam",
"reaxpro"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cdbd6addeed14af643b2f19130090081d04b83045a2838e0d365c6ac4fb471bd",
"md5": "33a7891be8e737c2436a301a7359e111",
"sha256": "d16d8e2bfb1ba26859c75596783147192355a9be0f4094b3203a73a65910daed"
},
"downloads": -1,
"filename": "simphony_catalytic-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "33a7891be8e737c2436a301a7359e111",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.11,>3.7",
"size": 481408,
"upload_time": "2023-09-28T14:46:17",
"upload_time_iso_8601": "2023-09-28T14:46:17.085201Z",
"url": "https://files.pythonhosted.org/packages/cd/bd/6addeed14af643b2f19130090081d04b83045a2838e0d365c6ac4fb471bd/simphony_catalytic-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dd99bb4fc546833a9f73c055e125673849186fc70ebec38a31652a24e49b545f",
"md5": "f6b4e10ce961ffcd8e28b5f079ae0d95",
"sha256": "57f2a786c7c633e6f35527397c5002d5cfb7a88e70b85327bf691e1a197ea682"
},
"downloads": -1,
"filename": "simphony-catalytic-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "f6b4e10ce961ffcd8e28b5f079ae0d95",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.11,>3.7",
"size": 457228,
"upload_time": "2023-09-28T14:46:18",
"upload_time_iso_8601": "2023-09-28T14:46:18.984083Z",
"url": "https://files.pythonhosted.org/packages/dd/99/bb4fc546833a9f73c055e125673849186fc70ebec38a31652a24e49b545f/simphony-catalytic-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-28 14:46:18",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "simphony-catalytic"
}
JSON