k-Wave Toolbox |

# toneBurst

Create an enveloped single frequency tone burst

## Syntax

    signal = toneBurst(sample_freq, signal_freq, signal_length, signal_offset, num_cycles)
    signal = toneBurst(sample_freq, signal_freq, signal_length, signal_offset, num_cycles,...)

## Description

`toneBurst` creates an enveloped single frequency tone burst for use in ultrasound simulations. If an array is given for `signal_offset`, a matrix of tone bursts is created where each row corresponds to a tone burst for particular value of the `signal_offset`. For example, running

    toneBurst(10e6, 1e6, 300, 50, 10, 'Plot', true);

will return and plot a 10 cycle tone burst with a Gaussian envelope.

## Inputs

`sample_freq` | sampling frequency [Hz]
`signal_freq` | signal frequency [Hz]
`signal_length` | signal length in number of samples
`signal_offset` | signal offset before the tone burst in number of samples
`num_cycles` | number of sinusoidal oscillations

## Optional Inputs

Optional 'string', value pairs that may be used to modify the default computational settings.

Input | Valid Settings | Default | Description
--- | --- | --- | ---
`'Envelope'` | `'Gaussian'` `'Rectangular'` | `'Gaussian'` | Envelope used to taper the tone burst.
`'Plot'` | (Boolean scalar) | `false` | Boolean controlling whether the created tone burst is plotted.

## Outputs

`signal` | created tone burst

## Examples

- Steering A Linear Array
- Snells Law And Critical Angle Reflection

## See Also

`gaussian`

© 2009, 2010 Bradley Treeby and Ben Cox.