Native source materials / 61 indexed

Native lessons and source materials

This index links to repository-authored course records, examples, tutorials, and technical reading. The separate browser lab is an educational surrogate; its sliders and checkpoints do not execute this repository's native engine.

Current audited native source: 6fed303797dff87409879b4dc3715b0a1e01c1a4

Conceptual teaching diagram selected from the repository visual mapping
Conceptual one-RC reference; not asserted as an exact example implementation.

Browser-lab provenance from the reconciled package: package source revision ed410f7db8c6f425c0d38ca5d03358975300872e. This is separate from the current native source revision above.

Section 03: Reproduce / parameters

Source-defined reproduction commands

These exact one-line commands were observed in the audited repository workflow records and link to their source location. Expected setup, tool licensing, data, and environment vary by repository; the dashboard does not execute these commands or promise a completion time.

Source-defined MATLAB validation command · Context: MATLAB Command Window (matlab-actions/run-command; not shell)

addpath('examples'); run('examples/validation-manifest/check_validation_manifest.m'); generate_validation_manifest(getenv('GITHUB_SHA'))

Observed in .github/workflows/matlab-validation.yml:L67

Source-defined MATLAB validation command · Context: MATLAB Command Window (matlab-actions/run-command; not shell)

addpath('examples/bess-unified-control'); run('examples/bess-unified-control/check_bess_unified_control.m')

Observed in .github/workflows/matlab-validation.yml:L96

Source-defined MATLAB validation command · Context: MATLAB Command Window (matlab-actions/run-command; not shell)

addpath('examples/bess-unified-control'); generate_bess_validation_evidence(getenv('GITHUB_SHA'))

Observed in .github/workflows/matlab-validation.yml:L101

Search the native catalog

61 materials

Read the machine-readable native catalog

Section 01: Question / topology

Question / topology

Native lesson / example

Battery SOC Hysteresis EKF

What happens when an SOC estimator treats equilibrium voltage as a

examples/battery-soc-hysteresis-ekf/README.md

native lesson
Native lesson / example

Battery State-of-Charge EKF

How can a transparent extended Kalman filter correct a biased

examples/battery-soc-ekf/README.md

native lesson
Native lesson / example

Closed-Loop Averaged Converter

This base-MATLAB reference adds bounded closed-loop control to an averaged

examples/converter-closed-loop-model/README.md

model native lesson
Native lesson / example

Sample timing contract

The runners record plant state at the input timestamp, before integrating

examples/bess-unified-control/docs/sample-timing.md

native lesson
Native lesson / example

Switching Buck Converter

This Base-MATLAB reference resolves ideal pulse-width modulation and the

examples/converter-switching-model/README.md

model native lesson
Native lesson / example

Switching Closed-Loop Buck Converter

This Base-MATLAB benchmark connects a bounded cascaded voltage/current

examples/converter-switching-closed-loop-model/README.md

model native lesson
Section 02: Equations / provenance

Equations / provenance

Native lesson / example

Architecture

The generated Simulink model is an executable shell around readable MATLAB

examples/bess-unified-control/docs/architecture.md

model native lesson
Native lesson / example

Battery OCV Hysteresis Model

How can a small equivalent-circuit model preserve charge/discharge history so

examples/battery-ocv-hysteresis/README.md

model native lesson
Native reading

Battery pulse-response lab in Base MATLAB

Use a first-order equivalent-circuit model to explain how current pulses change

docs/battery-pulse-response-lab.md

model
Native lesson / example

BESS DC-Link and SOC Reserve Model

This Base-MATLAB benchmark makes the battery and DC-side availability behind a

examples/bess-dc-reserve-model/README.md

model native lesson
Native lesson / example

Equations, Frames, and Conventions

For three-phase rated apparent power \(S_b\), line-to-line RMS voltage

examples/bess-unified-control/docs/equations.md

model native lesson
Native reading

Model Selection by Engineering Decision

Choose the smallest model that can answer the decision you actually need to

docs/model-selection-by-decision.md

model
Native lesson / example

Tuning and Parameter Replacement

All tunable values live in bess_unified_control_parameters.m; callers can

examples/bess-unified-control/docs/tuning.md

model native lesson
Native lesson / example

Unified BESS Control Work Log

Model repository:

examples/bess-unified-control/validation/work-log.md

model native lesson verification
Native reading

Which MATLAB Battery, Converter, or BESS Model Should I Use?

Use this guide to choose the smallest model that answers your engineering

docs/model-selection-guide.md

model
Section 03: Reproduce / parameters

Reproduce / parameters

Native lesson / example

Battery Module Liquid-Cooling Thermal Network

This base-MATLAB example models six battery-cell thermal masses along a serial

examples/battery-module-cooling-network/README.md

model native lesson
Native lesson / example

Battery RC Model Example

This runnable example implements a simple first-order battery equivalent-circuit model in MATLAB.

examples/battery-rc-model/README.md

model native lesson
Native lesson / example

Example Troubleshooting Notes

Use these notes to triage common run, path, data, and expected-output problems in the MATLAB examples.

examples/guides/example-troubleshooting-notes.md

native lesson
Native reading

Grid-Forming BESS Control in MATLAB and Simulink: An Executable Walkthrough

Grid-forming control is easiest to learn when operating modes, transition

docs/grid-forming-bess-control.md

native lesson
Native lesson / example

MATLAB Examples Index

This index lists the starter MATLAB examples, their purpose, key files, and run commands.

examples/README.md

native lesson reproduction
Native reading

Modeling Standards

Use these standards for examples in this repository.

notes/modeling-standards.md

model native lesson
Native lesson / example

Native Simulink Averaged Buck Converter

This example generates a genuine Simulink block diagram from readable MATLAB

examples/converter-simulink-model/README.md

model native lesson
Native lesson / example

Native Simulink Battery 2RC Model

This example generates an inspectable Simulink block diagram for the existing

examples/battery-2rc-simulink-model/README.md

model native lesson
Native lesson / example

Native Simulink Battery RC Model

This example generates an inspectable Simulink block diagram for the existing

examples/battery-simulink-model/README.md

model native lesson
Native lesson / example

Native Simulink Battery Thermal Model

This example generates an inspectable discrete Simulink diagram for the

examples/battery-thermal-simulink-model/README.md

model native lesson
Native lesson / example

Native Simulink Switching Closed-Loop Buck

This example generates a genuine fixed-step Simulink block diagram for the

examples/converter-switching-closed-loop-simulink-model/README.md

model native lesson
Native lesson / example

Pouch-Cell Through-Thickness Thermal Gradient

This base-MATLAB example resolves a pouch cell as a one-dimensional slab of

examples/pouch-cell-thermal-gradient/README.md

model native lesson
Native lesson / example

Temperature-Aware Battery Model

This runnable MATLAB example couples a first-order battery equivalent circuit

examples/battery-thermal-model/README.md

model native lesson
Native lesson / example

Unified BESS Control Requirements

This example is a transparent engineering translation of the unified BESS

examples/bess-unified-control/requirements/requirements.md

native lesson
Native lesson / example

Unified Grid-Tied and Grid-Forming BESS Control

This example is a transparent, executable engineering translation of the

examples/bess-unified-control/README.md

native lesson
Section 04: Verification / output

Verification / output

Native lesson / example

Automation Readiness Guide

Use this guide for making examples easier to validate through fast, no-plot automation checks. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/automation-readiness-guide.md

native lesson
Native lesson / example

Battery 2RC Model Example

This runnable example extends the validated battery state pipeline with two

examples/battery-2rc-model/README.md

model native lesson
Native lesson / example

Dependency Inventory Guide

Use this guide for identifying required MATLAB products, files, and local data before example publication. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/dependency-inventory-guide.md

native lesson
Native lesson / example

Documentation Update Playbook

Use this guide for keeping README text, expected outputs, and validation commands synchronized after edits. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/documentation-update-playbook.md

native lesson reproduction verification
Native lesson / example

Example Release Checklist

Use this guide for checking documentation, sample data, and validation commands before an example is treated as ready. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/example-release-checklist.md

native lesson reproduction verification
Native lesson / example

Expected Output Change Log

Use this guide for documenting intentional changes to example outputs so checks and README text stay aligned. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/expected-output-change-log.md

native lesson
Native lesson / example

Future Example Idea Bank

Use this guide for collecting small future example ideas with validation and data requirements. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/future-example-idea-bank.md

native lesson verification
Native lesson / example

Input Profile Review Guide

Use this guide for checking current, load, irradiance, or control input profiles before they drive examples. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/input-profile-review-guide.md

native lesson
Native reading

Machine-Readable Validation Manifest

The general MATLAB validation job

docs/validation-manifest.md

verification
Native lesson / example

Parameter Review Guide

Use this guide for checking example parameters for units, source, range, and educational placeholder status. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/parameter-review-guide.md

model native lesson
Native lesson / example

Plotting Script Review

Use this guide for checking that plotting scripts remain useful for explanation without hiding model logic. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/plotting-script-review.md

model native lesson
Native lesson / example

Reproducibility Checklist

Use this guide for checking whether another reviewer can run and understand the example from the repository alone. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/reproducibility-checklist.md

native lesson reproduction
Native lesson / example

Reproduction

Verified with MATLAB R2026a and Simulink. No additional toolbox is required.

examples/bess-unified-control/docs/reproduction.md

native lesson reproduction
Native lesson / example

Reviewer Runbook

Use this guide for giving reviewers a short path through example purpose, execution, and validation checks. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/reviewer-runbook.md

native lesson verification
Native lesson / example

Sample Data Quality Checklist

Use this guide for checking local sample data before it becomes part of an executable example. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/sample-data-quality-checklist.md

native lesson
Native lesson / example

Script Structure Review

Use this guide for keeping small example scripts readable, inspectable, and suitable for future checks. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/script-structure-review.md

native lesson
Native lesson / example

Small Model Extension Plan

Use this guide for planning small, reviewable example extensions without making starter models too large. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/small-model-extension-plan.md

model native lesson
Native lesson / example

Unified BESS Control Validation Report

All eight mandatory scenarios and all focused MATLAB/Simulink tests pass with

examples/bess-unified-control/validation/validation-report.md

native lesson verification
Native lesson / example

Unit Consistency Checklist

Use this guide for catching unit mismatches before example scripts are reused or automated. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/unit-consistency-checklist.md

native lesson
Native lesson / example

Validation Error Triage

Use this guide for separating expected-output drift, parameter errors, and environment problems during checks. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/validation-error-triage.md

model native lesson verification
Native reading

Validation Results

This page keeps the complete expected output for the repository regression

docs/validation-results.md

verification
Section 05: Scope / limitations

Scope / limitations

Native reading

A Reproducible Two-RC Battery Parameter-Identification Workflow in MATLAB

An equivalent-circuit model is useful when its assumptions, fitted parameters,

docs/two-rc-battery-parameter-identification.md

model reproduction scope
Native lesson / example

Assumptions To Tests Map

Use this guide for mapping example assumptions to the checks or outputs that should change if they are edited. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/assumptions-to-tests-map.md

native lesson scope verification
Native lesson / example

Converter Average Model Scaffold

This scaffold captures assumptions and signals for a simple averaged DC-DC converter example. It is intentionally small so the model intent can be reviewed before a detailed switching or Simulink implementation is added.

examples/converter-average-model/README.md

model native lesson scope
Native lesson / example

Educational Scaffold Guidance

Use this guide for separating teaching simplifications from project-ready engineering assumptions. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/educational-scaffold-guidance.md

native lesson scope
Native lesson / example

Example Quality Scorecard

Use this guide for scoring starter examples on clarity, runnability, assumptions, outputs, and validation readiness. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/example-quality-scorecard.md

native lesson scope verification
Native lesson / example

Limitations, Safety, and Qualification

This implementation is a transparent research translation and educational

examples/bess-unified-control/docs/limitations.md

native lesson scope
Native lesson / example

Project Assumptions

The identifiers in this register are stable. Numerical values live in the

examples/bess-unified-control/requirements/assumptions.md

native lesson scope
Native reading

Reduced-Order MATLAB and Simulink Models Versus Higher-Fidelity Workflows

MATLAB Simulink Energy Lab favors small, inspectable models whose assumptions,

docs/scope-comparison.md

model reproduction scope
Native lesson / example

Result Interpretation Notes

Use this guide for explaining how to interpret starter example outputs without overstating their scope. It is written for small MATLAB and Simulink examples that should remain easy to run, inspect, and validate.

examples/guides/result-interpretation-notes.md

native lesson scope verification