eFuse Telemetry Generator

Synthetic eFuse telemetry generator for Battery Electric Vehicle (BEV) Zone Controller architectures. Produces physics-grounded, labelled datasets for eFuse protection algorithm development, ML training, and validation — without lab hardware or OEM data.

Supports single-cycle quick runs and month-long multi-cycle drive simulations with stochastic fault injection, progressive aging, and realistic daily driving patterns.

The package is distributed as a full runtime package: library, CLI, built-in sample configs, and dashboard launcher.

Documentation: See docs/ for the quickstart guide (install from PyPI), architecture deep-dive, data model reference, configuration guide, onboarding materials, eFuse domain reference (for hardware engineers), signal-chain one-pager (for stakeholders), and use-case library.

What It Generates

Key Capabilities

Physics Models

• RC thermal model — junction temperature with Rds,on positive feedback loop (PROFET+2 / VIPower tempco)
• ISENSE sensing chain — k_ILIS tempco + R_ILIS manufacturing tolerance (frozen per-unit scatter)
• Dual protection + current limiting — F(i,t) energy integral + SCP comparator + I_CL active current clamp → trip → cooldown → retry → latch-off
• CAN signal packing — second quantization layer (0.01 A/bit, 0.01 V/bit) models CAN-transported resolution loss
• Composite noise — 1/f pink noise + ADC quantization + thermal noise + sporadic EMI spikes
• Bus voltage events — jump-start (16–24 V), load dump (ISO 16750-2, ~40 V spike), cold crank (7–9 V sag)
• Connector aging — fretting corrosion model: R_c(t) = R_c0 × (1 + k × t²)
• Die thermal coupling — cross-channel substrate heat transfer for co-packaged eFuse ICs
• Power-state gating — SLEEP/CRANK/ACTIVE/ACCESSORY states with inrush and dark current
• Duty-cycle gating — periodic on/off cycling for intermittent loads (wiper motors, PTC heaters, etc.)

eFuse IC Catalog (19 Families) — Optional Preset Library

The generator ships with a bundled catalog of 19 production eFuse IC families as convenience presets. You can use them to quickly set up realistic channels without looking up datasheets, or define your own channels from scratch with explicit electrical parameters — the catalog is entirely optional.

Included families: Infineon PROFET+2 (BTS7002, BTS7004, BTS7006, BTS7008, BTS70041, BTS70061, BTS70081), Infineon TLE multi-channel (TLE9104SH), Infineon high-current BTS (BTS81000), ST VIPower (VN7140AJ, VND7020AJ, VNH7013AY, VNL5050, VND5025), and CUSTOM. Each entry defines: Rds,on, I_max, I_trip ranges, ISENSE ratio, ADC resolution, blanking time, retry count, F(i,t) threshold, and thermal parameters.

16 Fault Types

Multi-Cycle Drive Simulation

Generate month-long datasets with realistic driving patterns:

• Poisson trip scheduling — configurable mean trips/day, no-drive-day probability
• Log-normal trip durations — median, min, max trip length tuning
• Mean-reverting ambient temperature — daily/seasonal variation
• Stochastic fault injection — Poisson rate per vehicle-hour per fault type
• Progressive aging — connector_aging and gradual_degradation intensify with accumulated driving hours
• Cold-crank gating — only fires when ambient < 5°C

Quick Start

pip install efuse-telemetry-generator
efuse-gen

That's it — telemetry, features, and fault labels are in output/. To visualize interactively:

pip install "efuse-telemetry-generator[dashboard]"
efuse-dashboard

New here? See the documentation index for a guided reading path, or jump to the Quickstart Guide.

Install from PyPI

pip install efuse-telemetry-generator                # core generator + CLI
pip install "efuse-telemetry-generator[excel]"        # adds Excel (.xlsx) import support
pip install "efuse-telemetry-generator[dashboard]"    # includes Streamlit dashboard

Developer Setup

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"            # generator + tests
pip install -e ".[dev,dashboard]"  # includes packaged Streamlit dashboard

Requires Python ≥ 3.10.

Usage

Single-Cycle Mode

# Default 3-channel mixed-fault demo (60 s)
efuse-gen

# List packaged configs
efuse-gen --list-configs

# 65-channel full ZC topology (300 s, 21 fault injections)
efuse-gen --config single_drive

# Override duration and seed
efuse-gen --config quick_demo --duration 120 --seed 99

# CSV output
efuse-gen --config quick_demo --format csv

# Filesystem paths still work too
efuse-gen --config ./my-custom-scenario.yaml

Multi-Cycle Mode

# 30-day mixed driving profile (~55 cycles, ~37 h driving, ~8.6 M rows)
efuse-gen --config multi_day

Multi-cycle mode is auto-detected when the config has drive_cycle.enabled: true. The CLI accepts either a filesystem path or a packaged config name (quick_demo, single_drive, multi_day, fleet, stress_test).

Common Options

--config, -c PATH     YAML scenario config
--output, -o DIR      Root output directory (default: output/)
--format, -f FORMAT   parquet | csv | json (default: parquet)
--duration, -d FLOAT  Override duration in seconds (single-cycle only)
--seed, -s INT        Override random seed
--dry-run             Preview what would be generated without writing files
--json-log            Structured JSON logging
--list-configs        List available built-in configs and exit

Fleet-only options (requires a config with a fleet: section):
--vehicles, -n INT    Override fleet vehicle count
--days INT            Override fleet duration in days
--workers, -w INT     Override fleet parallel workers
--combined            Write combined fleet_telemetry.parquet

Preview a Config

efuse-gen info quick_demo
efuse-gen info ./my_scenario.yaml

Import Topology from CSV / Excel

Engineers can import their channel list from a spreadsheet instead of writing YAML:

# Generate a CSV template (open in Excel / Google Sheets)
efuse-gen topology template -o my_channels.csv

# Or a minimal template with just the essential columns
efuse-gen topology template -o my_channels.csv --minimal

# Fill in your channels, then import to YAML
efuse-gen topology import my_channels.csv -o my_vehicle.yaml

# Export an existing topology YAML back to CSV for editing
efuse-gen topology export my_vehicle.yaml -o channels.csv

# Scaffold a topology from a bundled preset
efuse-gen topology new -t compact -o my_prototype.yaml   # 2 zones, 12 ch
efuse-gen topology new -t full -o my_production.yaml     # 4 zones, 65 ch

# Use it in a scenario
efuse-gen --config ./my-scenario.yaml   # with topology_file: ./my_vehicle.yaml

Output is written to output/<config>_<YYYYMMDD-HHMMSS>/ — each run is isolated and named after the config used.

Quickstart

python examples/quickstart.py

Dashboard

Interactive Streamlit dashboard for exploring generated data.

pip install -e ".[dashboard]"
efuse-dashboard
# Opens at http://localhost:8501 and reads ./output by default

The dashboard reads output/ from the current working directory by default. Set EFUSE_TELEMETRY_OUTPUT_DIR=/path/to/output to point it elsewhere.

Sidebar: Run selector, data source banner (synthetic / bench / HIL / production), zone filter (from channel manifest), day filter (multi-cycle), channel multi-select with load name labels.

Measurement Data Ingestion

Ingest real bench, HIL, or production recordings into the same run format the generator produces — so the dashboard and analysis pipeline work identically on real data.

# Single file with column mapping
efuse-gen ingest recording.csv \
  --map "I_ch01=current_a,U_bat=voltage_v,T_junc=temperature_c" \
  --channel ch_001

# Directory of per-channel CSVs (channel_id derived from filenames)
efuse-gen ingest bench_data/ --glob "*.csv"

# Tag the data source
efuse-gen ingest hil_capture.parquet --source-tag hil

Supported formats: CSV/TSV, Parquet, MDF/MF4 (requires asammdf), BLF/ASC CAN logs (requires python-can + cantools).

Ingested runs appear in the dashboard alongside synthetic runs, with a data-source badge in the sidebar.

Built-In Configs

Project Structure

efuse_datagen/
├── schemas/telemetry.py      # Pydantic data models (ChannelMeta, EFuseProfile, FaultInjection, …)
├── config/
│   ├── models.py             # SimulationConfig, DriveCycleConfig, FaultRateConfig, FeatureConfig
│   ├── catalog.py            # Optional eFuse IC preset library (19 families)
│   ├── builtin.py            # Built-in config loader and registry
│   ├── templates/*.yaml      # Scenario configs (reference topology_file for zones/channels)
│   └── topologies/*.yaml     # Reusable vehicle topology files (zones + channel_specs)
├── dashboard_app.py          # Slim Streamlit orchestrator (delegates to tab modules)
├── dashboard_launcher.py     # efuse-dashboard entry point
├── dashboard/
│   ├── _shared.py            # Data loaders, fault palette, data-source detection
│   └── tabs/                 # One module per tab: overview, signals, features, protection, config, fleet
├── simulation/
│   ├── generator.py          # TelemetryGenerator — signal synthesis, fault waveforms, protection
│   └── drive_cycles.py       # DriveCyclePlanner — schedule, fault distribution, multi-cycle orchestration
├── features/engine.py        # FeatureEngine — rolling statistics, anomaly scores
├── storage/writer.py         # StorageWriter — Parquet/CSV/JSON output + manifest
├── ingestion/                # MeasurementAdapter — load real bench/HIL/production data
├── analysis/
│   └── hardware_harness.py   # IC benchmarking, wiring sizing, thermal headroom (data-agnostic)
├── cli.py                    # Typer CLI: efuse-gen (with ingest subcommand)
└── utils/logging.py          # Logging configuration
dashboard/
└── app.py                    # Repo compatibility wrapper for the packaged dashboard
docs/                         # Architecture, data model, configuration, and onboarding docs
tests/                        # 158 pytest tests
examples/
└── quickstart.py             # Minimal end-to-end example

Tests

pytest                  # Run all tests
pytest -v               # Verbose
pytest --cov=efuse_datagen  # With coverage

License

MIT License. See LICENSE for details.