Keysight Pathwave 89600 VSA .NET API
RecallFile(String,String,String) Method
See Also 
Agilent.SA.Vsa.Interfaces Assembly > Agilent.SA.Vsa Namespace > Recording Class > RecallFile Method : RecallFile(String,String,String) Method


fileName
Specifies the file name.
format
Specifies the file format.
measurementName
Specifies the name of the measurement for this recording.

Glossary Item Box

Recall the recording for the specified measurement in the specified format from a file.

Syntax

Visual Basic (Declaration) 
Public Overloads Overridable Sub RecallFile( _
   ByVal fileName As String, _
   ByVal format As String, _
   ByVal measurementName As String _
) 
C# 
public virtual void RecallFile( 
   string fileName,
   string format,
   string measurementName
)
C++/CLI 
public:
virtual void RecallFile( 
   String^ fileName,
   String^ format,
   String^ measurementName
) 

Parameters

fileName
Specifies the file name.
format
Specifies the file format.
measurementName
Specifies the name of the measurement for this recording.

Remarks

The recording for the specified measurement, in SDF format, is overwritten. The measurementIndex must be 0 or greater and may specify a measurement that does not yet exist. When the specified measurement is created, it will use the data from this recalled recording.

Supported File Formats:

format Description
"CSV" CSV (Comma delimited) [*.csv]
"E3238S" E3238S Time Snapshot [*.cap]
"MAT" MAT-File [*.mat]
"MAT7" MAT-File (HDF5) [*.mat, *.hdf, *.h5]
"BINF" BINF (Little Endian Real32 Binary) [*.binf]
"N5110A" N5110A Waveform [*.bin]
"N5106A" N5106A Waveform [*.bin]
"SDF" SDF (Fast) [*.sdf, *.dat]
"TEXT" Text (Tab delimited) [*.txt]
"VITA49" VITA 49 [*.vita49]

Note:
MAT may be used instead of MAT7 for recall trace/recording (the matlab file format is auto detected for recall).

If the format is an empty string, then the application automatically determines the file format by looking at the file suffix.
If this is not sufficient, then the file is scanned to determine the format.
If the format cannot be determined or you specified an unknown format, then an error is raised.

VITA49 is only supported since release 2023 Update 2.0 (assembly version 27.40).

For more information about file types, see the "Supported File Formats" topic in the application help.

Requirements

Target Platforms: Windows 11 Professional or Enterprise; Windows 10 Professional, Enterprise, or Education (64-bit)

See Also