Manage ensemble data in custom file format
A fileEnsembleDatastore
object is a datastore specialized
for use in developing algorithms for condition monitoring and predictive maintenance
using measured data.
An ensemble is a collection of member data stored in a collection of files. The
fileEnsembleDatastore
object specifies the data variables,
independent variables, and condition variables in the ensemble. You provide functions
that tell the fileEnsembleDatastore
object how to read each type of
variable from the collection of files. Therefore, you can use
fileEnsembleDatastore
to manage ensemble data stored in any file
format or configuration of variables.
The data for a fileEnsembleDatastore
object can be stored at any
location supported by MATLAB® datastores, including remote locations, such as cloud storage using
Amazon S3™ (Simple Storage Service), Windows Azure® Blob Storage, and Hadoop® Distributed File System (HDFS™).
For a detailed example illustrating the use of a file ensemble datastore, see File Ensemble Datastore With Measured Data. For general information about data ensembles in Predictive Maintenance Toolbox™, see Data Ensembles for Condition Monitoring and Predictive Maintenance.
creates a fensemble
= fileEnsembleDatastore(location
,extension
)fileEnsembleDatastore
object that points to data at
the file path specified by location
and having the
specified file extension. Set properties of the object to specify the functions
for reading from and writing to the ensemble datastore.
specifies additional properties of the object using one or more name-value pair
arguments. For example, using
fensemble
= fileEnsembleDatastore(location
,extension
,Name,Value)'ConditionVariables',["FaultCond";"ID"]
specifies the
condition variables when you create the object.
The read
and writeToLastMemberRead
functions
are specialized for Predictive Maintenance Toolbox ensemble data. Other functions, such as reset
and
hasdata
, are identical to those used with
datastore
objects in MATLAB. To transfer all the member data into a table or cell array with a single
command, use readall
. To partition an ensemble
datastore, use the partition(ds,n,index)
syntax of the
partition
function.
read | Read member data from an ensemble datastore |
writeToLastMemberRead | Write data to member of an ensemble datastore |
reset | Reset datastore to initial state |
hasdata | Determine if data is available to read |
progress | Determine how much data has been read |
readall | Read all data in datastore |
numpartitions | Number of datastore partitions |
partition | Partition a datastore |
tall | Create tall array |
isPartitionable | Determine whether datastore is partitionable |
isShuffleable | Determine whether datastore is shuffleable |