If

Sélectionner l’exécution du sous-système en utilisant une logique semblable à l’instruction if-else

• 

Bibliothèques :
Simulink / Ports & Subsystems

Description

Le bloc If, ainsi que les blocs If Action Subsystem qui contiennent un bloc Action Port, implémente la logique if-else pour contrôler l’exécution des sous-systèmes. Pour un exemple qui utilise le bloc If, consultez Select Subsystem Execution.

Exemples

Simulink Subsystem Semantics

This set of examples shows different types of Simulink® Subsystems and what semantics are used when simulating these subsystems. Each example provides a description of the model and the subtleties governing how the model is executed.

• Ouvrir le live script

Blocs If-Then-Else

Cet exemple illustre l'effet de l'introduction d'une onde sinusoïdale dans les blocs If Action Subsystem. Il a pour but de souligner la similitude entre le bloc du sous-système If Action et le bloc Enabled Subsystem.

• Ouvrir le modèle

Modeling Clutch Lock-Up Using If Blocks

Use If/Else subsystems to build a clutch model. An 'If' subsystem models the clutch dynamics in the locked position while an 'Else' subsystem models the unlocked position. One or the other is enabled using the 'If' block. The dot-dashed lines from the 'If' block denote control signals, which are used to enable If/Else (or other conditional) subsystems. Checking any of the boxes on the GUI produces a plot of any of the selected variables (versus time).

• Ouvrir le modèle

Limitations

Remarque

Les limitations répertoriées dans cette section s’appliquent uniquement aux versions R2025b et antérieures.

Le bloc If possède les limitations suivantes :

• Il ne supporte pas les paramètres réglables. Les valeurs d’une expression if ou elseif ne peuvent pas être réglées pendant une simulation en mode normal ou accélérateur, ni pendant l’exécution de code généré.

  Pour implémenter des expressions if-else, réglez l’expression hors du bloc If. Par exemple, utilisez le bloc Relational Operator pour évaluer l’expression hors du bloc If ou ajoutez le paramètre réglable comme entrée au bloc If.

• Il ne supporte pas les classes de stockage personnalisées. Consultez la rubrique Organize Parameter Data into a Structure by Using Struct Storage Class (Embedded Coder).

• Les expressions if et elseif ne peuvent pas accepter certains opérateurs tels que +, -, * et /.

Ports

Entrée

Logical operands — Valeurs pour évaluer les expressions logiques

scalaire | vecteur

Pour les versions R2026a et ultérieures, vous pouvez modifier les étiquettes des ports d’entrée en fonction des expressions logiques utilisées dans le bloc. Pour modifier l’étiquette de port, passez le curseur sur le texte par défaut u1,u2,...,un et modifiez le texte.

Pour les versions R2025b ou antérieures, le bloc accepte uniquement l’étiquette de port d’entrée par défaut u1,u2,...,un. Les entrées u1,u2,...,un doivent avoir le même type de données. Les entrées ne peuvent pas être d’un type défini par l’utilisateur tel qu’un type énuméré.

Le bloc If ne supporte pas directement les types de données à virgule fixe. Cependant, vous pouvez utiliser le bloc Compare To Constant pour contourner cette limitation. Consultez la rubrique Select Subsystem Execution.

Types de données : single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean

Sortie(s)

Action — Signal d’action pour un bloc du sous-système If Action

scalaire

Les sorties des ports if, else et elseif sont des signaux d’action pour les blocs If Action Subsystem.

Paramètres

Number of inputs — Spécifier le nombre de ports d’entrée

1 (par défaut) | entier

1

Spécifiez un port d’entrée.

entier

Spécifiez le nombre de ports d’entrée. Les ports de bloc sont étiquetés avec un caractère 'u' suivi d’un nombre, 1,2,...,n, où n est égal au nombre d’entrées que vous spécifiez.

Utilisation programmatique

Paramètre de bloc : NumInputs

Type : vecteur de caractères

Valeurs : '1' | entier entre guillemets

Par défaut : '1'

Show else condition — Contrôler l’affichage du port Else

on (par défaut) | off

Quand le port if et toutes les expressions de port elseif sont false, le port else envoie un signal d’action pour exécuter le bloc If Action Subsystem relié.

on

Affichez le port else.

off

Masquez le port else.

Utilisation programmatique

Paramètre de bloc : ShowElse

Type : vecteur de caractères

Valeurs : 'on' | 'off'

Par défaut : 'on'

Enable zero-crossing detection — Contrôle de la détection des passages par zéro

on (par défaut) | off

Contrôlez la détection des passages par zéro.

on

Détectez les passages par zéro.

off

Ne détectez pas les passages par zéro.

Utilisation programmatique

Paramètre de bloc : ZeroCross

Type : vecteur de caractères

Valeurs : 'on' | 'off'

Par défaut : 'on'

Provide if-else statements in generated code — Option permettant d’inclure uniquement les instructions if-else dans le code généré à partir d’un bloc If

off (par défaut) | on

Depuis R2025a

Sélectionnez ce paramètre pour que seules les instructions if-else soient incluses dans le code généré à partir d’un bloc If .

on

Seules les instructions if-else sont incluses dans le code généré. Cette option empêche l’inclusion d’instructions switch-case dans le code généré.

off

Lorsque ce paramètre est défini à « off », le code généré à partir d’un bloc If peut contenir des instructions switch-case effectuant les mêmes opérations que le bloc If.

Utilisation programmatique

Pour définir la valeur du paramètre du bloc de manière programmatique, utilisez la fonction set_param.

Paramètre de bloc : EnsureIfElseCode

Type : vecteur de caractères

Valeurs : 'on' | 'off'

Par défaut : 'off'

if — Expression logique

u1 > 0 (par défaut) | expression logique

Le bloc If Action Subsystem relié au port if s’exécute quand l’expression if associée est évaluée à true.

u1 > 0

Spécifiez l’envoi d’un signal d’action sur le port de sortie quand l’entrée u1 est supérieure à 0.

Expression logique (depuis R2026a)

Utilisez diverses expressions logiques, y compris des expressions utilisant :

• Des paramètres réglables.

• Des expressions MATLAB^® générales comme x1 > x2 + 5.

• Des objets de données comme Simulink.Parameter et Simulink.Signal avec des classes de stockage personnalisées. Pour plus d’informations, consultez Create and Apply Storage Class Defined in User-Defined Package (Embedded Coder).

• Un type de données à virgule fixe.

• Un type de données énumérées.

• Des tableaux de structures MATLAB.

• Des expressions contenant :

  • Des fonctions arithmétiques : ceil, floor, abs et sign.

  • Des fonctions trigonométriques : sin, cos, tan, asin, acos, atan, atan2, sinh, cosh et tanh.

  • Des fonctions exponentielles, logarithmiques et racines : log, log10, exp et sqrt.

Expression logique (R2025b et versions antérieures)

Remarque

À partir de la version R2025a, pour modifier l’expression if par défaut (u1 > 0), utilisez le tableau Expressions. Pour une expression complexe comprenant plusieurs entrées et opérateurs, sélectionnez l’expression if et modifiez-la dans la zone Expression editor.

Pour les versions antérieures à la version R2025a, ce paramètre figure en tant que If expressions dans la boîte de dialogue du bloc. Vous pouvez spécifier des expressions logiques avec ce paramètre.

Cependant, dans toutes les versions de Simulink^®, cette expression apparaît sur le bloc If adjacent au port de sortie if.

L’expression ne peut inclure que les opérateurs <, <=, ==, ~=, >, >=, &, |, ~, () et unary-minus. Les opérateurs tels que +, -, *, / et ^ ne sont pas autorisés. L’expression ne doit pas contenir d’expressions de type de données, par exemple int8(6), et ne doit pas faire référence à des variables d’espace de travail dont le type de données est différent de double ou de single.

Utilisation programmatique

Paramètre de bloc : IfExpression

Type : vecteur de caractères

Valeurs : 'u1 > 0' | expression logique entre guillemets

Par défaut : 'u1 > 0'

elseif — Expression logique

vide (par défaut) | liste d’expressions logiques

Le bloc If Action Subsystem relié à un port elseif s’exécute quand l’expression elseif associée est évaluée à true et que toutes les expressions if et elseif sont fausses.

vide

Expressions logiques non spécifiées.

Liste des expressions logiques (depuis R2026a)

• Utilisez diverses expressions logiques qui n’étaient pas supportées auparavant, y compris des expressions utilisant :

  • Des paramètres réglables.

  • Des expressions MATLAB générales comme x1 > x2 + 5.

  • Des objets de données comme Simulink.Parameter et Simulink.Signal avec des classes de stockage personnalisées. Pour plus d’informations, consultez Create and Apply Storage Class Defined in User-Defined Package (Embedded Coder).

  • Un type de données à virgule fixe.

  • Un type de données énumérées.

  • Des tableaux de structures MATLAB.

  • Des expressions contenant :

    • Des fonctions arithmétiques : ceil, floor, abs et sign.

    • Des fonctions trigonométriques : sin, cos, tan, asin, acos, atan, atan2, sinh, cosh et tanh.

    • Des fonctions exponentielles, logarithmiques et racines : log, log10, exp et sqrt.

Expressions logiques (R2025b et versions antérieures)

Remarque

À partir de la version R2025a, pour ajouter et modifier des expressions elseif, utilisez le tableau Expressions. Utilisez les boutons d’action à gauche du tableau pour ajouter, supprimer et déplacer des expressions. Le tableau vous permet de rédiger chaque expression elseif séparément plutôt que sous forme de liste séparée par des virgules. Vous pouvez ainsi organiser les expressions selon vos exigences de modélisation. Pour une expression complexe comprenant plusieurs entrées et opérateurs, sélectionnez la ligne qui contient l’expression elseif en question et modifiez-la dans la zone Expression editor.

Pour les versions antérieures à la version R2025a, ce paramètre figure en tant que Else expressions dans la boîte de dialogue du bloc. Dans ces versions, spécifiez une liste d’expressions logiques séparées par des virgules.

Cependant, dans toutes les versions de Simulink, les expressions apparaissent sur le bloc If sous le port if et au-dessus du port else quand vous cochez la case Show else condition.

Les expressions ne peuvent inclure que les opérateurs <, <=, ==, ~=, >, >=, &, |, ~, () et unary-minus. Les opérateurs tels que +, -, *, / et ^ ne sont pas autorisés. Les expressions ne doivent pas contenir d’expressions de type de données, par exemple int8(6), et ne doivent pas faire référence à des variables d’espace de travail dont le type de données est différent de double ou de single.

Utilisation programmatique

Paramètre de bloc : ElseIfExpressions

Type : vecteur de caractères

Valeurs : '' | liste d’expressions logiques séparées par des virgules et placées entre guillemets

Par défaut : ''

Caractéristiques des blocs

Types de données	Boolean | double | integer | single
Traversée directe	oui
Signaux multidimensionnels	non
Signaux de taille variable	non
Détection des passages à zéro	oui

En savoir plus

Couverture du modèle

Les blocs If qui entraînent l’exécution d’un bloc If Action Subsystem reçoivent la couverture des conditions, des décisions et des conditions/décisions modifiées (MCDC). De plus :

• La condition if et chaque condition elseif, si elles existent, reçoivent la couverture des décisions.

• Toute condition if ou elseif qui contient une expression logique avec plusieurs conditions, telle que u1 && u2, reçoit également la couverture des conditions et MCDC pour chaque condition de l’expression.

• La condition else ne reçoit pas directement de couverture. Le cas faux de la condition if ou de la dernière condition elseif, s’il existe, est le cas vrai de la condition else, et vice versa. La couverture complète du reste du bloc If implique par conséquent la couverture complète de la condition else.

Simulink Coverage™ indique le nombre total de pas de temps où chaque condition if et elseif est évaluée comme vraie et comme fausse. Si la condition if ou elseif est évaluée au moins une fois comme vraie et au moins une fois comme fausse, la couverture des décisions est de 100 %. Si aucune condition if ou elseif n’est vraie, ou si aucune condition if ou elseif n’est fausse, la couverture des décisions est de 50 %. Si la condition if ou elseif précédente n’est fausse à aucun pas de temps, une condition elseif peut avoir une couverture des décisions de 0 %.

Étant donné que le bloc If compare ses signaux d’entrée, si vous sélectionnez la mesure de couverture Relational Boundary, le bloc If reçoit la couverture des limites relationnelles. Pour plus d’informations, consultez Relational Boundary Coverage (Simulink Coverage).

Le rapport de couverture affiche l’expression évaluée par Simulink Coverage et indique le nombre de pas de temps où l’expression est vraie et fausse. Prenons l’exemple d’un bloc If qui évalue si l’entrée est différente de zéro. Le rapport de couverture affiche if(u1 ~= 0) en tant que décision.

Capacités étendues

Génération de code C/C++
Générez du code C et C++ avec Simulink® Coder™.

Génération de code HDL

Générez du code VHDL, Verilog et SystemVerilog pour les designs FPGA et ASIC avec HLD Coder™.

HDL Coder™ fournit des options de configuration supplémentaires qui influent sur l’implémentation HDL et la logique synthétisée.

Architecture HDL

Ce bloc a une architecture HDL par défaut.

Propriétés de bloc HDL

ConstrainedOutputPipeline	Nombre de registres à placer aux sorties en déplaçant les retards au sein de votre design. Le pipelining distribué ne redistribue pas ces registres. La valeur par défaut est 0. Pour en savoir plus, consultez ConstrainedOutputPipeline (HDL Coder).
InputPipeline	Nombre d’étapes de pipelines d’entrée à insérer dans le code généré. Le pipelining distribué et le pipelining de sortie sous contrainte peuvent déplacer ces registres. La valeur par défaut est 0. Pour en savoir plus, consultez InputPipeline (HDL Coder).
OutputPipeline	Nombre d’étapes de pipelines de sortie à insérer dans le code généré. Le pipelining distribué et le pipelining de sortie sous contrainte peuvent déplacer ces registres. La valeur par défaut est 0. Pour en savoir plus, consultez OutputPipeline (HDL Coder).
SynthesisAttributes	Spécifie les attributs de synthèse des blocs et des signaux de sortie des blocs du modèle. Le code HDL généré contient ces attributs. Pour plus d’informations, consultez SynthesisAttributes (HDL Coder).

Historique des versions

Introduit avant R2006a

R2026a: Spécifier des attributs de synthèse pour les blocs et les signaux de sortie des blocs

Utilisez la propriété de bloc HDL SynthesisAttributes pour spécifier les attributs de synthèse du bloc et de ses signaux de sortie. HDL Coder inclut ces attributs dans le code HDL généré.

R2026a: Amélioration du port d’entrée et du support des expressions logiques

À partir de la version R2026a, le bloc vous permet de :

• Personnaliser l’étiquette du port d’entrée du bloc If selon vos exigences de modélisation. Auparavant, vous pouviez seulement utiliser les noms par défaut tels que u1, u2, etc. pour l’étiquette du port d’entrée.

• Utiliser diverses expressions logiques qui n’étaient pas supportées auparavant pour les conditions if et elseif. Pour plus d’informations sur la liste des expressions, consultez le paramètre if.

R2025a: Amélioration de la boîte de dialogue des blocs et de la génération de code

• La boîte de dialogue des blocs a été modifiée pour vous permettre de spécifier les expressions logiques dans un tableau. Vous n’avez plus besoin de spécifier les expressions elseif dans une liste séparée par des virgules. Ce changement rend le déroulement logique plus facile à visualiser et à analyser dans son ensemble. Le tableau contient de nouveaux boutons d’action permettant d’ajouter, de supprimer et de déplacer des expressions if-else vers le haut et vers le bas. Ces boutons vous aident à organiser les expressions selon vos exigences de modélisation. De plus, la nouvelle zone d’édition d’expression vous permet de modifier les expressions complexes.

• Le code généré contient des expressions if-else. Ce changement empêche l’inclusion d’instructions switch-case et améliore la lisibilité du code généré.

Voir aussi

Subsystem | Action Port | If Action Subsystem

Rubriques

• Sélectionner l’exécution de sous-systèmes