Документация

Обзор

В SimBiology событие является дискретным переходом в значении количества или выражения в модели. Этот дискретный переход происходит, когда индивидуально настраиваемое условие становится верным. Условием может быть определенное время и/или независимое от времени условие. Такие условия заданы в Event object.

Триггеры события

Объект-событие имеет a Trigger свойство, которое задает условие, которое должно быть верно, чтобы инициировать событие, чтобы выполниться.

Типичные триггеры события:

Функции события

Событие имеет EventFcns свойство, которое задает то, что происходит, когда событие инициировано. Функции события могут расположиться от простого, чтобы объединить. Например, событие функциональная сила:

Определение триггеров события

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

Триггер может содержать ключевое слово time и операторы отношения, чтобы инициировать событие, которое происходит в определенное время во время симуляции. Например, time >= x. Для получения дополнительной информации смотрите Trigger свойство.

Используйте синтаксис MATLAB^®, чтобы записать выражения для триггеров события. Обратите внимание на то, что выражение должно быть одним выражением MATLAB, которое возвращает логическое. Никакая точка с запятой или запятая не необходимы в конце выражения. MATLAB использует определенный приоритет оператора, чтобы выполнить триггерные выражения. Уровни приоритета определяют порядок, в котором MATLAB выполняет выражение. В каждом уровне приоритета операторы имеют одинаковый приоритет и оценены слева направо. Чтобы найти больше информации о том, как операторы отношения и логические операторы оценены, смотрите Реляционные операции и Логические операции.

Некоторые примеры триггеров:

Определение функций события

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

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

Следующее является правилами для записи выражений для функций события:

Решатели симуляции для моделей, содержащих События

Чтобы симулировать модели, содержащие события, используйте детерминированное (ОДУ или SUNDIALS) решатель или стохастический ssa решатель. Другие стохастические решатели не поддерживают события. Для получения дополнительной информации смотрите Выбор Simulation Solver.

Как оценены События

Рассмотрите пример простого события, где вы задаете в 4s, вы хотите присвоить значение 10 к разновидностям A.

В time = 4 s триггер становится верным, и событие выполняется. На предыдущем рисунке, принимающем тот 0 является ложным и 1 верно, когда триггер становится верным, сумма разновидностей A установлен в 10. В теории, с совершенным решателем, событие было бы выполнено точно в time = 4.00 s. На практике существует очень мелкая задержка (например, вы можете заметить, что событие выполняется в time = 4.00001 s). Таким образом необходимо указать, что триггер может стать верным в или после 4s, который является time >= 4 s.

Точка, в которой триггер становится верным, называется rising edge. События SimBiology^® выполняют EventFcn только в возрастающих ребрах.

Триггер оценен на каждом временном шаге, чтобы проверять, задало ли условие в триггерных переходах от лжи до истины. Решатель обнаруживает и отслеживает falling edges, который является, когда триггер становится ложным, поэтому если с другим возрастающим ребром сталкиваются, событие повторно выполняется. Если триггер уже верен, прежде чем симуляция запустится, то событие не выполняется в начале симуляции. Событие не выполняется, пока решатель не сталкивается с возрастающим ребром. Очень редко решатель может пропустить возрастающее ребро. Пример этого - когда возрастающее ребро следует очень быстро после падающего ребра и результатов размера шага в решателе, пропускающем точку перехода.

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

Оценка одновременных Событий

Когда два или больше триггерных условия одновременно становятся верными, решатель выполняет события последовательно в порядке, в котором они перечислены в модели. Можно переупорядочить события с помощью reorder метод. Например, рассмотрите этот случай.

Решатель пытается найти возрастающее ребро для этих событий в определенном уровне допуска. Если это приводит к обоим событиям, происходящим одновременно, то значение SpeciesB после того, как временным шагом, в котором эти два события имеют место, будет 25. Если вы переупорядочиваете события, чтобы инвертировать порядок события, то значение SpeciesB после того, как временным шагом, в котором эти два события имеют место, будет 10.

Рассмотрите пример, в который вы включаете функции события, которые изменяют компоненты модели зависимым способом. Например, функция события в Событии 2, предусматривает тот SpeciesB принимает значение SpeciesC.

Событие 1 и Событие 2 могут или не могут произойти одновременно.

Оценка нескольких функций события

Рассмотрите функцию события, в которой вы указываете что значение компонента модели (SpeciesB) зависит от значения компонента модели (SpeciesA), но SpeciesA также изменяется функцией события.

Решатель хранит значение SpeciesA в возрастающем ребре и прежде чем выполняются любые функции события, и использует эту хранимую сумму, чтобы присвоить SpeciesB его значение. Таким образом в этом примере, если SpeciesA = 15 в то время, когда событие инициировано, после того, как событие выполняется, SpeciesA = 10 и SpeciesB = 15.

Когда одно событие инициировало другое событие

В следующем примере Событие 1 включает выражение, в конечном счете функционируют, который заставляет Событие 2 быть инициированным (принимающий тот SpeciesA имеет сумму меньше, чем 5 когда Событие 1 выполняется).

Когда Событие 1 инициировано, решатель оценивает и выполняет Событие 1 так что в итоге SpeciesA = 10 и SpeciesB = 5. Теперь триггер для События 2 становится верным, и решатель выполняет функцию события для События 2. Таким образом, SpeciesC = 5 в конце этого выполнения события.

У вас могут таким образом быть каскады события произвольной длины, например, Событие 1 инициировало Событие 2, которое в свою очередь инициировало Событие 3 и так далее.

Циклические События

В некоторых ситуациях серия событий может инициировать каскад, который становится цикличным. Если вы инициировали циклический набор событий, единственный способ остановить симуляцию путем нажатия Ctrl+C. Вы теряете любые данные, полученные в текущей симуляции. Вот пример циклических событий. Этот пример принимает тот Species B <= 4 в начале цикла.

Используя События, чтобы обратиться к разрывам в выражениях правила и скорости реакции

Решатели, которым предоставляют SimBiology, дают неточные результаты, когда следующие выражения не непрерывны и дифференцируемы:

Или гарантируйте, что предыдущие выражения непрерывны и дифференцируемы или используют события, чтобы сбросить решатель в разрыве, как описано в Детерминированной Симуляции Модели, Содержащей Разрыв.