Math Function
MathLe bloc MathFunction applique une opération mathématique analytique ou d'arrondi sur un signal scalaire d'entrée . Le panel de fonctions intègre l'exponentielle, les logarithmes (naturel et décimal), la puissance, le reste modulo et les arrondis entiers (au plus proche, floor, ceil). Il est massivement utilisé dans la modélisation de procédés physiques (cinétique chimique, thermodynamique, traînée aérodynamique, conversion de décibels en acoustique) et le traitement du signal sans nécessiter de bloc de code personnalisé.
Modèle Mathématique
Le bloc calcule la sortie en fonction du signal d'entrée et du paramètre secondaire constant () :
Le comportement analytique de chaque fonction s'établit comme suit :
- Exponentielle (
exp) :
```latex
y(t) = \exp(u(t)) = e^{u(t)}
```
- Logarithme naturel (
log) :
```latex
y(t) = \ln(u(t)), \quad u(t) > 0
```
Pour les entrées non positives (), le bloc renvoie pour prévenir la propagation de valeurs NaN non gérées.
- Logarithme décimal (
log10) :
```latex
y(t) = \log_{10}(u(t)), \quad u(t) > 0
```
Renvoie pour .
- Puissance (
pow) :
```latex
y(t) = (u(t))^c
```
Élève la base à l'exposant constant (). Les bases négatives avec exposants non entiers génèrent NaN.
- Reste flottant (
rem) :
```latex
y(t) = u(t) \bmod c = u(t) - c \cdot \operatorname{trunc}\left(\frac{u(t)}{c}\right)
```
Calcule le reste avec protection contre la division par zéro (renvoie si ).
- Arrondi au plus proche (
round) :
```latex
y(t) = \operatorname{round}(u(t))
```
Arrondit à l'entier le plus proche.
- Partie entière par défaut (
floor) :
```latex
y(t) = \lfloor u(t) \rfloor
```
Arrondit à l'entier immédiatement inférieur ou égal.
- Partie entière par excès (
ceil) :
```latex
y(t) = \lceil u(t) \rceil
```
Arrondit à l'entier immédiatement supérieur ou égal.
Entrées & Sorties
| Direction | ID | Label | Type | Status |
|---|---|---|---|---|
| → In | in |
Input | number | Required |
| ← Out | out |
Output | number | Output |
Paramètres
| Paramètres | Label | Type | Défaut | Description |
|---|---|---|---|---|
function |
Function | select | exp |
|
constant |
Constant (n) | number | 2 |
Exemples d'Utilisation
Exemple 1 : Cinétique réactionnelle chimique selon la loi d'Arrhenius
En génie des réacteurs chimiques, la constante de vitesse de réaction varie exponentiellement avec la température selon la loi d'Arrhenius . L'injection du terme d'activation adimensionnel dans un bloc MathFunction avec function = "exp" multiplié par le facteur pré-exponentiel modélise fidèlement la cinétique.
Exemple 2 : Conversion de pression acoustique en décibels (dB SPL)
En acoustique, la pression efficace est convertie en décibels par rapport au seuil d'audibilité () : . Diviser la pression mesurée par , relier le rapport à MathFunction avec function = "log10" et appliquer un gain de 20 délivre le niveau sonore étalonné.
Remarques & Bonnes Pratiques
- Protection de domaine logarithmique : Pour des entrées négatives ou nulles (),
logetlog10renvoient au lieu de NaN, ce qui permet à des blocs Saturation ou MinMax aval d'écrêter proprement le signal. - Protection contre la division par zéro : Pour la fonction
rem, si , le bloc retourne pour neutraliser toute erreur de division flottante. - Exposants fractionnaires : Les exposants non entiers sur base négative produisent NaN en arithmétique réelle. Pour l'extraction de racines avec gestion personnalisée des nombres négatifs, préférez le bloc SquareRoot.
- Exécution sans état en WebAssembly : Exécuté sous forme d'instructions machines natives compilées en Rust sans allocation mémoire, consommant moins de 5 ns par évaluation.
Composants Associés
- SquareRoot: Bloc dédié au calcul de racines n-ièmes avec traitement des entrées négatives.
- Trigonometric: Fonctions trigonométriques et hyperboliques (, , , etc.).
- Abs: Valeur absolue et extraction de signe.
- Gain: Multiplication linéaire par un facteur constant.