Saturation

Limiter le signal d’entrée aux valeurs de saturation supérieure et inférieure

• 

Bibliothèques :
Simulink / Commonly Used Blocks
Simulink / Discontinuities
HDL Coder / Discontinuities

Description

Le bloc Saturation produit un signal de sortie qui correspond à la valeur du signal d’entrée limité aux valeurs de saturation supérieure et inférieure. Les limites supérieure et inférieure sont spécifiées par les paramètres Upper limit et Lower limit.

Entrée(s)	Sortie(s)
Limite inférieure ≤ valeur d’entrée ≤ limite supérieure	Valeur d’entrée
Valeur d’entrée < limite inférieure	Limite inférieure
Valeur d’entrée > limite supérieure	Limite supérieure

Exemples

Utilisation des blocs Quantizer et Saturation dans sldemo_boiler

Cet exemple montre comment les blocs Quantizer et Saturation sont utilisés dans le modèle ex_sldemo_boiler. Le sous-système ADC numérise la tension analogique d’entrée en :

• Multipliant la tension analogique par 256/5 avec le bloc Gain

• Arrondissant la valeur à l’entier inférieur avec le bloc Quantizer

• Limitant la sortie à un maximum de 255 (la plus grande valeur entière sur 8 bits non signée) avec le bloc Saturation

Exemples étendus

Pendule inversé avec animation

Cet exemple montre comment utiliser Simulink® pour modéliser et animer un système de pendule inversé. Un pendule inversé a son centre de masse au-dessus de son point de pivot. Pour maintenir la stabilité de cette position, le système implémente une logique de contrôle pour déplacer le point de pivot au-dessous du centre de masse quand le pendule commence à tomber. Le pendule inversé est un problème de dynamique classique utilisé pour tester les stratégies de contrôle.

• Ouvrir le modèle

Ports

Entrée(s)

Port_1 — Signal d'entrée

scalaire | vecteur

Signal d’entrée de l’algorithme de limitation de saturation.

Types de données : double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixed point

Sortie(s)

Port_1 — Signal de sortie

scalaire | vecteur

Signal de sortie qui est la valeur du signal d’entrée, la limite supérieure de saturation ou la limite inférieure de saturation.

Types de données : double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixed point

Paramètres

Paramètres principaux

Upper limit — Limite supérieure de saturation du signal d’entrée

0.5 (par défaut) | scalaire | vecteur

Spécifiez la limite supérieure du signal d’entrée. Si le signal d’entrée est supérieur à cette limite, le signal de sortie est réglé sur cette valeur de saturation. Le paramètre Upper limit est converti en type de données de sortie à l’aide des méthodes d’arrondi au plus proche et de saturation. La valeur du paramètre Upper limit doit être supérieure à celle du paramètre Output minimum et inférieure à celle du paramètre Output maximum.

Utilisation programmatique

Paramètre de bloc : UpperLimit

Type : vecteur de caractères

Valeur : scalaire réel ou vecteur

Par défaut : '0.5'

Lower limit — Limite inférieure de saturation du signal d’entrée

-0.5 (par défaut) | scalaire | vecteur

Spécifiez la limite inférieure du signal d’entrée. Si le signal d’entrée est inférieur à cette limite, le signal de sortie est réglé sur cette valeur de saturation. Le paramètre Lower limit est converti en type de données de sortie à l’aide des méthodes d’arrondi au plus proche et de saturation. La valeur du paramètre Lower limit doit être supérieure à celle du paramètre Output minimum et inférieure à celle du paramètre Output maximum.

Utilisation programmatique

Paramètre de bloc : LowerLimit

Type : vecteur de caractères

Valeur : scalaire réel ou vecteur

Par défaut : '-0.5'

Treat as gain when linearizing — Spécifier la valeur du gain

on (par défaut) | off

Sélectionnez ce paramètre pour que les commandes traitent le gain comme égal à 1. Les commandes de linéarisation de Simulink^® traitent ce bloc comme un gain dans la représentation d’état. Désélectionnez ce paramètre pour que les commandes traitent le gain comme égal à 0.

Utilisation programmatique

Paramètre de bloc : LinearizeAsGain

Type : vecteur de caractères

Valeurs : 'off' | 'on'

Par défaut : 'on'

Enable zero-crossing detection — Activer la détection des passages par zéro

on (par défaut) | off

Sélectionnez pour activer la détection des passages par zéro. Pour plus d’informations, consultez Zero-Crossing Detection.

Utilisation programmatique

Paramètre de bloc : ZeroCross

Type : vecteur de caractères | chaîne de caractères

Valeurs : 'off' | 'on'

Par défaut : 'on'

Sample time (-1 for inherited) — Intervalle entre échantillons

-1 (par défaut) | scalaire | vecteur

Spécifiez l’intervalle de temps entre échantillons. Pour hériter du pas d’échantillonnage, définissez ce paramètre sur -1. Pour plus d’informations, consultez Spécifier les pas d'échantillonnage.

Dépendances

Ce paramètre n’est visible que si vous le définissez sur une valeur différente de -1. Pour en savoir plus, consultez la rubrique Blocks for Which Sample Time Is Not Recommended.

Utilisation programmatique

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

Paramètre :	SampleTime
Valeurs :	"-1" (par défaut) | scalar or vector in quotes

Signal Attributes

Data Type Assistant vous aide à définir les attributs de données. Pour utiliser Data Type Assistant, cliquez sur . Pour plus d’informations, consultez Specify Data Types Using Data Type Assistant.

Output minimum — Valeur minimale de sortie pour la vérification de plage

[] (par défaut) | scalaire

Valeur inférieure de la plage de sortie vérifiée par le logiciel.

Le logiciel utilise la valeur minimale pour effectuer les opérations suivantes :

• Vérification de la plage de paramètres (consultez Specify Minimum and Maximum Values for Block Parameters) pour certains blocs.

• Vérification de la plage de simulation (consultez Specify Signal Ranges et Enable Simulation Range Checking).

• Mise à l’échelle automatique des types de données à virgule fixe.

• Optimisation du code que vous générez à partir du modèle. Cette optimisation peut supprimer du code algorithmique et avoir une incidence sur les résultats de certains modes de simulation tels que SIL ou le mode externe. Pour plus d’informations, consultez Optimize using the specified minimum and maximum values (Embedded Coder).

Conseils

La valeur Output minimum ne sature pas et ne coupe pas le signal de sortie réel. Utilisez le bloc Saturation à la place.

Utilisation programmatique

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

Paramètre :	OutMin
Valeurs :	'[]' (par défaut) | scalar in quotes

Output maximum — Valeur maximale de sortie pour la vérification de plage

[] (par défaut) | scalaire

Valeur supérieure de la plage de sortie vérifiée par le logiciel.

Le logiciel utilise la valeur maximale pour effectuer les opérations suivantes :

• Vérification de la plage de paramètres (consultez Specify Minimum and Maximum Values for Block Parameters) pour certains blocs.

• Vérification de la plage de simulation (consultez Specify Signal Ranges et Enable Simulation Range Checking).

• Mise à l’échelle automatique des types de données à virgule fixe.

• Optimisation du code que vous générez à partir du modèle. Cette optimisation peut supprimer du code algorithmique et avoir une incidence sur les résultats de certains modes de simulation tels que SIL ou le mode externe. Pour plus d’informations, consultez Optimize using the specified minimum and maximum values (Embedded Coder).

Conseils

La valeur Output Maximum ne sature pas et ne coupe pas le signal de sortie réel. Utilisez le bloc Saturation à la place.

Utilisation programmatique

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

Paramètre :	OutMax
Valeurs :	'[]' (par défaut) | scalar in quotes

Output data type — Spécifier le type de données de sortie

Inherit: Same as input (par défaut) | Inherit: Inherit via back propagation | double | single | int8 | int32 | uint32 | int64 | uint64 | fixdt(1,16,2^0,0) | <data type expression> | ...

Spécifiez le type de données de la sortie. Le type peut être hérité, spécifié directement ou exprimé comme un objet de type de données tel qu’un objet Simulink.NumericType. Pour plus d’informations, consultez Control Data Types of Signals.

Utilisation programmatique

Paramètre de bloc : OutDataTypeStr

Type : vecteur de caractères

Valeurs : 'Inherit: Same as input' | 'Inherit: Inherit via back propagation' | 'double' | 'single' | 'int8' | 'uint8' | int16 | 'uint16' | 'int32' | 'uint32' | 'int64' | 'uint64' | fixdt(1,16,0) | fixdt(1,16,2^0,0) | fixdt(1,16,2^0,0) | '<data type expression>'

Par défaut : 'Inherit: Same as input'

Lock output data type setting against changes by the fixed-point tools — Option permettant d’empêcher les outils à virgule fixe de remplacer le types de données Sortie

off (par défaut) | on

Sélectionnez ce paramètre pour empêcher les outils à virgule fixe de remplacer le type de données Output que vous spécifiez sur le bloc. Pour plus d’informations, consultez Use Lock Output Data Type Setting (Fixed-Point Designer).

Utilisation programmatique

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

Paramètre :	LockScale
Valeurs :	'off' (par défaut) | 'on'

Integer rounding mode — Spécifier le mode d’arrondi pour les opérations à virgule fixe

Floor (par défaut) | Ceiling | Convergent | Nearest | Round | Simplest | Zero

Choisissez l’un des modes d’arrondi ci-après.

Ceiling

Arrondit les nombres positifs et négatifs à l’infini positif. Équivalent de la fonction ceil de MATLAB^®.

Convergent

Arrondit le nombre à la valeur représentable la plus proche. En cas d’égalité, arrondit à l’entier pair le plus proche. Équivalent de la fonction convergent de Fixed-Point Designer™.

Floor

Arrondit les nombres positifs et négatifs à l’infini négatif. Équivalent de la fonction floor de MATLAB.

Nearest

Arrondit le nombre à la valeur représentable la plus proche. En cas d’égalité, arrondit à l’infini positif. Équivalent de la fonction nearest de Fixed-Point Designer.

Round

Arrondit le nombre à la valeur représentable la plus proche. En cas d’égalité, arrondit les nombres positifs à l’infini positif et arrondit les nombres négatifs à l’infini négatif. Équivalent de la fonction round de Fixed-Point Designer.

Simplest

Choisit automatiquement entre l’arrondi à l’entier inférieur ou égal le plus proche et l’arrondi à zéro afin de générer un code d’arrondi aussi efficace que possible.

Zero

Arrondit le nombre à zéro. Équivalent de la fonction fix de MATLAB.

Utilisation programmatique

Paramètre de bloc : RndMeth

Type : vecteur de caractères

Valeurs : 'Ceiling' | 'Convergent' | 'Floor' | 'Nearest' | 'Round' | 'Simplest' | 'Zero'

Par défaut : 'Floor'

Voir aussi

Pour plus d’informations, consulter Rounding Modes (Fixed-Point Designer).

Caractéristiques des blocs

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

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).

Génération de code PLC
Générez du texte structuré avec Simulink® PLC Coder™.

Conversion en virgule fixe
Concevez et simulez des systèmes en virgule fixe avec Fixed-Point Designer™.

Historique des versions

Introduit avant R2006a

Voir aussi

Saturation Dynamic | Backlash