modelTableVoltage

Tabular voltage source of analog electrical library

Extends from Interfaces.OnePort (OnePort partial model of analog electrical library).

Information

The tabular voltage source is built in bondgraphic technology from a bond graph tableSe element, a 1-junction, and three bonds. A-causal bonds must be used except at the source, because the causality depends on the embedding of the voltage source in its environment.


Parameters:

 table:      Two-dimensional table with supporting values (default value = [0, 0; 1, 1; 2, 4])

 offset:     Offset of time function to be generated (default value = 0 Volt)

 startTime:  Start time of time function to be generated (default value = 0 sec)


The model generates a voltage source by linear interpolation in a table. The time points and voltage values are stored in a matrix table[i,j], where the first column table[:,1] contains the time points, and the second column contains the voltage to be interpolated. The table interpolation has the following proporties:

  • The time points need to be monotonically increasing.
  • Discontinuities are allowed, by providing the same time point twice in the table.
  • Values outside of the table range, are computed by extrapolation through the last or first two points of the table.
  • If the table has only one row, no interpolation is performed and the voltage value is just returned independantly of the actual time instant, i.e., this is a constant voltage source.
  • Via parameters startTime and offset the curve defined by the table can be shifted both in time and in the voltage.
  • The table is implemented in a numerically sound way by generating time events at interval boundaries, in order to not integrate over a discontinuous or not differentiable points.


Example:

   table = [0  0
            1  0
            1  1
            2  4
            3  9
            4 16]
If, e.g., time = 1.0, the voltage v =  0.0 (before event), 1.0 (after event)
    e.g., time = 1.5, the voltage v =  2.5,
    e.g., time = 2.0, the voltage v =  4.0,
    e.g., time = 5.0, the voltage v = 23.0 (i.e. extrapolation).

Parameters

TypeNameDefaultDescription
Real[:,:]table[0, 0; 1, 1; 2, 4]Table matrix (time = first column, voltage = second column)
Modelica.SIunits.Voltageoffset0Voltage offset
Modelica.SIunits.TimestartTime0Time offset

Connectors

TypeNameDefaultDescription
Modelica.Electrical.Analog.Interfaces.PositivePinp (from OnePort)Left electrical connector
Modelica.Electrical.Analog.Interfaces.NegativePinn (from OnePort)Right electrical connector

Components

TypeNameDefaultDescription
Modelica.SIunits.Voltagev (from OnePort)Voltage drop between the two pins
Modelica.SIunits.Currenti (from OnePort)Current flowing from pin p to pin n