Skip to main content

CRATE: Clustering-based Nonlinear Analysis of Materials

Project description

logo

What is CRATE?

Docs | Installation | GitHub | PyPI

DOI

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. Ferreira1 in the context of his PhD Thesis2.

1 Profile: LinkedIN, ORCID, ResearchGate

2 Ferreira, B.P. (2022). Towards Data-driven Multi-scale Optimization of Thermoplastic Blends: Microstructural Generation, Constitutive Development and Clustering-based Reduced-Order Modeling. PhD Thesis, University of Porto (see here)

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

You can find everything you need to know in CRATE documentation!

logo

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 there 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

Copyright 2020, Bernardo Ferreira

All rights reserved.

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cratepy-1.0.5.tar.gz (196.8 kB view details)

Uploaded Source

Built Distribution

cratepy-1.0.5-py3-none-any.whl (222.9 kB view details)

Uploaded Python 3

File details

Details for the file cratepy-1.0.5.tar.gz.

File metadata

  • Download URL: cratepy-1.0.5.tar.gz
  • Upload date:
  • Size: 196.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for cratepy-1.0.5.tar.gz
Algorithm Hash digest
SHA256 ef9c82560c20da1582a008b485063ee3d24c5057dc4e62cb58968e4fe8aacfd9
MD5 e4c4655cf77472d4d9cce588c1dd50a2
BLAKE2b-256 c460ac52bcbab348e0d3d348703049a93d925258c3f799c1648f8c07b539e83c

See more details on using hashes here.

File details

Details for the file cratepy-1.0.5-py3-none-any.whl.

File metadata

  • Download URL: cratepy-1.0.5-py3-none-any.whl
  • Upload date:
  • Size: 222.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for cratepy-1.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 715795c69ec8007acb0b25a116b2a534148f9f3245608addaa41993dddc33a3c
MD5 2eddd8dbb27702e5ffbc87d97d46381d
BLAKE2b-256 760615cec0540498d3623cab5caa259f59c9459f068381e12b21cb8356f0ac91

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page