This user guide is incomplete and will be updated soon. A full list of the MSAT functions (with links to more information) is below.

MSAT function tables

Table 1. MSAT Input / generation of elastic constants.
Function Purpose

MS_VTI

Generate elastic constants for a vertically transverse isotropic medium from Thomsen parameters. Symmetry is in the 3-axis.

MS_VTI2

Generate elastic constants for a vertically transverse isotropic medium from xi, phi, eta parameters. Symmetry is in the 3-axis.

MS_build_isotropic

Create elasticity matrix from pairs of isotropic moduli.

MS_checkC

Check consistency of a stiffness matrix against various criteria

MS_effective_medium

Generate elastic constants from various effective medium theories.

MS_elasticDB

Database of various elastic constants..

MS_expand

Fill out elasticity matrix.

MS_iso

Generate elastic matrix from isotropic velocities.

MS_load

Load a set of elastic constants from a file.

MS_load_list

Load a list of CIJs, in a specific format

Table 2. MSAT Manipulation / transformation
Function Purpose

MS_VRH

N phase Voigt-Reuss-Hill average of elasticity.

MS_axes

Reorient elasticity matrix for optimal decomposition.

MS_decomp

Browaeys and Chevrot decomposition of the elasticity matrix.

MS_interpolate

Symmetry preserving elasticity interpolation

MS_norms

Browaeys and Chevrot analysis of the elasticity matrix.

MS_polyaverage

Isotropic elasticity for polycrystal

MS_rot3

Elasticity matrix rotation.

MS_rotEuler

Rotate an elasticity matrix using Bunge’s Euler angles.

MS_rotR

Script to rotate a set of elastic constants by a rotation matrix

Table 3. MSAT Analysis
Function Purpose

MS_anisotropy

Simple measures of anisotropy

MS_info

Information about an elasticity matrix.

MS_phasevels

Wave velocities in anisotropic media.

MS_plot

Plot phasevels/anisotropy on pole figures.

MS_poisson

Poisson’s ratio in anisotropic media.

Table 4. MSAT Visualisation
Function Purpose

MS_plot

Plot phasevels/anisotropy on pole figures.

MS_sphere

Plot a spherical plot of phasevels/anisotropy from a set of elastic constants.

Table 5. MSAT Miscellaneous / utility
Function Purpose

MS_Vrot3

Rotate a (set of) 3-vector(s) by 3 angles.

MS_cij2cijkl

Convert from Voigt elasticity matrix to tensor

MS_cijkl2cij

Convert from elastic tensor to Voigt elasticity matrix

MS_list

Print elasticity matrix (in list format)

MS_rotM

Create a cartesian rotation matrix.

MS_unwind_pm_90

Unwind an angle until it is between 0 and 360 degrees