Mondaic - Full Waveform Solutions

Copy

%matplotlib inline

Copy

# This notebook will use this variable to determine which
# remote site to run on.
import os
import numpy as np
import salvus.namespace as sn

SALVUS_FLOW_SITE_NAME = os.environ.get("SITE_NAME", "local")

Copy

p = sn.Project(path="project")

In a typical USCT setup, there is always enough space between the ultrasound transducers and the phantom. What if we include that information as prior knowledge into our problem formulation?

An easy way of doing this, is to define a region of interest and restrict the reconstruction to this area.

To keep it simple, we just define a sphere with a radius of 6.5 cm as the target region.

Copy

mesh = p.simulations.get_mesh(simulation_configuration="initial_model")
# define the region of interest
roi = np.zeros_like(mesh.connectivity)
mask = np.linalg.norm(mesh.points[mesh.connectivity], axis=2) < 0.065
roi[mask] = 1.0
mesh.attach_field("region_of_interest", roi)

Let's see if this helps with the iterations. To be able to compare the results, we just create a new inverse problem within the same project, initialize the region of interest, and start iterating.

Copy

p.add_to_project(
    sn.InverseProblemConfiguration(
        name="my_second_inversion",
        prior_model="initial_model",
        events=p.events.list(),
        mapping=sn.Mapping(
            scaling="absolute",
            inversion_parameters=["VP", "RHO"],
            region_of_interest=mesh,
        ),
        preconditioner=sn.ConstantSmoothing({"VP": 0.01, "RHO": 0.01}),
        method=sn.TrustRegion(initial_trust_region_linf=10.0),
        misfit_configuration="L2",
        wavefield_compression=sn.WavefieldCompression(
            forward_wavefield_sampling_interval=10
        ),
        job_submission=sn.SiteConfig(
            site_name=SALVUS_FLOW_SITE_NAME, ranks_per_job=4
        ),
    )
)

Copy

p.inversions.iterate(
    inverse_problem_configuration="my_second_inversion",
    timeout_in_seconds=360,
    ping_interval_in_seconds=10,
    delete_disposable_files="all",
)

[2026-06-02 10:25:18,001] INFO: Adding new iteration #0.
[2026-06-02 10:25:18,008] INFO: Resuming iteration #0.

[2026-06-02 10:25:18,009] INFO: 1 new tasks have been issued.
[2026-06-02 10:25:18,009] INFO: Processing task `misfit_and_gradient`
[2026-06-02 10:25:18,424] INFO: 
Iteration 0: Number of events: 5	 chi = 0.016385616624463036	 ||g|| = 0.015225054673727976
pred = ---	ared = ---	norm_update = ---	tr_radius = ---
[2026-06-02 10:25:18,425] INFO: 1 new tasks have been issued.
[2026-06-02 10:25:18,426] INFO: Processing task `preconditioner`

[2026-06-02 10:25:18,631] INFO: Some tasks of iteration #0 are still running. Please check again later.
[2026-06-02 10:25:28,645] INFO: Processing task `preconditioner`
[2026-06-02 10:25:28,840] INFO: 1 new tasks have been issued.
[2026-06-02 10:25:28,841] INFO: Processing task `misfit`
[2026-06-02 10:25:28,922] INFO: Submitting job array with 5 jobs ...

[2026-06-02 10:25:29,078] INFO: Launched simulations for 5 events. Please check again to see if they are finished.
[2026-06-02 10:25:29,081] INFO: Some tasks of iteration #0 are still running. Please check again later.
[2026-06-02 10:25:39,117] INFO: Processing task `misfit`
[2026-06-02 10:25:40,041] INFO: 
old misfit control group: 0.016385616624463036
new misfit control group: 0.0068495715397390525
predicted reduction control group: -0.005146099961393702
actual reduction control group: -0.009536045084723983
5 out of 5 event(s) improved the misfit.
[2026-06-02 10:25:40,044] INFO: 
Model update accepted.
[2026-06-02 10:25:40,046] INFO: 1 new tasks have been issued.
[2026-06-02 10:25:40,047] INFO: Processing task `finalize_iteration`
[2026-06-02 10:25:40,092] INFO: ... searching for obsolete files in project/INVERSIONS/my_second_inversion/00000
[2026-06-02 10:25:40,107] INFO: Freed up 613.0 KB of space.
[2026-06-02 10:25:40,107] INFO: Successfully completed iteration #0.
[2026-06-02 10:25:40,111] INFO: Adding new iteration #1.

Let's see if the region of interest was considered when the model was updated.

Copy

p.viz.nb.inversion(inverse_problem_configuration="my_second_inversion")

Indeed, outside of the pre-defined sphere, the model is still constant and has the same values as the initial model.

Let's do a few more iterations and see what the reconstruction will be.

Copy

for i in range(2):
    p.inversions.iterate(
        inverse_problem_configuration="my_second_inversion",
        timeout_in_seconds=360,
        ping_interval_in_seconds=10,
        delete_disposable_files="all",
    )
p.viz.nb.inversion(inverse_problem_configuration="my_second_inversion")

[2026-06-02 10:25:44,962] INFO: Resuming iteration #1.

[2026-06-02 10:25:44,967] INFO: 1 new tasks have been issued.
[2026-06-02 10:25:44,974] INFO: Processing task `gradient`
[2026-06-02 10:25:45,195] INFO: Submitting job array with 5 jobs ...

[2026-06-02 10:25:45,341] INFO: Launched adjoint simulations for 5 events. Please check again to see if they are finished.
[2026-06-02 10:25:45,348] INFO: Some tasks of iteration #1 are still running. Please check again later.
[2026-06-02 10:25:55,361] INFO: Processing task `gradient`
[2026-06-02 10:25:56,091] INFO: 
Iteration 1: Number of events: 5	 chi = 0.0068495715397390525	 ||g|| = 0.007636973282506061
pred = -0.005146099961393702	ared = -0.009536045084723983	norm_update = 0.6986523494085921	tr_radius = 0.6986522209328783
[2026-06-02 10:25:56,106] INFO: 1 new tasks have been issued.
[2026-06-02 10:25:56,106] INFO: Processing task `preconditioner`

[2026-06-02 10:25:56,209] INFO: Some tasks of iteration #1 are still running. Please check again later.
[2026-06-02 10:26:06,223] INFO: Processing task `preconditioner`
[2026-06-02 10:26:06,371] INFO: 1 new tasks have been issued.
[2026-06-02 10:26:06,371] INFO: Processing task `misfit`
[2026-06-02 10:26:06,433] INFO: Submitting job array with 5 jobs ...

[2026-06-02 10:26:07,537] INFO: Launched simulations for 5 events. Please check again to see if they are finished.
[2026-06-02 10:26:07,543] INFO: Some tasks of iteration #1 are still running. Please check again later.
[2026-06-02 10:26:17,616] INFO: Processing task `misfit`
[2026-06-02 10:26:18,930] INFO: 
old misfit control group: 0.0068495715397390525
new misfit control group: 0.0036732410562075645
predicted reduction control group: -0.0023949299470586993
actual reduction control group: -0.003176330483531488
5 out of 5 event(s) improved the misfit.
[2026-06-02 10:26:18,934] INFO: 
Model update accepted.
[2026-06-02 10:26:18,935] INFO: 1 new tasks have been issued.
[2026-06-02 10:26:18,937] INFO: Processing task `finalize_iteration`
[2026-06-02 10:26:19,107] INFO: ... searching for obsolete files in project/INVERSIONS/my_second_inversion/00001
[2026-06-02 10:26:19,471] INFO: Freed up 3.3 MB of space.
[2026-06-02 10:26:19,473] INFO: Successfully completed iteration #1.
[2026-06-02 10:26:19,480] INFO: Adding new iteration #2.
[2026-06-02 10:26:19,499] INFO: Resuming iteration #2.

[2026-06-02 10:26:19,502] INFO: 1 new tasks have been issued.
[2026-06-02 10:26:19,503] INFO: Processing task `gradient`
[2026-06-02 10:26:19,896] INFO: Submitting job array with 5 jobs ...

[2026-06-02 10:26:20,142] INFO: Launched adjoint simulations for 5 events. Please check again to see if they are finished.
[2026-06-02 10:26:20,152] INFO: Some tasks of iteration #2 are still running. Please check again later.
[2026-06-02 10:26:30,169] INFO: Processing task `gradient`
[2026-06-02 10:26:31,241] INFO: 
Iteration 2: Number of events: 5	 chi = 0.0036732410562075645	 ||g|| = 0.003914571177171008
pred = -0.0023949299470586993	ared = -0.003176330483531488	norm_update = 0.6666855264629865	tr_radius = 1.3973044418657565
[2026-06-02 10:26:31,277] INFO: 1 new tasks have been issued.
[2026-06-02 10:26:31,280] INFO: Processing task `preconditioner`

[2026-06-02 10:26:31,610] INFO: Some tasks of iteration #2 are still running. Please check again later.
[2026-06-02 10:26:41,666] INFO: Processing task `preconditioner`
[2026-06-02 10:26:42,085] INFO: 1 new tasks have been issued.
[2026-06-02 10:26:42,086] INFO: Processing task `misfit`
[2026-06-02 10:26:42,228] INFO: Submitting job array with 5 jobs ...

[2026-06-02 10:26:42,572] INFO: Launched simulations for 5 events. Please check again to see if they are finished.
[2026-06-02 10:26:42,575] INFO: Some tasks of iteration #2 are still running. Please check again later.
[2026-06-02 10:26:52,649] INFO: Processing task `misfit`
[2026-06-02 10:26:53,986] INFO: 
old misfit control group: 0.0036732410562075645
new misfit control group: 0.0030209278134020927
predicted reduction control group: -0.0003006637195994699
actual reduction control group: -0.0006523132428054718
5 out of 5 event(s) improved the misfit.
[2026-06-02 10:26:53,990] INFO: 
Model update accepted.
[2026-06-02 10:26:53,994] INFO: 1 new tasks have been issued.
[2026-06-02 10:26:53,994] INFO: Processing task `finalize_iteration`
[2026-06-02 10:26:54,052] INFO: ... searching for obsolete files in project/INVERSIONS/my_second_inversion/00002
[2026-06-02 10:26:54,162] INFO: Freed up 3.3 MB of space.
[2026-06-02 10:26:54,163] INFO: Successfully completed iteration #2.
[2026-06-02 10:26:54,176] INFO: Adding new iteration #3.

This looks better, so the prior knowledge was indeed helpful.

Alternatively, we could specify point-wise lower and upper bounds on the model parameters. In the example below, we allow deviations of +/- 20% in both VP and RHO, except for the previously selected region of interest, where we restrict VP updates to +/- 1 m/s.

Note that the mapping function does not contain a region of interest in this case.

Copy

p.add_to_project(
    sn.InverseProblemConfiguration(
        name="my_third_inversion",
        prior_model="initial_model",
        events=p.events.list(),
        mapping=sn.Mapping(
            scaling="absolute",
            inversion_parameters=["VP", "RHO"],
        ),
        preconditioner=sn.ConstantSmoothing({"VP": 0.01, "RHO": 0.01}),
        method=sn.TrustRegion(initial_trust_region_linf=10.0),
        misfit_configuration="L2",
        wavefield_compression=sn.WavefieldCompression(
            forward_wavefield_sampling_interval=10
        ),
        job_submission=sn.SiteConfig(
            site_name=SALVUS_FLOW_SITE_NAME, ranks_per_job=4
        ),
    )
)

Copy

mesh = p.simulations.get_mesh("initial_model")
lb = mesh.copy()
ones = np.ones_like(lb.elemental_fields["VP"])
lb.elemental_fields["VP"] *= 0.8
lb.elemental_fields["RHO"] *= 0.8
lb.elemental_fields["VP"][roi < 0.5] = 1501.0

ub = mesh.copy()
ub.elemental_fields["VP"] *= 1.2
ub.elemental_fields["RHO"] *= 1.2
ub.elemental_fields["VP"][roi < 0.5] = 1502.0

p.inversions.set_constraints(
    inverse_problem_configuration="my_third_inversion",
    constraints={
        "lower_bounds": lb,
        "upper_bounds": ub,
    },
)
p.inversions.iterate(
    "my_third_inversion", timeout_in_seconds=360, delete_disposable_files="all"
)
p.viz.nb.inversion(inverse_problem_configuration="my_third_inversion")

[2026-06-02 10:26:56,074] INFO: Adding new iteration #0.
[2026-06-02 10:26:56,083] INFO: Resuming iteration #0.

[2026-06-02 10:26:56,084] INFO: 1 new tasks have been issued.
[2026-06-02 10:26:56,084] INFO: Processing task `misfit_and_gradient`
[2026-06-02 10:26:57,302] INFO: 
Iteration 0: Number of events: 5	 chi = 0.016385616624463036	 ||g|| = 0.020187599407258453
pred = ---	ared = ---	norm_update = ---	tr_radius = ---
[2026-06-02 10:26:57,303] INFO: 1 new tasks have been issued.
[2026-06-02 10:26:57,303] INFO: Processing task `preconditioner`

[2026-06-02 10:26:57,573] INFO: Some tasks of iteration #0 are still running. Please check again later.
[2026-06-02 10:26:57,641] INFO: Processing task `preconditioner`
[2026-06-02 10:26:57,846] INFO: Some tasks of iteration #0 are still running. Please check again later.
[2026-06-02 10:27:00,455] INFO: 1 new tasks have been issued.
[2026-06-02 10:27:00,524] INFO: Submitting job array with 5 jobs ...

[2026-06-02 10:27:00,734] INFO: Launched simulations for 5 events. Please check again to see if they are finished.
[2026-06-02 10:27:00,790] INFO: Processing task `misfit`
[2026-06-02 10:27:00,975] INFO: Some tasks of iteration #0 are still running. Please check again later.
[2026-06-02 10:27:12,903] INFO: 
old misfit control group: 0.016385616624463036
new misfit control group: 0.0078109617854523515
predicted reduction control group: -0.0048543526499997824
actual reduction control group: -0.008574654839010685
5 out of 5 event(s) improved the misfit.
[2026-06-02 10:27:12,907] INFO: 
Model update accepted.
[2026-06-02 10:27:12,908] INFO: 1 new tasks have been issued.
[2026-06-02 10:27:12,957] INFO: ... searching for obsolete files in project/INVERSIONS/my_third_inversion/00000
[2026-06-02 10:27:12,974] INFO: Freed up 613.0 KB of space.
[2026-06-02 10:27:12,977] INFO: Successfully completed iteration #0.
[2026-06-02 10:27:12,980] INFO: Adding new iteration #1.

The example above is just meant to demonstrate the use of box constraints. For cases where lower and upper bounds are (almost) equal, we recommend using a region of interest instead.

It is sometimes helpful to let prior knowledge influence the model updates. There are inherent differences in the sensitivity with respect to the magnitude of some parameters, but we might use physical knowledge such as scaling relations between the parameters to tweak the proposed models. This can be achieved by a callback within the mapping function. In the following example, we only invert for VP, but use the following scaling relation for soft tissues to update RHO:

Copy

def scaling_relation_density(
    prior_model: sn.UnstructuredMesh,
    proposed_model: sn.UnstructuredMesh,
) -> sn.UnstructuredMesh:

    # Here we directly apply a scaling relation to the density model.
    # We don't need the prior model in this case.

    new_model = proposed_model.copy()
    new_model.elemental_fields["RHO"] = (
        0.893 * new_model.elemental_fields["VP"] - 349.0
    )

    return new_model

This callback will modify proposed model updates before recomputing the misfits. Strictly speaking, this results in inconsistent gradients, because we neglect density as an inversion parameter but because of the low sensitivity to density amplitudes, this does not impact the trust region algorithm much.

Copy

p.add_to_project(
    sn.InverseProblemConfiguration(
        name="my_fourth_inversion",
        prior_model="initial_model",
        events=p.events.list(),
        mapping=sn.Mapping(
            scaling="absolute",
            inversion_parameters=[
                "VP",
            ],
            postprocess_model_update=scaling_relation_density,
        ),
        preconditioner=sn.ConstantSmoothing({"VP": 0.01}),
        method=sn.TrustRegion(initial_trust_region_linf=10.0),
        misfit_configuration="L2",
        wavefield_compression=sn.WavefieldCompression(
            forward_wavefield_sampling_interval=10
        ),
        job_submission=sn.SiteConfig(
            site_name=SALVUS_FLOW_SITE_NAME, ranks_per_job=4
        ),
    )
)