API for Cartesian3DHomogeneous type meshes

Salvus version: 2024.1.2

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

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

Absorbing Boundary group [absorbing_boundaries]

Parameters for the addition of absorbing boundary elements.

Required: True

Detailed description of all parameters:

• number_of_wavelengths

  • Pretty name: Number of Wavelengths.

  • Description: Width of the absorbing boundary in number of wavelengths at the reference velocity and frequency. For best performance, we recommend that this parameter is set to 3.5 or more. If set to zero, only first order absorbing boundaries are used.

  • Parameter type: number

  • Required: True

  • Default: 0.0

• reference_frequency

  • Pretty name: Reference Frequency

  • Description: Reference frequency used in the 'number_of_wavelengths' calculation. This may require some tuning for optimal performance, but a good starting point is setting it to the center frequency of your source. Use lower values to be more conervative.

  • Parameter type: ['number', 'string']

  • Required: True

  • Default: inf

• reference_velocity

  • Pretty name: Reference Velocity

  • Description: Reference velocity which is used in the 'number_of_wavelengths' calculation. If the velocity is varying along the boundary, an average value may suffice. If undesirable reflections are still encountered it is best to trend towards the lowest velocity in the mesh, leading to a thicker absorbing layer.

  • Parameter type: number

  • Required: True

  • Default: 0.0

• side_sets

  • Pretty name: Side Sets

  • Description: List of absorbing side sets to extended for sponge layers. At the moment only supports ['all'] and ['all_except_free_surface'] for cartesian and only ['all_except_free_surface'] for spherical meshes, or ['none'].

  • Parameter type: array of strings

  • Required: True

  • Default: ['none']

Advanced Parameters group [advanced]

Advanced 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

• 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]

The most important parameters for seismic wave simulations.

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

• max_frequency_in_hertz

  • Pretty name: Resolved Frequency

  • Description: The desired resolved frequency of the mesh.

  • Parameter type: number

  • Required: True

Cartesian 3D Arguments group [cartesian]

3D cartesian arguments.

Required: True

Detailed description of all parameters:

• x

  • Pretty name: X dimension in km

  • Description: Horizontal dimension in km.

  • Parameter type: array of null or number

  • Required: True

  • Default: [0.0, None]

• y

  • Pretty name: Y dimension in km

  • Description: Vertical/horizontal dimension in km.

  • Parameter type: array of null or number

  • Required: True

  • Default: [0.0, None]

• z

  • Pretty name: Z dimension in km

  • Description: Vertical dimension in km.

  • Parameter type: array of null or number

  • Required: True

  • Default: [0.0, None]

Option 1: Homogeneous Model Parameters group [model]

The physics and corresponding model parameters for a homogeneous model. Currently allows for acoustic and elastic isotropic models.

Required: True

Detailed description of all parameters:

• RHO

  • Pretty name: RHO

  • Description: density

  • Parameter type: number

  • Required: True

• VP

  • Pretty name: VP

  • Description: P-wave velocity

  • Parameter type: number

  • Required: True

• physics

  • Pretty name: Physics

  • Description: Physics to be used, used to determine the required model parametrization.

  • Parameter type: string

  • Required: True

  • Possible values: "acoustic_isotropic"

Option 2: Homogeneous Model Parameters group [model]

The physics and corresponding model parameters for a homogeneous model. Currently allows for acoustic and elastic isotropic models.

Required: True

Detailed description of all parameters:

• RHO

  • Pretty name: RHO

  • Description: density

  • Parameter type: number

  • Required: True

• VP

  • Pretty name: VP

  • Description: P-wave velocity

  • Parameter type: number

  • Required: True

• VS

  • Pretty name: VS

  • Description: S-wave velocity

  • Parameter type: number

  • Required: True

• physics

  • Pretty name: Physics

  • Description: Physics to be used, used to determine the required model parametrization.

  • Parameter type: string

  • Required: True

  • Possible values: "elastic_isotropic"