Document toolboxDocument toolbox

(8.D.2.3) RandSequencer

Owned by Catherine Spain
Nov 09, 2023
2 min read

Overview

Generates randomized sequences of integers.

Discussion

This module generates randomized sequences of integers. The randomness comes from pseudo-random number generator typically used in computer programs. The randomized sequence may contain duplicates. Two output pins are provided: A and B outputs each a half of the sequence. Reset pin reshuffles the sequence vector. Increment control input pins select the next value from the sequencer vector. Only an inc value higher than the prior one will generate a new value at the output.

Type Definition

typedef struct _ModuleRandSequencer { ModuleInstanceDescriptor instance; // Common Audio Weaver module instance structure INT32 reset; // Reset Random Sequence INT32 seqLength; // Length of the randomized sequence INT32 incrStateA; // State of increment A INT32 incrStateB; // State of increment B INT32 stateA; // State of sequence A INT32 stateB; // State of sequence B INT32 resetState; // Reset Random Sequence INT32* seqVector; // Vector holding randomized sequence INT32* seqVectorA; // Column vector holding randomized sequence for Out A INT32* seqVectorB; // Column vector holding randomized sequence for Out B } ModuleRandSequencerClass;

Variables

Properties

Name

Type

Usage

isHidden

Default value

Range

Units

reset

int

parameter

0

1

0:1

 

seqLength

int

const

1

20

Unrestricted

 

incrStateA

int

state

1

0

Unrestricted

 

incrStateB

int

state

1

0

Unrestricted

 

stateA

int

state

1

0

Unrestricted

 

stateB

int

state

1

0

Unrestricted

 

resetState

int

state

1

0

Unrestricted

 

seqVector

int*

state

1

[20 x 1]

Unrestricted

 

seqVectorA

int*

state

1

[10 x 1]

Unrestricted

 

seqVectorB

int*

state

1

[10 x 1]

Unrestricted

 

Pins

Input Pins

Name: reset

Description: reset sequence

Data type: int

Channel range: 1

Block size range: 1

Sample rate range: Unrestricted

Complex support: Real

 

Name: incA

Description: increment Output A

Data type: int

Channel range: 1

Block size range: 1

Sample rate range: Unrestricted

Complex support: Real

 

Name: incB

Description: increment Output B

Data type: int

Channel range: 1

Block size range: 1

Sample rate range: Unrestricted

Complex support: Real

Output Pins

Name: A

Description: Sequence Number Output A

Data type: int

 

Name: B

Description: Sequence Number Output B

Data type: int

MATLAB Usage

File Name: rand_sequencer_module.m

M=rand_sequencer_module(NAME) Creates an Audio Weaver Module that acts as a random sequencer. Arguments: NAME - name of the module. SEQLENGTH - length of the sequencer vector

Â