fixed.DataGenerator

Creates value set and generates data

Since R2019b

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

example

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

Properties

expand all

`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.

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

collapse all

Create a `fixed.DataGenerator` object

Open Live Script

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

Create the DataSpecification object with an interval from $- 2 π$ to $2 π$ 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);

Algorithms

expand all

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

fixed.DataGenerator

Description

Creation

Syntax

Description

Properties

`DataSpecifications` — Properties of generated data
`fixed.DataSpecification` object | cell array of `fixed.DataSpecification` objects

`NumDataPointsLimit` — Maximum number of data points in generated data
100000 (default) | integer-valued scalar

Object Functions

Examples

Create a `fixed.DataGenerator` object

Algorithms

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

Version History

See Also

Objects

fixed.DataGenerator

Description

Creation

Syntax

Description

Properties

DataSpecifications — Properties of generated data fixed.DataSpecification object | cell array of fixed.DataSpecification objects

NumDataPointsLimit — Maximum number of data points in generated data 100000 (default) | integer-valued scalar

Object Functions

Examples

Create a fixed.DataGenerator object

Algorithms

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

Version History

See Also

Objects

`DataSpecifications` — Properties of generated data
`fixed.DataSpecification` object | cell array of `fixed.DataSpecification` objects

`NumDataPointsLimit` — Maximum number of data points in generated data
100000 (default) | integer-valued scalar

Create a `fixed.DataGenerator` object