IST Li-ion Battery Simulator V-10.0.1 (Connected to P01 — evbike-48v project) (Trial, 45 days left)
Home
File
Home
Database
Pack Configuration
Thermal Analysis
BMS Design
Circuit Design
Housing
Safety & Compliance
Reports
View
New Pack Design
Open Project
Save Design
Design
Run Simulation
Validate Configuration
Optimize Pack Layout
Analysis
Export Report
Export BOM
Export
New
Open
Save
Design
Simulate
Validate
Optimize
Analysis
Report
BOM
Export
Home

Open a Project

A project is the container for everything that follows — cells, models, studies, and results all live inside one. A default project is created automatically for new accounts.

New Pack Design

Lock down target KPIs and build the cell-level electrochemical model before opening any solver — this wizard sets up every downstream simulation.

Projects

A project is the container for everything that follows — cells, models, studies, and results all live inside one. A default project is created automatically for new accounts. Upload a saved project (.pro) file below, or open one of your existing projects.

No file selected
Project NamePack ConfigCellsStatusLast Opened
evbike-48v (Default Project)13S4P — 48.1V 24Ah4 Active12/3/2024 9:22 AM
solar-ess-51v16S6P — 51.2V 36Ah2 Draft11/20/2024 2:03 PM
Define Application
Define objectives, chemistry & requirements
Before opening any solver, lock down what the simulation needs to answer.

Project Details

Application Context

Electrical Targets

to

Charging Requirements

Environmental & Operating Envelope

to
to

Thermal Management Target

Life & Safety Targets

Applicable compliance standards

Mechanical / Packaging Constraints

BMS / Control Scope

Notes

Output: Simulation requirement specification and target KPI sheet, used to configure every downstream model.
Pack Configuration
Cell-level electrochemical design
Build the cell: geometry, materials, and performance model.

Cell & Pack Design

Pulled live from the Cell database (Database > Cell Library).
Pulled live from the BMS database (Database > BMS Library). Used to check protection/chemistry compatibility.
Output: Nominal capacity, open-circuit voltage, internal resistance, cell mass, and a TBM (thermal battery model) file for downstream CFD linkage. Calculated server-side in PHP; the TBM file is generated by a Python background job.
Pack Configuration
BDS Cell Modeling
Four stages of the BDS cell-modeling workflow, run server-side in pure PHP (inc/bds/*.php — a from-scratch port of the original Python module, no Python runtime required): HPPC-based ECM parameter extraction, EIS-based CNLS fitting, a Newman P2D finite-volume solver, and a joint parameter-identification driver. Click Run, then results appear below once the analysis finishes.

(a) HPPC-Based ECM Parameter Extraction

Paste a time series spanning at least one full HPPC pulse plus its relaxation period.

(b) EIS-Based ECM/CNLS Fitting

Z_imag follows the usual EIS sign convention (negative = capacitive).

(c) Newman Pseudo-2D (P2D) Finite-Volume Solver

Uses a generic graphite/NMC 18650-class default parameter set (geometry, transport, OCP curves) — override the fields above; everything else uses documented illustrative defaults.

(d) Joint Parameter Identification (Cycler → P2D θ)

Fits θ = [Ds,neg, Ds,pos, kneg, kpos, Bruggeman] against the measured trace above via identify_p2d_params(), starting from the same defaults as the P2D card. Given the P2D forward model's known instability (see the P2D card's results for details), this is likely to fail on realistic multi-step traces — that failure will be reported clearly rather than silently.
Thermal Analysis
STAR-CCM+ Module — Battery Pack Thermal Simulation
Resolves 3D-equivalent pack thermal behavior in pure PHP (inc/star/*.php — a from-scratch port of STAR-CCM+-Module-Equivalent.py, no Python runtime required): conjugate heat transfer across cell & coolant channel, coolant flow & pressure drop, and multi-physics thermal-runaway propagation for pack safety design.

Battery Design Studio (BDS) supplies the per-cell heat-generation term used as the CHT source (I²R + entropic, from the ECM/P2D modules under Pack Configuration > Advanced Cell Modeling). Amesim would supply a pack-level current/voltage duty cycle as a boundary condition and can receive back a reduced RC-tree thermal network for fast co-simulation — both are external tools outside this app; the heat-generation and duty-cycle fields below are where that hand-off happens, entered directly for now.

(a) Conjugate Heat Transfer — Cell & Coolant Channel

Coolant properties default to a typical 50/50 glycol-water mix; cell wetted area/cross-section default to the reference module's example geometry.

(b) Coolant Flow & Pressure Drop

(c) Multi-Physics Thermal-Runaway Propagation

A single value runs single-cell kinetics (the N=1 case has no neighbor terms, so it's mathematically identical). Add more values for a multi-cell pack propagation network. Limit 12 cells.
Uses a Kim/Hatchard-type 4-reaction Arrhenius abuse-kinetics model (SEI decomposition, negative-electrode/electrolyte, positive-electrode decomposition, electrolyte decomposition) with the reference module's illustrative parameter set — not calibrated against any specific cell's ARC/DSC data. Runaway onset (dT/dt > 10℃/min) is detected per cell; a very sharp runaway onset can outrun this explicit adaptive-step integrator, in which case results up to that point are still shown with a clear note.
Thermal Analysis
Thermal Imaging & Cooling Process Activation — Live Simulation
A lumped-RC thermal network (Bernardi heat generation, inter-module conduction, coolant convection) driving a staged hysteresis cooling controller, rendered as a false-color thermal-camera view that runs continuously below — not a pre-rendered animation. Eight physical modules (2×4 grid) are each a single lumped thermal node; heat flows to neighbors by conduction and to the coolant loop by convection, and a controller watches the pack's hottest module to escalate/de-escalate OFF → LOW → MEDIUM → HIGH with independent turn-on/turn-off thresholds per stage (so it doesn't chatter at a boundary). Runs entirely in the browser (a JavaScript port of the same formulas as inc/thermal_imaging/*.php / the uploaded thermal.py) — simulated time runs faster than real time so the full heating/cooling cycle is visible without waiting.

Controls

Live Readout

Simulated Time
00:00
Cooling Stage
OFF
Fan/Pump Duty
0%
Load Current
0.0 A
T Max
25.0℃
T Mean
25.0℃
T Min
25.0℃
Box color = live simulated module temperature (thermal-camera IR palette, fixed display span 15–65℃). Dashed outline = the configured hotspot module. Thin lines = the inter-module conduction network.

Batch Simulation Result (server-side PHP, full duration)

Runs the identical physics once, server-side, for the full 1800s reference duration and returns a stage-transition timeline — useful for validating the live view above, or for a quick numeric summary without watching it play out.
BMS Design
Amesim Module — System-Level 0D/1D Simulation
Assembles BDS-exported cell models into a full pack circuit, runs BMS estimation/protection/balancing logic, and drives the pack with vehicle-level load — computed in pure PHP (inc/amesim/*.php — a from-scratch port of Amesim-Module-Equivalent.py, no Python runtime required), fast enough for design-of-experiments sweeps.

Battery Design Studio (BDS) exports the per-cell reduced-order model (OCV(SOC), R0/R1C1/R2C2) that this module replicates Ns×Np times to build the pack. STAR-CCM+ would supply a reduced thermal RC-network in place of a fixed cell temperature. MAGNET would supply the motor/inverter efficiency map used in the drive-cycle power-flow chain. All three are external tools outside this app; the cell/thermal/motor parameters below are where that hand-off happens, entered directly for now.

(1) Pack Circuit (Ns×Np)

(2) BMS Protection & Balancing

(3) SOC/SOH Estimation (EKF + RLS + Aging)

The EKF starts intentionally offset from the true SOC, and the RLS resistance tracker starts intentionally seeded 20% low, to demonstrate convergence.

(4) Full Drive-Cycle Closed-Loop Simulation

Uses the reference module's own synthetic drive cycle (a smooth speed profile). BMS protection thresholds and current limits use the same defaults as card (2) above.
Circuit Design

MAGNET Module

Magnetostatic/Eddy-Current FEA on Busbars, Contactors & Current Sensors — 2D magnetostatic and phasor eddy-current field solves for busbar cross-sections (field, Maxwell-stress force, skin/proximity-effect AC loss), a contactor reluctance-network + coenergy force model with armature pull-in dynamics, and Hall-effect/Rogowski/shunt current-sensor transfer functions.

More Circuit Design Tools

Busbar routing, contactor/fuse sizing, and harness layout tools beyond the MAGNET FEA module will live here. Not yet built out.

HV/LV Electrical Circuit Diagram

Module & Pack, Input to Output — 2D Schematic & 3D Layout Generator. Builds the HV power chain (modules → service disconnect → contactor/precharge → fuse → current sensor → DC bus) and the parallel HVIL loop & LV BMS network, rendered as a 2D single-line schematic and a live, rotatable 3D layout.

Circuit Design
MAGNET Module — Magnetostatic/Eddy-Current FEA on Busbars, Contactors & Current Sensors
Pack-level electrical hardware EM analysis, computed in pure PHP (inc/magnet/*.php — a from-scratch port of circuit.py, no Python runtime required): busbar magnetostatic field/force, eddy-current skin/proximity-effect AC loss, contactor solenoid actuation, and current-sensor models.

Amesim would supply the pack current profile (drive-cycle Ipack(t), fault/short-circuit transients) as the excitation for this analysis. STAR-CCM+ would receive the I²R Joule-loss distributions computed here as volumetric heat sources for conjugate heat transfer, and could return busbar temperature back for a resistivity update. Both are external tools outside this app; the current/frequency fields below are where that hand-off happens, entered directly for now.

(a) Busbar Magnetostatic FEA — Field & Force

(b) Eddy-Current / Skin Effect — AC Loss

(c) Contactor Solenoid — Reluctance Network & Pull-In Dynamics

A large enough hold current relative to the spring constant will snap the armature fully closed (gap → 0) — this is normal contactor closing behavior, not an error; the closed-form force law isn't clamped at contact, so times after that point aren't physically meaningful.

(d) Current Sensors — Hall (Open/Closed-Loop), Rogowski, Shunt

Circuit Design
HV/LV Electrical Circuit Diagram — Module & Pack, Input to Output
Builds the HV power chain and LV BMS/control network for a battery pack — from cell modules (input) through contactors, fuse, current sensor, to the DC bus output (output) — computed in pure PHP (inc/hvlv/*.php — a from-scratch port of hv-lv.py, verified byte-for-byte against the Python original's binary STL output). Rendered two ways: a 2D single-line schematic (SVG) and a live, rotatable 3D layout (STL, parsed and drawn in this page with a small hand-written binary-STL reader — no external CAD viewer plugin).

Path: Input (cell modules) → Service Disconnect → [+] Contactor (∥ Precharge) → Fuse → Current Sensor → DC Bus Output → [−] Contactor → back to Input. A parallel HVIL sense loop and a separate LV BMS network (master, per-module slaves, coil drivers, isolation monitor) are modeled alongside the same component set.

Pack Configuration

2D Single-Line Schematic

Input (cell modules) → Service Disconnect → [+] Contactor (∥ Precharge) → Fuse → Current Sensor → DC Bus Output → [−] Contactor → back to Input, rendered directly from the same topology used for the 3D layout below. Solid heavy lines are the HV power path, dashed heavy-spaced lines are the HVIL loop, and light dashed/solid lines are the LV signal/power network.

3D Layout — Live View

Rendered from the same topology's real 3D component positions (module footprints, busbar runs, contactor/fuse/sensor boxes, HVIL wire, LV harness), exported as STL and parsed live in this page. Drag to rotate, scroll to zoom.
Reports
Complete System Simulation & Report
Runs one consistent pack configuration through every analysis module built in this app — Cell & Pack electrochemical model, HPPC parameter extraction, conjugate heat transfer, full drive-cycle closed loop, busbar EM FEA, HV/LV circuit topology & sizing, and thermal-imaging cooling simulation — then assembles the results into one downloadable/printable report. Each stage calls the same server-side endpoint already used by its own screen elsewhere in the app; nothing here is a separate implementation.

Pack Configuration (shared across all stages)

Progress

Housing

Battery Pack Housing

Vehicle-Space-Driven, 3D-Printable Module & Pack Housing Design Generator — the parametric mechanical housing layer that sits underneath the rest of the Simcenter-style workflow (BDS cell models, STAR-CCM+ thermal, Amesim system/BMS, MAGNET electromagnetics). Derives every housing dimension directly from the actual available vehicle package space and exports print-ready STL meshes.

Housing
Battery Pack Housing — Vehicle-Space-Driven, 3D-Printable Module & Pack Housing Design Generator
This screen is set up and reachable from the Housing menu, but the actual geometry generator hasn't been built yet — the source file (housing.py) referenced for this conversion wasn't attached to that request, so there's nothing yet to port. Please attach housing.py and I'll convert it the same way as the BDS/STAR-CCM+/Amesim/thermal-imaging modules: a verified PHP port (mesh primitives, the VehiclePackageEnvelope/cell/module dataclasses, the pack layout calculator, module & pack housing generators, printability checks) plus an STL export endpoint, cross-checked against the Python original at matched inputs before anything ships.
Database
Cell
BMS
BTMS
M-PCB
Busbar
ColdPlate
Other Parts
×
🔍 Search
Add New
X
NameChemistryCapacity (Ah)Voltage (V)StatusCycle LifeMax C-RateLast Modified
Summary
Discharge Curve
Safety Data
Sourcing
Database
Cell
BMS
BTMS
M-PCB
Busbar
ColdPlate
Other Parts
×
🔍 Search
Add New
X
NameManufacturerCategoryCell ChemistryMax Series CellsStatusLast Modified
Summary
Protection
Balancing & Sensing
Comms & Switching
Power & Diagnostics
Compliance & Sourcing
Database
Cell
BMS
BTMS
M-PCB
Busbar
ColdPlate
Other Parts
×
🔍 Search
Add New
X
NameCooling TypeCoolantDesign Target ΔTStatusLast Modified
Summary
Thermal Performance
Material Properties
Heating
Fluid & Electrical
Sensors & Sourcing
Database
Cell
BMS
BTMS
M-PCB
Busbar
ColdPlate
Other Parts
×
🔍 Search
Add New
X
NameManufacturerCategoryRatingStatusLast Modified
Summary
Voltage & Current
Isolation & Safety
I/O & Switching
Balancing & Thermal
Comms & Diagnostics
Power & Mechanical
Diagnostics & Sourcing
Database
Cell
BMS
BTMS
M-PCB
Busbar
ColdPlate
Other Parts
×
🔍 Search
Add New
X
NameManufacturerCategoryConductor MaterialStatusLast Modified
Summary
Electrical Properties
Current Ratings
Thermal Performance
Insulation & Dimensions
Sourcing
Database
Cell
BMS
BTMS
M-PCB
Busbar
ColdPlate
Other Parts
×
🔍 Search
Add New
X
NameCategoryRatingVendorStatusLast Modified
ColdPlate-Al-400x200Thermal2.5 kWBoydActive11/29/2024 4:20 PM
Summary
Ratings
Compliance
Sourcing
Database
Cell
BMS
BTMS
M-PCB
Busbar
ColdPlate
Other Parts
×
🔍 Search
Add New
X
NameCategoryRatingVendorStatusLast Modified
Fuse-MEGA-150AProtection150A / 58VLittelfuseActive11/18/2024 2:47 PM
Contactor-EV200Switching500ATE ConnectivityDraft11/10/2024 8:30 AM
Summary
Ratings
Compliance
Sourcing
New Part Specification

The part specification is the blueprint for a discrete pack-level part: its ratings, compliance, and sourcing. Every BOM and pack design references one from the Master PCB, Busbar, ColdPlate, or Other Parts library.

General Information

Ratings

Compliance

to

Sourcing

Component datasheet created and saved as component-datasheet.dat (JSON) in the data folder.
New Cell Specification

The cell datasheet is the electrochemical and mechanical blueprint for a single cell — its ratings, geometry, and safety limits. Every pack design and simulation in the Cell Library references one of these records.

General Information

Physical & KPI Targets

Electrical KPIs

to

Charge Parameters

Discharge Parameters

to

Safety Limits

to

Sourcing

Cell datasheet created and saved as cell-datasheet.dat (JSON) in the data folder.
New BMS Specification

The BMS datasheet is the electrical, protection, and communications blueprint for a battery management system module. Every pack design and simulation in the BMS Library references one of these records.

General Information

Cell Compatibility

Voltage Measurement

Current Measurement

Protection Thresholds

Balancing

Temperature Sensing

Communication

Switching & Contactor Control

Power Consumption

SOC/SOH & Diagnostics

Compliance & Mechanical

Sourcing

BMS datasheet created and saved as bms-datasheet.dat (JSON) in the data folder.
New BTMS Specification

The BTMS datasheet is the thermal, material, and fluid/electrical blueprint for a battery thermal management component. Every pack design and simulation in the BTM Library references one of these records.

General Information

Design Target

to

Thermal Performance

Material Properties

Heating

Electrical

Fluid

Sensors

Sourcing

BTMS datasheet created and saved as btms-datasheet.dat (JSON) in the data folder.
New M-PCB Specification

The Master PCB datasheet is the electrical, isolation, I/O, and functional-safety blueprint for a master BMS carrier/controller board. Every pack design and simulation in the M-PCB Library references one of these records.

General Information

Board Basics

Voltage Measurement

Current Measurement

Isolation

Safety

Digital I/O

Balancing

Thermal Sensing

Communication

Functional Safety

Power Supply

Mechanical & Environmental

Compliance

Battery Diagnostics

Sourcing

M-PCB datasheet created and saved as mpcb-datasheet.dat (JSON) in the data folder.
New Busbar Specification

The busbar datasheet is the electrical, current-carrying, thermal, and insulation blueprint for a rigid conductor interconnect. Every pack design and simulation in the Busbar Library references one of these records.

General Information

Ratings Overview

Conductivity & Resistance

Contact & Surface

Continuous Current

Short-Time & Fault Withstand

Thermal

Insulation

Dimensions & Skin Effect

Sourcing

Busbar datasheet created and saved as busbar-datasheet.dat (JSON) in the data folder.
Ready
6 cells loaded
Pack: 13S4P — 48.1V 24Ah
Simulation engine: idle
User: dhira.eng