Data Store Read

Считайте данные из хранилища данных

  • Библиотека:
  • Simulink / Маршрутизация Сигнала

  • Data Store Read block

Описание

Блок Data Store Read копирует данные из именованного хранилища данных или выбранного фрагмента этого к его выходу. Больше чем один блок Data Store Read может читать из того же хранилища данных.

Хранилище данных, из которого считаны данные, определяется местоположением блока Data Store Memory или объекта сигнала, который задает хранилище данных. Для получения дополнительной информации смотрите Хранилища данных и Data Store Memory.

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

Можно выбрать Data Store Read, Data Store Write или блок Data Store Memory, чтобы подсветить блоки, связанные с ним.

Порты

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

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

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

Зависимости

Чтобы включить внешний порт индекса, на вкладке Element Assignment, выбирают Enable indexing. Затем в Nстрока th таблицы Index Option, набор Index Option к Index vector (port) или Starting index (port).

Типы данных: int8 | int16 | int32 | uint8 | uint16

Вывод

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

Значения от заданного хранилища данных, выведенного с совпадающим типом данных и количеством размерностей как в хранилище данных. Блок поддерживает и действительные и комплексные сигналы. Можно выбрать, вывести ли целое хранилище данных или только выбранные элементы.

Можно использовать массивы шин с блоком Data Store Read. Для получения дополнительной информации об определении и использовании массива шин, смотрите Группу Невиртуальные Шины в Массивах Шин.

Типы данных: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | Boolean | fixed point | enumerated | bus

Параметры

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

Параметры

Задайте имя хранилища данных, из которого этот блок считывает данные. Смежный список обеспечивает имена блоков Data Store Memory, которые существуют на том же уровне в модели как блок Data Store Read или в более высоких уровнях. Список также включает весь Simulink.Signal объекты в базовых рабочих пространствах и рабочих пространствах модели. Чтобы изменить название, выберите имя из списка или введите имя непосредственно в поле редактирования.

При компиляции модели, содержащей этот блок, Simulink® ищет модель вверх от уровня блока для блока Data Store Memory, имеющего заданное имя хранилища данных. Если Simulink не находит такой блок, он ищет рабочее пространство модели и рабочую область MATLAB® для Simulink.Signal объект, имеющий то же имя. Если Simulink находит объект сигнала, он создает скрытый блок Data Store Memory на корневом уровне модели со свойствами, заданными объектом сигнала и набором начального значения к массиву нулей. Размерности того массива наследованы от Dimensions свойство объекта сигнала.

Если Simulink не находит ни блока Data Store Memory, ни объекта сигнала, это останавливает компиляцию и отображает ошибку. Смотрите Разрешение Символа для получения дополнительной информации о пути поиска файлов.

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

Параметры блоков: DataStoreName
Ввод: символьный вектор
Значения: имя хранилища данных
Значение по умолчанию: 'A'

Это свойство доступно только для чтения.

Это cписки полей блок Data Store Memory, который инициализировал хранилище, из которого читает этот блок.

Это свойство доступно только для чтения.

Это cписки полей, которые путь ко всему Data Store Write блокирует с тем же именем хранилища данных как этот блок, которые находятся в той же (sub) системе или в любой подсистеме ниже его в иерархии модели. Кликните по любой записи в этом списке, чтобы подсветить соответствующий блок в вашей модели.

Шаг расчета, который управляет, когда блок читает из хранилища данных. Значение -1 указывает, что шаг расчета наследован. См. Настройку времени выборки для получения дополнительной информации.

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

Параметры блоков: SampleTime
Ввод: символьный вектор
Значения: скаляр | вектор
Значение по умолчанию: '-1'

Выбор элемента

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

Если Enable indexing не выбран, выберите элемент и используйте один из следующих подходов:

  • Нажмите Select>>, чтобы отобразить тот элемент и все его подэлементы в списке Selected element(s).

  • Используйте окно редактирования Specify element(s) to select, чтобы задать подэлементы, которые вы хотите выбрать для чтения. Затем нажмите Select>>.

Чтобы выбрать несколько элементов, повторите вышеупомянутую процедуру для каждого элемента.

В качестве альтернативы можно выбрать Enable indexing, затем выбрать один элемент и задать подэлементы динамически с помощью параметра Index Option.

Чтобы обновить отображение и отразить модификации к массиву или шине, используемой в хранилище данных, нажмите Refresh.

Зависимости

Подсказка для этого раздела (Elements in the array или Signals in the bus) зависит от типа данных в хранилище данных.

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

Параметры блоков: DataStoreElements
Ввод: символьный вектор
Значения: разграниченный фунтом список элементов (См., что Спецификация использует командную строку.)
Значение по умолчанию: ''

Введите выражение MATLAB, чтобы задать определенный элемент, который вы хотите считать, затем нажать Select>>, чтобы добавить элемент в таблицу Selected elements(s). Повторитесь, чтобы выбрать дополнительные элементы.

Например, для хранилища данных под названием DSM это имеет максимальные размерности [3,5], вы могли ввести выражения, такие как DSM(2,4) или DSM([1 3],2) в окне редактирования. Смотрите Получающую доступ Определенную Шину и Элементы матрицы.

Чтобы применить выбор элемента, нажмите OK или Apply.

Зависимости

Окно редактирования Specify element(s) to select появляется, только если Enable indexing не выбран.

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

Параметры блоков: DataStoreElements
Ввод: символьный вектор
Значения: разграниченный фунтом список элементов (См., что Спецификация использует командную строку.)
Значение по умолчанию: ''

Элементы, которые вы выбираете из хранилища данных. Значок блока Data Store Read отображает выходной порт для каждого элемента, который вы указываете.

Чтобы изменить порядок шины или элементов матрицы в списке, выберите элемент в списке и нажмите Up или Down. Изменение порядка элементов в списке изменяет порядок портов. Чтобы удалить элемент, нажмите Remove.

Зависимости

Таблица Selected element(s) появляется, только если Enable indexing не выбран.

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

Параметры блоков: DataStoreElements
Ввод: символьный вектор
Значения: разграниченный фунтом список элементов (См., что Спецификация использует командную строку.)
Значение по умолчанию: ''

Выберите этот параметр, чтобы позволить индексировать похожий на используемый блоком Selector, посредством чего можно динамически задать индексы подэлементов, чтобы читать при помощи одного или нескольких входных портов индекса, а также индексов определения при помощи диалогового окна блока. Блок Data Store Read может читать только из одного элемента хранилища данных (то есть, один сигнал в шине), когда этот параметр выбран. Чтобы читать из нескольких элементов хранилища данных, использующего динамическую индексацию, используйте несколько блоков Data Store Read.

Очистите этот параметр, чтобы отключить индексацию стиля блока Selector. Можно выбрать несколько элементов хранилища данных, чтобы читать, но можно задать который подэлементы к только для чтения при помощи диалогового окна блока.

Примечание

Не выбирайте Enable indexing, если связанное хранилище данных содержит только один, скалярный элемент.

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

Параметры блоков: EnableIndexing
Ввод: символьный вектор
Значения: 'off' | 'on'
Значение по умолчанию: 'off'

Количество размерностей выбранного элемента хранилища данных. Необходимо явным образом указать на этот номер.

Зависимости

Этот параметр включен, только если Enable indexing выбран.

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

Параметры блоков: NumberOfDimensions
Ввод: символьный вектор
Значения: positive integer
Значение по умолчанию: '1'

Выберите режим индексации. Если One-based выбран, индекс 1 указывает первый элемент входного вектора. Если Zero-based выбран, индекс 0 указывает первый элемент входного вектора.

Зависимости

Этот параметр включен, только если Enable indexing выбран.

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

Параметр: IndexMode
Ввод: символьный вектор
Значения: 'Zero-based' | 'One-based'
Значение по умолчанию: 'One-based'

Задайте размерностью, как подэлементы выбранного элемента хранилища данных должны быть индексированы. Из списка выберите:

Пункт менюДействие
Select all

Все подэлементы читаются.

Index vector (dialog)

Включает столбец Index. Введите вектор, содержащий индексы подэлементов, которые будут считаны.

Index vector (port)

Соответствующий порт индекса задает индексы подэлементов, которые будут считаны.

Starting index (dialog)

Включает столбцы Output Size и Index. Введите начальное значение индекса и размер области значений подэлементов, которые будут считаны.

Starting index (port)

Включает столбец Output Size. Соответствующий порт индекса задает начальное значение индекса области значений элементов, которые будут считаны. Введите размер области значений.

Index и столбцы Output Size отображены как релевантные.

Зависимости

Этот параметр включен, только если Enable indexing выбран.

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

Параметр: IndexOptionArray
Ввод: символьный вектор
Значения: 'Select all' | 'Index vector (dialog)' | 'Index vector (port)' | 'Starting index (dialog)' | 'Starting index (port)'
Значение по умолчанию: 'Index vector (dialog)'

Если Index Option является Index vector (dialog), введите вектор, содержащий индексы каждого подэлемента, чтобы читать.

Если Index Option является Starting index (dialog), введите начальное значение индекса области значений подэлементов, чтобы читать.

Зависимости

Этот параметр включен, только если Enable indexing выбран, и Index Option для размерности является Index vector (dialog) или Starting index (dialog).

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

Параметр: IndexParamArray
Ввод: символьный вектор
Значения: cellArray
Значение по умолчанию: '{ }'

Если Index Option является Starting index (dialog) или Starting index (port), введите размер области значений подэлементов, чтобы читать.

Зависимости

Этот параметр включен, только если Enable indexing выбран, и Index Option для размерности является Starting index (dialog) или Starting index (port).

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

Параметры блоков: OutputSizeArray
Ввод: символьный вектор
Значения: cellArray
Значение по умолчанию: '{ }'

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

Типы данных

Boolean | bus | double | enumerated | fixed point | half | integer | single | string

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

no

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

yes

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

no

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

no

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

Генерация кода C/C++
Генерация кода C и C++ с помощью Simulink® Coder™.

Преобразование фиксированной точки
Спроектируйте и симулируйте системы фиксированной точки с помощью Fixed-Point Designer™.

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