exponenta event banner

Waterfall

(Чтобы быть удаленным) векторы Представления из данных в зависимости от времени

Блок Waterfall будет удален в будущем релизе. Используйте различный осциллограф вместо этого, смотрите Осциллографы и Регистрацию данных.

  • Библиотека:
  • DSP System Toolbox / Устаревшие Блоки

  • Waterfall block

Описание

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

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

Кнопки на панели инструментов помечены на окне Waterfall, как это появляется, когда вы дважды кликаете блок Waterfall.

Порты

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

развернуть все

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

Типы данных: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | fixed point

Параметры

развернуть все

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

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

Отображение

Эти параметры управляют отображением Водопада.

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: NumTraces
Ввод: положительная скалярная величина, заданная как вектор символов

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: UpdateInterval
Ввод: положительная скалярная величина, заданная как вектор символов

Цвета для отображенных данных в виде допустимой палитры.

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: CMapStr
Ввод: символьный вектор
Ввод: допустимое имя палитры, смотрите map

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: TNewest и TOldest
Ввод: номер между [0,1] заданный как вектор символов

Оси

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

Минимальное значение y - ось, заданная как целое число.

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: YMin
Ввод: символьный вектор

Максимальное значение y - ось, заданная как целое число

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: YMax
Ввод: символьный вектор

Цвет осей в виде триплета RGB, заданного названия цвета или шестнадцатеричного цветового кода.

Триплеты RGB и шестнадцатеричные цветовые коды полезны для определения пользовательских цветов.

  • Триплет RGB представляет собой трехэлементный вектор-строку, элементы которого определяют интенсивность красных, зеленых и синих компонентов цвета. Интенсивность должна быть в области значений [0,1]; например, [0.4 0.6 0.7].

  • Шестнадцатеричный цветовой код является вектором символов или строковым скаляром, который запускается с символа хеша (#) сопровождаемый тремя или шестью шестнадцатеричными цифрами, которые могут лежать в диапазоне от 0 к F. Значения не являются чувствительными к регистру. Таким образом, цветовые коды '#FF8800', '#ff8800', '#F80', и '#f80' эквивалентны.

Кроме того, вы можете задать имена некоторых простых цветов. Эта таблица приводит опции именованного цвета, эквивалентные триплеты RGB и шестнадцатеричные цветовые коды.

Название цветаКраткое названиеТриплет RGBШестнадцатеричный цветовой кодВнешний вид
'red''r'[1 0 0]'#FF0000'

Sample of the color red

'green''g'[0 1 0]'#00FF00'

Sample of the color green

'blue''b'[0 0 1]'#0000FF'

Sample of the color blue

'cyan' 'c'[0 1 1]'#00FFFF'

Sample of the color cyan

'magenta''m'[1 0 1]'#FF00FF'

Sample of the color magenta

'yellow''y'[1 1 0]'#FFFF00'

Sample of the color yellow

'black''k'[0 0 0]'#000000'

Sample of the color black

'white''w'[1 1 1]'#FFFFFF'

Sample of the color white

Вот являются триплеты RGB и шестнадцатеричные цветовые коды для цветов по умолчанию MATLAB® использование во многих типах графиков.

Триплет RGBШестнадцатеричный цветовой кодВнешний вид
[0 0.4470 0.7410]'#0072BD'

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]'#D95319'

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]'#EDB120'

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]'#7E2F8E'

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]'#77AC30'

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]'#4DBEEE'

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]'#A2142F'

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: AxisColor
Ввод: вектор символов в векторе символов
Пример: set_param(block,'AxisColor',char("'b'"))

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: XLabel
Ввод: символьный вектор

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: YLabel
Ввод: символьный вектор

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: ZLabel
Ввод: символьный вектор

История данных

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

Количество векторов (trace), которых вы хотите, чтобы блок сохранил в виде положительного целого числа.

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: HistoryLength
Ввод: положительное целое число, заданное как вектор символов

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

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

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

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: HistoryFull
Ввод: символьный вектор

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

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

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

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: ExportMode
Ввод: символьный вектор

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: MLExportName
Ввод: символьный вектор

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: AutoExport
Значения: 'off' | 'on'

Инициирование

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

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

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

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

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

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: TrigStartMode | TrigStartT | TrigStartN | TrigStartFcn
Ввод: символьный вектор

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

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

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

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

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

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: TrigStopMode | TrigStopT | TrigStopN | TrigStopFcn
Ввод: символьный вектор

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

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

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

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

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

Зависимость

Чтобы включить этот параметр, установите Stop recording на After T seconds, After N inputs, или User-defined.

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: TrigRearmMode | TrigRearmT | TrigRearmN | TrigRearmFcn
Ввод: символьный вектор

Преобразовать

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

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

Выберите преобразование, что требуется обратиться к входу блока 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 — Блок преобразует входную мощность в децибелы.

  • User-defined fcn — смотрите Функцию.

  • User-defined expr — смотрите Выражение.

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: XFormMode
Ввод: символьный вектор

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

Зависимость

Чтобы включить этот параметр, установите Transform на User-defined fcn.

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: XFormFcn
Ввод: символьный вектор

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

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

Зависимость

Чтобы включить этот параметр, установите Transform на User-defined expr.

Программируемое использование

Управляйте этим параметром от использования командной строки set_param (Simulink) и get_param (Simulink).

Параметры блоков: XFormExpr
Ввод: символьный вектор

Характеристики блока

Типы данных

double | fixed point | integer | single

Прямое сквозное соединение

no

Многомерные сигналы

no

Сигналы переменного размера

no

Обнаружение пересечения нулем

no

Вопросы совместимости

развернуть все

Не рекомендуемый запуск в R2020b

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

Смотрите также

(Simulink) | |

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