The value of a basic circuit element (resistor, capacitor, or inductor).

Syntax


Property RLCValue ( _
       ByVal componentName As String) _
       As Double

Parameters

componentName—The name (RefDes) of the RLC element to get/set.

Remarks

This read/write property allows the user to get/set the value of an RLC circuit element. Only basic components are supported, not rated components, advanced inductors, etc.

  To modify other types of components, they must be replaced using ReplaceComponent.

  Use circuit parameters for component properties and change the value using CircuitParameterValue.

If the component does not exist in the circuit, an error occurs. The value returned is in ohms, farads, and henrys, for resistors, capacitors and inductors, respectively. No prefixes are used.

If a circuit parameter contains an expression, it will be evaluated first. For example if x=1, x+1 will return 2, not “x+1”. If an error occurs, 0 will be returned.

Attempting to change component values while a simulation is running causes an error. The simulator must be in the stopped state.

Example


' Change the value of the resistor R1 to 550 ohms
Circuit.RLCValue("R1") = 550


' Retrieve the value of the capacitor C2 and store it in capValue
Dim capValue As Double
capValue = RLCValue("C2")

See Also

EnumComponents

ReplaceComponent