UPGRADED AND DOCUMENTED VERSION COMING SOON !!!
Fill this google form to be notified
of the new version release, or to get in touch with the developers with
any questions or suggestions.
This open-source python package provides cutting-edge tools for analyzing and visualizing elastic symmetry. At its core, it finds an elastic map conforming to a selected symmetry class, closest to an input elastic map of arbitrary symmetry. Wrapper methods centered around this core functionality facilitate the determination of symmetry of given elastic maps. The applicability of the algorithm used is not limited to high symmetry input elastic maps. This is enabled by the data driven nature of the algorithm, which in its default state, does not make assumptions on the material’s symmetry axes. Auxiliary tools such as those for elastic map manipulation (basis transformation, rotation), and Christoffel matrix based seismic velocity computation are also included. The package automatically utilizes simple parallel‑computing frameworks when available, for computationally intensive processes. This is extremely useful when dealing with large datasets, for instance a global dataset of elastic maps from a geodynamic analysis.
> git clone https://github.com/uafgeotools/elasticmapper.git
> cd elasticmapper
> conda env create -f environment.yml
Matrices are represented by capitalized first letters in functions and
variables.
C --> Stiffness matrix in the Voigt representation
T --> stiffness matrix represented in the TapeTape basis
tsp --> theta, sigma and phi angles representing 3D rotation
If you use this package in your own research, please cite the following paper:
- Gupta, A., Tape, C., Brown, M.J., & Becker, T.W., (2025): “Navigating the space of seismic anisotropy for crystal and whole-Earth scales”. Geophysical Journal International, 242(1), 1-18.
The following papers can also be cited in relation to this package:
- Tape, W., & Tape, C., (2024): "A Reformulation of the Browaeys and Chevrot Decomposition of Elastic Maps". Journal of Elasticity, 156, 415-454.
- Tape, W., & Tape, C., (2022): "Two complementary methods of inferring elastic symmetry". Journal of Elasticity, 150, 91-118.
- Tape, W., & Tape, C., (2021): "Elastic symmetry with beachball pictures". Geophysical Journal International, 227(2), 970-1003.