PeriLab is a Software to solve Peridynamic problems. It is written in Julia to overcome many issues related to the Software Peridigm.

Get started
2019 commits | Last commit โ‰ˆ 1 week ago

What PeriLab can do for you

PeriLab - Peridynamic Laboratory

DocumentationBuild StatusQuality

Welcome to PeriLab, a powerful software solution designed for tackling Peridynamic problems.


Explore the comprehensive documentation for PeriLab.


A few basic examples of PeriLab can be found in the examples directory, or if you want to have a look at results go to our growing PeriLab-Results service.

Features โญ

  • ๐Ÿš€ Easy Installation: PeriLab's straightforward installation process makes it accessible for researchers and engineers without extensive computational expertise.

  • โœ’๏ธ Modularization: The software is designed with a modular architecture that allows users to easily integrate their own material and damage models.

  • ๐ŸŽจ Formulations: Bond-based as well as oridnary and non-ordinary state-based peridynamic formulations can be used with PeriLab.

  • ๐Ÿ”ฉ Material models: PeriLab supports various material models, such as elastic, plastic, and more, enabling simulation of complex materials and structures.

  • ๐Ÿ”จ Damage models: Damage models such as critical stretch or an energy based criterium are included to simulate different types of damage, such as crack propagation or delamination, in their peridynamic simulations.

  • ๐Ÿ”ฅ Additive Manufacturing: PeriLab supports additive manufacturing, allowing users to create custom additive models for their simulations.

  • ๐Ÿงฒ Multiphysics: PeriLab supports multiphysics simulations, combining different types of peridynamics and damage models to create a comprehensive simulation environment.

  • โšก MPI: PeriLab supports parallel computing using Message Passing Interface (MPI) technology to improve simulation performance on high-performance clusters.

  • ๐Ÿ’ป HPC capabilities: PeriLab is designed for high-performance computing (HPC) environments, allowing users to run large-scale simulations efficiently.

  • ๐Ÿ“ค๐Ÿ“ฅ Exodus Input/Output: PeriLab uses the Exodus II data format for input and output, enabling easy transfer of data between simulation tools.

  • ๐Ÿงฎ Abaqus Input: PeriLab supports Abaqus input files, allowing users to create custom Abaqus models for their simulations.

  • โž— Bond filter: The bond filter feature allows users to apply specific conditions to the bonds between particles in a simulation, influencing their behavior and interaction with other particles.

  • ๐Ÿ”ง User specified Input/Output: PeriLab provides flexible options for users to specify custom input and output files, enabling easy data manipulation and analysis.

  • ๐Ÿงช Test Pipeline: The PeriLab Source Code will be tested in a test pipeline to ensure its correctness and performance.


The PeriLab package is available through the Julia package system and can be installed using the following commands:

using Pkg

Throughout the rest of this tutorial, we will assume that you have installed the
PeriLab package and have already typed using PeriLab to bring all of the
relevant variables into your current namespace.

Getting Started with PeriLab

Jumpstart your exploration of the PeriLab simulation core with provided examples. Run the following commands in Julia:

using PeriLab


Note: More details about the main functionalities in the yaml input deck here.

Parallel Processing with PeriLab (MPI)

To handle large-scale problems efficiently, install MPI. Run PeriLab with two processors on a Linux system using the following commands:

$ julia
julia> using MPI
julia> MPI.install_mpiexecjl()

Note: If you work with Windows 10 or higher you can use the WSL environment.

Run PeriLab with two processors:

$ mpiexecjl -n 2 julia -e "using PeriLab; PeriLab.main()" examples/DCB/DCBmodel.yaml -v

Note: For HPC configurations please refer to here.

Installing with Docker ๐Ÿณ

To install PeriLab using the official Perihub/Perilab Docker image, follow these steps:

  1. Install Docker: Before you begin, ensure that you have Docker installed on your system. You can download and install Docker from the official website ( Make sure your system meets the minimum requirements for running Docker.

  2. Pull the Perihub/Perilab Docker image: Use the following command in a terminal or command prompt to pull the latest Perihub/Perilab Docker image from the Docker Hub repository:

    docker pull perihub/perilab
  3. Run the Docker container: Once the image has been downloaded, create a new directory for your PeriLab simulations and navigate to it in the terminal or command prompt. Run the following command to start the Docker container:

    docker run -it --rm -v <path_to_local_simulations_directory>:/app/simulations perihub/perilab bash

    Replace <path_to_local_simulations_directory> with the absolute path to a local directory where you want to store your PeriLab simulations. This command will open a new terminal session inside the Docker container.

Now, you've successfully installed PeriLab using the official Perihub/Perilab Docker image. You can start running your own peridynamic simulations within the container.

PeriLab on JuliaHub

Experience the convenience of using PeriLab as a ready-to-use application on JuliaHub. Simply create an account, navigate to the applications page, and add the repository URL:

Configure advanced options, such as filename, dryrun, verbosity, debug, and silence. Click Start and monitor the job progress. Results will be available in a zipped folder.

Hit the Start button and wait for the job to finish, the results will be available in a zipped folder.

Note: The free tier on JuliaHub offers 20 hours of computational time per month.

What's Next? ๐Ÿš€

Here are some exciting tasks on our roadmap:

  • ๐Ÿ”‘ Quasi-static solver: A future development for PeriLab is extending its capabilities with a more robust quasi-static solver for larger systems and complex boundary conditions.

  • ๐Ÿ‘Š Contact: An upcoming feature in PeriLab is enhancing contact modeling to support advanced features like friction, adhesion, and contact forces based on temperature or other variables.

  • โž• More material and damage models: PeriLab's future development plans include adding more sophisticated material models (e.g., viscoelastic-plastic) and damage models, expanding the software's applicability to a wider range of real-world phenomena.

  • ๐Ÿ‘ฌ FEM/PD coupling: A future enhancement for PeriLab is improving its FEM/PD coupling functionality by implementing more advanced techniques, such as a seamless data exchange between FEM and PD domains.

  • โœ‚๏ธ Distribution logic: As part of its ongoing development, PeriLab will continue to incorporate new distribution logic for improved performance and reduced computational resources.

  • ๐ŸŽ๏ธ Optimizations: As part of its ongoing development, PeriLab will continue to focus on optimizing the simulation process by incorporating new techniques like parallel optimization algorithms for improved efficiency and reduced computational resources.

  • ๐Ÿฆฟ CUDA support: We are planning to support GPU acceleration for improved performance and reduced computational resources.

Feel free to contribute and help us make PeriLab even better! ๐Ÿ™Œ

Programming languages
  • Julia 99%
  • Batchfile 1%
  • BSD-3-Clause
</>Source code

Participating organisations

German Aerospace Center (DLR)


Christian Willberg
German Aerospace Center (DLR)
Jan-Timo Hesse
Deutsches Zentrum fรผr Luft- und Raumfahrt DLR Institut fรผr Faserverbundleichtbau und Adaptronik

Related software



PeriHub is a platform that provides a numerical implementation of the peridynamic theory. It is an extension of the open source Peridigm software. Peridynamics is a non-local theory that overcomes discontinuity problems of the classical theory of continuum mechanics.

Updated 1 month ago
1 2