1.) Systém pro prezentaci modelů

1.1.) Popis systému

Tento systém byl vytvořen jako univerzální prostředek pro prezentaci modelů vytvořených v prostředí Matlab-Simulink. Systém je koncipován jako otevřený a umožňuje instalovaný okruh modelů kdykoliv snadno rozšířit. Nespornou výhodou je možnost systém doplnit o jakýkoliv model vytvořený v prostředí Simulinku. Základnu modelů je tudíž možno kdykoliv velmi rychle doplnit o modely z různých kategorií. Ke každému zásahu do systému je však nutná alespoň minimální znalost Matlabu.
     Samozřejmostí je i jednoduché a intuitivní ovládání bez nutnosti neustálého nahlížení do dokumentace. Velký důraz byl kladen na využití systému pro výukové účely. Systém nabízí možnosti prezentace a studie modelů formou interaktivních demo prezentací s komentáři pro rychlé seznámení uživatelů s modely. Instalované modely jsou prezentovány formou blokových schémat v prostředí Simulinku. Systém navíc poskytuje uživatelům možnost se blíže seznámit s modelováním samotných modelů. Modely jsou pro jednodušší srozumitelnost rozděleny na blokové části. Každá část je doplněna aktivními odkazy na matematické vztahy, které danou část modelují. Uživatel tak má možnost nahlédnout do modelování matematických vztahů v Simulinku.
     Mezi výhody systému patří i jeho snadná přenositelnost a kompatibilita závislá pouze na použité verzi Matlabu. Systém je možno provozovat na verzi Matlabu R14 a vyšší.

1.2.) Ovládání systému

Cílem bylo systém co nejvíce přiblížit potřebám uživatelů. Vzhledem k tomu, že uživatelé systému mohou být lidé se znalostí Matlabu nebo i lidé bez jakýchkoliv zkušeností s ovládáním Matlabu a Simulinku, bylo snahou co nejvíce zjednodušit ovládání systému a umožnit tak uživatelům pohodlnou práci se systémem.
     Celý systém je rozdělen do 4 základních částí. Tyto části tvoří:

První část tvoří hlavní programová nabídka, která tvoří základ systému, umožňuje navigaci mezi modely, spouštění navazujících částí programu a otevírání ostatních nabídek systému. Druhou část tvoří sekce pro práci s modely v Simulinku, která obsahuje základní ovládací prvky pro modely a výukové odkazy na modelované matematické vztahy. Třetí část představuje systém pro demo prezentace, který umožňuje u zvolených modelů interaktivně prohlížet naměřené veličiny včetně výukových komentářů. Poslední část se zabývá nastavením a modifikací parametrů modelů.

1.2.1.) Hlavní programová nabídka

Základ uživatelského rozhraní tvoří hlavní programová nabídka (obr.1.1.), která se zobrazí hned po spuštění programu.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.1. Hlavní nabídka programu

Ovládaní programu je velmi jednoduché a intuitivní. K jednoduché manipulaci s programem slouží hlavní programové menu a ovládací panel s tlačítky.


Obr.1.2. Ovládací panel programu

Pomocí ovládacích tlačítek je možné kdykoliv rychle otevřít dostupnou možnost pro zvolený model nebo zobrazit tuto uživatelskou příručku.

Význam tlačítek panelu:

Hlavní programové menu:


Obr.1.3. Hlavní programové menu

Hlavní programové menu obsahuje pouze následující položky:

1.2.2.) Otevření modelů v Simulinku

Všechny modely instalované v systému jsou zobrazeny v několika základních kategoriích v hlavní stromové struktuře programu. Každý spustitelný model je označen touto ikonou .

Pro otevření modelu v Simulinku nejdříve proveďte jeho výběr (obr.1.4.) v rozbalovací stromové struktuře.


Obr.1.4. Ukázka výběru modelu ze stromové struktury

Jakmile je příslušný model vybrán, prosvítí se tlačítko v hlavním ovládacím panelu programu. Po stisknutí tohoto tlačítka se otevře vybraný model v simulinkovém okně.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.5. Ukázka otevřeného modelu v Simulinku - Model Epidemie AIDS

Celý model je doplněn komentáři, případně významy jednotlivých proměnných pro rychlé seznámení uživatele s modelem. Některé modely navíc obsahují výukové odkazy na matematické vztahy u vybraných částí modelu. Tyto odkazy umožňují uživateli nejen rychlou orientaci v modelu, ale zároveň i lepší náhled na modelování v Simulinku.


Obr.1.6. Ovládací tlačítka modelu

Význam ovládacích tlačítek modelu:

Otevřený model s sebou obvykle přináší další možnosti jako např. zobrazení a editaci parametrů modelu, popis zobrazeného modelu nebo nápovědu s popisem ovládání Simulinku. O tyto činnosti se starají ovládací tlačítka modelu (obr.1.7.).


Obr.1.7. Výukové odkazy

Barva odkazů zde zastává velmi důležitou výukovou roli. Každý simulinkový blok, který se podílí na modelování daného matematického vztahu, je zobrazen ve stejné barvě jako výukový odkaz (obr.1.5.). Po kliknutí na výukový odkaz se otevře odpovídající matematický vztah s popisem modelu.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.8. Výsledek kliknutí na výukový odkaz - rovnice 2.5

1.2.2.1.) Práce s modelem v Simulinku

Pro spuštění simulace vyberte v hlavním menu položku Simulation a v podmenu položku Start. Simulaci je možno předčasně ukončit volbou položky Stop ze stejného podmenu.


Obr.1.9. Menu Simulinku

V případě, že chcete změnit parametry simulace (numerická metoda integrace, krok integrace, celková doba simulace, tolerance), zvolte opět v hlavním menu položku Simulation a podmenu Configuration Parameters. Toto vyvolá otevření menu konfigurace parametrů simulace (obr.1.10.).

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.10. Menu konfigurace parametrů v Simulinku

Změnu parametrů modelu je možno provést dvěma způsoby:

Práci s modelem je možno ukončit následujícími způsoby:

Zobrazování veličin:

Pro sledování průběhu jednotlivých veličin v Simulinku slouží bloky Scope, Graph, Auto-Scale Graph a XY Graph.

Pozn: U některých modelů se mohou vyskytovat jenom některé z nich.

V případě, že si přejete sledovat veličinu v místě, kde není žádný z výše uvedených bloků připojen, můžete si vytvořit kopii z výše uvedených bloků nebo příslušný blok vložit do schématu z knihovny dostupných bloků. Kopii vytvoříte uchopením příslušného bloku pravým tlačítkem myši, držením tlačítka a uvolněňím na příslušném místě ve schématu nebo vyběrem bloku a použití klávesových zkratek CTRL+C a CTRL+V. Poté bude kopie bloku vložena na aktuální pozici kurzoru.

Připojení bloku do schématu můžete provést pomocí kliknutí pravého tlačítka myši na vybraný vodič a tažením spojení ke vstupu sledovacího bloku.

Chcete-li, aby se požadovaný průběh např. v bloku Scope zobrazil, musíte jej před spouštěním simulace otevřít (dvojitým kliknutím).

1.2.3.) Ovládání dema

Demo slouží k prezentaci typických průběhů vybraných veličin získaných simulací. Pro zájemce o hlubší seznámení s modelem jsou určeny bloková schémata modelů v "Simulinku". Nabídka demo prezentace je rozdělena do tří částí (ovládacího panelu dema, grafického okna a textového pole). V pravé horní části je umístěn ovládací panel dema s navigačními tlačítky. Nalevo od ovládacího panelu je zobrazeno grafické okno, které slouží k zobrazování sérií předem naměřených průběhů sledovaných veličin. Textové pole pod grafickým oknem slouží ke stručnému popisu modelu a prezentovaných veličin.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.11. Hlavní program s otevřenou nabídkou demo prezentace

Tlačítka a slouží k navigaci v demu a tlačítko ukončí demo nabídku.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.12. Ukázka demo prezentace – Modifikovaný Kermack-McKendrickův model epidemií

1.2.4.) Nastavení a změna parametrů modelů

Program umožňuje prohlížení i změnu nastavení parametrů u vybraných modelů. Změnu parametrů vybraného modelu je možno provést následujícími způsoby:

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.13. Hlavní program s otevřenou nabídkou nastavení parametrů

Nabidka nastavení parametrů:

Výše uvedený postup otevře nabídku nastavení parametrů. Na obrázku níže je zobrazena ukázka nastavení parametrů pro model Epidemie AIDS.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.14. Nabídka nastavení parametrů pro model “Epidemie AIDS“

Význam tlačítek panelu:

1.3.) Rožšiřování systému

Celý systém byl již od počátku koncipován tak, aby bylo možné okruh prezentovaných modelů kdykoliv rozšířit. Tato kapitola obsahuje všechny potřebné informace pro rozšiřování systému o další modely.

Zásady rozšiřování systému:

V systému platí několik zásad, které je nutno při rozšiřování dodržovat:

1.3.1.) Přidání nového modelu

Přidání nového modelu začíná vytvořením hierarchické adresářové struktury, kterou uživatel následně uvidí v rozbalovací stromové struktuře systému (viz kapitola 1.2.2). Adresářovou strukturu jednoduše vytvoříte přímo v souborovém systému operačního systému použitím např. Windows Průzkumníka nebo programu Total Commander. Každý souborový adresář bude ve stromové struktuře systému zobrazen jako rozbalovací uzel a všechny jeho podadresáře budou zobrazeny jako jeho další hierarchické uzly.

Všechny instalované modely se nacházejí v adresáři "Modely", který naleznete v kořenovém adresáři instalace programu. Pokud otevřete tento adresář, uvidíte základní kategorie modelů, které se uživateli objeví jako hlavní uzly v rozbalovací stromové struktuře. Pro rychlejší pochopení vytváření hierarchické adresářové struktury doporučuji tento adresář důkladně prozkoumat včetně jeho podadresářů. Současná instalace programu obsahuje pouze tyto základní kategorie modelů: Epidemiologicke modely, Fyziologicke modely a Socioekonomicke modely. Můžete buď tyto stávající kategorie rozšířit nebo vytvořit své vlastní kategorie.

Řekněme, že chcete vytvořit novou kategorii modelů např. Nove modely. Tuto novou hlavní kategorii založíte vytvořením adresáře "Nove modely" v adresáři “Modely“. Následně otevřete nově přidaný adresář a vytvořte obdobným způsobem jeho podadresář například pod jménem "Model A". Pokud nyní spustíte systém, bude stromová struktura vypadat obdobně jako obr.1.15.


Obr.1.15. Ukázka stromové struktury po přidání nového modelu

Výše uvedeným způsobem můžete vytvářet libovolně složité hierarchické struktury.

Pokud jste úspěšně vytvořil adresářovou strukturu, přejdeme ke kopírování potřebných souborů. Pro demonstraci využiji výše zmíněný adresář "Model A". Otevřete tento adresář a nakopírujte do něj všechny soubory, které obsahuje nově přidávaný model (soubor s koncovkou .mdl) včetně všech jeho datových souborů (typicky s koncovkou .mat).

Nyní je potřeba vytvořit nový soubor s koncovkou (.m) za využití Matlabu nebo souborového systému, který bude následně zobrazen v rozbalovací stromové struktuře systému a bude představovat váš model. Zde je důležité dodržovat výše zmíněné zásady rozšiřování systému. Soubor musí v názvu obsahovat prefix “Blokove_schema“ a nesmí obsahovat diakritiku a mezery. Je vhodné název souboru zvolit rozumně, protože bude zobrazen v rozbalovací stromové struktuře. Vhodný název je např. Blokove_schema__pulsni_model.m, Blokove_schema_baroflexu.m apod. Na následujícím obr.1.16. je zobrazena typická struktura, kterou musí takovýto soubor obsahovat.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.16. Demonstrační ukázka souboru Blokove_schema__nizsi_promiskuita.m

Obsah tohoto souboru přepište do svého nového souboru nebo jej zkopírujte z ostatních souborů pojmenovaných jako Blokove_schema*****.m. Tyto soubory je možno nalézt v podadresářích adresáře „Modely“. Důležitými informacemi pro vás jsou řádky číslo 4 a 7 z obr.1.16. Začneme řádkem 4, který obsahuje následující příkaz:

     load data1;

Příkaz load nahrává data z MAT-souboru (.mat). Za příkazem následuje název datového souboru (zde data1.mat bez souborové koncovky .mat), který bude použit jako zdroj dat pro model. Nahraďte jej názvem vašeho datového souboru. Např. pokud je název vášeho datového souboru mojedata1.mat, váš řádek v souboru Blokove_schema*****.m bude vypadat následně:

     load mojedata1;

Řádek číslo 7 z obr.1.16. obsahuje následující příkaz:

     run (‘aids’);

Tento příkaz spouští název souboru simulinkového modelu (.mdl) v apostrofech (zde aids.mdl, zapisuje se bez koncovky .mdl), který bude po spuštění nahrán. datového souboru (zde data1.mat bez souborové koncovky .mat), který bude použit pro nahrání dat pro model. Nahraďte jej vaším názvem simulinkového modelu. Např. jestliže je název vašeho modelu muj_model.mdl, bude řádek ve vašem souboru vypadat následovně:

     run(‘muj_model’);

Na obr.1.17. jsou zobrazeny všechny výše uvedené změny v ukázkovém souboru Blokove_schema__ukazkovy_model.m.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.17. Ukázka souboru Blokove_schema__ukazkovy_model.m

Nyní po spuštění systému a rozbalení stromové struktury uvidíte vámi vytvořený název souboru, který po jeho vybrání (obr.1.18.) v rozbalovací stromové struktuře můžete spustit.


Obr.1.18. Ukázka výběru souboru Blokove_schema__ukazkovy_model.m v rozbalovací stromové struktuře systému

1.3.1.1.) Přidání ovládacích tlačítek do modelu

Tato podkapitola se zaměřuje na přidání ovládacích tlačítek do nového modelu v Simulinku. Tato tlačítka byla již blíže popsána v kapitole 1.2.1.


Obr.1.19. Ovládací tlačítka modelu

Pro přidání ovládacích tlačítek do nového modelu, nejdříve otevřete některý z již instalovaných modelů a myší označte ovládací tlačítka, která chcete vložit. Dále stiskněte klávesovou zkratku CTRL+C. Následně otevřete model, do kterého chcete tlačítka vložit a stiskněte klávesovou zkratku CTRL+V. Tlačítka budou poté vložena do modelu.

1.3.2.) Vytvoření demo prezentace

Demo prezentace slouží k interaktivní prezentaci dosažených výsledků na modelu, případně pro výukové účely.

Pro prezentaci výsledků je nutné mít uložena naměřená data na modelu nejlépe v datových souborech. Prezentace dema probíhá formou ukázek naměřených dat v grafech společně s textovými komentáři.

K vytvoření interaktivní demo prezentace pro váš model je nutné mít v adresáři s modelem vložen soubor Demo.m. Typickou strukturu tohoto souboru můžete vidět na obr.1.20.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.20. Demonstrační ukázka souboru Demo.m

Obsah tohoto souboru nebo i celý soubor si jednoduše nakopírujte z libovolného již nainstalovaného modelu. Soubory Demo.m můžete nalézt v podadresářích adresáře “Modely“. Můžete k tomu použít např. soubor Demo.m z následující adresářové cesty:

     <adresarInstalace>\Modely\Epidemiologicke modely\Model Epidemie AIDS

Soubor Demo.m začíná funkcí Demo(Stranka,HndlTxt,HndBtn), která má nasledující vstupní parametry:

     Stranka ... číslo stránky k načtení
     HndlTxt ... ukazatel na komentářové okno v demo prezentaci
     HndBtn ... ukazatel na navigační tlačítko dema

Demo je rozčleněno na samostatné celky, které představují stránky dema. Stránky dema se zde definují pomocí if podmínek. Typická struktura if podmínky vypadá následovně:

     if Stranka==1
          str= str2mat ( 'Popis prvniho kroku v demu',...
                                 'popis grafu apod.');
          set(HndlTxt,'String',str);           %ulozeni popisu do komentare dema
          load vysl2;                                  %nahrani dat pro graf
          plot(0:60/601:60,y(:,1),'r');        %graficke zobrazeni vysledku
     end;

Nejdříve se porovná číslo stránky uložené v proměnné Stranka s číslem v podmínce, pokud neodpovídá jedná se o jinou stránku a program přejde na další podmínku. Tento postup se opakuje až do okamžiku, kdy dojde ke shodě. V tomto případě se začne provádět zdrojový kód v dané if podmínce. Např: Pokud se vstupní parametr Stranka funkce Demo rovná 3, provede se kód v podmínce if Stranka==3 ... end;.

Zdrojový kód podmínky musí obsahovat následující řádek:

     set(HndlTxt,'String',str);

Tento řádek nastavuje komentářovému oknu v demo prezentaci textový komentář k dané stránce, který je uložen v proměnné str (viz. předchozí zdrojový kód if podmínky). Dále obvykle následuje nahrání uložených dat a jejich zobrazení v prezentovaném grafu.

     load vysl2;                                  %nahrani dat pro graf.
     plot(0:60/601:60,y(:,1),'r');        %graficke zobrazeni vysledku

Obdobným způsobem jsou vytvořeny všechny stránky dema. Jediná odlišnost je v poslední stránce dema. Poslední stránka musí obsahovat ve svém zdrojovém kódu následující řádek:

     set(HndBtn,'Userdata',-1);          % !!!povinna soucast ... urcuje konec dema

Tento řádek musí být součástí zdrojového kódu poslední stránky demo prezentace, protože představuje konec prezentace.

Níže je ukázka zdrojového kódu poslední stránky.

     if Stranka==6
          str=str2mat('Popis posledniho kroku dema');
          set(HndlTxt,'String',str);             %ulozeni popisu do komentare dema
          hold on;
          plot(0:60/601:60,y(:,2),'g');          %graficke zobrazeni vysledku + popisky os
          plot(0:60/601:60,y(:,3),'b');
          xlabel('Cas [roky]');ylabel('Počet jedinců v dané skupině');
          title('Vývoj počtu jedinců v jednotlivých skupinách');
          set(HndBtn,'Userdata',-1);          % !!!povinna soucast ... urcuje konec dema
     end;

Zde jsou příklady několika stránek v demu, které jsou zobrazeny jako dvojice "zdrojový kód - náhled v demo prezentaci" (obr.1.21.-1.26.)

Kermack-McKendrickův (KMK) model epidemií - Úvodní strana

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.21. Kermack-McKendrickův (KMK) model epidemií - Úvodní strana - Zdrojový kód

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.22. Kermack-McKendrickův (KMK) model epidemií - Úvodní strana - Demo prezentace

Krevní oběh - Pulsní model - Poslední strana

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.23. Krevní oběh - Pulsní model - Poslední strana - Zdrojový kód

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.24. Krevní oběh - Pulsní model - Poslední strana - Demo Prezentace

Model počtu studentů ve škole - Pulsní model - Strana 4

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.25. Model počtu studentů ve škole - Strana 4 - Zdrojový kód

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.26. Model počtu studentů ve škole - Strana 4 - Demo Prezentace

1.3.3.) Vytvoření nabídky nastavení parametrů

V této kapitole se seznámíme s vytvářením nabídky nastavení parametrů pro nově vložený model. Základ nabídky opět tvoří M-soubor, který musí být umístěn ve stejném adresáři jako model. Tento soubor zde nese název Nastaveni_parametru.m. Jeho typický obsah můžete vidět na obr.1.27.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.27. Demonstrační ukázka souboru Nastaveni_parametru.m

Obsah tohoto souboru nebo i celý soubor si jednoduše nakopírujte z libovolného již nainstalovaného modelu. Soubory Nastaveni_parametru.m můžete nalézt v podadresářích adresáře “Modely“. Můžete k tomu použít např. soubor Nastaveni_parametru.m z následující adresářové cesty:

     <adresarInstalaceSystemu>\Modely\Epidemiologicke modely\Model Epidemie AIDS

Pokud si otevřete tento soubor, uvidíte, že se na jeho začátku objevují if podmínky. Tyto podmínky zde slouží ke kontrole vybraného modelového souboru ve stromové struktuře. Tvorba těchto souborů již byla blíže popsána v kapitole 1.3.1. Podmínky jsou užitečné zejména v případech, kdy máte více datových souborů pro váš model s různými nastaveními parametrů. Příklad takovýchto podmínek můžete vidět na následujícím příkladu.

     if(any(findstr(selectedModel,'Blokove_schema__nizsi_promiskuita'))~=0)
          load data1;
          defaultData='data1';
          modelName='Nastavení parametrů - Epidemie AIDS - nižší promiskuita';
     end

     if(any(findstr(selectedModel,'Blokove_schema__vyssi_promiskuita'))~=0)
          load data2;
          defaultData='data2';
          modelName='Nastavení parametrů - Epidemie AIDS - vyšší promiskuita';
     end

V prvním řádku těchto podmínek probíhá ověření, zda model vybraný v rozbalovací stromové struktuře systému, jehož název je uložen v proměnné selectedModel, odpovídá modelu s daty (zde Blokove_schema__nizsi promiskuita ). Pokud ano nahrají se data (zde data1.mat, v kódu bez koncovky .mat). Pokud při porovnání názvu souboru nedojde ke shodě, kontrola se automaticky přesune na následující podmínku (v tomto případě Blokove_schema__vyssi_promiskuita). V případě shody se nahrají příslušná data atd. Tímto způsobem se zajistí výběr správného datového souboru pro nastavení parametrů. Proměnná defaultData zde slouží pouze pro uložení názvu datového souboru, který bude později využit pro opětovné načtení původních parametrů do nabídky nastavení parametrů v systému. Do této proměnné se vkládá totožný název datového souboru v apostrofech. Například pokud jste jako zdroj parametrů využil datový soubor s názvem modelova_data.mat, budou řádky s nahráním dat a proměnnou defaultData ve vašem souboru vypadat následovně:

     load modelova_data;
     defaultData='modelova_data';

Pokud jako zdroj parametrů využijete M-soubor (např. modelova_data.m), budou tyto řádky ve vašem souboru vypadat takto:

     run modelova_data;
     defaultData='modelova_data';

Proměnná modelName zde představuje uživatelskou proměnnou, pomocí které si uživatel může definovat text, který se zobrazí v horní části nabídky nastavení parametrů v systému. Tento text si můžete libovolně zvolit (obr.1.28.).


Obr.1.28. Ukázka zobrazení proměnné modelName v systému

Následující struktura již slouží ke specifikaci parametrů, které chcete vložit.

     i=1; %index
     [hlabel(i),hedit(i),htextbox(i)]=createParameters('Počáteč. počet zdravých jedinců',x0,'x0',i);i=i+1;
     [hlabel(i),hedit(i),htextbox(i)]=createParameters('Počáteč. počet infikovaných jedinců',y0,'y0',i);i=i+1;

Proměnná i je zde použita jako pořadový index pro jednotlivé parametry. Každý parametr se přidává pomocí funkce createParameters(), která má následující vstupní parametry.

     createParameters(Textový popis proměnné, proměnná obsahující hodnotu parametru, název proměnné, pořadový index)

Prvním z těchto parametrů je textový popis proměnné, který bude zobrazený v textovém okně v nabídce nastavení parametrů v systému. Druhý parametr je proměnná, kterou chcete vložit jako parametr. Váš datový soubor by měl tuto proměnnou obsahovat. Následující třetí parametr pouze obsahuje název této proměnné v apostrofech. Do této položky se vyplňuje název proměnné, který musí být shodný s názvem předchozího parametru. Poslední parametr zde již pouze představuje pořadový index i, který se před nastavením dalšího parametru inkrementuje.

Proměnné hlabel, hedit a htextbox slouží pro zápis handlerů grafických objektů, které jsou vytvořeny funkcí createParameters(). Tyto objekty budou následně zobrazeny v nabídce nastavení parametrů v systému.

     [hlabel(i),hedit(i),htextbox(i)]

Například 3 následující řádky zdrojového kódu, zobrazí 3 parametry v nabídce parametrů v systému (obr.1.29.).

     [hlabel(i),hedit(i),htextbox(i)]=createParameters('Rychlost šíření nemoci',b,'b',i);i=i+1;
     [hlabel(i),hedit(i),htextbox(i)]=createParameters('Rychlost překonání nemoci',c,'c',i);i=i+1;
     [hlabel(i),hedit(i),htextbox(i)]=createParameters('Rychlostní konstanta očkování',k,'k',i);i=i+1;


Obr.1.29. Ukázka zobrazení 3 parametrů v nabídce nastavení parametrů v systému

Tímto způsobem se postupně nastavují všechny parametry, které chcete vložit do nabídky nastavení parametrů. Doporučuji si vždy nakopírovat obsah souborů uložených v již instalovaných modelech. Pak již pouze stačí změnit potřebné názvy parametrů na názvy vašich parametrů použitých ve vašem modelu.

Pro model můžete takto přidávat libovolné množství parametrů. Pokud je například počet parametrů vyšší než 11, do nabídky nastavení parametrů v systému se automaticky přidá posuvná lišta (obr.1.30.).

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.30. Zobrazení posuvné lišty v nabídce nastavení parametrů

1.3.4.) Přidání dokumentace k modelu

Tato kapitola popisuje způsob, jakým lze přidávat dokumentaci k modelu, kterou lze následně spustit ze systému. Je možno přidat dokumentaci ve formátu HTML, PDF, DOC nebo i případně dokumentaci z webových stránek.

Základ pro spouštění dokumentace tvoří M-soubor uložený v adresářové struktuře s modelem. Tato struktura byla již blíže rozebrána v kapitole 1.3.1. Jejím popisem se zde již nebudu dále zabývat. Abychom mohli přidat dokumentaci k novému modelu do systému, musíme si nejdříve takovýto M-soubor pro dokumentaci vytvořit. Tento soubor se musí jmenovat Popis_modelu.m a musí se nacházet ve stejném adresáři jako model a ostatní soubory k modelu. Typická struktura tohoto souboru je zobrazena na následujícím obr.1.31.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.31. Demonstrační ukázka souboru Popis_modelu.m

Obsah tohoto souboru nebo i celý soubor si jednoduše nakopírujte z jiného již instalovaného modelu. Tyto soubory najdete v podadresářích adresáře “Modely“. Doporučuji k tomu použít např. soubor Popis_modelu.m z následující adresářové cesty:

     <adresarInstalaceSystemu>\Modely\Epidemiologicke modely\Model Epidemie AIDS

Obsah tohoto souboru je zobrazen na obr.1.31. Z tohoto souboru je pro vás důležitý pouze řádek 2.

     relativeFilePath=’Dokumentace/2_Modely.html#212’;

V proměnné relativeFilePath je zde uložena pouze relativní adresářová cesta k HTML dokumentaci. Relativní adresářová cesta vychází přímo z kořenového adresáře instalace. Absolutní adresářová cesta je pak vytvořena v proměnné url na řádku číslo 4 (obr.1.31.).

Vaši dokumentaci k modelu můžete obecně umístit téměř kamkoliv. Jen nedoporučuji pro ni vytvářet nový podadresář v adresáři “Modely“, protože by pak tento adresář byl zbytečně zobrazen v rozbalovací stromové struktuře systému. Nejvhodnější místo je nový adresář v kořenovém adresáři instalace nebo podadresář adresáře “Dokumentace“, který naleznete v témže adresáři. Pokud váš adresář vytvoříte pod adresářem “Dokumentace“ a pojmenujete ho např. jako “ModelA“, tak váš výše zmíněný soubor Popis_modelu.m bude obsahovat následující relativní cestu:

     relativeFilePath=’Dokumentace/ModelA/VasModel.html’;

Přidání dokumentace z webových stránek:

V případě, že je dokumentace pro váš model je umístěna na webové stránce, smažte nebo zakomentujte řádky s proměnnými homeDirectory a relativeFilePath ve svém souboru a pouze přepište obsah proměnné url například na následující tvar:

     url='http://www.server.cz/dokumenty/dokumentace.html';

Příklad nastavení takovéto dokumentace v souboru Popis_modelu.m můžete vidět na následujícím obr.1.32.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.32. Ukázka souboru Popis_modelu.m – webová dokumentace

Dokumentace ve formátu PDF nebo DOC:

Pro dokumentace ve formátu PDF nebo DOC. Využijte konstrukci souboru Popis_modelu.m zobrazenou na obr.1.33.

Klikněte pro zobrazení obrázku v plné velikosti
Obr.1.33. Ukázka souboru Popis_modelu.m – dokumentace PDF