Водопад

Просмотрите векторы данных в зависимости от времени

Библиотека

Приемники

dspsnks4

Описание

Блок Waterfall отображает несколько векторов данных когда-то. Эти векторы представляют входные данные в последовательных шагах расчета. Вход к блоку может быть действительными или векторами данных с комплексным знаком любого типа данных включая типы данных с фиксированной точкой. Однако вход преобразован в с двойной точностью, прежде чем блок обработает данные. Блок Waterfall отображает только векторы с двойной точностью, с действительным знаком данных.

Данные отображены на 3D оси в окне Waterfall. По умолчанию x - ось представляет амплитуду, y - ось представляет выборки и z - ось представляет время. Можно настроить количество демонстрационных векторов, которые отображает блок, переместите и измените размер окна Waterfall и измените значения параметров блоков во время симуляции. Окно Waterfall имеет кнопки на панели инструментов, которые позволяют вам увеличить масштаб отображенных данных, приостановить сбор данных, заморозить отображение осциллографа, сохранить положение осциллографа и экспортировать данные в рабочую область. Кнопки на панели инструментов маркированы в следующей фигуре, которая показывает окно Waterfall, как это появляется, когда вы дважды кликаете блок Waterfall.

Параметры водопада

Можно управлять отображением и поведением окна Waterfall с помощью диалогового окна Parameters.

Примечание

Можно изменить параметры Водопада, в то время как симуляция запускается. Однако, когда вы вносите изменения в значения в текстовых полях, необходимо нажать Enter или нажатие кнопки вне текстового поля, прежде чем блок примет изменения.

  1. Чтобы открыть диалоговое окно Parameters, нажмите кнопку Scope parameters.

    Диалоговое окно Parameters появляется.

  2. Нажмите на различные панели, чтобы ввести установки параметров.

Отобразите параметры

Следующие параметры управляют отображением окна Waterfall.

Display traces

Введите номер векторов данных, которые будут отображены в окне Waterfall.

Update interval

Введите номер векторов, которые должен сохранить блок, прежде чем это отобразит их к окну.

Colormap

Выберите палитру для отображенных данных.

Transparency

Задайте прозрачность новейших и самых старых векторов данных. Размещение ползунка в крайнем левом положении говорит блоку делать вектор данных прозрачным. Размещение ползунка в самом правом положении говорит блоку делать вектор данных непрозрачным. Промежуточный переход векторов данных между двумя выбранными значениями прозрачности.

Параметры осей

Следующие параметры управляют осями в окне Waterfall.

Y Min

Введите минимальное значение y - ось.

Y Max

Введите максимальное значение y - ось.

Axis color

Введите цвет фона для осей. Задайте цвет с помощью вектора символов. Например, чтобы задать черный, введите 'k'.

X Axis

Введите x - подпись по осям.

Y Axis

Введите y - подпись по осям.

Z Axis

Введите z - подпись по осям.

Параметры истории данных

Следующие параметры управляют, сколько входных данных векторизовал хранилища блока Waterfall. Они также управляют, как данные экспортированы в рабочую область MATLAB®.

History traces

Введите номер векторов (trace), которых вы хотите, чтобы блок сохранил.

When the buffer is full

Используйте этот параметр, чтобы управлять поведением блока, когда буфер будет заполнен:

  • Overwrite — Старые данные заменяются новыми данными.

  • Suspend — Блок прекращает хранить данные в буфере; однако, симуляция продолжает запускаться.

  • Extend — Блок расширяет буфер так, чтобы это могло продолжить хранить все входные данные.

Data logging

Используйте этот параметр, чтобы управлять, какие данные экспортированы из блока:

  • Selected — Выбранный вектор данных экспортируется.

  • All visible — Экспортируются все векторы данных, отображенные в окне Waterfall.

  • All history — Экспортируются все векторы данных, сохраненные в буфере истории блока.

Export variable

Введите имя переменной, которая представляет ваши данные в рабочем пространстве MATLAB. Именем переменной по умолчанию является ExportData.

Export at end of simulation

Установите этот флажок, чтобы автоматически экспортировать данные в рабочее пространство MATLAB, когда симуляция остановится.

Инициирование параметров

Следующее управление параметрами, когда блок Waterfall запускает и прекращает собирать данные.

Begin recording

Этот параметр управляет, когда блок Waterfall начинает собирать данные:

  • Окно Immediately — The Waterfall получает входные данные, как только симуляция запускается.

  • After T seconds — Параметр Time, T появляется в диалоговом окне. Введите номер секунд, блок должен ожидать, прежде чем это начнет собирать данные.

  • After N inputs — Параметр Count, N появляется в диалоговом окне. Введите номер входных параметров, которые должен получить блок, прежде чем это начнет собирать данные.

  • User-defined — Параметр Function name появляется в диалоговом окне. Введите имя функции MATLAB, которая задает, когда блок должен начать собирать данные. Для получения дополнительной информации о том, как вы задаете эту функцию, смотрите Триггерную Функцию Осциллографа.

Stop recording

Этот параметр управляет, когда блок Waterfall прекращает собирать данные:

  • Never — Блок получает входные данные, пока симуляция запускается.

  • After T seconds — Параметр Time, T появляется в диалоговом окне. Введите номер секунд, блок должен ожидать, прежде чем это прекратит собирать данные.

  • After N inputs — Параметр Count, N появляется в диалоговом окне. Введите номер входных параметров, которые должен получить блок, прежде чем это прекратит собирать данные.

  • User-defined — Параметр Function name появляется в диалоговом окне. Введите имя функции MATLAB, которая задает, когда блок должен прекратить собирать данные. Для получения дополнительной информации о том, как вы задаете эту функцию, смотрите Триггерную Функцию Осциллографа.

Re-arm trigger

Этот параметр управляет, когда блок Waterfall начинает ожидать, чтобы собрать данные. Это доступно только, когда вы выбираете After T seconds, After N inputs или User-defined для параметра Stop recording:

  • Never — Блок Waterfall Scope запускает и прекращает собирать данные, как задано параметрами Stop recording и Begin recording.

  • After T seconds — Параметр Time, T появляется в диалоговом окне. Введите номер секунд, блок должен ожидать, прежде чем это начнет ожидать, чтобы собрать данные.

  • After N inputs — Параметр Count, N появляется в диалоговом окне. Введите номер входных параметров, которые должен получить блок, прежде чем это начнет ожидать, чтобы собрать данные.

  • User-defined — Параметр Function name появляется в диалоговом окне. Введите имя функции MATLAB, которая задает, когда блок должен начать ожидать, чтобы собрать данные. Для получения дополнительной информации о том, как вы задаете эту функцию, смотрите Триггерную Функцию Осциллографа.

Процесс инициирования проиллюстрирован в диаграмме состояний ниже.

Определите объем триггерной функции

Можно создать пользовательские триггерные функции осциллографа, чтобы управлять, когда осциллограф запускается, останавливает или начинает ожидать, чтобы собрать данные.

Эти функции должны быть допустимыми функциями MATLAB и быть расположены или в текущей папке или на пути MATLAB.

Каждая триггерная функция осциллографа должна иметь следующую форму

y = functionname(blk,t,u),

где functionname относится к имени, вы даете свою триггерную функцию осциллографа. Переменная blk является указателем блока Simulink®. Когда триггерная функция осциллографа вызвана блоком, Simulink автоматически заполняет эту переменную с указателем блока Waterfall. Переменная t является текущим временем симуляции, представленным действительным, скалярным значением с двойной точностью. Переменная u является векторным входом к блоку. Вывод триггерной функции осциллографа, y, интерпретирован как логический сигнал. Это - любой TRUE или FALSE:

  • Начните записывать триггерную функцию осциллографа

    • Когда вывод этой триггерной функции осциллографа верен, блок Waterfall начинает собирать данные.

    • Когда вывод является ложным, блок остается в своем текущем состоянии.

  • Прекратите записывать триггерную функцию осциллографа

    • Когда вывод этой триггерной функции осциллографа верен, блок прекращает собирать данные.

    • Когда вывод является ложным, блок остается в своем текущем состоянии.

  • Перевооружите триггерную триггерную функцию осциллографа

    • Когда вывод этой триггерной функции осциллографа верен, блок ожидает начать события записи.

    • Когда вывод является ложным, блок остается в своем текущем состоянии.

      Примечание

      Блок Waterfall передает свои входные данные непосредственно триггерным функциям осциллографа. Эти функции не используют преобразованные данные, заданные параметрами Преобразования.

Следующее является примером триггерной функции осциллографа. Эта функция, вызванная trigPower, обнаруживает, когда энергия в u превышает определенный порог.

function y = trigPower(blk, t, u)

y = (u'*u > 2300);

Следующее является другим примером триггерной функции осциллографа. Эта функция, вызванная count3, инициировала осциллограф, если три вектора с положительными средними значениями вводятся к блоку. Затем функция сбрасывает себя и начинает искать следующие три входных вектора с положительными средними значениями. Эта триггерная функция осциллографа допустима только, когда один блок Waterfall присутствует в вашей модели.

function y = count3(blk, t, u)

persistent state;
if isempty(state); state = 0; end
if mean(u)>0; state = state+1; end
y = (state>=3);
if y; state = 0; end

Преобразуйте параметры

Следующие параметры преобразовывают входные данные к блоку Waterfall. Результат преобразования отображен в окне Waterfall.

Примечание

Блок принимает, что вход к блоку соответствует параметру Transform, который вы выбираете. Например, когда вы выбираете Complex-> Angle, блок принимает, что вход является комплексным. Блок не производит ошибку, когда вход не является комплексным. Поэтому необходимо проверить формат входных данных, чтобы гарантировать, что значимый результат отображен в окне Waterfall.

Transform

Выберите преобразование, что требуется обратиться к входу блока Waterfall:

  • 'none' Вход отображен, когда он получен блоком.

  • Amplitude-> dB — Блок преобразовывает входную амплитуду в децибелы.

  • Complex-> Mag Lin — Блок преобразовывает комплексный вход в линейное значение.

  • Complex-> Mag dB — Блок преобразовывает комплексный вход в значение в децибелах.

  • Complex-> Angle — Блок преобразовывает комплексный вход в фазу.

  • FFT-> Mag Lin Fs/2 — Блок берет линейное значение входа FFT и строит его от 0 до частоты Найквиста.

  • FFT-> Mag dB Fs/2 — Блок берет значение входа FFT, преобразовывает его в децибелы и строит его от 0 до частоты Найквиста.

  • FFT-> Angle Fs/2 — Блок преобразовывает вход FFT в фазу и строит его от 0 до частоты Найквиста.

  • Power-> dB — Блок преобразовывает входную мощность в децибелы.

Function

Этот параметр только доступен, когда вы выбираете User-defined fcn для параметра Transform. Введите функцию, что требуется обратиться к входу блока Waterfall. Для получения дополнительной информации о том, как вы задаете эту функцию, смотрите Функцию Преобразования Осциллографа.

Expression

Этот параметр только доступен, когда вы выбираете User-defined expr для параметра Transform. Введите выражение, что требуется обратиться к входу блока Waterfall. Результат этого выражения должен быть с действительным знаком. Когда вы пишете выражение, убедиться включать только одну неизвестную переменную. Блок принимает, что эта неизвестная переменная представляет вход блоку. Когда блок полагает, что ваше выражение недопустимо, следующее окно появляется.

Когда вы нажимаете No, ваше выражение не применяется к входу. Когда вы нажимаете Yes, и ваше выражение недопустимо, ваши остановки симуляции и Simulink отображает ошибку.

Определите объем преобразовывают функцию

Можно создать осциллограф, преобразовывают функцию, чтобы управлять, как блок Waterfall преобразовывает входные данные. Эта функция должна иметь допустимое имя функции MATLAB и быть расположена или в текущей папке или на пути MATLAB.

Ваш осциллограф преобразовывает функцию, должен иметь следующую форму

y = functionname(u),

где functionname относится к имени, вы даете свою функцию. Переменная u является вектором действительных чисел или входом комплексного вектора к блоку. Вывод осциллографа преобразовывает функцию, y, должен быть двойная точность, вектор с действительным знаком. Когда это не, остановки симуляции и Simulink отображает ошибку. Обратите внимание на то, что выходной вектор не должен быть одного размера как входной вектор.

Примеры

Следующие примеры иллюстрируют некоторые возможности блока Waterfall.

Экспортирование данных

Можно использовать блок Waterfall, чтобы экспортировать данные в рабочее пространство MATLAB:

  1. Открытый и выполнение пример dspanc.

  2. В то время как симуляция запускается, нажмите кнопку Export to Workspace.

  3. Введите whos в командной строке MATLAB.

    Переменная ExportData появляется в вашем рабочем пространстве MATLAB. ExportData 40 6 матрица. Эта матрица представляет шесть векторов данных, которые присутствовали в окне Waterfall в то время, когда вы нажали кнопку Export to Workspace. Каждый столбец этой матрицы содержит 40 коэффициентов фильтра. Столбцы данных были получены в шесть моментов подряд вовремя.

    Можно управлять тем, какие данные экспортированы с помощью параметра Data logging в панели Data history диалогового окна Parameters. Для получения дополнительной информации смотрите Параметры Истории Данных.

Собирание данных

Можно использовать блок Waterfall, чтобы взаимодействовать с данными, в то время как это получается:

  1. Открытый и выполнение пример dspanc.

  2. В то время как симуляция запускается, нажмите кнопку Suspend data capture.

    Блок Waterfall больше не получает или не отображает данные, прибывающие из блока Downsample.

  3. Чтобы продолжить собирать данные, нажмите кнопку Resume data capture.

  4. Чтобы заморозить отображение данных, продолжая собирать данные, нажмите кнопку Snapshot display.

  5. Чтобы просмотреть блок Waterfall, из которого прибывают данные, нажмите кнопку Go to scope block.

    В окне модели Simulink, блок Waterfall, который соответствует активным вспышкам окна Waterfall. Эта функция полезна, когда у вас есть больше чем один блок Waterfall в модели, и вы хотите разъясниться, какие данные отображаются.

Соединение осциллографов

Можно соединить несколько блоков Водопада в порядке получить эффект образцового события во всех окнах Waterfall в модели:

  1. Откройте пример dspanc.

  2. Перетащите второй блок Waterfall в модель в качестве примера.

  3. Соедините этот блок с Выходным портом блока LMS Filter как показано в фигуре ниже.

  4. Запустите модель и просмотрите поведение модели в обоих окнах Waterfall.

  5. В dspanc/Waterfall окне нажмите кнопку Link scopes.

  6. В том же окне нажмите кнопку Suspend data capture.

    Сбор данных является приостановленными окнами in и scope.

  7. Нажмите кнопку Resume data capture.

    Сбор данных возобновляет окна in и scope.

  8. В dspanc/Waterfall окне нажмите кнопку Snapshot display.

    Окна In и scope, данные отображают замораживания, в то время как блок продолжает собирать данные.

  9. Чтобы продолжить отображать собранные данные, нажмите кнопку Resume display.

Выбор данных

Следующие данные показывают окно Waterfall, отображающее вывод примера dspanc:

  1. Чтобы выбрать определенный набор данных, нажмите кнопку Select.

  2. Нажмите на Панель Времени в правом нижнем углу осей, чтобы выбрать вектор данных.

    Блок Waterfall подсвечивает выбранную трассировку.

    В то время как симуляция запускается в правом нижнем углу, окно Waterfall отображает относительный индекс выбранной трассировки. Например, в предыдущей фигуре, выбранный вектор является двумя шагами расчета далеко от актуальнейшего вектора данных. Когда симуляция останавливается, окно Waterfall отображает и относительный индекс и время симуляции, сопоставленное с выбранной трассировкой.

  3. Чтобы отменить выбор вектора данных, кликните по нему снова.

  4. Перетащите вдоль панели времени.

    Ваш выбор следует за перемещением указателя.

Можно использовать эту функцию, чтобы выбрать конкретный вектор, чтобы экспортировать в рабочее пространство MATLAB. Для получения дополнительной информации смотрите Параметры Истории Данных.

Изменение масштаба

Можно использовать окно Waterfall, чтобы увеличить масштаб данных:

  1. Нажмите кнопку Zoom camera.

  2. В окне Waterfall щелкните и удерживайте левую кнопку мыши.

  3. Переместите мышь вверх и вниз и от одной стороны к другой придвинуться поближе и дальше от осей.

  4. Чтобы изменить размер осей, чтобы соответствовать окну Waterfall, нажмите кнопку Fit to view.

Вращение отображения

Можно вращать данные, отображенные в окне Waterfall:

  1. Нажмите на кнопку Orbit camera.

  2. В окне Waterfall щелкните и удерживайте левую кнопку мыши.

  3. Переместите мышь в круговое движение, чтобы вращать оси.

  4. Чтобы возвратиться к положению исходных осей, нажмите кнопку Restore scope position and view.

Масштабирование осей

Можно использовать окно Waterfall, чтобы повторно масштабировать y - значения оси:

  1. Открытый и выполнение пример dspanc.

  2. Нажмите кнопку Rescale amplitude.

    y - ось изменяется так, чтобы ее минимальное значение было нулем. Максимальному значению масштабируют для соответствия отображенные данные.

Также можно масштабировать y - ось с помощью Y Min и параметров Y Max в панели Axes диалогового окна Parameters. Это полезно когда это необходимо, чтобы отменить эффекты перемасштабирования амплитуды. Для получения дополнительной информации смотрите Параметры Осей.

Сохранение настроек осциллографа

Блок Waterfall может сохранить экранное положение и точку зрения окна Waterfall:

  1. Нажмите кнопку Save scope position and view.

  2. Закройте окно Waterfall.

  3. Вновь откройте окно Waterfall.

    Это вновь открылось в том же месте на вашем экране. Точка зрения осей также остается то же самое.

Поддерживаемые типы данных

ПортПоддерживаемые типы данных

Входной параметр

  • Плавающая точка двойной точности

  • Плавающая точка с одинарной точностью

  • Фиксированная точка (подписанный и без знака)

  • 8-, 16-, и 32-битные целые числа со знаком

  • 8-, 16-, и 32-битное беззнаковое целое

Блок Waterfall принимает любой из этих типов данных, как введено. Однако вход преобразован в с двойной точностью, прежде чем блок обработает данные. Блок Waterfall отображает только векторы с двойной точностью, с действительным знаком данных.

Расширенные возможности

Представлено до R2006a

Для просмотра документации необходимо авторизоваться на сайте