fixed.DataGenerator

Creates value set and generates data

Description

Use the fixed.DataSpecification and fixed.DataGenerator objects to generate simulation inputs to test the full operating range of your designs.

Creation

Syntax

data = fixed.DataGenerator(Name, Value)

Description

data = fixed.DataGenerator(Name, Value) creates a DataGenerator object with additional properties specified as Name, Value pair arguments.

Properties

DataSpecifications — Properties of generated data

fixed.DataSpecification object | cell array of fixed.DataSpecification objects

Properties of the data to generate, specified as a fixed.DataSpecification object.

Specifying a cell array of DataSpecification objects produces a single DataGenerator object for input to a system with the same number of inputs and in the same order as elements in the cell array.

NumDataPointsLimit — Maximum number of data points in generated data

100000 (default) | integer-valued scalar

Maximum number of data points in generated data, specified as an integer-valued scalar. For more information, see getNumDataPointsInfo.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Object Functions

getUniqueValues	Get unique values from fixed.DataGenerator object
getNumDataPointsInfo	Get information about number of data points in generated data
outputAllData	Get data from fixed.DataGenerator object

Examples

Create a fixed.DataGenerator object

Create a DataGenerator object by specifying a DataSpecification object in the constructor.

Create the DataSpecification object with an interval from $$-2\pi$$ to $$2\pi$$ with a data type of single.

dataspec = fixed.DataSpecification('single', 'Intervals', {-2*pi, 2*pi})

dataspec = 
  fixed.DataSpecification with properties:

          DataTypeStr: 'single'
            Intervals: [-6.2832,6.2832]
     ExcludeDenormals: false
  ExcludeNegativeZero: false
      MandatoryValues: <empty>
           Complexity: 'real'
           Dimensions: 1

Use the DataSpecification object to create a DataGenerator object. Limit the number of data points in the generated data to 5000 points. You can specify these properties as name-value pairs in the constructor of the DataGenerator object.

datagen = fixed.DataGenerator('DataSpecifications', dataspec, 'NumDataPointsLimit', 5000)

datagen = 
  fixed.DataGenerator with properties:

    DataSpecifications: {[1x1 fixed.DataSpecification]}
    NumDataPointsLimit: 5000

Use the outputAllData function to see the generated data.

myData = outputAllData(datagen)

myData = 1x262 single row vector

   -6.2832   -6.2832   -4.0000   -4.0000   -4.0000   -2.0000   -2.0000   -2.0000   -1.0000   -1.0000   -1.0000   -0.5000   -0.5000   -0.5000   -0.2500   -0.2500   -0.2500   -0.1250   -0.1250   -0.1250   -0.0625   -0.0625   -0.0625   -0.0313   -0.0312   -0.0156   -0.0078   -0.0078   -0.0078   -0.0039   -0.0039   -0.0039   -0.0020   -0.0020   -0.0001   -0.0000   -0.0000   -0.0000   -0.0000   -0.0000   -0.0000   -0.0000   -0.0000   -0.0000   -0.0000   -0.0000   -0.0000   -0.0000   -0.0000   -0.0000

Algorithms

Data Generation for One-Dimensional, Two-Dimensional, and Complex Data

When you use a DataGenerator object to generate data for a DataSpecification object with the Dimensions property set to 1, the output data always contains the minimum and maximum values of the specified intervals, and any values specified by the MandatoryValues property.

When you generate data for a DataSpecification object with the Dimensions property set to a value greater than 1, the output is generated by taking a cartesian product of the one-dimensional output.

For example, consider the following two DataSpecification objects. The two objects are identical except that one is one-dimensional, and the other is two-dimensional.

dataspec_1d = fixed.DataSpecification('single',...
   'Intervals', {-1,1}, 'Dimensions',1);
dataspec_2d = fixed.DataSpecification('single',...
   'Intervals', {-1,1}, 'Dimensions',2);

Create two DataGenerator objects based on these specifications. Set the maximum number of data points in the generated data to inf.

datagen_1d = fixed.DataGenerator('DataSpecifications', ...
  dataspec_1d, 'NumDataPointsLimit', inf);
datagen_2d = fixed.DataGenerator('DataSpecifications', ...
  dataspec_2d, 'NumDataPointsLimit', inf);

Get the size of the generated data for each of the configurations.

size_1d_data = size(outputAllData(datagen_1d))
size_2d_data = size(outputAllData(datagen_2d))

size_1d_data =

     1   244

size_2d_data =

           2       59536

The length of the two-dimensional data is exactly the squared length of the one-dimensional data.

The DataGenerator generates complex data in a similar way to the two-dimensional data. Create a DataSpecification object with Dimensions set to 1 and the Complexity set to complex. Create a DataGenerator object using this specification.

dataspec_complex = fixed.DataSpecification('single', ...
'Intervals', {-1,1}, 'Dimensions', 1, 'Complexity', 'complex');

datagen_complex = fixed.DataGenerator('DataSpecifications', ...
  dataspec_complex, 'NumDataPointsLimit', inf);

Get the size of the generated data from this configuration.

size_complex_data = size(outputAllData(datagen_complex))

size_complex_data =

           1       59536

The length of the output data for the one-dimensional complex data is the same as the length of the two-dimensional real data.

Version History

Introduced in R2019b