Metadata-Version: 2.2
Name: ntrfc
Version: 0.2.5
Summary: Numerical Test Rig for Cascades. A workflows-library for CFD analysis of cascade-flows
Author-email: Malte Nyhuis <nyhuis@tfd.uni-hannover.de>
License: MIT License
Keywords: ntrfc
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: pip>=23
Requires-Dist: open3d==0.19.0
Requires-Dist: numpy==1.26.4
Requires-Dist: matplotlib==3.10.1
Requires-Dist: pytest==8.3.5
Requires-Dist: trame==3.8.1
Requires-Dist: pyvista[all]==0.44.2
Requires-Dist: PyYAML==6.0.2
Requires-Dist: scipy==1.15.2
Requires-Dist: pandas==2.2.3
Requires-Dist: fluidfoam==0.2.9
Requires-Dist: tqdm==4.67.1
Requires-Dist: statsmodels>=0.14.4
Requires-Dist: imageio==2.37.0
Requires-Dist: jupyter
Requires-Dist: sphinx
Requires-Dist: gmsh==4.13.1
Requires-Dist: shapely==2.0.7
Requires-Dist: scikit-image==0.25.2
Provides-Extra: test
Requires-Dist: pytest>=3; extra == "test"

============
NTRfC README
============

**Numerical Test Rig for Cascades.**


* Free software: MIT license
* Documentation: https://ntrfc.readthedocs.io.
* NTRfC is the base of the (NTRFlows)[https://gitlab.uni-hannover.de/tfd_public/tools/NTRFlows] repository, a workflow for cfd parameter studies



**Features**

Easy geometry and post-processing visualization and manipulation with pyvista.
Tested methods and functions for math, time-series, and mesh quality analysis.

**Dependencies**

- libgl1-mesa-glx (graphics driver)
- xvfb (virtual Display)
- libglu1-mesa (gmsh dependency)
- libxcursor1 (gmsh dependency)
- libxinerama1 (gmsh dependency)
- libxft2 (gmsh dependency)

Python requirement is Python>=3.10. Current NTRfC versions are based on Python 3.11. Only versions <v0.1.0 can be used with older versions of Python. Library requirements will be installed with the package itself.
Installation

NTRfC is utilizing powerful and complex dependencies like pyvista,open3d and gmsh. We strongly recommend using virtual or conda environments for installation.

For more information, see:

    virtualenv: https://pypi.org/project/virtualenv/
    miniconda: https://docs.conda.io/en/latest/miniconda.html
    anaconda: https://docs.anaconda.com/anaconda/install/index.html
    mamba: https://mamba.readthedocs.io/en/latest/installation.html


**Installation**

Installation from pypi


    pip install ntrfc




Installation from gitlab with pip


    pip install git+https://gitlab.uni-hannover.de/tfd_public/tools/NTRfC.git


Installation from source

After cloning the repository, go to the project root dir and type


    python setup.py install


Editable installation from source with pip

After cloning the repository, go to the project root dir and type


    pip install -e .


This way you have NTRfC installed but the code is not installed, but linked to the source-code.
You don't have to reinstall the package after your edits.
This speeds up testing and will lead to less debugging time.

**Singularity releases**

Use a singularity container from ntrfc singularity releases:  https://cloud.sylabs.io/library/nyhuma/ntrflows/ntr.sif].
The containers will come with a virtual graphics card and a xvfb display-server, enabling you to render on hpc-systems and any other unprepared system with limited graphics capability.

**Credits**

This package was created with Cookiecutter and the `audreyr/cookiecutter-pypackage` project template. It uses the following libraries:

- [pyvista](https://github.com/pyvista)
- [gmsh](http://gmsh.info/)
- [Cookiecutter](https://github.com/audreyr/cookiecutter)
- [audreyr/cookiecutter-pypackage](https://github.com/audreyr/cookiecutter-pypackage)
