Package: smatool
SMATool - Strength of Materials Analysis ToolkitSMATool-- Strength of Materials Analysis Toolkit is a comprehensive computational package developed to evaluate the tensile, shear, biaxial, and indentation strength (Vickers' hardness) of materials at zero temperature (using density functional theory) and finite temperature (using ab-initio molecular dynamics). Integrating advanced algorithms and leveraging the capabilities of well-established electronic structure codes like VASP and QE as the stress calculator, SMATool provides a robust platform for analyzing the strength of 1D, 2D, and 3D materials.Importance of SMAToolThe significance of SMATool lies in its ability to provide accurate and efficient strength parameters, which are crucial in material design and analysis. Understanding these mechanical properties helps in predicting material behavior under different loading conditions and in different environments, contributing to the development of materials with optimized performance characteristics.Types of Strengths within SMAToolUniaxial Tensile Strength:The maximum stress a material can withstand while being stretched or pulled before failure. Tensile strength is crucial in applications where materials are subject to tension. The tensile strength can be computed along the various directions: x, y, and z, and along the critical plane directions.Biaxial Strength:The strength of a material when subjected to biaxial stress conditions. This is important for materials used in applications where they are exposed to stresses in two perpendicular directions.Shear Strength:This measures a material's ability to resist shear loads, which is vital in understanding how materials will behave when forces are applied parallel to a material's surface. The shear strength can be determined along the critical plane directions and slip directions.Indentation Strength:The measure of the resistance of a material to deformation under localized compressive forces. This can be used to quantify the Vickers' hardness of a material.Additionally, the SMATool package computes the yield strength for each of the strengths above, and the corresponding energy storage capacity (in MJ/L and Wh/Kg) of the material at the ultimate strain.SMATool Stress CalculatorsSMATool utilizes VASP (Vienna Ab initio Simulation Package) and QE (Quantum Espresso) as its calculator, ensuring high accuracy and reliability. These powerful electronic structure codes, combined with the ASE (Atomic Simulation Environment) backend, enable detailed and precise material analysis. If you're interested in other electronic structure code as the stress calculation, we will be more than happy to collaborate in such implementations.InstallationSMATooloffers straightforward installation options suitable for various user preferences as explained below. We note that in all the installation options, all the libraries and dependables are automatically determined and installed alongside the SMATool.Using pip: Our recommended way to install theSMAToolpackage is using pip.Quickly install the latest version of the SMATool package with pip by executing:pip install -U smatoolFrom Source Code:Alternatively, users can download the source code with:git clone [git@github.com:gmp007/smatool.git]Then, install SMATool by navigating to the master directory and running:pip install .Installation via setup.py:SMATool can also be installed using thesetup.pyscript:python setup.py install [--prefix=/path/to/install/]The optional--prefixargument is useful for installations in environments like shared High-Performance Computing (HPC) systems, where administrative privileges might be restricted.Please note that while this method remains supported, its usage is gradually declining in favor of more modern installation practices. We only recommend this installation option where standard installation methods likepipare not applicable.Usage and Running SMAToolThe best way to learn how to use the SMATool package is to start with the provided examples folder. The key steps for initializing SMATool follows:Create a Calculation Directory:Start by creating a directory for your calculations.Runsmatool -0to generate main input template of the SMATool, which is thesmatool.in.Modify Input Files:Customize the generated files according to your project's requirements, choose the code type between VASP and QE, and specify the directory of your potential files.Initialize the Job:Executesmatoolto begin the calculation process.Understanding SMATool Options:The main input filesmatool.inincludes descriptive text for each flag, making it user-friendly.Citing SMAToolIf you have used the SMATool package in your research, please cite:SMATool: An automated toolkit for strength of materials-@article{Ekuma2024,
title = {SMATool: Strength of Materials Analysis Toolkit},
journal = {XXX},
volume = {XXX},
pages = {XXX},
year = {2024},
doi = {https://doi.org/10.1016/XXXX},
url = {XXX},
author = {XXXX}
}SMATool UtilityASP electronic structure calculations come with proprietary pseudopotentials included in the package. In contrast, Quantum Espresso (QE) is open source, offering a variety of sources for obtaining pseudopotentials. While no specific pseudopotential database is officially recommended for QE, we prefer the norm-conservingPdojo pseudopentials. The SMATool computational toolkit includes an automated utility package,qepotential, located in the utility folder. This tool automates the generation of pseudopotentials from the Pdojo website for all materials required to run the SMATool package with QE as the calculator. Users can also specify custom requirements in thepseudo.infoinput file. The SMATool utility package saves the potentials of various elements aselement_pdojo.upfin theqe_potentialsfolder.Contact InformationPlease if you find a bug, want to extend the SMATool computational toolkit, or have an idea that you would want us to incorporate, please reach out to us. Our team is dedicated to supporting your work and enhancing capabilities and efficiency of the SMATool package.Feel free to contact us via email:cekuma1@gmail.comYour feedback and questions are invaluable to us, and we look forward to hearing from you.LicenseThis project is licensed under the GNU GPL version 3 - see theLICENSEfile for details.AcknowledgmentsThis work was supported by the U.S. Department of Energy, Office of Science, Basic Energy Sciences under Award DOE-SC0024099.