Source Description

The sources are defined using YAML format and can be specified in the sources.yaml file. The sources are defined in a list format, allowing for any number and combination of sources. The sources can be defined as force, moment-tensor, or adjoint-source. Each source type has its own set of parameters that can be specified. The full description of possible values for each source type is given below.

sources.yaml

number-of-sources

Total number of sources in the simulation box.

Default value:

None

Possible values:

[int]

sources

Definition of sources. Note that this list can contain any number and combination of sources.

Default value:

None

Possible values:

[List of YAML Nodes]

force

Definition of force source

Default value:

None

Possible values:

[YAML Node]

x

X coordinate location of the force source.

Default value:

None

Possible values:

[float]

z

Z coordinate location of the force source.

Default value:

None

Possible values:

[float]

angle

Angle of the force source.

Default value:

0.0

Possible values:

[float]

Dirac

Definition of Dirac source Dirac Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

Ricker

Definition of Ricker source Ricker Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

dGaussian

Definition of first derivative of Gaussian time function Gaussian Derivative Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

External

Definition of External source External Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

Example

force:
    x: 0.0
    z: 0.0
    angle: 0.0
    Dirac:
        factor: 1e10
        tshift: 0.0

moment-tensor

Definition of moment tensor source

Default value:

None

Possible values:

[YAML Node]

x

X coordinate location of the moment tensor source.

Default value:

None

Possible values:

[float]

z

Z coordinate location of the moment tensor source.

Default value:

None

Possible values:

[float]

Mxx

Mxx moment tensor component.

Default value:

None

Possible values:

[float]

Mzz

Mzz moment tensor component.

Default value:

None

Possible values:

[float]

Mxz

Mxz moment tensor component.

Default value:

None

Possible values:

[float]

Dirac

Definition of Dirac source Dirac Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

Ricker

Definition of Ricker source Ricker Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

dGaussian

Definition of first derivative Gaussian time function Gaussian Derivative Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

External

Definition of External source External Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

Example

moment-tensor:
    x: 0.0
    z: 0.0
    Mxx: 1e10
    Mzz: 1e10
    Mxz: 0.0
    Ricker:
        factor: 1e10
        tshift: 0.0
        f0: 1.0

adjoint-source

Definition of adjoint source

Default value:

None

Possible values:

[YAML Node]

station_name

Name of the station.

Default value:

None

Possible values:

[string]

network_name

Name of the network.

Default value:

None

Possible values:

[string]

x

X coordinate location of the adjoint source.

Default value:

None

Possible values:

[float]

z

Z coordinate location of the adjoint source.

Default value:

None

Possible values:

[float]

angle

Angle of the adjoint source.

Default value:

0.0

Possible values:

[float]

Dirac Definition of Dirac source Dirac Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

dGaussian

Definition of first derivative Gaussian time function Gaussian Derivative Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

Ricker

Definition of Ricker source Ricker Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

External

Definition of External source External Source Time Function Description

Default value:

None

Possible values:

[YAML Node]

Example

adjoint-source:
    station_name: AA
    network_name: S0001
    x: 0.0
    z: 0.0
    angle: 0.0
    Dirac:
        factor: 1e10
        tshift: 0.0

Example

number-of-sources: 2
sources:
    - force:
        x: 0.0
        z: 0.0
        angle: 0.0
        Dirac:
            factor: 1e10
            tshift: 0.0
    - moment-tensor:
        x: 0.0
        z: 0.0
        Mxx: 1e10
        Mzz: 1e10
        Mxz: 0.0
        Ricker:
            factor: 1e10
            tshift: 0.0
            f0: 1.0

Source Time Function Description

Dirac Source Time Function Description

Dirac

Definition of Dirac source time function

Default value:

None

Possible values:

[YAML Node]

Dirac.factor

Scaling factor for Dirac source time function

Default value:

None

Possible values:

[float]

Dirac.tshift

Time shift for Dirac source time function

Default value:

0.0

Possible values:

[float]

Example

Dirac:
    factor: 1e10
    tshift: 0.0

Ricker Source Time Function Description

Ricker

Definition of Ricker source time function

Default value:

None

Possible values:

[YAML Node]

factor

Scaling factor for Ricker source time function

Default value:

None

Possible values:

[float]

tshift

Time shift for Ricker source time function

Default value:

0.0

Possible values:

[float]

f0

Central frequency for Ricker source time function

Default value:

None

Possible values:

[float]

Example

Ricker:
    factor: 1e10
    tshift: 0.0
    f0: 1.0

Gaussian Derivative Source Time Function Description

dGaussian

Definition of first derivative of Gaussian source time function

Default value:

None

Possible values:

[YAML Node]

dGaussian.factor

Scaling factor for first derivative of Gaussian time function

Default value:

None

Possible values:

[float]

dGaussian.tshift

Time shift for first derivative of Gaussian time function

Default value:

0.0

Possible values:

[float]

dGaussian.f0

Central frequency for first derivative of Gaussian time function

Default value:

None

Possible values:

[float]

Example

dGaussian:
    factor: 1e10
    tshift: 0.0
    f0: 1.0

External Source Time Function Description

External

Definition of external source time function

Default value:

None

Possible values:

[YAML Node]

External.format

Format of the external source time function

Default value:

ASCII

Possible values:

[ASCII]

External.stf

Location of the external source time function files

Default value:

None

Possible values:

[YAML Node]

External.stf.X-component [optional]

Location of time series trace for X-component of the external source time function (if unset the source time function is set to 0)

Default value:

“”

Possible values:

[string]

External.stf.Y-component [optional]

Location of time series trace for Y-component of the external source time function (if unset the source time function is set to 0)

Default value:

“”

Possible values:

[string]

External.stf.Z-component [optional]

Location of time series trace for Z-component of the external source time function (if unset the source time function is set to 0)

Default value:

“”

Possible values:

[string]

Note

Atlease one of the components must be set for the external source time function.

Example

External:
    format: ascii
    stf:
        X-component: /path/to/X-component.stf
        Z-component: /path/to/Z-component.stf