PeriPy, a collaboration between Exeter, Cambridge & the Alan Turing Institute, is a lightweight, open-source and high-performance python package for solving bond-based peridynamics (BBPD) problems in solid mechanics. It is implemented in Python and the performance critical parts are implemented in Cython and PyOpenCL.
PeriPy allows users to write their code in pure Python. Simulations are then executed seamlessly using high performance OpenCL code.
- Easy to use. Get started with the latest documentation at peripy.readthedocs.org
- 2-10x faster than exisiting OpenCL solvers
- 'Outer-loop' applications including uncertainty quantification, optimisation and feature recognition are made possible
- Support for both regular and irregular mesh files. See meshio for the full list of mesh formats
- Support for composite and interface material models
- Support for arbritrary n-linear 'microelastic' damage models
- Simulates force or displacement controlled boundary conditions and initial conditions
- Arbritrary subsets of particles are easily measured for their displacements, damages etc.
- Output files can be viewed in Paraview
- Various 'partial volume correction' algorithms, 'surface correction' algorithms and 'micromodulus functions' are included. The code is easily extended to define your own
- Velocity-Verlet, Euler and Euler-Cromer integrators are included and the code is easily extended to define your own higher order and/or adaptive integrators
- The package requires Python 3.7+
- Install pyopencl, a build dependency, by following these instructions https://documen.tician.de/pyopencl/misc.html
- To install pyopencl, note that pyopencl may need to be installed from
(base)environment - If using pyopencl on Windows with a CPU (rather than a GPU), first, ensure the C++ build tools for Visual Studio are installed (e.g., see https://youtu.be/KUTVnxCeC50)
- Make sure the OpenCL device driver is installed for your device:
The error
python import pyopencl pyopencl.get_platforms()pyopencl._cl.LogicError: clGetPlatformIDs failed: PLATFORM_NOT_FOUND_KHRmeans that the OpenCL device driver is not correctly installed. - Install cython, a build dependency,
pip install cython - Install PeriPy
pip install peripy
- Run the first example by typing
peripy run example1on the command line - You can show the example code by typing
peripy run example1 --cat - Type
peripy run --listfor a list of examples - For usage, type
peripy run --help
The tests for this project use pytest. To run the tests yourself,
- Install pytest using pip
pip install pytest - Type
peripy teston the command line - For coverage install
pytest-covand typeperipy coverageon the command line
- The package requires Python 3.7+
- Install pyopencl, a build dependency, by following these instructions https://documen.tician.de/pyopencl/misc.html
- To install pyopencl, note that pyopencl may need to be installed from
(base)environment - If using pyopencl on Windows with a CPU (rather than a GPU), first, ensure the C++ build tools for Visual Studio are installed (e.g., see https://youtu.be/KUTVnxCeC50)
- Make sure the OpenCL device driver is installed for your device
The error
python import pyopencl pyopencl.get_platforms()pyopencl._cl.LogicError: clGetPlatformIDs failed: PLATFORM_NOT_FOUND_KHRmeans that the OpenCL device driver is not correctly installed. - Install cython, a build dependency,
pip install cython - Clone the repository
git clone git@github.com:alan-turing-institute/peripy.git - Install using pip
pip install -e .from the root directory of the repository
- You can find examples of how to use the package under:
peripy/examples/. Run the first example by typingpython peripy/examples/example1/example.py
The tests for this project use pytest. To run the tests yourself,
- If you haven't already, install using pip
pip install -e .from the root directory of the repository - Install pytest using pip
pip install pytest - Run
pytestfrom the root directory of the repository - For coverage install
pytest-covand runpytest --cov=./peripy