Stable Python API

The stable Python-facing API is centered on PyMieSim.Simulation for single-particle calculations and PyMieSim.Experiment for parameter sweeps. Both accept the historical measure strings and the discoverable PyMieSim.Measure enum:

from PyMieSim import Measure, Simulation

simulation.run(Measure.QSCA)

Use available_measures to inspect what the configured geometry and detector support. Existing string calls remain supported for compatibility.

Typed results

Typed result containers are opt-in:

result = simulation.run(Measure.QSCA, as_result=True)
print(result.measure, result.quantity, result.units)

For multiple single-particle measures, as_result=True returns a mapping of measure names to SimulationResult objects. Experiment sweeps always return LabeledArray; use result.as_numpy() or result.as_dataframe() for explicit conversion.