FMUCS – Import modelu FMU CS (pro Co-Simulation)

Symbol blokuPotřebná licence: ADVANCED
PIC

Popis funkce
Blok FMUCS umožnuje simulovat dané FMU ve formátu Co-Simulation (tj. včetně FMU, obsahujícího kromě modelu i simulační solver).

V parametru FMUPath je uložena úplná cesta k souboru modelu s příponou .FMU na počítači, kde je tento blok konfigurován. Tento blok předpokládá, že načtený model má maximálně 16 vstupů (symbolicky označených u1..u16), 16 výstupů (y1..y16) a 16 parametrů (p1..p16), které jsou po načtení modelu namapovány na jim pořadím odpovídajícím vstupům, výstupům a parametrům modelu FMU, které lze zjistit pomocí informačního bloku FMUINFO. Protože FMU může mít velký počet parametrů, lze jich pro mapování zvolit jen několik pomocí seznamu SelPars, jehož význam je popsán v bloku FMUINFO. Všechny vstupy u1..u16, výstupy y1..y16 i parametry p1..p16 jsou typu Double (F64), který odpovídá typu fmu2Real ze specifikace [5]. Pokud má některý z těchto signálů v dané FMU typ fmu2Integer nebo fmu2Boolean, je v tomto bloku na tento typ automaticky zkonvertován. Signály typu fmu2String nejsou v tomto bloku podporovány.

První dva vstupy řídí běh simulace. Logický vstup R1 umožňuje resetovat (inicializovat) simulaci do počátečních podmínek. Náběžnou hranou (0 1) tohoto vstupu se simulace zastaví, sestupnou hranou (1 0) se simulace spustí z počátečních podmínek od simulačního času 0. Hodnota logického vstup HLD = 1 umožňuje pozastavit simulaci, je-li HLD = 0 simulace běží (tj. i v případě, že vstup HLD není připojen).

Výstup iE indikuje výskyt chyby simulace, pokud jeho hodnota je nenulová. Vyskytne-li se při simulaci chyba, simulace se ukončí až do nového startu simulačního systému. Druhý výstup yFMU obsahuje odkaz na načtenou FMU. Tento odkaz může být připojen na vstup bloku FMUINFO, který umožní získat počáteční informace o FMU. Odpojením tohoto odkazu od bloku FMUINFO se žádné informace nevyhodnocují, což může start simulace zrychlit.

Zbylé parametry bloku FMUCS slouží pro řízení běhu simulace. Pokud je logický vstup TSTOPDEF = 1, bude experiment ukončen v čase tstop, po němž se hodnoty výstupů nemění (jako by byla nastaven vstup HLD = 1) až do následujícího resetu vstupem R1. Parametr eps určuje přesnost simulace.

Parametr loglevel určuje závažnost výpisů, které budou ukládány při běhu simulačního systému do systémového logu. Je třeba dát pozor na to, že velké množství výpisů během probíhající simulace tuto simulaci značně zpomaluje, a proto je vhodné množství výpisů ukládaných do systémového logu vizuálně zkontrolovat!

FMI 2.0 zavádí, kromě obyčejných parametrů, ještě tzv. laditelné parametry (tunable parameters). Obyčejné parametry lze nastavit ve fázi inicializace modelu (před zahájením vlastní simulace), kdežto laditelné parametry lze měnit i mezi jednotlivými simulačními kroky. Tento požadavek specifikace FMI 2.0 však některé simulační systémy nerespektují, např. OpenModelica. Proto byl v tomto bloku zaveden logický parametr TUNEALLP. Pokud je jeho hodnota nulová, nastavují se před každým simulačním krokem pouze laditelné parametry. Je-li TUNEALLP = 1, považují se všechny vybrané parametry (pomocí parametru SelPars) za laditelné, a proto se blok před každým simulačním krokem pokouší nastavit všechny.

Vstupy

R1

Reset bloku

Bool

HLD

Podržení aktuálního stavu modelu

Bool

u1..u16

Vstupní signály daného FMU

Double (F64)

Výstupy

iE

Kód chyby

Error

yFMU

Výstupní odkaz na instanci FMU

Reference

y1..y16

Výstupní signály daného FMU

Double (F64)

Parametry

tstop

Koncový čas simulace   1e-06 1.0

Double (F64)

eps

Přesnost aproximace   0.0  1.0 1e-06

Double (F64)

loglevel

Úroveň protokolování knihovny FMI do systémového logu   0  7 2

Long (I32)

0 ....

Nic

1 ....

Fatální chyba

2 ....

Chyba

3 ....

Varování

4 ....

Info

5 ....

Podrobný

6 ....

Ladění

7 ....

Všechno

SelPars

Seznam vybraných parametrů FMU

String

TUNEALLP

Považuj všechny vybrané parametry za laditelné parametry

Bool

p1..p16

Vybrané parametry modelu FMU podle nastavení parametru SelPars

Double (F64)

2023 © REX Controls s.r.o., www.rexygen.com