Write-only

About Exporting Data

Description

Export data by specifying parameters with this method.

You can also specify parameters using separate commands. Learn how.

 VB Syntax

doc.ExportTimeDomainTextFile (fileName, delimiterType, dataFormat, portNmbr, portMap, diffPortMap, dutCfgDesc, dataToExport, paramList, ExportInOneFile, timeUnit, dataRange, startTimeNs, stopTimeNs, stepTimeNs

Variable

(Type) - Description

doc

(object) - A PLTSDoc object

fileName

(String) Full path, file name, and suffix of exported file.

delimiterType

(Integer) Choose the type of text file to export.

0 - Tab

1 - Comma

dataFormat

(Integer)(Enum as pltsFreqDomainTextFileDataFormat) Data format. Choose from:

0 - StepReal

1 - ImpulseReal

2 - StepVolts

3 - ImpulseVolts

4 - StepLog

5 - ImpulseLog

6 - StepImpedance

Learn more about time domain format.

portNmbr

(Integer) - Number of DUT ports for which data will be exported. Learn more.

 -1 specifies the port number of the original data.

portMap

(String) Mapping of ports to export. Learn more

" " specifies the original port mapping.

diffPortMap

(String) Mapping of ports to export. Learn more

" " specifies the original port mapping.

dutCfgDesc

(String) Description of the DUT configuration after export. Learn more.

Use " " to use the current DUT configuration.

dataToExport

(Enum as pltsTextFileDataToExport) Parameter data to export. Choose from:

0 - SE (all single-ended parameters)

1 - Balanced (all balanced parameters)

2 - All (all single-ended and balanced parameters)

3 - Customized (parameters selected using the following paramList argument.

paramList

(String) List of parameter to export separated by commas. Use " " when the previous argument is NOT Customized. Learn more.

ExportInOneFile

(Boolean) Export all data in one file or to separate files. Choose from:

0- False  All selected parameters are saved to separate files. Each file is saved to the specified folder with the filename you entered and a parameter label appended to the name. For example, if you entered device4 as the file name, the S11 parameter file is named: device4_S11.txt.

1 - True  All selected parameters are saved to one file.

timeUnit

(Enum as pltsTimeUnits) Units to use when exporting time domain data. Choose from:

0 - Ns (Nano seconds)

1 - Cm (centimeters)

dataRange

(Integer) The data range to export. Choose from:

0 - RangeAll - Export the entire data range in PLTS memory.

1 - Subset  The data range is specified with the following arguments: startTime, stopTime, steptime

startTimeNs

(Double)  Start time to export when Subset of data is selected.

stopTimeNs

(Double)  Stop time to export when Subset of data is selected.

stepTimeNs

(Double)  Step time (number of points) to export when Subset of data is selected.

Return Type

None

Default

None

Examples

doc.ExportTimeDomainTextFile "C:/PLTS/MyDut.dut", 0,1,-1," "," ","MyExportedData",3,"S11,S22",0,1,1,1,1.5,2.5,.1

C++ Syntax

HRESULT ExportTimeDomainTextFile(BSTR fileName, SHORT delimiterType, SHORT dataFormat, SHORT portNmbr, BSTR portMap, BSTR diffPortMap, BSTR dutCfgDesc, SHORT dataToExport, BSTR paramList, VARIANT_BOOL exportInOneFile, SHORT timeUnit, SHORT dataRange, DOUBLE startTimeNs, DOUBLE stopTimeNs, DOUBLE stepTimeNs);

Interface

IPLTSDocument