Quickstart

Run your first simulation in Ionworks Studio in under 5 minutes

This guide will walk you through the essential steps to get up and running with Ionworks Studio. We’ll create a new project, a cell, a model, a study, and run a basic simulation.

Step-by-Step Guide

1. Select 'Default Project'

We create a default Project for you to get started.

1. Navigate to the Projects page from the main menu.
2. Click “Default Project” to go to the default project.

2. Create a Cell Specification

Now, let’s define the cell you want to work with within your new project. A Cell Specification is the blueprint for your cell.

1. Navigate to the Cells page.
2. Click “New Cell”.
3. Fill in the required properties:
   • Name: A descriptive name, e.g., “My First NMC Cell”.
   • Chemistry: e.g., “NMC/Graphite”.
   • Nominal Capacity: e.g., 5 Ah.
   • Voltage Limits: e.g., 2.5 V (lower) and 4.2 V (upper).
4. Click “Create” to save it.

3. Create a Model

Next, we need a Model to describe the cell’s electrochemical behavior.

1. Navigate to the Models page.
2. Click “Create Model”.
3. In the creation wizard, select the Cell Specification you just created.
4. For this quickstart, let’s start with a pre-defined parameter set. Select “From Library” and choose a suitable starting point (e.g., a SPM model for your chemistry).
5. The platform will run a Parameter Validation check. You can review the parameters and see if there are any warnings or errors.
6. Give your model a name and click “Create” to finalize it.

4. Create a Study

A Study lives inside a project and is used for a focused investigation.

1. Go back to your newly created project.
2. Inside the project, click “Create Study”.
3. Give your study a name, e.g., “Cycling Test”.
4. Click “Create”.

5. Run a Simulation

Now we’re ready to run a Simulation within your study.

1. Inside your study, click the “Run Simulation” button.
2. Select the Cell Specification and Model you created.
3. Choose an experiment type, for example, “Constant Current Discharge”.
4. Configure the experiment parameters. For example, set the C-rate to 2.
5. Click “Run”. Ionworks Studio will start the simulation.

6. Visualize Results

Once the simulation is complete, the results will appear in your study.

1. Go back to your study.
2. You can see your simulation in the Data View table.
3. Switch to the Visualization View to plot the results.
4. Click “Add Plot” and configure it to show voltage vs. capacity.

Congratulations! You’ve just run your first simulation in Ionworks Studio.

Next Steps

Now that you’ve run a basic simulation, you can explore more advanced features:

Run Parameter Sweeps

Explore the effect of changing multiple parameters at once.

Clone and Edit Models

Iterate on your models to refine their accuracy.

Organize Your Work

Create new projects and studies for different research initiatives.

Simulate Commercial Protocols

Simulate real-world battery tests from manufacturers like Maccor and Neware.

Parameterize Models with Python

Use our Python library to parameterize models from experimental data.