API for Globe3DAxialSymmetry type meshes

Salvus version: 2024.1.1

This document describes all the various parameters and settings for meshes of the Globe3DAxialSymmetry type available when using the simple_mesh interface of SalvusMesh:

Copy
from salvus.mesh import simple_mesh
m = simple_mesh.Globe3DAxialSymmetry(...)
# Accessing the elements_per_wavelength parameter in the basic group
m.basic.elements_per_wavelength = 2.0

Advanced Parameters group [advanced]

Advanced mesh parameters.

Required: True

Detailed description of all parameters:

• courant_number

  • Pretty name: Courant Number

  • Description: Courant Number.

  • Parameter type: number

  • Required: True

  • Default: 0.6

• model_parameters

  • Pretty name: Model Parameters

  • Description: Model parameters.

  • Parameter type: array of strings

  • Required: False

  • Default: []

  • Possible values: "g", "dg", "VP", "VS", "VSV", "VSH", "VPV", "VPH", "RHO", "QMU", "QKAPPA", "C11", "C12", "C13", "C14", "C15", "C16", "C21", "C22", "C23", "C24", "C25", "C26", "C31", "C32", "C33", "C34", "C35", "C36", "C41", "C42", "C43", "C44", "C45", "C46", "C51", "C52", "C53", "C54", "C55", "C56", "C61", "C62", "C63", "C64", "C65", "C66", "A", "C", "L", "N", "F", "XI", "PHI", "LAMBDA", "MU", "KAPPA", "ETA"

• tensor_order

  • Pretty name: Tensor Order

  • Description: Tensor order for the shape and material parameters.

  • Parameter type: integer

  • Required: True

  • Default: 1

Attenuation Arguments group [attenuation]

Parameters related to attenuation.

Required: True

Detailed description of all parameters:

• auto_band

  • Pretty name: Automatic frequency band determination.

  • Description: Automatically determine the frequency band.

  • Parameter type: boolean

  • Required: True

  • Default: true

• frequencies

  • Pretty name: Frequeny Band

  • Description: Frequency band for the linear solids.

  • Parameter type: array of numbers

  • Required: False

  • Default: [0.001, 1.0]

• number_of_linear_solids

  • Pretty name: Number of Linear Solids

  • Description: The number of linear solids used.

  • Parameter type: integer

  • Required: True

  • Default: 5

• power_law_alpha

  • Pretty name: Alphas for Power Law Alpha

  • Description: Exponent alpha for the power law.

  • Parameter type: number

  • Required: True

  • Default: 0.0

• power_law_reference_frequency

  • Pretty name: Reference Frequency for Power Law

  • Description: Refeference frequency for the power law.

  • Parameter type: number

  • Required: True

  • Default: 1.0

Basic Parameters group [basic]

Basic parameters that must always be given.

Required: True

Detailed description of all parameters:

• elements_per_wavelength

  • Pretty name: Elements per Wavelength

  • Description: Number of elements per wavelength

  • Parameter type: number

  • Required: True

• min_period_in_seconds

  • Pretty name: Minimum Period in Seconds

  • Description: The minimum period of the mesh in seconds.

  • Parameter type: number

  • Required: True

• model

  • Pretty name: Model

  • Description: The background model name or file.

  • Parameter type: string

  • Required: True

2D Chunk Arguments group [chunk]

Parameters for circular 2D chunks.

Required: True

Detailed description of all parameters:

• max_colatitude

  • Pretty name: Maximum Colatitude

  • Description: Maximum colatitude.

  • Parameter type: number

  • Required: True

  • Default: 180.0

Refinement Arguments group [refinement]

Parameters for refinement of spherical 2D meshes.

Required: True

Detailed description of all parameters:

• hmax_refinement

  • Pretty name: h-max Refinement

  • Description: Move refinement layers based on this criterion.

  • Parameter type: number

  • Required: True

  • Default: 1.5

• horizontal_max_slowness_layer_index

  • Pretty name: Horizontal maximum slowness layer index (EXPERIMENTAL)

  • Description: For low velocity layers at the surface, horizontal refinements can be avoided if the source is below the LVL and hence cannot excite waves above a certain slowness. This is a 1D argument and might not me valid in 3D, hence check carefully. Ignored for 'local' refinement styles, if available.

  • Parameter type: integer

  • Required: True

  • Default: 0

• refinement_bottom_up

  • Pretty name: Refinement Bottom Up

  • Description: Refine from the bottom.

  • Parameter type: boolean

  • Required: True

  • Default: false

• refinement_style

  • Pretty name: Refinement Style

  • Description: The mesh refinement style.

  • Parameter type: string

  • Required: True

  • Default: "doubling"

  • Possible values: "doubling", "tripling"

Spherical Arguments group [spherical]

Parameters for 3D spherical meshes.

Required: True

Detailed description of all parameters:

• ellipticity

  • Pretty name: Ellipticity

  • Description: Ellipticity of the sphere.

  • Parameter type: number

  • Required: True

  • Default: 0.0

• min_radius

  • Pretty name: Minimum radius.

  • Description: Min radius of the sphere in km.

  • Parameter type: number

  • Required: True

  • Default: 0.0