Return ensemble member data based on the member index
readMember is a function used in code generated by Diagnostic Feature
reads the workspace ensemble
data = readMember(
wensemble member identified by
index and returns member data in
readMember reads only variables that the
'SelectedVariables' property of
Code that is generated by Diagnostic Feature
under the following conditions:
The input data is an ensemble datastore, such as a file or simulation ensemble datastore.
The computation option during code generation specified storing results in local memory rather than writing results back to the ensemble datastore.
Explicitly specifying a member index when reading and writing within the
local version of the data, which the code manages using a
workspaceEnsemble object, ensures member synchronization with the original
ensemble datastore. This synchronization is necessary when you have sequential
member-processing loops, such as when you compute ensemble statistics as a precursor to
computing signal residues.
During the first member-processing loop, which starts with an empty ensemble, no indexing is needed. The code appends each new member result to the end of the ensemble.
During the second loop, the index enables the code to write updated member results to the correct location within the now-populated ensemble.
For more information about the dual processing loop for ensemble statistics, see Anatomy of App-Generated MATLAB Code.
wensemble — Ensemble object
Ensemble object, specified as a
wensemble contains ensemble
data and specifies the variable names and types within the ensemble, such as data
variables and condition variables.
index — Member index
Member index, specified as a positive integer.
the ensemble member to read new data from.
data — Member data
Member data that
readMember extracts, returned as a single-row
Introduced in R2020a