Skriptování v jazyce MATLABSkriptování v jazyce MATLAB
1. Úvod1. Úvod
V prostředí OghmaNano funguje skriptování v jazyce MATLAB tak, že se přímo upravují konfigurační soubory simulace uložené na disku a poté se spustí simulační modul (oghma_core.exe), který provede samotnou simulaci modelu. Tato část podrobně popisuje tento postup.V prostředí OghmaNano funguje skriptování v jazyce MATLAB tak, že se přímo upravují konfigurační soubory simulace uložené na disku a poté se spustí simulační modul (oghma_core.exe), který provede samotnou simulaci modelu. Tato část podrobně popisuje tento postup.
2. Spouštění simulačních souborů pomocí programu MATLAB.2. Spouštění simulačních souborů pomocí programu MATLAB.
Simulace OghmaNano je plně definována jediným konfiguračním souborem ve formátu JSON, sim.json. Tento soubor obsahuje kompletní stav simulace, včetně struktury zařízení, parametrů materiálů, numerických nastavení a konfigurace výstupu. V mnoha případech sim.json již existuje jako běžný soubor v adresáři simulace.Simulace OghmaNano je plně definována jediným konfiguračním souborem ve formátu JSON, sim.json. Tento soubor obsahuje kompletní stav simulace, včetně struktury zařízení, parametrů materiálů, numerických nastavení a konfigurace výstupu. V mnoha případech sim.json již existuje jako běžný soubor v adresáři simulace.
Při spouštění programu OghmaNano z prostředí MATLAB načítá skript soubor sim.json do paměti pomocí funkcí MATLAB pro práci s formátem JSON, upraví jeden nebo více parametrů a uloží aktualizovaný soubor JSON zpět na disk.Při spouštění programu OghmaNano z prostředí MATLAB načítá skript soubor sim.json do paměti pomocí funkcí MATLAB pro práci s formátem JSON, upraví jeden nebo více parametrů a uloží aktualizovaný soubor JSON zpět na disk.
Klíčové je, že program MATLAB musí být spuštěn oghma_core.exe s nastaveným pracovním adresářem na adresář simulace – tedy adresář, který obsahuje sim.json (a sim.oghma). Simulační modul vždy načítá vstupní soubory z aktuálního pracovního adresáře, takže pokud je pracovní adresář nastaven nesprávně, simulace selže nebo spustí nesprávný model.Klíčové je, že program MATLAB musí být spuštěn oghma_core.exe s nastaveným pracovním adresářem na adresář simulace – tedy adresář, který obsahuje sim.json (a sim.oghma). Simulační modul vždy načítá vstupní soubory z aktuálního pracovního adresáře, takže pokud je pracovní adresář nastaven nesprávně, simulace selže nebo spustí nesprávný model.
Toto rozdělení odpovědností je záměrné a jasně definované: MATLAB má za úkol určit, jaké změny se mají v simulaci provést, zatímco OghmaNano má za úkol provádět fyzikální výpočty s využitím souborů, které se nacházejí v aktuálním adresáři.Toto rozdělení odpovědností je záměrné a jasně definované: MATLAB má za úkol určit, jaké změny se mají v simulaci provést, zatímco OghmaNano má za úkol provádět fyzikální výpočty s využitím souborů, které se nacházejí v aktuálním adresáři.
Následující příklad ilustruje tento postup načtením sim.json, úpravou pohyblivosti nositelů náboje v první vrstvě zařízení, uložením aktualizované konfigurace zpět na disk a následným spuštěním simulace z adresáře simulace.Následující příklad ilustruje tento postup načtením sim.json, úpravou pohyblivosti nositelů náboje v první vrstvě zařízení, uložením aktualizované konfigurace zpět na disk a následným spuštěním simulace z adresáře simulace.
% Set this to your simulation folder (must contain sim.json / sim.oghma)
sim_dir = "C:\path\to\your\simulation";
% Read sim.json
sim_path = fullfile(sim_dir, "sim.json");
txt = fileread(sim_path);
data = jsondecode(txt);
% Edit a value: mobility of segment1 (same JSON path as the Python page)
data.epitaxy.segment1.shape_dos.mue_y = 1.0;
% Write sim.json back to disk
out = jsonencode(data);
fid = fopen(sim_path, "w");
fprintf(fid, "%s", out);
fclose(fid);
% Run the simulation (working directory must be the simulation folder)
orig_dir = pwd;
cd(sim_dir);
system("oghma_core.exe");
cd(orig_dir);
Pokud je v simulaci v sim.json nastaveno generování J–V křivky, program OghmaNano zapíše výstupní soubory do adresáře simulace, které budou obsahovat hodnoty jako PCE, faktor plnění, \(J_{sc}\) a \(V_{oc}\).Pokud je v simulaci v sim.json nastaveno generování J–V křivky, program OghmaNano zapíše výstupní soubory do adresáře simulace, které budou obsahovat hodnoty jako PCE, faktor plnění, \(J_{sc}\) a \(V_{oc}\).
3. Získávání výsledků3. Získávání výsledků
Mnoho výstupních souborů OghmaNano je zapisováno ve formátu JSON. Běžný postup spočívá v načtení sim_info.dat, extrahování skalárního ukazatele kvality (například Voc) a jeho přidání do textového souboru pro pozdější analýzu.Mnoho výstupních souborů OghmaNano je zapisováno ve formátu JSON. Běžný postup spočívá v načtení sim_info.dat, extrahování skalárního ukazatele kvality (například Voc) a jeho přidání do textového souboru pro pozdější analýzu.
Následující příklad načte sim_info.dat a připojí hodnotu \(V_{oc}\) do samostatného textového souboru.Následující příklad načte sim_info.dat a připojí hodnotu \(V_{oc}\) do samostatného textového souboru.
% Must be run from (or pointed at) a completed simulation directory
sim_dir = "C:\path\to\your\simulation";
info_path = fullfile(sim_dir, "sim_info.dat");
txt = fileread(info_path);
info = jsondecode(txt);
voc = info.Voc;
% Append to a text file (one Voc per line)
out_path = fullfile(sim_dir, "out.dat");
fid = fopen(out_path, "a");
fprintf(fid, "%g\n", voc);
fclose(fid);
3. Složitější simulace3. Složitější simulace
V mnoha případech, kdy používáte skripty, budete chtít opakovaně spouštět stejnou základní simulaci s různými hodnotami parametrů a přitom zajistit, aby každé spuštění probíhalo izolovaně v samostatném adresáři. To je nejjednodušší způsob, jak udržet výstupy přehledné a zabránit náhodnému přepsání výsledků.V mnoha případech, kdy používáte skripty, budete chtít opakovaně spouštět stejnou základní simulaci s různými hodnotami parametrů a přitom zajistit, aby každé spuštění probíhalo izolovaně v samostatném adresáři. To je nejjednodušší způsob, jak udržet výstupy přehledné a zabránit náhodnému přepsání výsledků.
Následující příklad vytvoří sadu adresářů, které odpovídají čtyřem typům pohyblivosti (1e-5, 1e-6, 1e-7, 1e-8). Pro každý adresář provede následující:Následující příklad vytvoří sadu adresářů, které odpovídají čtyřem typům pohyblivosti (1e-5, 1e-6, 1e-7, 1e-8). Pro každý adresář provede následující:
- Vytvoří adresář (pokud již neexistuje).Vytvoří adresář (pokud již neexistuje).
- Zkopíruje aktuální verzi
sim.jsondo tohoto adresáře.Zkopíruje aktuální verzisim.jsondo tohoto adresáře. - Upravuje zkopírovaný prvek
sim.jsona nastavuje požadovanou úroveň pohyblivosti.Upravuje zkopírovaný prveksim.jsona nastavuje požadovanou úroveň pohyblivosti. - Změní aktuální pracovní adresář na zadaný adresář.Změní aktuální pracovní adresář na zadaný adresář.
- Spustí řešič v daném adresáři a vygeneruje výstupy, které jsou uloženy lokálně v rámci tohoto spuštění.Spustí řešič v daném adresáři a vygeneruje výstupy, které jsou uloženy lokálně v rámci tohoto spuštění.
Tento postup je základem pro dávkové skriptování v OghmaNano: pro každé spuštění se používá jeden adresář, jeden konfigurační soubor a pro každou hodnotu parametru se vytváří samostatná výstupní složka.Tento postup je základem pro dávkové skriptování v OghmaNano: pro každé spuštění se používá jeden adresář, jeden konfigurační soubor a pro každou hodnotu parametru se vytváří samostatná výstupní složka.
% The script should be started in the base simulation directory
% (i.e. the directory containing the reference sim.json).
base_dir = pwd;
mobilities = [1e-5, 1e-6, 1e-7, 1e-8];
src_sim = fullfile(base_dir, "sim.json");
for k = 1:numel(mobilities)
mu = mobilities(k);
run_name = sprintf("mu_%.0e", mu);
run_dir = fullfile(base_dir, run_name);
if ~exist(run_dir, "dir")
mkdir(run_dir);
end
% Copy the base sim.json into the run directory
dst_sim = fullfile(run_dir, "sim.json");
copyfile(src_sim, dst_sim);
% Load the copied sim.json and edit the mobility in THAT copy
txt = fileread(dst_sim);
data = jsondecode(txt);
data.epitaxy.segment1.shape_dos.mue_y = mu;
out = jsonencode(data);
fid = fopen(dst_sim, "w");
fprintf(fid, "%s", out);
fclose(fid);
% Change into the run directory and execute the solver there
cd(run_dir);
system("oghma_core.exe");
cd(base_dir);
end
4. Získávání výsledků4. Získávání výsledků
Po provedení série simulací v samostatných adresářích (například mu_1e-05, mu_1e-06, ...) je dalším krokem extrahování klíčového ukazatele z každé simulace a vizualizace trendu. Běžným příkladem je načtení napětí v otevřeném obvodu \(V_{oc}\) z sim_info.dat v každém adresáři a jeho grafické znázornění v závislosti na inverzní pohyblivosti \(1/\mu\).Po provedení série simulací v samostatných adresářích (například mu_1e-05, mu_1e-06, ...) je dalším krokem extrahování klíčového ukazatele z každé simulace a vizualizace trendu. Běžným příkladem je načtení napětí v otevřeném obvodu \(V_{oc}\) z sim_info.dat v každém adresáři a jeho grafické znázornění v závislosti na inverzní pohyblivosti \(1/\mu\).
Následující skript prochází předem definovanou sadu adresářů, které odpovídají hodnotám pohyblivosti 1e-5, 1e-6, 1e-7, 1e-8, a pro každý adresář provádí následující:Následující skript prochází předem definovanou sadu adresářů, které odpovídají hodnotám pohyblivosti 1e-5, 1e-6, 1e-7, 1e-8, a pro každý adresář provádí následující:
- Načte
sim_info.datve formátu JSON.Načtesim_info.datve formátu JSON. - Výňatky
Voc.VýňatkyVoc. - Vypočítá hodnotu \(1/\mu\) na základě mobility, která je spojená s daným adresářem.Vypočítá hodnotu \(1/\mu\) na základě mobility, která je spojená s daným adresářem.
- Vytvoří malý soubor s přehledem (
voc_vs_inv_mobility.dat).Vytvoří malý soubor s přehledem (voc_vs_inv_mobility.dat). - Grafy \(V_{oc}\) oproti \(1/\mu\).Grafy \(V_{oc}\) oproti \(1/\mu\).
% Run this from the BASE directory that contains the run folders
% (mu_1e-05, mu_1e-06, ...). If not, set base_dir explicitly.
base_dir = pwd;
% Mobilities must match the run directories you generated earlier
mobilities = [1e-5, 1e-6, 1e-7, 1e-8];
inv_mu = zeros(size(mobilities));
vocs = zeros(size(mobilities));
for k = 1:numel(mobilities)
mu = mobilities(k);
run_dir = fullfile(base_dir, sprintf("mu_%.0e", mu));
info_path = fullfile(run_dir, "sim_info.dat");
if ~exist(info_path, "file")
error("Missing sim_info.dat in: %s", run_dir);
end
txt = fileread(info_path);
info = jsondecode(txt);
vocs(k) = info.Voc;
inv_mu(k) = 1.0 / mu;
end
% Write a small summary table to disk
out_path = fullfile(base_dir, "voc_vs_inv_mobility.dat");
fid = fopen(out_path, "w");
fprintf(fid, "# inv_mobility(1/mu) Voc(V)\n");
for k = 1:numel(inv_mu)
fprintf(fid, "%.6e %g\n", inv_mu(k), vocs(k));
end
fclose(fid);
% Plot Voc against inverse mobility
figure;
plot(inv_mu, vocs, "o-");
xlabel("Inverse mobility (1/\mu)");
ylabel("Open-circuit voltage V_{oc} (V)");
title("V_{oc} vs inverse mobility");
grid on;