ee_getPowerLossTimeSeries
Calculate dissipated power losses and return time series data
Syntax
Description
lossesCell = ee_getPowerLossTimeSeries(node)
Before you call this function, you must have the simulation log variable in your current workspace. Create the simulation log variable by simulating the model with data logging turned on, or load a previously saved variable from a file.
The ee_getPowerLossTimeSeries function calculates dissipated power
losses for each block that has a power_dissipated variable. All blocks in
the Semiconductor Devices library, as well as some other blocks, have an internal variable
called power_dissipated, which represents the instantaneous power
dissipated by the block. Some blocks have more than one power_dissipated
variable, depending on their configuration. For example, the N-Channel MOSFET
block has separate power_dissipated logging nodes for the MOSFET, the
gate resistor, and for the source and drain resistors if they have nonzero resistance
values. The function sums all these losses and provides the power loss value for all of the
blocks as functions of time.
Note
The power_dissipated internal variable does not report dynamic
losses incurred from semiconductor switching or magnetic hysteresis.
If node is the name of the simulation log variable, then the table
contains the data for all the blocks in the model that dissipate power (that is, contain at
least one power_dissipated variable). If node is the
name of a node in the simulation data tree, then the table contains the data only for the
blocks within that node.
lossesCell = ee_getPowerLossTimeSeries(node,startTime,endTime)startTime to endTime. If
startTime is equal to endTime, the interval is
effectively zero and the function returns the instantaneous power for the time step that
occurs at that moment. If you omit these two input arguments, the function returns data over
the whole simulation time.
lossesCell = ee_getPowerLossTimeSeries(node,startTime,...
endTime,intervalWidth)startTime to endTime, averaged over the time
intervalWidth. If you omit the intervalWidth, or
set it to 0, the function returns the instantaneous data, without averaging. If you omit all
three optional arguments, the function returns the instantaneous data over the whole
simulation time.
Examples
Calculate Dissipated Power Losses for the Entire Simulation Time
This example shows how to calculate instantaneous losses based on the power dissipated and return the time series data for all time steps in the entire simulation time using the ee_getPowerLossTimeSeries function.
Open the model. At the MATLAB® command prompt, enter:
model = 'ee_solar_inverter';
open_system(model)
This example model has data logging enabled. Run the simulation and create the simulation log variable.
sim(model)
The simulation log variable simlog_ee_solar_inverter is saved in your current workspace.
Calculate dissipated power losses and return the time series data in cell array.
lossesCell = ee_getPowerLossTimeSeries(simlog_ee_solar_inverter)
lossesCell =
8×2 cell array
{'ee_solar_inverter.Diode1'} {77180×3 double}
{'ee_solar_inverter.MOS1' } {77180×3 double}
{'ee_solar_inverter.MOS2' } {77180×3 double}
{'ee_solar_inverter.MOS3' } {77180×3 double}
{'ee_solar_inverter.MOS4' } {77180×3 double}
{'ee_solar_inverter.Diode2'} {77180×3 double}
{'ee_solar_inverter.Diode3'} {77180×3 double}
{'ee_solar_inverter.Diode4'} {77180×3 double}
View the time series data. From the workspace, open the lossesCell cell array, then open the 77180x3 double numeric array for the ee_solar_inverter.Diode1.
The first two columns contain the interval start and end time. The third column contains the power loss data.
Plot the data.
plot(lossesCell{1, 2}(:,end))
title('Dissipated Power')
xlabel('Time Interval')
ylabel('Power (W)')
Calculate Dissipated Power Losses for a Specific Time Period
This example shows how to calculate instantaneous losses based on the power dissipated and return the time series data for all time steps in a specific time period using the ee_getPowerLossTimeSeries function.
Open the model. At the MATLAB® command prompt, enter:
model = 'ee_solar_inverter';
open_system(model)
This example model has data logging enabled. Run the simulation and create the simulation log variable.
sim(model)
The simulation log variable simlog_ee_solar_inverter is saved in your current workspace.
The model simulation time (t) is 1/60 seconds. Calculate dissipated power losses and return the time series data in cell array for the second half of the simulation cycle, when t is between 1/120 and 1/60 seconds.
lossesCell = ee_getPowerLossTimeSeries(simlog_ee_solar_inverter,1/120,1/60)
lossesCell =
8×2 cell array
{'ee_solar_inverter.Diode1'} {39150×3 double}
{'ee_solar_inverter.MOS1' } {39150×3 double}
{'ee_solar_inverter.MOS2' } {39150×3 double}
{'ee_solar_inverter.MOS3' } {39150×3 double}
{'ee_solar_inverter.MOS4' } {39150×3 double}
{'ee_solar_inverter.Diode2'} {39150×3 double}
{'ee_solar_inverter.Diode3'} {39150×3 double}
{'ee_solar_inverter.Diode4'} {39150×3 double}
View the time series data. From the workspace, open the lossesCell cell array, then open the 39150x3 double numeric array for the ee_solar_inverter.Diode1.
The first two columns contain the interval start and end time. The third column contains the power loss data.
Plot the data.
plot(lossesCell{1, 2}(:,end))
title('Dissipated Power')
xlabel('Time Interval')
ylabel('Power (W)')
Calculate Dissipated Power Losses Using Specific Interval Widths
This example shows how to calculate losses based on the power dissipated and return the time series data for a specific time period with averaging applied over intervals of a specified width.
Open the model. At the MATLAB® command prompt, enter:
model = 'ee_solar_inverter';
open_system(model)
This example model has data logging enabled. Run the simulation and create the simulation log variable.
sim(model)
The simulation log variable simlog_ee_solar_converter is saved in your current workspace.
The model simulation time (t) is 1/60 seconds. Calculate the average dissipated power losses for 1.1e-4 s intervals and return the time series data in cell array for the period when simulation time, t, is 0.008-0.017 seconds.
lossesCell = ee_getPowerLossTimeSeries(simlog_ee_solar_inverter,0.008,0.016,1.1e-4)
lossesCell =
8×2 cell array
{'ee_solar_inverter.Diode1'} {72×3 double}
{'ee_solar_inverter.MOS1' } {72×3 double}
{'ee_solar_inverter.MOS2' } {72×3 double}
{'ee_solar_inverter.MOS3' } {72×3 double}
{'ee_solar_inverter.MOS4' } {72×3 double}
{'ee_solar_inverter.Diode2'} {72×3 double}
{'ee_solar_inverter.Diode3'} {72×3 double}
{'ee_solar_inverter.Diode4'} {72×3 double}
View the time series data. From the workspace, open the lossesCell cell array, then open the 72x3 double numeric array for the ee_solar_inverter.Diode1
The first two columns contain the interval start and end time. The third column contains the power loss data. In this case, to use averaging intervals that are equal in width to 1.1e-4 seconds, the function adjusts the start time for the first interval from the specified value of 0.008 seconds to a value of 0.0081 seconds. There are 72 intervals of 1.1e-4 seconds.
Plot the data.
plot(lossesCell{1, 2}(:,end))
title('Dissipated Power')
xlabel('Time Interval')
ylabel('Power (W)')
Input Arguments
node — Simulation log variable, or a specific node within the simulation log variable
Node object
Simulation log workspace variable, or a node within this variable,
that contains the logged model simulation data, specified as a Node object.
You specify the name of the simulation log variable by using the Workspace
variable name parameter on the Simscape pane
of the Configuration Parameters dialog box. To specify a node within
the simulation log variable, provide the complete path to that node
through the simulation data tree, starting with the top-level variable
name.
If node is the name of the simulation log
variable, then the table contains the data for all blocks in the model
that contain power_dissipated variables. If node is
the name of a node in the simulation data tree, then the table contains
the data only for:
Blocks or variables within that node
Blocks or variables within subnodes at all levels of the hierarchy beneath that node
Example: simlog.Cell1.MOS1
startTime — Start of the time interval for calculating the data
0 (default) | real number
Start of the time interval for calculating the power loss time
series, specified as a real number, in seconds. startTime must
be greater than or equal to the simulation Start time and
less than endTime.
Data Types: double
endTime — End of the time interval for calculating the data
simulation stop time (default) | real number
End of the time interval for calculating the power loss time
series, specified as a real number, in seconds. endTime must
be greater than startTime and less than or equal
to the simulation Stop time.
Data Types: double
intervalWidth — Size of the time interval for calculating the average power dissipation
0 (default) | real number
Size of the time interval for calculating the average power
dissipation, specified as a real number, in seconds. If specified,
the function returns data for time steps from startTime to endTime,
averaged over the intervalWidth. If you omit the intervalWidth argument,
or set it to 0, the function returns the instantaneous data, without
averaging. If all the optional arguments are omitted, the function
returns the instantaneous data over the whole simulation time.
If the time between the specified startTime and endTime is
not an integer multiple of intervalWidth, the
function adjusts the start time. The figure shows how the function
adjusts the start time to ensure that width of each time interval
that the dissipated power is averaged over is equal to the specified intervalWidth.
The black line is an example of the instantaneous power_dissipated variables
summed over all elements in an individual block. The simulation runs
for 6 seconds. The startTime and endTime are
indicated by the solid blue lines. The intervalWidth is
set to 1 second. There are five intervals as indicated by the red
dashed lines. The right-most edge of the last interval coincides with endTime.
The left-most edge of the first interval is always greater than or
equal to startTime. The edge is equal to startTime only
if (endTime -startTime)/intervalWidth is
an integer. The output in this case consists of five values for the
averaged power dissipation, one point for each time period. The function
outputs the actual start and stop times in the tabulated output data.
Example: 1.1e-3
Data Types: double