# Pulse Generator

Generate square wave pulses at regular intervals

• Library:

## Description

The Pulse Generator block generates square wave pulses at regular intervals. The block waveform parameters, Amplitude, Pulse Width, Period, and Phase delay, determine the shape of the output waveform. The following diagram shows how each parameter affects the waveform.

The Pulse Generator block can emit scalar, vector, or matrix signals of any real data type. To emit a scalar signal, use scalars to specify the waveform parameters. To emit a vector or matrix signal, use vectors or matrices, respectively, to specify the waveform parameters. Each element of the waveform parameters affects the corresponding element of the output signal. For example, the first element of a vector amplitude parameter determines the amplitude of the first element of a vector output pulse. All the waveform parameters must have the same dimensions after scalar expansion. The data type of the output is the same as the data type of the Amplitude parameter.

The block output can be generated in time-based or sample-based modes, determined by the Pulse type parameter.

### Time-Based Mode

In time-based mode, Simulink® computes the block output only at times when the output actually changes. This approach results in fewer computations for the block output over the simulation time period. Activate this mode by setting the Pulse type parameter to `Time based`.

The block does not support a time-based configuration that results in a constant output signal. Simulink returns an error if the parameters Pulse Width and Period satisfy either of these conditions:

$\begin{array}{l}Period\text{​}*\frac{PulseWidth}{100}=0\\ Period\text{​}*\frac{PulseWidth}{100}=Period\end{array}$

Depending on the pulse waveform characteristics, the intervals between changes in the block output can vary. For this reason, a time-based Pulse Generator block has a variable sample time. The sample time color of such blocks is brown (see View Sample Time Information for more information).

Simulink cannot use a fixed-step solver to compute the output of a time-based pulse generator. If you specify a fixed-step solver for models that contain time-based pulse generators, Simulink computes a fixed sample time for the time-based pulse generators. Then the time-based pulse generators simulate as sample based.

If you use a fixed-step solver and the Pulse type is `Time based`, choose the step size such that the period, phase delay, and pulse width (in seconds) are integer multiples of the solver step size. For example, suppose that the period is `4` seconds, the pulse width is `75%` (that is, `3` s), and the phase delay is `1` s. In this case, the computed sample time is `1` s. Therefore, choose a fixed-step size of `1` or a number that divides `1` exactly (for example, `0.25`). To ensure this setting, select `auto` on the Solver pane of the Configuration Parameters dialog box.

### Sample-Based Mode

In sample-based mode, the block computes its outputs at fixed intervals that you specify. Activate this mode by setting the Pulse type parameter to `Sample based`.

An important difference between the time-based and sample-based modes is that in time-based mode, the block output is based on simulation time, and in sample-based mode, the block output depends only on the simulation start, regardless of elapsed simulation time.

This block supports reset semantics in sample-based mode. For example, if a Pulse Generator block is in a resettable subsystem that hits a reset trigger, the block output resets to its initial condition.

## Ports

### Output

expand all

Generated square wave pulse signal specified by the parameters.

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

## Parameters

expand all

Computational technique to generate the type of square wave that this block generates, either time- or sample-based. Some parameters in the dialog box appear depending on whether you select time-based or sample-based.

#### Programmatic Use

 Block Parameter: `PulseType` Type: character vector Values: ```'Time based'``` | `'Sample based'` Default: ```'Time based'```

Specifies whether to use simulation time or an external signal as the source of values for the output pulse's time variable. If you specify an external source, the block displays an input port for connecting the source. The output pulse differs as follows:

• `Use simulation time`: The block generates an output pulse where the time variable equals the simulation time.

• `Use external signal`: The block generates an output pulse where the time variable equals the value from the input port, which can differ from the simulation time.

#### Programmatic Use

 Block Parameter: `TimeSource` Type: character vector Values: ```'Use simulation time'``` | ```'Use external signal'``` Default: ```'Use simulation time'```

Specify the amplitude of the signal.

#### Programmatic Use

 Block Parameter: `Amplitude` Type: character vector Value: scalar Default: `'1'`

Pulse period specified in seconds if the pulse type is time-based. If the pulse type is sample-based, then the period is specified as the number of sample times.

#### Programmatic Use

 Block Parameter: `Period` Type: character vector Value: scalar Default: `'10'`

Duty cycle specified as the percentage of the pulse period that the signal is on if time-based or as number of sample times if sample-based.

#### Programmatic Use

 Block Parameter: `PulseWidth` Type: character vector Value: scalar Default: `'5'`

Delay before the pulse is generated, specified in seconds, if the pulse type is time-based or as number of sample times if the pulse type is sample-based.

#### Programmatic Use

 Block Parameter: `PhaseDelay` Type: character vector Value: scalar Default: `'0'`

Length of the sample time for this block in seconds. This parameter appears only if the block's pulse type is sample-based. See Specify Sample Time.

#### Programmatic Use

 Block Parameter: `SampleTime` Type: character vector Value: scalar Default: `'0'`

Select this check box to output a vector of length `N` if the Constant value parameter evaluates to an `N`-element row or column vector.

• When you select this check box, the block outputs a vector of length `N` if the Constant value parameter evaluates to an `N`-element row or column vector. For example, the block outputs a matrix of dimension `1-by-N` or `N-by-1`.

• When you clear this check box, the block does not output a vector of length `N` if the Constant value parameter evaluates to an `N`-element row or column vector.

#### Programmatic Use

 Block Parameter: `VectorParams1D` Type: character vector Values: `'on' | 'off'` Default: `'on'`

## Block Characteristics

 Data Types `Boolean` | `double` | `fixed point` | `integer` | `single` Direct Feedthrough `yes` Multidimensional Signals `no` Variable-Size Signals `no` Zero-Crossing Detection `no`