Data Store Memory

Задайте хранилище данных

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

  • Data Store Memory block

Описание

Блок Data Store Memory определяет и инициализирует именованное хранилище разделяемых данных, которое является областью памяти, используемой блоками Data Store Read и Data Store Write, которые задают то же имя хранилища данных.

Расположение блока Data Store Memory, который определяет хранилище данных, определяет, какие Data Store Read и Data Store Write блоки могут получить доступ к хранилищу данных:

  • Если блок Data Store Memory находится в системе верхнего уровня, Data Store Read и Data Store Write блоки в любом месте модели могут получить доступ к хранилищу данных.

  • Если блок Data Store Memory находится в подсистеме, Data Store Read и Data Store Write блоки в одной подсистеме или в любой подсистеме под ней в иерархии модели могут получить доступ к хранилищу данных.

Data Store Read или Data Store Write блоки не могут получить доступ к блоку Data Store Memory, который находится либо в модели, содержащей блок Model, либо в модели-ссылке.

Не включать блок Data Store Memory в подсистему For Each.

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

Можно использовать Simulink.Signal объекты в сложение или вместо Data Store Memory блоков для определения хранилищ данных. Хранилище данных, заданное в базовом рабочем пространстве с объектом сигнала, является хранилищем глобальных данных. Глобальные данные доступны для каждой модели, включая все модели-ссылки. Для получения дополнительной информации см. раздел «Хранилища данных».

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

Параметры

расширить все

Главный

Укажите имя для хранилища данных, определяемого этим блоком. Data Store Read и Data Store Write блоки с таким же именем могут считывать и записывать в хранилище данных, инициализированное этим блоком. Имя может представлять блок Data Store Memory или объект знака, заданный как хранилище данных.

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

Параметры блоков: DataStoreName
Тип: Вектор символов
Значения: 'A' | ...
По умолчанию: 'A'

Переименуйте это хранилище данных везде, где блоки Data Store Read и Data Store Write используют его в модели.

Ограничения

Вы не можете использовать Rename All для переименования хранилища данных, если:

  • Использование Simulink.Signal объект в рабочей области для управления кодом, сгенерированным для хранилища данных

  • Использование Simulink.Signal объект вместо блока Data Store Memory для определения хранилища данных

Вместо этого необходимо переименовать соответствующий Simulink.Signal объект из Model Explorer. Для получения примера смотрите Переименовать Хранилище Данных, Заданный Объектом Сигнала.

Перечислите все блоки Data Store Read и Data Store Write, которые имеют то же имя хранилища данных, что и текущий блок, и которые находятся в текущей системе или в любой подсистеме под ней в иерархии модели. Щелчок по пути блока отображает и подсвечивает этот блок в вашей модели.

Атрибуты сигнала

Задайте начальное значение или значения хранилища данных. Параметр Minimum задает минимальное значение для этого параметра, а параметр Maximum задает максимальное значение.

Если вы задаете нескалярное значение и устанавливаете Dimensions на -1 (по умолчанию), хранилище данных имеет те же размерности, что и массив. Данные, которые вы записываете в хранилище данных (при помощи блоков Data Store Write), должны иметь эти размерности.

Если вы устанавливаете параметр Dimensions на значение, отличное от -1размеры начальных значений должны совпадать с заданными вами размерностями, если только начальное значение не является скаляром или MATLAB® структура. Если вы задаете скаляр, каждый элемент хранилища данных использует скаляр в качестве начального значения. Используйте этот метод, чтобы применить то же начальное значение (заданный скаляр) к каждому элементу, не совпадая вручную с размерностями начального значения и размерностями хранилища данных.

Чтобы использовать этот блок для инициализации невиртуального сигнала шины, задайте начальное значение как структуру MATLAB и установите параметр конфигурации модели Underspectified initialization detection на Simplified. Для получения дополнительной информации об инициализации невиртуальных сигналов шины с помощью структур, смотрите Задайте Начальные Условия для Элементов Шины.

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

Параметры блоков: InitialValue
Тип: Вектор символов
Значения: скаляр | вектор | матрица | N-D массив
По умолчанию: '0'

Задайте минимальное значение, которое должен выдать блок. Значение по умолчанию [] (не определено). Это число должно быть конечным вещественным двойным скалярным значением.

Примечание

Если вы задаете объект шины в качестве типа данных для этого блока, не устанавливайте минимальное значение для данных шины на блоке. Simulink игнорирует эту настройку. Вместо этого установите минимальные значения для элементов шины объекта шины, заданные как тип данных. Для получения информации о свойстве Minimum элемента шины смотрите Simulink.BusElement.

Simulink® использует минимальное значение для выполнения:

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

Параметры блоков: OutMin
Тип: Вектор символов
Значения: скаляр
По умолчанию: '[ ]'

Задайте максимальное значение, которое должен выдать блок. Значение по умолчанию [] (не определено). Это число должно быть конечным вещественным двойным скалярным значением.

Примечание

Если вы задаете объект шины в качестве типа данных для этого блока, не устанавливайте максимальное значение для данных шины на блоке. Simulink игнорирует эту настройку. Вместо этого установите максимальные значения для элементов шины объекта шины, заданные как тип данных. Для получения информации о свойстве Maximum элемента шины смотрите Simulink.BusElement.

Simulink использует максимальное значение для выполнения:

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

Параметры блоков: OutMax
Тип: Вектор символов
Значения: скаляр
По умолчанию: '[ ]'

Задайте тип выходных данных. Вы можете установить его на:

  • Правило, которое наследует тип данных (для примера, Inherit: auto).

  • Имя встроенного типа данных (для примера, single).

  • Имя объекта типа данных (для примера, a Simulink.NumericType объект).

  • Выражение, которое вычисляется как тип данных (для примера, fixdt(1,16,0)). Не указывайте объект шины в качестве типа данных в выражении; использовать Bus: <object name> для определения типа данных шины.

Нажмите кнопку Show data type assistant, чтобы отобразить Data Type Assistant, которая помогает вам задать атрибуты type данных. Для получения дополнительной информации смотрите Задать типы данных Используя Data Type Assistant.

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

Параметры блоков: OutDataTypeStr
Тип: Вектор символов
Значения: 'Inherit: auto' | 'double' | 'single' | 'half' | 'int8' | 'uint8' | 'int16' | 'uint16' | 'int32' | 'uint32' | 'int64' | 'uint64' | 'boolean' | 'fixdt(1,16,0)' | 'fixdt(1,16,2^0,0)' | 'string' | 'Enum: <class name>'
По умолчанию: 'Inherit: auto'

Выберите этот параметр, чтобы предотвратить переопределение инструментами с фиксированной точкой типа данных Output, заданного на блоке. Для получения дополнительной информации смотрите Использование настройки типа выходных данных блокировки (Fixed-Point Designer).

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

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

Размерности хранилища данных. Значение по умолчанию, -1, позволяет вам задать размерности хранилища данных с помощью параметра Initial value. Однако в этом случае вы не можете использовать скалярное расширение с начальным значением. Необходимо задать начальное значение при помощи массива с нужными размерностями.

Если вы используете значение, отличное от -1задайте те же размерности, что и размерности параметра Initial value, если только вы не задаете начальное значение в виде скаляра (для скалярного расширения) или структуры MATLAB. Если хранилище данных представляет массив шин, и если для начального значения используется структура MATLAB, можно задать размерности, чтобы инициализировать массив шин с этой структурой.

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

Параметры блоков: Dimensions
Тип: Вектор символов
Значения: скаляр | вектор | матрица
По умолчанию: '-1'

Задайте, что хранилище данных интерпретирует начальные значения вектора как одномерные.

По умолчанию MATLAB представляет векторные данные как матрицы, которые имеют две размерности. Для примера MATLAB представляет вектор [1 2 3] как матрица 1 на 3.

Когда вы выбираете этот параметр, хранилище данных представляет векторные данные с использованием только одной размерности вместо двух. Для примера, если вы задаете начальное значение [1 2 3]хранилище данных хранит одномерный вектор с тремя элементами.

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

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

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

Задайте числовой тип, действительный или комплексный, значений в хранилище данных.

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

Параметры блоков: SignalType
Тип: Вектор символов
Значения: 'auto' | 'real' | 'complex'
По умолчанию: 'auto'

В одной иерархии модели-ссылки, когда вы используете несколько блоков Model для обращения к модели, которая содержит блок Data Store Memory, по умолчанию каждый образец модели-ссылки (каждый блок Model) читает и записывает в отдельную копию хранилища данных. Когда вы выбираете Share across model instances, вместо взаимодействия с отдельной копией, все образцы считываются и записываются в то же хранилище данных.

Когда вы устанавливаете параметр конфигурации модели Code interface packaging равным Reusable function чтобы сгенерировать повторный код из модели (Simulink Coder™), хранилище данных с Share across model instances выбранными появляется в коде как глобальный символ, к которому сгенерированная точка входа выполняет прямой доступ. Для примера глобальным символом является глобальная переменная или поле глобальной структурной переменной. Поэтому каждый вызов, который ваш код выполняет в функции точки входа (каждый образец модели), разделяет данные.

Для получения примера см. Раздел «Совместное использование хранилища данных между Образцами переиспользуемого алгоритма». Для получения дополнительной информации см. Раздел «Совместное использование данных между образцами модели-ссылки».

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

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

Укажите, что программное обеспечение Simulink при компиляции модели ищет в рабочем пространстве модели и базовом рабочем пространстве Simulink.Signal объект, имеющий то же имя, как описано в Symbol Resolution. Если Simulink не находит такой объект, компиляция останавливается с ошибкой. В противном случае Simulink сравнивает атрибуты объекта сигнала с соответствующими атрибутами блока Data Store Memory. Если блок и атрибуты объекта противоречивы, Simulink останавливает компиляцию модели и отображает ошибку.

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

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

Диагностика

Выберите диагностическое действие, которое необходимо предпринять, если модель пытается считать данные из хранилища данных, в которое она не записала данные в этот временной шаг. Смотрите также диагностику «Обнаружить чтение перед записью» в разделе «Память хранилища данных» на панели Model Configuration Parameters Diagnostics > Data Validity >.

  • None - Нет ответа.

  • Warning - Отобразите предупреждение и продолжите симуляцию.

  • Error - Завершите симуляцию и отобразите ошибку.

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

Параметры блоков: ReadBeforeWriteMsg
Тип: Вектор символов
Значения: 'none' | 'warning' | 'error'
По умолчанию: 'warning'

Выберите диагностическое действие, которое необходимо предпринять, если модель пытается записать данные в хранилище данных после предварительного чтения данных из него в текущем временном шаге. См. также раздел «Обнаружение записи после чтения» в Data Store Memory block разделе панели Model Configuration Parameters Diagnostics > Data Validity >.

  • None - Нет ответа.

  • Warning - Отобразите предупреждение и продолжите симуляцию.

  • Error - Завершите симуляцию и отобразите ошибку.

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

Параметры блоков: WriteAfterReadMsg
Тип: Вектор символов
Значения: 'none' | 'warning' | 'error'
По умолчанию: 'warning'

Выберите диагностическое действие, которое необходимо предпринять, если модель пытается записать данные в хранилище данных дважды последовательно в текущем временном шаге. См. также раздел «Обнаружение записи после записи» в блоке Data Store Memory на панели Model Configuration Parameters Diagnostics > Data Validity >.

  • None - Нет ответа.

  • Warning - Отобразите предупреждение и продолжите симуляцию.

  • Error - Завершите симуляцию и отобразите ошибку.

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

Параметры блоков: WriteAfterWriteMsg
Тип: Вектор символов
Значения: 'none' | 'warning' | 'error'
По умолчанию: 'warning'

Логгирование

Выберите эту опцию, чтобы сохранить значения этого сигнала в рабочем пространстве MATLAB во время симуляции. Для получения дополнительной информации см. раздел «Регистрация сигналов».

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

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

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

Simulink по умолчанию использует имя сигнала в качестве имени логгирования. Чтобы задать пользовательское имя логгирования, выберите Custom в поле списка и введите пользовательское имя в соседнем поле редактирования.

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

Параметры блоков: DataLoggingNameMode
Тип: Вектор символов
Значения: 'SignalName' | 'Custom'
По умолчанию: ''

Примечание

Если вы задаете DataLoggingNameMode на Custom, необходимо указать имя, сопоставленное с записанными данными сигнала с помощью DataLoggingName параметр.

Параметры блоков: DataLoggingName
Тип: Вектор символов
Значения: Вектор символов
По умолчанию: ''

Отменить все, кроме последнего N точки данных, где N - это номер, который вы вводите в соседнем поле редактирования. Для получения дополнительной информации см. раздел Журнал хранилищ данных.

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

Параметры блоков: DataLoggingMaxPoints
Тип: Вектор символов
Значения: ненулевое целое число
По умолчанию: '5000'

Регистрируйте каждую Nпервая точка данных, где N - это номер, который вы вводите в соседнем поле редактирования. Например, предположим, что ваша модель использует решатель с фиксированным шагом с размером шага 0.1 s. Если вы выбираете эту опцию и принимаете значение десятикратного уменьшения по умолчанию (2), Simulink регистрирует точки данных для этого сигнала в разы 0.0, 0.2, 0.4и так далее. Для получения дополнительной информации см. раздел Журнал хранилищ данных.

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

Параметры блоков: DataLoggingLimitDataPoints
Тип: Вектор символов
Значения: ненулевое целое число
По умолчанию: '2'

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

Типы данных

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

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

yes

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

yes

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

no

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

no

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

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

..

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

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