.measure/.meas : LTspice -- Evaluate User-Defined Electrical Quantities

This article details the use of the dot command ".measure(.meas)".

By using ".measure", you can measure voltage and current values more easily than using the cursor function of a waveform viewer.

TOC

What is ".measure"?

".measure" is a dot command that automatically measures voltage and current values during simulation.

First, let's try to simulate using ".measure" with the schematic created in the following article.

The schematic can be downloaded from the link below.

1
LTspice XVII .measure

Open the schematic "01_sample-tran-lt1028.asc" and enter the following the ".measure" syntax in "SPICE Directive".

.measure TRAN A MAX V(OUTPUT)

This syntax means to measure the maximum voltage of V(OUTPUT) with the label "A".

Both ".measure" and ".means" have the same meaning.

2
LTspice XVII .measure simulation run

After placing the ".measure" syntax, click "Run" to run the simulation.

3
LTspice XVII SPICE error log

Select "View-SPICE Error Log" to open the log file.

4
LTspice XVII SPICE error log .measure

If you open the log file, you will see the following description.

a: MAX(v(output))=3.99891 FROM 0 TO 0.01

Thus, by using the dot command ".measure", voltage and current values can be easily calculated as numerical values.

This command is more convenient and reliable than using the cursor in a waveform viewer to calculate.

The schematic used for the ".measure" simulation can be downloaded from the following link.

".measure" syntax

The usage of the ".measure" syntax is classified into "specify the Measurement Range on the Time Axis (X-Axis)" and "specify the Measurement Point on the Time Axis (X-Axis)" as follows.

Specify the Measurement Range on the Time Axis (X-Axis)

LTspice XVII .measure time axis measurement range
LTspice XVII .measure time axis measurement range

Specify the Measurement Point on the Time Axis (X-Axis)

LTspice XVII .measure time axis measurement point
LTspice XVII .measure time axis measurement point

Common Settings

This section describes common settings in the ".measure" syntax.

Analysis Type

Analysis TypeExplanation
TRANTransient Analysis
ACAC Analysis
DCDC Sweep Analysis
NOISENoise Analysis
TFDC Transfer Function Analysis
OPDC Operating Point Analysis

Describes the analysis type in the simulation. For example, if the simulation in section "What is ".measure"?" was ".tran 10m", you would write "TRAN".

Label

Specify any alphanumeric character. In the simulation in section "What is ".measure"?", the label "A" was specified, so "a" appears at the beginning of the sentence, as shown in the log file below.
(Even if the label is written in uppercase, it will be in lowercase.)

LTspice XVII .measure label

Therefore, if you are measuring the maximum voltage with the ".measure" syntax, you should specify the alphanumeric characters of the label for your own clarity, such as "v-max" for the label.

Node Name & Part No.

Node Name & Part No.Explanation
V(NodeName)"Voltage" to be measured
I(PartNumber)"Current" to be measured

Specify the voltage or current to be measured with the ".measure" syntax. For voltage, specify the node number; for current, specify the part number.

Specify the Measurement Range on the Time Axis (X-Axis)

This section describes how to "specify the measurement range on the time axis (x-axis)" in the ".measure" syntax.

Measurement Item

Measurement ItemExplanation
AVEaverage value
MAXmaximum value
MINminimum value
PPPeak-to-Peak
RMSRoot-Mean-Square Value(Effective Value)
INTEGIntegral Value

As shown above, it is possible to measure average, maximum, minimum, PP, RMS, and integral values.

Measurement Range

The measurement range is described by "FROM value TO value". For example, if the measurement range is from 0msec to 5msec in the simulation results, it would be as follows.

FROM 0 TO 5m

If "FROM value TO value" is not described, all times are in the measurement range.

TRIG: Equation for increase/TARG: Equation for decrease

"TRIG: Equation for increase/TARG: Equation for decrease" is a rather complex setup, so we plan to explain how to create the syntax using the ".means Statement Editor" in the section "examples of ".measure" simulation".

Specify the Measurement Point on the Time Axis (X-Axis)

This section describes how to "specify the measurement point on the time axis (x-axis)" in the ".measure" syntax.

Measurement Item

Measurement ItemExplanation
FINDInstantaneous Value
DERIVDifferential Value
PARAMNumerical Calculation

As shown above, it is possible to measure instantaneous and differential values. It is also possible to perform numerical calculation in PARAM.

Measurement Point

The measurement point is described by "AT value". For example, if the measurement point is at 5msec in the simulation results, it would be as follows.

AT 5m

WHEN: Equation

"WHEN: Equation" is a rather complex setup, so we plan to explain how to create the syntax using the ".means Statement Editor" in the section "examples of ".measure" simulation".

Examples of ".measure" simulation

It may be difficult to understand the ".measure" syntax with just a description, so we will actually simulate ".measure" as some examples.

Specify the Measurement Range on the Time Axis (X-Axis)

1
LTspice XVII .measure time axis measurement range measure

Open the schematic "01_sample-tran-lt1028.asc" and enter the following ".measure" in "SPICE Directive".

.meas TRAN V-ave AVE V(OUTPUT)
.meas TRAN V-max MAX V(OUTPUT)
.meas TRAN V-min MIN V(OUTPUT)
.meas TRAN V-pp PP V(OUTPUT)
.meas TRAN V-rms RMS V(OUTPUT)
.meas TRAN V-integ INTEG V(OUTPUT) FROM 1 TO 2m

After placing the ".measure" syntax, click "Run" to run the simulation.

2

The results of the simulation and the ".measure" syntax are as follows.

LTspice XVII .measure time axis measurement range voltage waveform
LTspice XVII .measure time axis measurement range log
v-ave=0.01 FROM 0 TO 0.01
v-max: MAX(v(output))=3.99891 FROM 0 TO 0.01
v-min: MIN(v(output))=-3.99408 FROM 0 TO 0.01
v-pp: PP(v(output))=7.99298 FROM 0 TO 0.01
v-rms: RMS(v(output))=2.8276 FROM 0 TO 0.01
v-integ: INTEG(v(output))=0.00254599 FROM 0.001 TO 0.002

If you compare the results with the waveform graph in the waveform viewer, you can see that the results are almost identical.

The schematic used for the ".measure" simulation can be downloaded from the following link.

Specify the Measurement Point on the Time Axis (X-Axis)

1

Open the schematic "01_sample-tran-lt1028.asc" and enter the following ".measure" in "SPICE Directive".

LTspice XVII .measure time axis measurement point measure
.meas TRAN V-find FIND V(OUTPUT) AT 1.5m

After placing the ".measure" syntax, click "Run" to run the simulation.

2

The results of the simulation and the ".measure" syntax are as follows

LTspice XVII .measure time axis measurement point voltage waveform
LTspice XVII .measure time axis measurement point log
v-find: v(output)=3.99363 at 0.0015

If you compare the results with the waveform graph in the waveform viewer, you can see that the results are almost identical.

The schematic used for the ".measure" simulation can be downloaded from the following link.

Let's share this post !
TOC