Lemonergy · Studio block

Delayed contactor with declared fault mode

Changes finite electrical resistance only after the modeled actuation delay, with separate command, actual closed feedback and declared stuck-open or welded faults.

Implementation ID: controlled-contactor
Reviewed: 2026-10-30

Behavior

Changes finite electrical resistance only after the modeled actuation delay, with separate command, actual closed feedback and declared stuck-open or welded faults.

Interface

Select a terminal or signal to inspect its meaning. This is a conceptual interface, not simulation output.

Ports and observed outputs
Name	Direction	Unit	Meaning
`p`	conserving	electrical	Positive voltage-reference terminal
`n`	conserving	electrical	Negative voltage-reference terminal
`h`	conserving	thermal	Contact dissipation delivered as heat
`Close or open command`	input	1	Close or open command is a directed dimensionless input to this component, expressed in 1. Its binding supplies information; it is not a conserving connection.
`voltage`	output	V	Directed output available to compatible consumers: voltage.
`current`	output	A	Directed output available to compatible consumers: current.
`power`	output	W	Directed output available to compatible consumers: power.
`closed`	output	fraction	Directed output available to compatible consumers: closed.

Signal inputs

These directed signals carry information. Conserving terminals exchange the quantities of their physical domain.

Signal outputs

Outputs can supply compatible inputs. Connections and values are inspected in the model that owns them.

Current authoring interface
Pin	Direction	Unit or domain	Meaning
Close or open command	input	1	Close or open command is a directed dimensionless input to this component, expressed in 1. Its binding supplies information; it is not a conserving connection.
voltage	output	V	Directed output available to compatible consumers: voltage.
current	output	A	Directed output available to compatible consumers: current.
power	output	W	Directed output available to compatible consumers: power.
closed	output	fraction	Directed output available to compatible consumers: closed.

Parameters

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

Configuration fields
Parameter	Unit	Default	Meaning and limits
onResistanceOhm `onResistanceOhm`	ohm	0.002	Declared authoring field: onResistanceOhm. Minimum 1e-06; Maximum 1000000
offResistanceOhm `offResistanceOhm`	ohm	1000000000	Declared authoring field: offResistanceOhm. Minimum 1; Maximum 1000000000000
closeDelayS `closeDelayS`	s	0.002	Declared authoring field: closeDelayS. Minimum 0; Maximum 10
openDelayS `openDelayS`	s	0.001	Declared authoring field: openDelayS. Minimum 0; Maximum 10
sampleTimeS `sampleTimeS`	s	0.001	Declared authoring field: sampleTimeS. Minimum 0.001; Maximum 1
initialClosed `initialClosed`	boolean	0	Declared authoring field: initialClosed. Minimum 0; Maximum 1
faultMode `faultMode`	0 normal; 1 stuck open; 2 welded	0	Declared authoring field: faultMode. Minimum 0; Maximum 2

Equations and rules

The behavior and configured interface above define this authoring component. This reference does not add numerical equations beyond its source contract.

Use in Studio

Use this authoring component

Choose this component in the Studio library and configure its declared interface. This reference describes the authoring contract; it does not claim a standalone numerical validation or a measured result.

Open Studio →

Use in a workflow

Connected concepts

Limits and interpretation

The symbolic diagram describes the component and its declared interface. It is not a solved circuit or simulated output.
Configured parameters and model connections determine the result. Check the complete model before interpreting its outputs.

Implementation sources

This reference follows Lemonergy implementation sources. Scientific articles support the linked concepts separately.

Repository: battery-design · Revision: 0a28f1a0a75a0447903b868cbcc734133a77a847

docs/glossary/studio-help-catalog.json

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

Current authoring interface provenance

The interactive graphic is exported from the same Studio help descriptor. Source base: 0a28f1a0a75a0447903b868cbcc734133a77a847. File content hashes in the public descriptor catalog identify the exact source snapshot. Existing numerical checks above retain their own verification scope.