A Simulation is the result of running a Model with a specific set of inputs and experimental conditions. Simulations are the core of Ionworks, allowing you to explore the performance of your CellSpecification beyond what you have measured experimentally. Simulations are always created and viewed within the context of a Study.

​
Running a New Simulation

You can run a new simulation or a sweep of simulations from within a study. The process is broken down into a simple, step-by-step workflow.
  1. Select Cell Specification: First, choose the cell you want to simulate.
  2. Select Model: Next, select a model that has been parameterized for your chosen cell.
  3. Select Experiment Type: Choose the type of experiment you want to run, such as a “Constant Current Charge” or a “Pulse Resistance” test.
  4. Configure Experiment Parameters: Set the specific conditions for the experiment you selected (e.g., the C-rate for a charge step).
  5. Configure Design Parameters (Optional): You can also vary the model’s own parameters to explore their effect on performance (e.g., “Electrode height [m]”).
Running Sweeps: For any experiment or design parameter, you can enter multiple values separated by commas (e.g., 1, 2, 5). Ionworks Studio will automatically create and run a simulation for every possible combination of the parameters you’ve entered. The UI will show you the total number of simulations that will be run.
To save you time and computational resources, Ionworks Studio automatically checks if an identical simulation has already been run. Existing results are reused, and new results are saved for future use.

​
Visualizing and Comparing Results

Once your simulations are complete, they are added to the study’s results page, which provides powerful tools for analysis. Simulation results are organized by “experiment type” so that you can compare like-for-like results within a single experiment type - for example, investigating the effect of C-rate on capacity in a constant current discharge. You can switch between two views:

​
Data View

This is a table containing the results of all simulations within the study. It includes the inputs for each simulation and the key summary metrics that were calculated. You can use this view to sort and filter your results to find specific runs.

​
Visualization View

This is a customizable dashboard where you can create plots to visualize and compare your simulation results.
  • Add Plots: Click the “Add Plot” button to configure and add a new visualization to your dashboard. You can choose between “time series” (whole variable trace vs time or capacity) and “metrics” (single values e.g. “Capacity” vs “C-rate”).
  • Custom Layout: You can add multiple plots to your dashboard to compare different simulations or look at different variables. The plots can be dragged, dropped, and resized to create the perfect layout for your analysis.
  • Interactivity: The plots are fully interactive, allowing you to zoom, pan, and hover over data points to get more detail. Any new simulations you run within the same study will automatically be added to the plots.
This flexible visualization tool allows you to build a comprehensive view of your simulation results, tailored to your specific analysis needs.