ee_comtradeDataset

Read and extract values from COMTRADE record

Since R2020b

Syntax

dataset = ee_comtradeDataset(comtradeRecordName)

dataset = ee_comtradeDataset(comtradeRecordName,'HeaderFileType',filetype)

Description

dataset = ee_comtradeDataset(comtradeRecordName) reads the comtradeRecordName COMTRADE record and outputs a dataset structure with the configuration, header, data, and information properties.

To export the data channel signals to a format compatible with the Simulink Signal Editor block, use the exportMATFile method to create a myComtradeRecordName.mat file:

exportMATFile(dataset);

dataset = ee_comtradeDataset(comtradeRecordName,'HeaderFileType',filetype) reads the header file of the comtradeRecordName COMTRADE record as a file of the extension specified by filetype, and outputs a dataset structure with configuration, header, data, and information properties.

Input Arguments

comtradeRecordName — Name of COMTRADE record

case-sensitive string

File name of the COMTRADE record that you want to read and extract values from, specified as a case-sensitive string without the file extension. Configuration and data files are mandatory for each COMTRADE record. Header and information files are optional. All files must have the same name and different extensions.

These are the accepted extensions for the COMTRADE records:

• .cfg for configuration files

• .dat for data files

• .hdr for header files

• .inf for information files

filetype — Type of header file in COMTRADE record

text | xml

Type of the header file in the COMTRADE record input, specified as 'text' or 'xml'.

Output Arguments

dataset — Extracted values from COMTRADE record

structure

Extracted values from the COMTRADE record, returned as a structure with these fields:

Configuration — COMTRADE configuration

structure

Data extracted from the configuration file of the COMTRADE record, returned as a structure. This data is necessary to interpret the information contained in the data file.

Data — COMTRADE data

structure

Data extracted from the data file of the COMTRADE record, returned as a structure.

Header — COMTRADE header

structure

Data extracted from the header file of the COMTRADE record, returned as a structure.

Information — COMTRADE information

structure

Data extracted from the information file of the COMTRADE record, returned as a structure.

Version History

Introduced in R2020b