SCPI.CALCulate(Ch).SELected.DATA.MFData

Object type

Property (Read-Only)

Syntax

Data = SCPI.CALCulate(Ch).TRACe.DATA.MFData(param)

OR

Data = SCPI.CALCulate(Ch).SELected.DATA.MFData(param)

Description

This command gets the formatted data array of multiple traces (traces-n, m, .... to l) of the selected channel (Ch). This command is supported in revision A.11.20 and above.

SCPI.CALCulate(Ch).SELected.DATA.FDATa returns only one trace. On the other hand, this command allows you to get several trace data with one command.


The array data element varies in the data format (specified with the SCPI.CALCulate(Ch).SELected.FORMat object). For more information on the formatted data array, see Internal Data Processing.

The maximum number of trace you can specify is up to the maximum number of trace.

"Out of Memory" error occurs when the total number of data exceeds the limitation. When this error occurs, reduce the number of specified trace number and divide into two commands.

“Data out of range” error occurs when the specified trace number exceeds the maximum trace number.

“Illegal parameter value” error occurs when the number of specified traces exceeds the maximum trace number. For example, ("1,1,2") is specified where maximum trace number is 2.

Variable

Parameter

Param

Description

Trace Number

Data type

Character string type (String)

Range

"n, m, l, ..."
where n, m, l are 1 to the maximum trace number.

Note

Use comma for separator of trace number.

 

Parameter

Data

Description

Indicates the array data (formatted data array) of NOP (number of measurement points)×2×(number of specified traces). Where n is an integer between 1 and NOP.

  • Data(n×2-2) :Data (primary value) at the n-th measurement point.

  • Data(n×2-1) :Data (secondary value) at the n-th measurement point. Always 0 when the data format is not the Smith chart format or the polar format.

The output trace data is listed according to the order of the specified trace number.

The index of the array starts from 0.

Data type

Variant type (Variant)

Note

If there is no array data of NOP (number of measurement point)×2 when setting a formatted data array, an error occurs when executed and the object is ignored.

Examples

Dim MFData As Variant
SCPI.CALCulate(1).PARameter.COUNt = 4
SCPI.SENSe(1).SWEep.POINts = 201
MFData = SCPI.CALCulate(1).SELected.DATA.MFData("1,2,3,4")

' You can place the order randomly. The query follows the specified order. In this case Trace 1, 4 then Trace 3 is returned.
MFData = SCPI.CALCulate(1).SELected.DATA.MFData("1,4,3")

' You can place the same trace number as long as it does not exceed the number of traces. The query follows the specified order. In this case Trace 1, 1 then Trace 3 is returned.
MFData = SCPI.CALCulate(1).SELected.DATA.MFData("1,1,3")

Related objects

SCPI.CALCulate(Ch).SELected.DATA.SDATa

SCPI.CALCulate(Ch).SELected.DATA.FDATa

SCPI.CALCulate(Ch).SELected.DATA.MSData

Equivalent key

No equivalent key is available on the front panel.

Equivalent SCPI command

Syntax

:CALCulate{[1]-160}:SELected:DATA:MFData? <string ("n, m, l...")>
:CALCulate{[1]-160}:TRACe:DATA:MFData? <string ("n, m, l...")>

Query response

{numeric 1},… ,{numeric NOP×2×(number of specified traces)}<newline><^END>

Example of use

10 DIM A(1:401,1:2,1:6)
20 OUTPUT 717;":CALC1:DATA:MFD? ""1,2,3,4,5,6"""
30 ENTER 717;A(*)