How Do I Submit Multiple Simulations?

How Do I Submit Multiple Simulations?#

Date

Category

2026-04-14 14:22:09

Parameter Sweep

How do I submit multiple simulations?#

web.run is the unified interface for running simulations on the Tidy3D cloud.

For parameter scans and multi-simulation workflows, web.run accepts not only a single simulation, but also dictionaries, lists, tuples, and nested combinations of these.

As shown in ParameterScanWebRun.ipynb, using a dictionary is convenient because each dictionary key is preserved as the task name in the returned results mapping.

When should I use it?#

  • Parameter sweeps

  • Design-of-experiments workflows

  • Any scripted workflow involving many related simulations

Running many simulations#

Create a dictionary of simulations and pass it directly to web.run:

import tidy3d as td
from tidy3d import web

sims = {
    "run_a": sim_a,
    "run_b": sim_b,
}

results = web.run(sims, verbose=True)

Here, web.run handles submission, monitoring, and loading of all simulations in one call.

Accessing results#

The returned object can be indexed by task name or iterated over:

sim_data_a = results["run_a"]

for task_name, sim_data in results.items():
    print(task_name, sim_data)

This makes web.run a natural choice for parameter scans where task names are derived from parameter values.

Contents