Main Content

La traduction de cette page n'est pas à jour. Cliquez ici pour voir la dernière version en anglais.

Équations

Écrire des équations pour représenter le comportement de composants personnalisés

La section equations d’un fichier de composant sert à établir les relations mathématiques entre les variables, les paramètres, les entrées et les sorties du composant, le temps de simulation et les dérivées temporelles de chacune de ces entités.

De même, la section equations d’un fichier de domaine sert à établir les relations mathématiques entre les variables Across, les paramètres et les termes intermédiaires du domaine. Les équations de domaine sont propagées aux nœuds du type de domaine correspondant.

La syntaxe des équations de composant et de domaine est la même. Defining Component Equations donne des informations générales sur l’écriture d’équations en langage Simscape™. Domain Equations présente des informations spécifiques aux équations de domaine.

Syntaxe du langage

assertProgram customized run-time errors and warnings
delayReturn past value of operand
derReturn time derivative of operand
equationsDefine component or domain equations
functionReuse expressions in component equations and in member declarations of domains and components
ifSpecify conditional equations, assignments, annotations, and conditional sections in component files
.ifPerform element-wise conditional operations with array-type predicates (depuis R2023b)
integPerform time integration of expression
intermediatesDefine intermediate terms for use in equations
scatteredlookupReturn value based on interpolating unstructured set of data points (depuis R2023a)
tablelookupReturn value based on interpolating set of data points
timeAccess global simulation time
valueConvert variable or parameter to unitless value with specified unit conversion

Rubriques

  • Defining Component Equations

    The purpose of the equations section in a component file is to establish the mathematical relationships between the variables, parameters, inputs, and outputs of the component, the simulation time, and the time derivatives of each of these entities.

  • Simple Algebraic System

    This example shows implementation for a simple algebraic system.

  • Use Simulation Time in Equations

    This example shows how you can access global simulation time from the equation section.

  • Using Conditional Expressions in Equations

    You can specify conditional expressions in equations or conditional assignments to intermediates by using if and .if statements.

  • Using Intermediate Terms in Equations

    Textbooks often define certain equation terms in separate equations, and then substitute these intermediate equations into the main one.

  • Using Lookup Tables in Equations

    You can use the tablelookup function in the equations section of the Simscape file to interpolate input values based on a set of data points in a one-dimensional, two-dimensional, three-dimensional, or four-dimensional table.

  • Programming Run-Time Errors and Warnings

    Use the assert construct to implement run-time error and warning messages for a custom block.

  • Initial Equations

    Specify additional equations to be executed during model initialization only.

  • Simscape Functions

    Use Simscape functions to reuse expressions in equations and member declarations of multiple components.

  • Import Symbolic Math Toolbox Equations

    Example of using Symbolic Math Toolbox™ software to solve the physical equations, generate code in the format appropriate for the Simscape language equation section, and incorporate the generated code into the equation section of a component file.

  • Domain Equations

    Specify additional equations to propagate to all the components that have nodes of the corresponding domain type.