CRATE¶

Summary¶

CRATE (Clustering-based Nonlinear Analysis of Materials) is a Python project (package cratepy) developed in the context of computational mechanics to aid the design and development of new materials. Its main purpose is performing multi-scale nonlinear analyses of heterogeneous materials through a suitable coupling between first-order computational homogenization and clustering-based reduced-order modeling: given a representative volume element of the material microstructure and the corresponding material phase properties, CRATE computes the material’s effective mechanical response when subject to a prescribed macro-scale loading path.

Statement of Need¶

cratepy is essentially a numerical tool for any application that requires material multi-scale simulations. Given the intrinsic clustering-based reduced-order modeling approach (e.g., SCA, ASCA), CRATE is mostly useful in applications where the computational cost of standard simulation methods is prohibitive, namely to solve lower-scales in coupled hierarchical multi-scale simulations (e.g., B.P. Ferreira (2022)) and to generate large material response databases for data-driven frameworks based on machine learning (e.g., Bessa et al. (2017)). Clustering-based reduced-order models achieve a striking balance between accuracy and computational cost by first performing a clustering-based domain decomposition of the material model and then solving the equilibrium problem formulated over the resulting reduced model.

In the particular case of a research environment, cratepy is designed to easily accommodate further developments, either by improving the already implemented methods or by including new numerical models and techniques. It also provides all the fundamental means to perform comparisons with alternative methods, both in terms of accuracy and computational cost. In a teaching environment, cratepy is a readily available tool for demonstrative purposes and/or academic work proposals in solid mechanics and material-related courses.

Consider leaving a star if you think CRATE is useful for the research community!

Authorship & Citation¶

CRATE was originally developed by Bernardo P. Ferreira [1] in the context of his PhD Thesis [2] .

If you use CRATE in your research or in a scientific publication, it is appreciated that you cite the two papers below.

Journal of Open Source Software (paper):

@article{Ferreira2023,
    title = {CRATE: A Python package to perform fast material simulations},
    author = {Bernardo P. Ferreira and F. M. Andrade Pires and Miguel A. Bessa}
    doi = {10.21105/joss.05594},
    url = {https://doi.org/10.21105/joss.05594},
    year = {2023},
    publisher = {The Open Journal},
    volume = {8},
    number = {87},
    pages = {5594},
    journal = {Journal of Open Source Software}
}

Computer Methods in Applied Mechanics and Engineering (paper):

@article{Ferreira2022,
    title = {Adaptivity for clustering-based reduced-order modeling of localized history-dependent phenomena},
    author = {Ferreira, B.P., and Andrade Pires, F.M., and Bessa, M.A.},
    doi = {10.1016/j.cma.2022.114726},
    url = {https://www.sciencedirect.com/science/article/pii/S0045782522000895},
    year = {2022},
    volume = {393},
    pages = {114726},
    issn = {0045-7825},
    journal = {Computer Methods in Applied Mechanics and Engineering},
}

Getting started¶

To get a quick idea of what CRATE is all about, take a look into GETTING STARTED and go through Overview > Installation > Run a benchmark!

Useful Links¶

GitHub repository (source code);
PyPI (distribution package).

Community Support¶

If you find any issues, bugs or problems with CRATE, please use the GitHub issue tracker to report them. Provide a clear description of the problem, as well as a complete report on the underlying details, so that it can be easily reproduced and (hopefully) fixed!

You are also welcome to post any questions, comments or suggestions for improvement in the GitHub discussions space!

Please refer to CRATE’s Code of Conduct.

Note

Bear in mind that CRATE is a program developed in an academic environment and that I’m currently the only developer as a side project. This means that I’ll do my best to address all the issues, questions and suggestions, but do expect a reasonable time frame! ~ Bernardo P. Ferreira

Credits¶

Bernardo P. Ferreira is deeply thankful to Francisco Pires and Miguel Bessa for supervising the PhD Thesis that motivated the development of CRATE.
Bernardo P. Ferreira acknowledges the pioneering development of clustering-based reduced-order models by Zeliang Liu , namely by proposing the Self-Consistent Clustering Analysis (SCA) , that established the conceptual framework and foundations for the development of CRATE.

License¶

CRATE is a free and open-source software published under a BSD 3-Clause License.