GitHub - alan-turing-institute/PeriPy: Code base for PeriPy, a lightweight, open-source and high-performance package for peridynamic simulations written in Python - a collaboration between Exeter, Cambridge & Turing (original) (raw)

PeriPy

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.

Features

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

Get started (preferred)

Building and Installation

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:

python  
import pyopencl  
pyopencl.get_platforms()

The error pyopencl._cl.LogicError: clGetPlatformIDs failed: PLATFORM_NOT_FOUND_KHR means that the OpenCL device driver is not correctly installed.

Install cython, a build dependency, pip install cython
Install PeriPy pip install peripy

Running examples

Run the first example by typing peripy run example1 on the command line
You can show the example code by typing peripy run example1 --cat
Type peripy run --list for a list of examples
For usage, type peripy run --help

Running the tests

The tests for this project use pytest. To run the tests yourself,

Install pytest using pip pip install pytest
Type peripy test on the command line
For coverage install pytest-cov and type peripy coverage on the command line

Get started from the GitHub repository (for developers)

Building and Installation

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

python  
import pyopencl  
pyopencl.get_platforms()

The error pyopencl._cl.LogicError: clGetPlatformIDs failed: PLATFORM_NOT_FOUND_KHR means 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

Running examples

You can find examples of how to use the package under:peripy/examples/. Run the first example by typing python peripy/examples/example1/example.py

Running the tests

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 pytest from the root directory of the repository
For coverage install pytest-cov and run pytest --cov=./peripy