Crearea de scripturi în MATLAB.Crearea de scripturi în MATLAB.
1. Introducere1. Introducere
În OghmaNano, scripturile MATLAB funcționează prin editarea directă a fișierelor de configurare a simulării, stocate pe disc, și apoi prin activarea motorului de simulare (oghma_core.exe) pentru a executa modelul. Această secțiune descrie în detaliu acest flux de lucru.În OghmaNano, scripturile MATLAB funcționează prin editarea directă a fișierelor de configurare a simulării, stocate pe disc, și apoi prin activarea motorului de simulare (oghma_core.exe) pentru a executa modelul. Această secțiune descrie în detaliu acest flux de lucru.
2. Executarea fișierelor de simulare cu MATLAB.2. Executarea fișierelor de simulare cu MATLAB.
O simulare OghmaNano este definită în întregime de un singur fișier de configurare JSON, sim.json. Acest fișier conține starea completă a simulării, inclusiv structura dispozitivului, parametrii materialelor, setările numerice și configurația de ieșire. În multe cazuri, sim.json există deja ca un fișier normal în directorul simulării.O simulare OghmaNano este definită în întregime de un singur fișier de configurare JSON, sim.json. Acest fișier conține starea completă a simulării, inclusiv structura dispozitivului, parametrii materialelor, setările numerice și configurația de ieșire. În multe cazuri, sim.json există deja ca un fișier normal în directorul simulării.
Atunci când se utilizează OghmaNano în cadrul MATLAB, scriptul citește datele din sim.json și le stochează în memorie, folosind funcționalitatea JSON a MATLAB, modifică unul sau mai mulți parametri și salvează fișierul JSON actualizat pe disc.Atunci când se utilizează OghmaNano în cadrul MATLAB, scriptul citește datele din sim.json și le stochează în memorie, folosind funcționalitatea JSON a MATLAB, modifică unul sau mai mulți parametri și salvează fișierul JSON actualizat pe disc.
Este esențial ca MATLAB să ruleze oghma_core.exe cu directorul de lucru setat la directorul de simulare – adică, directorul care conține sim.json (și sim.oghma). Motorul de simulare citește întotdeauna fișierele de intrare din directorul de lucru curent, astfel încât, dacă directorul de lucru este incorect, simularea va eșua sau va rula modelul greșit.Este esențial ca MATLAB să ruleze oghma_core.exe cu directorul de lucru setat la directorul de simulare – adică, directorul care conține sim.json (și sim.oghma). Motorul de simulare citește întotdeauna fișierele de intrare din directorul de lucru curent, astfel încât, dacă directorul de lucru este incorect, simularea va eșua sau va rula modelul greșit.
Această împărțire a responsabilităților este intenționată și explicită: MATLAB este responsabil pentru definirea modificărilor care vor avea loc în simulare, în timp ce OghmaNano este responsabil pentru executarea calculelor fizice folosind fișierele prezente în directorul curent.Această împărțire a responsabilităților este intenționată și explicită: MATLAB este responsabil pentru definirea modificărilor care vor avea loc în simulare, în timp ce OghmaNano este responsabil pentru executarea calculelor fizice folosind fișierele prezente în directorul curent.
Exemplul de mai jos ilustrează acest proces prin încărcarea sim.json, modificarea mobilității purtătorilor de sarcină din primul strat al dispozitivului, salvarea configurației actualizate pe disc și apoi executarea simulării din directorul de simulare.Exemplul de mai jos ilustrează acest proces prin încărcarea sim.json, modificarea mobilității purtătorilor de sarcină din primul strat al dispozitivului, salvarea configurației actualizate pe disc și apoi executarea simulării din directorul de simulare.
% 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);
Dacă simularea din sim.json este configurată pentru a genera o curbă J–V, OghmaNano va crea fișiere de ieșire în directorul de simulare, care vor conține valori precum PCE, factorul de umplere, \(J_{sc}\) și \(V_{oc}\).Dacă simularea din sim.json este configurată pentru a genera o curbă J–V, OghmaNano va crea fișiere de ieșire în directorul de simulare, care vor conține valori precum PCE, factorul de umplere, \(J_{sc}\) și \(V_{oc}\).
3. Extragerea rezultatelor3. Extragerea rezultatelor
Multe dintre fișierele de ieșire OghmaNano sunt scrise în format JSON. O practică obișnuită este să se citească sim_info.dat, să se extragă o valoare scalară reprezentând un indicator de performanță (de exemplu, Voc) și să se adauge această valoare la un fișier text, pentru o analiză ulterioară.Multe dintre fișierele de ieșire OghmaNano sunt scrise în format JSON. O practică obișnuită este să se citească sim_info.dat, să se extragă o valoare scalară reprezentând un indicator de performanță (de exemplu, Voc) și să se adauge această valoare la un fișier text, pentru o analiză ulterioară.
Exemplul de mai jos citește sim_info.dat și adaugă valoarea lui \(V_{oc}\) într-un fișier text separat.Exemplul de mai jos citește sim_info.dat și adaugă valoarea lui \(V_{oc}\) într-un fișier text separat.
% 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. Simulări mai complexe.3. Simulări mai complexe.
În multe fluxuri de lucru care implică scripturi, veți dori să executați aceeași simulare de bază de mai multe ori, folosind valori diferite pentru parametri, și să mențineți fiecare execuție izolată, într-un director separat. Aceasta este cea mai simplă modalitate de a obține rezultate clare și de a evita suprascrierea accidentală a acestora.În multe fluxuri de lucru care implică scripturi, veți dori să executați aceeași simulare de bază de mai multe ori, folosind valori diferite pentru parametri, și să mențineți fiecare execuție izolată, într-un director separat. Aceasta este cea mai simplă modalitate de a obține rezultate clare și de a evita suprascrierea accidentală a acestora.
Exemplul de mai jos creează un set de directoare corespunzătoare celor patru tipuri de mobilitate (1e-5, 1e-6, 1e-7, 1e-8). Pentru fiecare director, acesta:Exemplul de mai jos creează un set de directoare corespunzătoare celor patru tipuri de mobilitate (1e-5, 1e-6, 1e-7, 1e-8). Pentru fiecare director, acesta:
- Creează directorul (dacă acesta nu există deja).Creează directorul (dacă acesta nu există deja).
- Copiază fișierul
sim.jsonîn directorul respectiv.Copiază fișierulsim.jsonîn directorul respectiv. - Modifică
sim.jsoncopiat pentru a seta valoarea dorită a mobilității.Modificăsim.jsoncopiat pentru a seta valoarea dorită a mobilității. - Modifică directorul de lucru, astfel încât acesta să devină directorul specificat.Modifică directorul de lucru, astfel încât acesta să devină directorul specificat.
- Rulează programul de rezolvare în directorul respectiv, generând rezultate specifice acelei sesiuni de lucru.Rulează programul de rezolvare în directorul respectiv, generând rezultate specifice acelei sesiuni de lucru.
Acest model reprezintă fundamentul scripturilor de procesare în lot în OghmaNano: un director pentru fiecare execuție, un fișier de configurare pentru fiecare execuție și un folder de ieșire curat pentru fiecare valoare de parametru.Acest model reprezintă fundamentul scripturilor de procesare în lot în OghmaNano: un director pentru fiecare execuție, un fișier de configurare pentru fiecare execuție și un folder de ieșire curat pentru fiecare valoare de parametru.
% 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. Extragerea rezultatelor4. Extragerea rezultatelor
După efectuarea unei serii de simulări în directoare separate (de exemplu, mu_1e-05, mu_1e-06, ...), următorul pas este de a extrage un indicator cheie de performanță din fiecare simulare și de a vizualiza tendința. Un exemplu comun este citirea tensiunii în circuit deschis \(V_{oc}\) din sim_info.dat în fiecare director și reprezentarea grafică a acesteia în funcție de mobilitatea inversă \(1/\mu\).După efectuarea unei serii de simulări în directoare separate (de exemplu, mu_1e-05, mu_1e-06, ...), următorul pas este de a extrage un indicator cheie de performanță din fiecare simulare și de a vizualiza tendința. Un exemplu comun este citirea tensiunii în circuit deschis \(V_{oc}\) din sim_info.dat în fiecare director și reprezentarea grafică a acesteia în funcție de mobilitatea inversă \(1/\mu\).
Scriptul de mai jos analizează un set fix de directoare, corespunzătoare valorilor de mobilitate 1e-5, 1e-6, 1e-7, 1e-8, și, pentru fiecare director, efectuează următoarele:Scriptul de mai jos analizează un set fix de directoare, corespunzătoare valorilor de mobilitate 1e-5, 1e-6, 1e-7, 1e-8, și, pentru fiecare director, efectuează următoarele:
- Încarcă
sim_info.datîn format JSON.Încarcăsim_info.datîn format JSON. - Fragmente
Voc.FragmenteVoc. - Calculează \(1/\mu\) folosind mobilitatea asociată cu directorul respectiv.Calculează \(1/\mu\) folosind mobilitatea asociată cu directorul respectiv.
- Creează un fișier cu un scurt rezumat (
voc_vs_inv_mobility.dat).Creează un fișier cu un scurt rezumat (voc_vs_inv_mobility.dat). - Graficele \(V_{oc}\) comparate cu graficele \(1/\mu\).Graficele \(V_{oc}\) comparate cu graficele \(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;