Documentation |
Package: dsp
State-level estimation for bilevel rectangular waveform
The StateLevels object estimates the state levels of a bilevel rectangular waveform.
To estimate the state levels of a bilevel waveform:
Define and set up your state-level estimation. See Construction.
Call step to estimate the state levels for an input vector according to the properties of dsp.StateLevels. The behavior of step is specific to each object in the toolbox.
H = dsp.StateLevels creates a state-level estimation System object™, H, that estimates state levels in a bilevel rectangular waveform using the histogram method with 100 bins.
H = dsp.StateLevels('PropertyName',PropertyValue,...) returns an StateLevels System object, H, with each specified property set to the specified value.
HistogramBounds |
Minimum and maximum levels of the histogram. Specify the range of the histogram as a 2-element real–valued row vector. Signal values outside the range defined by this property are ignored. This property applies when you set the Method property to'Histogram mode' or 'Histogram mean', and either RunningStateLevels is true, or the HistogramBoundsSource property is set to 'Property'. Default: [0 5] |
HistogramBoundsSource |
Source of histogram bounds. Specify how to determine the histogram bounds as one of 'Auto' or 'Property'. When you set this property to 'Auto', the histogram bounds are determined by the minimum and maximum input values. When you set this property to 'Property', the histogram bounds are determined by the value of the HistogramBounds property. This property applies when you set the Method property to 'Histogram mode' or 'Histogram mean', and the RunningStateLevels property is false. Default: 'Auto' |
HistogramNumBins |
Number of bins in the histogram. Specify the number of bins in the histogram. This property applies when you set the Method property to 'Histogram mode' or 'Histogram mean'. Default: 100 |
HistogramOutputPort |
Enable histogram output. Set this property to true to output the histogram used in the computation of the state levels. This property applies when you set the Method property to 'Histogram mode' or 'Histogram mean'. Default: false |
Method |
Algorithm used to compute state levels. Specify the method used to compute state levels as one of 'Histogram mean', 'Histogram mode', or 'Peak to peak'. Default: 'Histogram mode' |
RunningStateLevels |
Calculation over successive calls to step. Set this property to true to enable computation of the state levels over successive calls to the step. Otherwise, compute the state levels of the current input. When you set the RunningStateLevels property to false and you are using a histogram to compute your state levels, you must set the HistogramBoundsSource property to 'Property'. |
A particular level, which can be associated with an upper and lower state boundary. States are ordered from the most negative to the most positive. In a bilevel waveform, the most negative state is the low state. The most positive state is the high state.
Each state level can have associated lower- and upper-state boundaries. These state boundaries are defined as the state level plus or minus a scalar multiple of the difference between the high state and low state. To provide a useful tolerance region, the scalar is typically a small number such as 2/100 or 3/100. In general, the α% tolerance region for the low state is defined as
$${S}_{1}\pm {\scriptscriptstyle \frac{\alpha}{100}}({S}_{2}-{S}_{1})$$
where S_{1} is the low-state level and S_{2} is the high-state level. Replace the first term in the equation with S_{2} to obtain the α% tolerance region for the high state.
The following figure illustrates lower and upper 2% state boundaries (tolerance regions) for a positive-polarity bilevel waveform. The estimated state levels are indicated by a dashed red line.
clone | Clones the current instance of the state levels object |
getNumInputs | Number of expected inputs to the step method |
getNumOutputs | Number of outputs of the step method |
isLocked | Locked status (logical) for input attributes and nontunable properties |
plot | Plot signal, state levels, and histogram |
release | Allow property value and input characteristics changes |
reset | Reset internal states of state levels object |
step | Estimate state levels for bilevel rectangular waveform |
The StateLevels System object uses the histogram method to estimate the states of a bilevel waveform. The histogram method is described in [1]. To summarize the method:
Determine the maximum and minimum amplitudes and amplitude range of the data.
For the specified number of histogram bins, determine the bin width as the ratio of the amplitude range to the number of bins.
Sort the data values into the histogram bins.
Identify the lowest-indexed histogram bin, i_{low}, and highest-indexed histogram bin, i_{high}, with nonzero counts.
Divide the histogram into two subhistograms. The lower-histogram bins are i_{low} ≤ i ≤ 1/2(i_{high} — i_{low}).
The upper-histogram bins are i_{low} + 1/2(i_{high} – i_{low}) ≤ i ≤ i_{high}.
Compute the state levels by determining the mode or mean of the lower and upper histograms.
[1] IEEE^{®} Standard on Transitions, Pulses, and Related Waveforms, IEEE Standard 181, 2003, pp. 15–17.