MATLAB betik diliMATLAB betik dili
1. Giriş1. Giriş
OghmaNano'da, MATLAB betik dili, diskin üzerindeki simülasyon yapılandırma dosyalarını doğrudan düzenleyerek ve ardından simülasyon motorunu (oghma_core.exe) çağırarak modelin çalıştırılmasını sağlayacak şekilde işler. Bu bölüm, bu iş akışını ayrıntılı olarak açıklamaktadır.OghmaNano'da, MATLAB betik dili, diskin üzerindeki simülasyon yapılandırma dosyalarını doğrudan düzenleyerek ve ardından simülasyon motorunu (oghma_core.exe) çağırarak modelin çalıştırılmasını sağlayacak şekilde işler. Bu bölüm, bu iş akışını ayrıntılı olarak açıklamaktadır.
2. MATLAB ile simülasyon dosyalarını çalıştırma2. MATLAB ile simülasyon dosyalarını çalıştırma
Bir OghmaNano simülasyonu, tamamen tek bir JSON yapılandırma dosyasıyla, sim.json ile tanımlanır. Bu dosya, cihazın yapısı, malzeme parametreleri, sayısal ayarlar ve çıktı yapılandırması dahil olmak üzere simülasyonun tüm durumunu içerir. Birçok durumda, sim.json zaten simülasyon dizini içindeki normal bir dosya olarak mevcuttur.Bir OghmaNano simülasyonu, tamamen tek bir JSON yapılandırma dosyasıyla, sim.json ile tanımlanır. Bu dosya, cihazın yapısı, malzeme parametreleri, sayısal ayarlar ve çıktı yapılandırması dahil olmak üzere simülasyonun tüm durumunu içerir. Birçok durumda, sim.json zaten simülasyon dizini içindeki normal bir dosya olarak mevcuttur.
MATLAB üzerinden OghmaNano'yu çalıştırırken, betik, MATLAB'in JSON desteğini kullanarak sim.json'i belleğe yükler, bir veya daha fazla parametreyi değiştirir ve güncellenmiş JSON'u tekrar diske yazar.MATLAB üzerinden OghmaNano'yu çalıştırırken, betik, MATLAB'in JSON desteğini kullanarak sim.json'i belleğe yükler, bir veya daha fazla parametreyi değiştirir ve güncellenmiş JSON'u tekrar diske yazar.
Önemli olarak, MATLAB'in oghma_core.exe komutuyla çalıştırılması ve çalışma dizininin simülasyon dizinine ayarlanması gerekmektedir; yani, sim.json (ve sim.oghma) dosyalarını içeren dizin. Simülasyon motoru, giriş dosyalarını her zaman geçerli çalışma dizininden okur; bu nedenle çalışma dizini yanlışsa, simülasyon başarısız olur veya yanlış modeli çalıştırır.Önemli olarak, MATLAB'in oghma_core.exe komutuyla çalıştırılması ve çalışma dizininin simülasyon dizinine ayarlanması gerekmektedir; yani, sim.json (ve sim.oghma) dosyalarını içeren dizin. Simülasyon motoru, giriş dosyalarını her zaman geçerli çalışma dizininden okur; bu nedenle çalışma dizini yanlışsa, simülasyon başarısız olur veya yanlış modeli çalıştırır.
Bu sorumlulukların ayrılması kasıtlı ve açık bir şekilde yapılmıştır: MATLAB, simülasyonda hangi değişikliklerin yapılacağını belirlemekten sorumludur; OghmaNano ise mevcut dizindeki dosyalarda bulunan verileri kullanarak fiziksel hesaplamaları gerçekleştirmekten sorumludur.Bu sorumlulukların ayrılması kasıtlı ve açık bir şekilde yapılmıştır: MATLAB, simülasyonda hangi değişikliklerin yapılacağını belirlemekten sorumludur; OghmaNano ise mevcut dizindeki dosyalarda bulunan verileri kullanarak fiziksel hesaplamaları gerçekleştirmekten sorumludur.
Aşağıdaki örnek, sim.json'i yükleyerek, ilk cihaz katmanının taşıyıcı hareketliliğini değiştirerek, güncellenmiş yapılandırmayı tekrar diske kaydederek ve ardından simülasyonu simülasyon dizininden başlatarak bu süreci göstermektedir.Aşağıdaki örnek, sim.json'i yükleyerek, ilk cihaz katmanının taşıyıcı hareketliliğini değiştirerek, güncellenmiş yapılandırmayı tekrar diske kaydederek ve ardından simülasyonu simülasyon dizininden başlatarak bu süreci göstermektedir.
% 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);
sim.json içinde gerçekleştirilen simülasyon, bir J–V eğrisi oluşturacak şekilde ayarlanırsa, OghmaNano, simülasyon dizinine, PCE, doluluk faktörü, \(J_{sc}\) ve \(V_{oc}\) gibi değerleri içeren çıktı dosyaları yazacaktır.sim.json içinde gerçekleştirilen simülasyon, bir J–V eğrisi oluşturacak şekilde ayarlanırsa, OghmaNano, simülasyon dizinine, PCE, doluluk faktörü, \(J_{sc}\) ve \(V_{oc}\) gibi değerleri içeren çıktı dosyaları yazacaktır.
3. Sonuçları çıkarma3. Sonuçları çıkarma
Birçok OghmaNano çıktı dosyası JSON formatında yazılır. Yaygın bir yöntem, sim_info.dat'i okumak, bir ölçek parametresi (örneğin Voc) çıkarmak ve bunu daha sonra analiz yapmak üzere bir metin dosyasına eklemektir.Birçok OghmaNano çıktı dosyası JSON formatında yazılır. Yaygın bir yöntem, sim_info.dat'i okumak, bir ölçek parametresi (örneğin Voc) çıkarmak ve bunu daha sonra analiz yapmak üzere bir metin dosyasına eklemektir.
Aşağıdaki örnekte sim_info.dat değeri okunur ve \(V_{oc}\) değerinin içeriği ayrı bir metin dosyasına eklenir.Aşağıdaki örnekte sim_info.dat değeri okunur ve \(V_{oc}\) değerinin içeriği ayrı bir metin dosyasına eklenir.
% 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. Daha karmaşık simülasyonlar3. Daha karmaşık simülasyonlar
Birçok betik oluşturma sürecinde, aynı temel simülasyonu farklı parametre değerleriyle birden çok kez çalıştırmak ve her bir çalıştırmayı kendi dizininde ayrı tutmak isteyeceksiniz. Bu, çıktıları düzenli tutmanın ve sonuçların yanlışlıkla üzerine yazılmasını önlemenin en basit yoludur.Birçok betik oluşturma sürecinde, aynı temel simülasyonu farklı parametre değerleriyle birden çok kez çalıştırmak ve her bir çalıştırmayı kendi dizininde ayrı tutmak isteyeceksiniz. Bu, çıktıları düzenli tutmanın ve sonuçların yanlışlıkla üzerine yazılmasını önlemenin en basit yoludur.
Aşağıdaki örnek, dört farklı hareketlilik türüne (1e-5, 1e-6, 1e-7, 1e-8) karşılık gelen bir dizi dizin oluşturur. Her bir dizin için şunları yapar:Aşağıdaki örnek, dört farklı hareketlilik türüne (1e-5, 1e-6, 1e-7, 1e-8) karşılık gelen bir dizi dizin oluşturur. Her bir dizin için şunları yapar:
- Dizin mevcut değilse, dizini oluşturur.Dizin mevcut değilse, dizini oluşturur.
- Mevcut
sim.jsondosyasının bir kopyasını belirtilen dizine kopyalar.Mevcutsim.jsondosyasının bir kopyasını belirtilen dizine kopyalar. - Kopyalanan
sim.json'i düzenleyerek hedef hareketliliği ayarlar.Kopyalanansim.json'i düzenleyerek hedef hareketliliği ayarlar. - Çalışma dizinini belirtilen dizine değiştirir.Çalışma dizinini belirtilen dizine değiştirir.
- Çözücüyü belirtilen dizinde çalıştırır ve bu çalıştırmaya özgü çıktıları oluşturur.Çözücüyü belirtilen dizinde çalıştırır ve bu çalıştırmaya özgü çıktıları oluşturur.
Bu yapı, OghmaNano'da toplu komut dosyası oluşturmanın temelini oluşturur: her çalıştırma için bir dizin, her çalıştırma için bir yapılandırma dosyası ve her parametre değeri için temiz bir çıktı klasörü.Bu yapı, OghmaNano'da toplu komut dosyası oluşturmanın temelini oluşturur: her çalıştırma için bir dizin, her çalıştırma için bir yapılandırma dosyası ve her parametre değeri için temiz bir çıktı klasörü.
% 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. Sonuçları çıkarma4. Sonuçları çıkarma
Ayrı ayrı çalışma dizinlerinde bir dizi simülasyon çalıştırdıktan sonra (örneğin mu_1e-05, mu_1e-06, ...), bir sonraki adım, her bir çalışmadan elde edilen önemli bir performans ölçütünü çıkarmak ve eğilimi görselleştirmektir. Yaygın bir örnek olarak, her dizindeki sim_info.dat'ten açık devre voltajı \(V_{oc}\)'i okuyup, bunu ters hareketliliğe \(1/\mu\) karşı çizerek göstermek verilebilir.Ayrı ayrı çalışma dizinlerinde bir dizi simülasyon çalıştırdıktan sonra (örneğin mu_1e-05, mu_1e-06, ...), bir sonraki adım, her bir çalışmadan elde edilen önemli bir performans ölçütünü çıkarmak ve eğilimi görselleştirmektir. Yaygın bir örnek olarak, her dizindeki sim_info.dat'ten açık devre voltajı \(V_{oc}\)'i okuyup, bunu ters hareketliliğe \(1/\mu\) karşı çizerek göstermek verilebilir.
Aşağıdaki betik, 1e-5, 1e-6, 1e-7 ve 1e-8 hareketliliklerine karşılık gelen belirli bir dizi dizini tarar ve her dizin için şunları yapar:Aşağıdaki betik, 1e-5, 1e-6, 1e-7 ve 1e-8 hareketliliklerine karşılık gelen belirli bir dizi dizini tarar ve her dizin için şunları yapar:
- Yükler
sim_info.datJSON formatında.Yüklersim_info.datJSON formatında. - Alıntılar
Voc.AlıntılarVoc. - Bu dizinle ilişkili hareketlilik değerini kullanarak \(1/\mu\) hesaplar.Bu dizinle ilişkili hareketlilik değerini kullanarak \(1/\mu\) hesaplar.
- Küçük bir özet dosyası oluşturur (
voc_vs_inv_mobility.dat).Küçük bir özet dosyası oluşturur (voc_vs_inv_mobility.dat). - \(V_{oc}\) ve \(1/\mu\) arasındaki grafikler.\(V_{oc}\) ve \(1/\mu\) arasındaki grafikler.
% 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;