Lemonergy · Studio block

Bus selector

Selects one declared field or nested field from a named bus.

Implementation ID
bus-select
Reviewed
2026-10-27

Behavior

A dotted field path selects the original typed value; missing fields are rejected before simulation.

Interface

Bus selector interfaceInputs or arguments on the left, observed outputs on the right. Conserving terminals appear below the component. The tables give units and behavior.Bus selectorStudio blockbussoc
Original Lemonergy interface view. Lines identify ports; they are not a completed simulation circuit.
Ports and observed outputs
NameDirectionUnitMeaning
businput1pack; named bus with declared typed fields.
socoutputfractionsoc; real signal.

Parameters

Defaults are initial model values. Select values for your own model and operating conditions.

Configuration fields
ParameterUnitDefaultMeaning and limits
Bus declaration
bus
1packExplicit bus used by this worked model.
Selected field path
field
1state.socExplicit field used by this worked model.

Equations and rules

  • y = bus[configured field path]

Worked example

Update nested battery telemetry

Initial-SOC = 0.5; Updated-SOC = 0.6; Cell-voltage = 3.7. Before at 1 s = 0.5; After at 1 s = 0.6.

Open Studio example after release →
Numerical checks for the bundled synthetic example
OutputTime (s)Expected valueUnitAbsolute tolerance
Before
Before
10.5fraction1e-09
After
After
10.6fraction1e-09

Use in a workflow

Update nested battery telemetry

Selects one declared field or nested field from a named bus.

  1. Bus selector: A dotted field path selects the original typed value; missing fields are rejected before simulation.
    • Use the block reference for settings and connections.
    • Implementation tested locally; public release pending.
Open Studio example after release

Connected concepts

Limits and interpretation

  • Paths must exist in the declared bus version; dynamic field names are not supported.

Reference basis

This software operation is defined by its public contract and worked example; no external research result is claimed.

Implementation sources

This reference follows the public interface and locally verified numerical checks for an upcoming release.

Contract: Lemonergy Studio public contract · Verification record: verification-2026-10-27

  • docs/glossary/native-block-verification.json

This implementation and its workflow uses (JSON) · Knowledge graph (JSON-LD)