result = fmiCoSimulate(fmu, tStop)
result = fmiCoSimulate(fmu, tStop, dt)
result = fmiCoSimulate(fmu, tStop, dt, inputs)
| Paramètre | Description |
|---|---|
| fmu | une chaîne de caractères : le chemin d'une archive .fmu, ou d'un répertoire de FMU déjà extrait. La FMU doit fournir l'interface de co-simulation (voir fmiInfo). |
| tStop | un scalaire réel strictement positif : l'instant d'arrêt de la simulation, dans l'unité de temps de la FMU (secondes). La simulation débute à l'instant 0. |
| dt | un scalaire réel strictement positif optionnel : le pas de communication. En son absence il vaut par défaut tStop / 100 (cent pas). Il est ramené à tStop s'il est plus grand. |
| inputs | une structure scalaire optionnelle dont les noms de champs sont des variables d'entrée Float64 de la FMU et les valeurs les valeurs constantes maintenues sur ces entrées pendant toute l'exécution, par exemple struct('u', 2.5). Les entrées non listées conservent leurs valeurs initiales. |
| Paramètre | Description |
|---|---|
| result | une structure scalaire contenant la trajectoire enregistrée, avec les champs time, outputNames et outputs décrits ci-dessous. |
fmiCoSimulate exécute une co-simulation d'une unité de maquette fonctionnelle (FMU) conforme au standard FMI 2.0 ou 3.0 et renvoie les valeurs de chaque sortie Float64 à chaque point de communication.
La FMU est instanciée, initialisée entre les instants 0 et tStop, puis avancée avec un pas de communication fixe dt. Au début de chaque pas les sorties Float64 courantes sont enregistrées ; la FMU est ensuite avancée d'un pas. La boucle s'arrête à tStop, ou plus tôt si la FMU demande l'arrêt. La FMU est toujours terminée et libérée avant le retour de la fonction, y compris en cas d'erreur.
Aucune entrée externe n'est appliquée : les paramètres et les entrées de la FMU conservent les valeurs initiales déclarées dans sa description de modèle. La fonction reproduit donc la réponse libre du modèle tel qu'empaqueté. L'application d'entrées personnalisées n'est pas encore prise en charge par ce point d'entrée.
L'argument fmu accepte aussi bien une archive .fmu qu'un répertoire déjà extrait. Une archive .fmu est décompressée avec un extracteur durci contre le ZIP-slip dans un répertoire temporaire neuf, supprimé automatiquement au retour de la fonction ; les entrées comportant un chemin absolu, une lettre de lecteur ou une remontée .. sont rejetées.
La structure renvoyée result comporte les champs suivants :
| Champ | Taille | Détails |
|---|---|---|
| time | N x 1 | les points de communication, débutant à 0 et strictement croissants par pas de dt (le dernier point peut être plus court lorsque la FMU s'arrête prématurément). |
| outputNames | 1 x nOut | un tableau de cellules des noms des variables de sortie Float64, dans l'ordre de déclaration. |
| outputs | N x nOut | les valeurs de sortie enregistrées ; la colonne j est la trajectoire de outputNames{j}, la ligne i correspond à time(i). |
Le nombre de lignes N vaut floor(tStop / dt) + 1 pour une exécution qui se termine à tStop. Lorsque la FMU ne déclare aucune sortie Float64, outputNames est vide et outputs possède zéro colonne, tandis que time est tout de même renvoyé.
Utilisez d'abord fmiInfo pour inspecter les variables et confirmer la présence de l'interface de co-simulation. Une erreur est levée lorsque tStop n'est pas strictement positif, lorsque la FMU ne gère pas la co-simulation, ou lorsqu'un appel FMI échoue.
result = fmiCoSimulate('VanDerPol.fmu', 20)r = fmiCoSimulate('VanDerPol.fmu', 20, 0.01);
plot(r.time, r.outputs);
legend(r.outputNames);
xlabel('temps');
title('Sorties de co-simulation FMU');r = fmiCoSimulate('VanDerPol.fmu', 20, 0.01);
col = find(strcmp(r.outputNames, 'x0'));
x0 = r.outputs(:, col);fmu = [modulepath('nflow_fmi', 'root'), '/examples/Feedthrough.fmu'];
r = fmiCoSimulate(fmu, 2, 0.1, struct('Float64_continuous_input', 2.5));
col = find(strcmp(r.outputNames, 'Float64_continuous_output'));
r.outputs(end, col)| Version | Description |
|---|---|
| 2.0.0 | version initiale |