Main Content

readFeatureTable

Read feature values, independent variables, and condition variables from an ensemble data set into a table

Description

readFeatureTable is a function used in code generated by Diagnostic Feature Designer.

ft = readFeatureTable(ensemble) extracts a feature table ft from ensemble ensemble for all features computed in full-signal mode. The feature table contains features, independent variables, and condition variables, and is the primary output of code generated by Diagnostic Feature Designer.

ft = readFeatureTable(ensemble,framepolid) uses the frame size and frame rate defined in FramePolicyID to read each frame interval when the function constructs the feature table. This syntax applies to frame-based—also known as segmented—signal and feature computation.

ft = readFeatureTable(___,Name,Value) specifies the features and variables to read using one or more name-value pair arguments. For instance, if you use ft = readFeatureTable(ensemble,'ConditionVariables','FaultCode'), ft contains only the 'FaultCode' condition variable but still includes all features and independent variables. You can use this syntax with any of the input argument combinations in previous syntaxes.

Input Arguments

collapse all

Ensemble of member data, specified as a fileEnsembleDatastore object, a simulationEnsembleDatastore object, or a workspaceEnsemble object.

Frame policy ID, specified as a string formatted as FRM_<frame policy index>. In code generated by Diagnostic Feature Designer, the frame policy reflects the choice of frame size and frame rate in segmented data.

Name-Value Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'ConditionVariables','FaultCode'

Features to read, specified as the comma-separated pair consisting of 'Features' and a string array of paths that point to the selected features. If you do not specify 'Features', the function reads all the features.

Independent variables to read, specified as the comma-separated pair consisting of 'IndependentVariables' and a string array of paths that point to the selected variables. If you do not specify 'IndependentVariables', the function reads all the independent variables.

Condition variables to read, specified as the comma-separated pair consisting of 'ConditionVariables' and a string array of paths that point to the selected variables. If you do not specify 'ConditionVariables', the function reads all the condition variables.

Option to return ensemble member IDs, specified as the comma-separated pair consisting of 'IncludeMemberID' and a logical scalar. When you set 'IncludeMemberID' to true, the feature table ft includes a column of member IDs.

Output Arguments

collapse all

Feature table, specified as a table. The table contains features, independent variables, and condition variables for each member. The features and condition variables are scalars. The independent variables are timetables, tables, or cell arrays.

Introduced in R2020a