MATLAB-i skriptide loomineMATLAB-i skriptide loomine
1. Sissejuhatus1. Sissejuhatus
OghmaNano keskkonnas toimub MATLAB-skriptide abil simulatsiooni seadete failide otse redigeerimine ja seejärel käivitatakse simulatsioonimootor (oghma_core.exe), et mudelit käivitada. Käesolevas jaotises kirjeldatakse seda töövoogu üksikasjalikult.OghmaNano keskkonnas toimub MATLAB-skriptide abil simulatsiooni seadete failide otse redigeerimine ja seejärel käivitatakse simulatsioonimootor (oghma_core.exe), et mudelit käivitada. Käesolevas jaotises kirjeldatakse seda töövoogu üksikasjalikult.
2. Simulatsioonifailide käivitamine MATLAB-is.2. Simulatsioonifailide käivitamine MATLAB-is.
OghmaNano simulatsiooni määratleb täielikult üksainus JSON-konfiguratsioonifail, sim.json. See fail sisaldab simulatsiooni täielikku olekut, sealhulgas seadme struktuuri, materjalide parameetrid, numbrilised sätted ja väljundkonfiguratsiooni. Paljudel juhtudel on sim.json juba olemas tavalise failina simulatsiooni kaustas.OghmaNano simulatsiooni määratleb täielikult üksainus JSON-konfiguratsioonifail, sim.json. See fail sisaldab simulatsiooni täielikku olekut, sealhulgas seadme struktuuri, materjalide parameetrid, numbrilised sätted ja väljundkonfiguratsiooni. Paljudel juhtudel on sim.json juba olemas tavalise failina simulatsiooni kaustas.
Kui OghmaNano programmi käivitatakse MATLAB-ist, loeb skript faili sim.json sisse, kasutades MATLAB-i JSON-i tuge, muudab ühte või mitut parameetrit ja salvestab muudetud JSON-faili tagasi kettale.Kui OghmaNano programmi käivitatakse MATLAB-ist, loeb skript faili sim.json sisse, kasutades MATLAB-i JSON-i tuge, muudab ühte või mitut parameetrit ja salvestab muudetud JSON-faili tagasi kettale.
Oluline on, et MATLAB peab käivituma oghma_core.exe režiimis, kus selle töökaust on määratud simulatsiooni kaustaks – see tähendab, kaust, mis sisaldab sim.json (ja sim.oghma). Simulatsioonimootor loeb alati oma sisendfailid praegusest töökaustast, seega, kui töökaust on vale, siis simulatsioon ebaõnnestub või käivitab vale mudeli.Oluline on, et MATLAB peab käivituma oghma_core.exe režiimis, kus selle töökaust on määratud simulatsiooni kaustaks – see tähendab, kaust, mis sisaldab sim.json (ja sim.oghma). Simulatsioonimootor loeb alati oma sisendfailid praegusest töökaustast, seega, kui töökaust on vale, siis simulatsioon ebaõnnestub või käivitab vale mudeli.
See vastutusvaldkondade jagamine on teadlik ja selgesõnaline: MATLAB vastutab simulatsioonis tehtavate muudatuste määratlemise eest, samas kui OghmaNano vastutab füüsikaliste arvutuste teostamise eest, kasutades selleks praeguses kaustas olevad failid.See vastutusvaldkondade jagamine on teadlik ja selgesõnaline: MATLAB vastutab simulatsioonis tehtavate muudatuste määratlemise eest, samas kui OghmaNano vastutab füüsikaliste arvutuste teostamise eest, kasutades selleks praeguses kaustas olevad failid.
Järgnev näide illustreerib seda protsessi, laadides faili sim.json, muutes esimese seadme kihi kandelaengute liikuvust, salvestades uuendatud konfiguratsiooni tagasi kettale ja seejärel käivitades simulatsiooni simulatsioonikaustast.Järgnev näide illustreerib seda protsessi, laadides faili sim.json, muutes esimese seadme kihi kandelaengute liikuvust, salvestades uuendatud konfiguratsiooni tagasi kettale ja seejärel käivitades simulatsiooni simulatsioonikaustast.
% 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);
Kui sim.json simulatsiooni on seadistatud J–V graafiku genereerimiseks, salvestab OghmaNano simulatsiooni kaustas väljundfailid, mis sisaldavad selliseid parameetreid nagu PCE, täitefaktor, \(J_{sc}\) ja \(V_{oc}\).Kui sim.json simulatsiooni on seadistatud J–V graafiku genereerimiseks, salvestab OghmaNano simulatsiooni kaustas väljundfailid, mis sisaldavad selliseid parameetreid nagu PCE, täitefaktor, \(J_{sc}\) ja \(V_{oc}\).
3. Tulemuste väljavõtmine3. Tulemuste väljavõtmine
Paljud OghmaNano väljundfailid on kirjutatud JSON-vormingus. Levinud praktika on lugeda sim_info.dat, eraldada sellest üksik väärtus, mis näitab tulemuse kvaliteeti (näiteks Voc), ja lisada see hilisemaks analüüsiks tekstifaili.Paljud OghmaNano väljundfailid on kirjutatud JSON-vormingus. Levinud praktika on lugeda sim_info.dat, eraldada sellest üksik väärtus, mis näitab tulemuse kvaliteeti (näiteks Voc), ja lisada see hilisemaks analüüsiks tekstifaili.
Järgmine näide näitab, kuidas sim_info.dat väärtus loetakse ja \(V_{oc}\) väärtus lisatakse eraldi tekstifaili.Järgmine näide näitab, kuidas sim_info.dat väärtus loetakse ja \(V_{oc}\) väärtus lisatakse eraldi tekstifaili.
% 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. Keerukamad simulatsioonid3. Keerukamad simulatsioonid
Paljudes skriptipõhises töövoos soovite käivitada sama põhisimulatsiooni mitu korda, kasutades erinevaid parameetriväärtusi, ja hoida iga simulatsiooni tulemused eraldi kaustas. See on kõige lihtsam viis tagada, et tulemused oleksid korrektsed ja vältida kogemata andmete üle kirjutamist.Paljudes skriptipõhises töövoos soovite käivitada sama põhisimulatsiooni mitu korda, kasutades erinevaid parameetriväärtusi, ja hoida iga simulatsiooni tulemused eraldi kaustas. See on kõige lihtsam viis tagada, et tulemused oleksid korrektsed ja vältida kogemata andmete üle kirjutamist.
Järgmine näide loob neli kausta, mis vastavad neljale erinevale liikumisvõimalusele (1e-5, 1e-6, 1e-7, 1e-8). Iga kausta puhul tehakse järgmine:Järgmine näide loob neli kausta, mis vastavad neljale erinevale liikumisvõimalusele (1e-5, 1e-6, 1e-7, 1e-8). Iga kausta puhul tehakse järgmine:
- Loob kausta (kui see veel olemas ei ole).Loob kausta (kui see veel olemas ei ole).
- Kopeerib praeguse
sim.jsonselle kausta.Kopeerib praegusesim.jsonselle kausta. - Muudab kopeeritud
sim.jsonväärtust, et määrata soovitud liikumiskiirus.Muudab kopeeritudsim.jsonväärtust, et määrata soovitud liikumiskiirus. - Muudab töökausta, nii et see on nüüd määratud kataloog.Muudab töökausta, nii et see on nüüd määratud kataloog.
- Käivitab lahendaja selles kaustas, mille tulemused salvestatakse kohalikult.Käivitab lahendaja selles kaustas, mille tulemused salvestatakse kohalikult.
See muster on OghmaNano paketiskriptide aluseks: iga käivituse jaoks on eraldi kaust, iga käivituse jaoks on eraldi konfiguratsioonifail ja iga parameetri väärtuse jaoks on eraldi puhas väljundkaust.See muster on OghmaNano paketiskriptide aluseks: iga käivituse jaoks on eraldi kaust, iga käivituse jaoks on eraldi konfiguratsioonifail ja iga parameetri väärtuse jaoks on eraldi puhas väljundkaust.
% 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. Tulemuste väljavõtmine4. Tulemuste väljavõtmine
Pärast simulatsioonide partii käivitamist eraldi kaustades (näiteks mu_1e-05, mu_1e-06, ...), on järgmine samm määrata iga simulatsiooni tulemuste põhjal oluline näitaja ja visualiseerida selle tendents. Tavaline näide on avatud vooluringi pinge \(V_{oc}\) lugemine iga kausta sim_info.dat seest ja selle graafiline esitus koos pöördväärtusega mobiilsusega \(1/\mu\).Pärast simulatsioonide partii käivitamist eraldi kaustades (näiteks mu_1e-05, mu_1e-06, ...), on järgmine samm määrata iga simulatsiooni tulemuste põhjal oluline näitaja ja visualiseerida selle tendents. Tavaline näide on avatud vooluringi pinge \(V_{oc}\) lugemine iga kausta sim_info.dat seest ja selle graafiline esitus koos pöördväärtusega mobiilsusega \(1/\mu\).
Allpool olev skript skannib kindla komplekti katalooge, mis vastavad mobiilsustele 1e-5, 1e-6, 1e-7, 1e-8, ning iga kataloogi puhul:Allpool olev skript skannib kindla komplekti katalooge, mis vastavad mobiilsustele 1e-5, 1e-6, 1e-7, 1e-8, ning iga kataloogi puhul:
- Laadib andmed
sim_info.datJSON-vormingus.Laadib andmedsim_info.datJSON-vormingus. - Väljavõtted
Voc.VäljavõttedVoc. - Arvutab \(1/\mu\) väärtuse, kasutades sellega seotud kausta mobiilsust.Arvutab \(1/\mu\) väärtuse, kasutades sellega seotud kausta mobiilsust.
- Loob väikese kokkuvõttega faili (
voc_vs_inv_mobility.dat).Loob väikese kokkuvõttega faili (voc_vs_inv_mobility.dat). - Graafikud \(V_{oc}\) ja \(1/\mu\).Graafikud \(V_{oc}\) ja \(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;