Metadata-Version: 2.1 Name: FPTE Version: 1.2.0 Summary: The FPTE package is a collection of tools for finite pressure temperature elastic constants calculation. Features include, but are not limited to stress-strain method for getting second order elastic tensors using DFT package VASP as well as, ab initio molecular dynamic method for temperaturedependent elastic constants. Home-page: https://github.com/MahdiDavari/FPTE Download-URL: https://pypi.org/project/FPTE/#files Author: Mahdi Davari Author-email: Mahdi.Davari@iCloud.com License: UNKNOWN Project-URL: Documentation, https://github.com/MahdiDavari/FPTE/blob/master/README.md Project-URL: Source Code, https://github.com/MahdiDavari/FPTE Project-URL: Bug Reports, https://github.com/MahdiDavari/FPTE/issues Platform: UNKNOWN Classifier: Intended Audience :: Science/Research Classifier: Intended Audience :: Developers Classifier: Programming Language :: Python Classifier: Topic :: Software Development Classifier: Topic :: Scientific/Engineering Classifier: Development Status :: 5 - Production/Stable Classifier: Operating System :: POSIX Classifier: Operating System :: Unix Classifier: Operating System :: MacOS Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 Classifier: Programming Language :: Python :: Implementation :: CPython Classifier: License :: OSI Approved :: MIT License Classifier: Operating System :: OS Independent Requires-Python: >=3.7 Description-Content-Type: text/markdown License-File: LICENSE Requires-Dist: numpy (>=1.16.5) Requires-Dist: pandas (>=0.25.3) Requires-Dist: matplotlib (>=2.2.4) Requires-Dist: joblib (>=0.11) Requires-Dist: subprocess32 (>=3.5.4) Provides-Extra: docs Requires-Dist: pandas (>=0.25.3) ; extra == 'docs' Requires-Dist: matplotlib (>=2.2.4) ; extra == 'docs' Requires-Dist: seaborn (>=0.9.0) ; extra == 'docs' Requires-Dist: memory-profiler (>=0.57.0) ; extra == 'docs' Requires-Dist: sphinx (>=4.0.1) ; extra == 'docs' Requires-Dist: sphinx-gallery (>=0.7.0) ; extra == 'docs' Requires-Dist: Pillow (>=7.1.2) ; extra == 'docs' Requires-Dist: sphinx-prompt (>=1.3.0) ; extra == 'docs' Requires-Dist: sphinxext-opengraph (>=0.4.2) ; extra == 'docs' Provides-Extra: examples Requires-Dist: pandas (>=0.25.3) ; extra == 'examples' Requires-Dist: matplotlib (>=2.2.4) ; extra == 'examples' Requires-Dist: seaborn (>=0.9.0) ; extra == 'examples' Provides-Extra: tests Requires-Dist: pandas (>=0.25.3) ; extra == 'tests' Requires-Dist: matplotlib (>=2.2.4) ; extra == 'tests' Requires-Dist: pytest (>=5.0.1) ; extra == 'tests' Requires-Dist: PyHamcrest (>=2.0.3) ; extra == 'tests' Requires-Dist: pytest-cov (>=2.9.0) ; extra == 'tests' Requires-Dist: pyamg (>=4.0.0) ; extra == 'tests' # Finite Pressure Temperature Elasticity (FPTE) package Stress-Strain ## Installation ### Dependencies FPTE requires: - Python (>= 3.7) - NumPy (>= 1.16.5) - Pandas (>= 0.25.3) - Matplotlib (>= 2.2.4) - joblib (>= 0.11) FPTE 1.2.0 and later require Python 3.7 or newer. FPTE 1.1.0 and later require Python 3.4 or newer. FPTE plotting capabilities (i.e., functions start with `plot_` and classes end with "Display") require Matplotlib (>= 2.2.4). ### User installation If you already have a working installation of numpy and scipy, the easiest way to install FPTE is using `pip`: pip install -U FPTE or `install from source`: git clone https://github.com/MahdiDavari/FPTE cd FPTE python setup.py install In order to check your installation you can use: python -m pip show FPTE # to see which version and where FPTE is installed python -m pip freeze # to see all packages installed in the active virtualenv python -c "import FPTE; print(FPTE.__version__)" _Note that in order to avoid potential conflicts with other packages it is strongly recommended to use a virtual environment (venv)._ ## Theory **Elastic Stifness Coefficients from Stress-Strain Relations:** According to Hooke's law, the second-rank stress and strain tensors for a slightly deformed crystal are related by $$ $$ where the fourth rank tensors cijkl and sijkl are called the elastic stiffness coefficients and elastic compliance constants respectively. Here we deal with elastic stiffness coefficients cijkl, which govern the proper stress-strain relations at nite strain. In general, we can write $$ $$ where X and x are the coordinates before and after the deformation. There are 81 independent stiffness coefficients in general; however, this number is reduced to 21 by the requirement of the complete Voigt symmetry. In Voigt notation (cij), the elastic constants form a symmetric 6x6 matrix $$ $$ In single suffix notation (running from 1 to 6), we can also use the matrix representations for stress and strain $$ $$
and $$ $$ where the stress components are σ1 = σxx ; σ2 = σyy ; σ3 = σzz ; σ4 = σyz ; σ5 = σzx ; σ6 = σxy, and the strain components are ε1 = ε xx ; ε2 = εyy ; ε3 = εzz ; ε4 = εyz ; ε5 = εzx ; ε6 = εxy. When a crystal lattice is deformed with strain (ε), new lattice vectors a are related to old vectors ** a**0 by **a** = (I + ε) **a**0, where I is identity matrix. The stress-strain relations are then simply given by $$ $$ The presence of the symmetry in the crystal reduces further the number of independent c ij . A cubic crystal having highest symmetry is characterized by the lowest number (only three) of independent elastic constants, c11, c12 and c44, which in matrix notation is $$ $$ | Crystal System |Space Group Number |No. of Elastic Constants | |----------------|-------------------------------|-----------------------------| |`Cubic`|195-230 | 3 | |`Hexagonal` |168-194 |5 | |`Trigonal` |143-167|6-7| |`Tetragonal` |75-142 |6-7| |`Orthorhombic`| 16-74 | 9| |`Monoclinic` | 3-15| 13| |`Triclinic` | 1 and 2 | 21| > **Note:** For **more information** regarding the second-order elastic constant see reference:
1. Golesorkhtabar, Rostam, et al., “ElaStic: A Tool for Calculating Second-Order Elastic Constants from First Principles.” Computer Physics Communications 184, no. 8 (2013): 1861–73. 2. Karki, Bijaya B. “High-Pressure Structure and Elasticity of the Major Silicate and Oxide Minerals of the Earth’s Lower Mantle,” 1997. 3. Barron, THK, and ML Klein. “Second-Order Elastic Constants of a Solid under Stress.” Proceedings of the Physical Society 85, no. 3 (1965): 523.