Package: cratepy
What is CRATE?Docs|Installation|GitHub|PyPISummaryCRATE(Clustering-based Nonlinear Analysis of Materials) is a Python project (packagecratepy) developed in the context of computational mechanics to aid the design and development of new materials. Its main purpose isperforming multi-scale nonlinear analyses of heterogeneous materialsthrough 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 needcratepyis 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 astriking balance between accuracy and computational costby 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 aresearch environment,cratepyis 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 ateaching environment,cratepyis 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 & CitationCRATE was originally developed by Bernardo P. Ferreira1in the context of his PhD Thesis2.1Profile:LinkedIN,ORCID,ResearchGate2Ferreira, 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 (seehere)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 startedYou can find everything you need to know inCRATE documentation!Community SupportIf you find anyissues,bugsorproblemswith CRATE, please use theGitHub issue trackerto 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 anyquestions,commentsorsuggestionsfor improvement in theGitHub discussionsspace!Please refer to CRATE'sCode 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. FerreiraCreditsBernardo P. Ferreira is deeply thankful toFrancisco PiresandMiguel Bessafor supervising the PhD Thesis that motivated the development of CRATE.Bernardo P. Ferreira acknowledges the pioneering development of clustering-based reduced-order models byZeliang Liu, namely by proposing theSelf-Consistent Clustering Analysis (SCA), that established the conceptual framework and foundations for the development of CRATE.LicenseCopyright 2020, Bernardo FerreiraAll rights reserved.CRATE is a free and open-source software published under a BSD 3-Clause License.