Main Content

ee_comtradeDataset

Read and extract values from COMTRADE record

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

collapse all

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

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

Output Arguments

collapse all

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

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 extracted from the data file of the COMTRADE record, returned as a structure.

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

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

Introduced in R2020b