NLMech：非局部模型的有限元实现和有限差分近似

# NLMech [](https://circleci.com/gh/nonlocalmodels/nonlocalheatequation) [](https://www.codacy.com/gh/nonlocalmodels/NLMech?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=nonlocalmodels/NLMech&amp;utm_campaign=Badge_Grade) [](https://coveralls.io/github/nonlocalmodels/NLMech?branch=master) Welcome to NLMech repository. In this project we implement nonlocal fracture theory, referred to as Peridynamics, using both finite element and finite difference discretization. Logo below has been obtained by running Peridynamic simulation on the logo mesh, [see](https://nonlocalmodels.github.io/examples/fd-logo-soft-material.html). <p style="text-align:center;"><img src="https://github.com/nonlocalmodels/NLMech/blob/master/assets/logo/logo_sim.png?raw=true" alt="logo" width="400"/></p> ## Building The code uses * [CMake](https://cmake.org/) 3.10 as the build system and has following dependencies: * [HPX](https://github.com/STEllAR-GROUP/hpx) 1.5.1 * [Blaze](https://bitbucket.org/blaze-lib/blaze/src/master/) 3.8, * [Blaze_Iterative](https://github.com/STEllAR-GROUP/BlazeIterative) master, * [Boost](https://www.boost.org/) 1.73, * [gmsh](https://gmsh.info/) 4.6, * [VTK](https://www.vtk.org) 9.0, and * [YAML-CPP](https://github.com/jbeder/yaml-cpp) 0.6.3. Following dependencies are optional, but are recommend for large simualtions: * [PCL](https://github.com/PointCloudLibrary/pcl) 1.11. Note that the above provided versions are the minimal rquired versions and we recommend to use these to build the code. We provide following support to build the code * Bash scripts to build the code on [Ubuntu](https://github.com/nonlocalmodels/buildscripts/tree/master/Ubuntu) and [Fedora](https://github.com/nonlocalmodels/buildscripts/tree/master/Fedora), * Docker files to build the code using the [Fedora packages](https://github.com/nonlocalmodels/buildscripts/blob/master/Docker/Fedora) or [build all dependencies](https://github.com/nonlocalmodels/buildscripts/blob/master/Docker/FedoraAll), * [Scripts](https://github.com/nonlocalmodels/HPCBuildInfrastructure) to build the code on HPC systems. If you just interested the code, we provide a Doker image with the [latest sucessful build](https://github.com/nonlocalmodels/NLMech/packages/384758) of the master branch. For writing your own [YAML](https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html) files, we provide a bunch of [examples](https://nonlocalmodels.github.io/examples/). If you encounter any bug or want to submit a feature request, please generate an [issue](https://github.com/nonlocalmodels/NLMech/issues) on GitHub. Right now, we have [](https://github.com/nonlocalmodels/NLMech/issues). For contributing, we refer to the Contributing section below. ## Documentation The documentation of the the master branch is available [here](https://nonlocalmodels.github.io/documentation/). ## Releases The current stable version is [](https://GitHub.com/nonlocalmodels/NLMech/releases/) and the current developement happens in the [master branch](https://github.com/nonlocalmodels/NLMech). For more details, we refer to the [Changelog](https://github.com/nonlocalmodels/NLMech/blob/master/CHANGELOG.md) file. ## Code of conduct We have adopted a [code of conduct](https://github.com/nonlocalmodels/NLMech/blob/master/CODE_OF_CONDUCT.md) for this project. Please refer to this document if you would like to know more about the expectations for members of our community, with regard to how they will behave toward each other. ## Contributing The source code is released under the [](https://github.com/nonlocalmodels/nonlocalmodels.github.io/blob/master/LICENSE) license. If you like to contribute, we only accept your pull request using the same license. Please feel free to add your name to license header of the files you added or contributed to. If possible please add a test for your new feature using [CTest](https://gitlab.kitware.com/cmake/community/-/wikis/doc/ctest/Testing-With-CTest). We adapted the Google C++ [Style Guide](https://google.github.io/styleguide/cppguide.html) for this project. We use the [clang-format](https://clang.llvm.org/docs/ClangFormat.html) tool to format the soruce code with respect to this style guide. Please run the `format.sh' script before your do your pull request. ## Citing In publications, please use our paper as the main citation for NLMech: * P. Diehl, P. K. Jha, H. Kaiser, R. Lipton, and M. Lévesque. An asynchronous and task-based implementation of peridynamics utilizing hpx—the C++ standard library for parallelism and concurrency. SN Applied Sciences, 2(12):2144, 2020, [10.1007/s42452-020-03784-x](https://doi.org/10.1007/s42452-020-03784-x), [Preprint](https://arxiv.org/abs/1806.06917). For more references, we refer to NLMech's [publication list](https://nonlocalmodels.github.io/publications/). ## Acknowledgements NLMech has been funded by: * Army Research Office Grant # W911NF-16-1-0456 to PI Dr. Robert Lipton (Professor at Louisiana State University). This grant supported Prashant K. Jha on a postdoctoral position from October 2016 - July 2019. * Canada Research Chairs Program under the Canada Research Chair in Multiscale Modelling of Advanced Aerospace Materials held by M. Lévesque; Natural Sciences and Engineering Research Council of Canada (NSERC) Discovery Grants Program under Discovery Grant RGPIN-2016-06412. * We are grateful for the support of the [Google Summer of Code program](https://summerofcode.withgoogle.com/) funding internships.