This model simulates the conversion process, based on porous carbonaceous materials, like coal. It is a zero dimensional model which solves the ODE conversion equation.
The project simulates different model approaches for the conversion process of porous carbonaceous particle. The conversion process depends on a variety of property and conditions, like overall pressure. Be aware that this model only solve the conversion process depending on the input. No additional equations are solved. This includes energy or motion/diffusion specific processes.
-
To work with the package you need to have at least Python 3.10 installed.
-
This project uses the Python dependency manager
poetry(Installation guide for poetry)Example command line for Linux/Ubuntu:
$ curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python3 -or
$ pip install poetry
Step 1. Clone the repository.
-
via ssh (first, create SSH key)
$ git clone --depth=1 --branch=main [email protected]:tfoerst3r/particle_conversion.git -
or via https
$ git clone --depth=1 --branch=main https://github.com/tfoerst3r/particle_conversion.git
Alternatively, you can download source code directly via the download option on top of the repository page.
Step 2. Install required dependencies.
To build the package run the following in the root folder of the project:
$ poetry install
Poetry can build, so called wheels, which can be installed in any other python environment.
Step 1. Create the wheel or download the wheel
You can download any wheel via any desired CI job called "build_wheel_package". Or build from scratch via the following step:
$ poetry build --format wheel
This will create a wheel file particle-conversion-*.whl in the folder ./dist.
Step 2. Installing the wheel
- First you need to activate your desired python environment, e.g.
$ source /path/to/your/env/bin/activate. And then install your the wheel.
$ pip install particle_conversion-*.whl
- With
$ which pconvyou can check if the executable is in the desired environment.
For uninstalling pconv in your current environment use:
$ pip uninstall pconv
First you need to activate the environment you want to work in. Either use
-
the provided poetry environment
$ poetry serve -
or any other environment where you installed the provided wheel
$ source /path/to/your/env/bin/activate
In both versions an executable pconv should be available. Alternatively you can run the CLI directly via:
$ poetry run pconv [OPTIONS]
Syntax
$ pconv --config [CONFIG FILE] --output [OUTPUT FILE]
For more help type:
$ pconv --help
Step 1. Choose the appropriate model settings and adapted the corresponding configuration file.
- Choose the appropriate configuration settings (for more details see the config and model documentation)
- Adapt the corresponding model configuration
*.tomlfile (see base example in config file.
Step 2. Run the model with the desired output path.
default model
$ pconv --config ./config/base.toml --output ./output/base_output.csv
No visualisation of the results are included in the package. But for displaying a *.csv the tool gnuplot can be used easily.
You can use the headers defined in your output file.
Example in the gnuplot console
gnuplot> set datafile separator comma
gnuplot> plot 'your-csv-output-file.csv' using (column('Time')):(column('dXdt')) with linesWe welcome your contribution!
The repository is still under development and any feedback, suggestions, technical contributions are highly welcome.
General Options:
- open an issue, if you have improvement ideas
- fork the project and contribute via merge request against the main branch of this repository
Please see the file LICENSE.md for further information about how the content is licensed.
If you are using this code in your publications, please refer to the following DOI Link for citation, or cite as:
Thomas Förster. (2023). Particle Conversion Solver: Testing tool for different conversion models via custom predefined boundary conditions. Zenodo. https://doi.org/10.5281/zenodo.7953765