Welcome to santex’s documentation!#
Seismic Anisotropy from Texture (SAnTex) is a Python library which calculates the full elastic tensor of rocks from modal mineral composition, crystallographic orientation, and a crystal stiffness tensor catalogue that accounts for the dependency of elasticity with pressure and temperature.
Features#
Pre-processing and cleaning of EBSD data: SAnTex facilitates the processing and cleaning of EBSD data. To enhance data completeness, SAnTex offers the option to fill not-indexed pixels or indexed pixels removed during the cleaning process, using machine learning techniques.
Tensor operations: Tensor conversions between Voigt matrix and full stiffness tensors, as well as rotations based on euler angles.
Material analysis: SAnTex provides a catalogue of minerals, users can load the catalogue and can either utilise them to load stiffness tensors for their EBSD phases or make a modal rock and can calculate seismic anisotropy for the modal rock.
Seismic Anisotropy: SAnTex performs calculations of seismic anisotropy at a range of pressure and temperature conditions. It also offers visualisation capabilities, allowing users to view the calculated seismic anisotropy in 2D and 3D plots.
Isotropic velocities: Calculates isotropic seismic wave velocities (Vp, Vs and vbulk), isothermal bulk modulus, and density at elevated temperatures and pressures (Hacker & Abers, 2004).
Installation
Working
- Working with SAnTex
- Available methods in the EBSD class
- Plotting Conventions
- Cleaning EBSD data
- Calculating Anisotropy from EBSD file
- Pole Figures
- Inverse Pole Figure
- IPF color key
- Tensor analysis
- Material analysis
- Hooke’s Law
- Modal Mineral Composition of a rock and anisotropy
- Isotropic Velocities analysis
- 3-D visualisation of vp, vs1, vs2 and vs splitting
Notebooks
- SAnTex code examples
- A complete brief intro to EBSD processing using SAnTex
- Load the required modules
- Load the ebsd ctf file
- Get the available phases information
- Load the ebsd file in a dataframe
- Pole Figures, Pole Density function, Inverse pole figures
- Plot the ebsd file, default: x2east, zoutofplane
- Calculate the stiffness tensors and the density at Pressure = 1.4GPa and Temperature = 1100 K (Chatzaras et al. 2016)
- Get the euler angles from ebsd file
- Calculate the stiffness tensors and the density at ambient pressure and temperature
- Calculate the stiffness tensors and the density at pressure = 1.4GPa and temperature = 1100K, and assumed melt of 7%
- Rotating the dataset by 90 degree around the z-axis
- Rotating ebsd for matching SEM orientation
- Cleaning EBSD data
- Removing data with MAD > 0.7
- Calculating grain boundaries with threshold of 10 degrees misorientation
- Removing grains with grain size less than 10 pixels
- Calculating Anisotropy
- Anisotropy calculation for a stiffness matrix and density
- 3D VTK plotter plots
- Material Analysis
- Tensor Analysis
- Rotate Tensors
- Isotropic Velocities Analysis
- Define isotropy instance
- Get Available phases
- Get phase constants for e.g. Forsterite
- Get velocities and densities
- Modal Mineral Composition of a Rock and calculate seismic Anisotropy
Modules and submodules within SAnTex
- santex.ebsd package
- santex.material package
- santex.tensor package
- santex.anisotropy package
- Submodules
- santex.anisotropy.anisotropy module
- santex.anisotropy.map module
- santex.anisotropy.melt module
- santex.anisotropy.modalAnisotropy module
- santex.anisotropy.plot_seismic_velocity module
- santex.anisotropy.plot_vel_grid module
- santex.anisotropy.utils module
- santex.anisotropy.vtkplotter module
- Module contents
- santex.isotropy package
- santex package
- santex