בית דוגמאות צילומי מסך מדריך למשתמש הלוגו של בלוסקיי YouTube ☰
OghmaNano פלטפורמת סימולציה רב-פיזיקלית עבור התקנים אופטו-אלקטרוניים ומערכות פוטוניות הורד מדריך להתחלה מהירה

תכנות באמצעות סקריפטים ב-MATLABתכנות באמצעות סקריפטים ב-MATLAB

1. מבוא1. מבוא

ב-OghmaNano, סקריפטים של MATLAB פועלים על ידי עריכה ישירה של קבצי התצורה של הסימולציה בדיסק, ולאחר מכן הפעלת מנוע הסימולציה (oghma_core.exe) כדי להריץ את המודל. בחלק זה מתואר תהליך העבודה הזה בפירוט.ב-OghmaNano, סקריפטים של MATLAB פועלים על ידי עריכה ישירה של קבצי התצורה של הסימולציה בדיסק, ולאחר מכן הפעלת מנוע הסימולציה (oghma_core.exe) כדי להריץ את המודל. בחלק זה מתואר תהליך העבודה הזה בפירוט.

2. הפעלת קבצי סימולציה באמצעות MATLAB2. הפעלת קבצי סימולציה באמצעות MATLAB

סימולציה של OghmaNano מוגדרת במלואה באמצעות קובץ תצורה יחיד בפורמט JSON, sim.json. קובץ זה מכיל את המצב השלם של הסימולציה, כולל מבנה המכשיר, פרמטרים של חומרים, הגדרות נומריות ותצורת פלט. במקרים רבים, sim.json כבר קיים כקובץ רגיל בתוך תיקיית הסימולציה.סימולציה של OghmaNano מוגדרת במלואה באמצעות קובץ תצורה יחיד בפורמט JSON, sim.json. קובץ זה מכיל את המצב השלם של הסימולציה, כולל מבנה המכשיר, פרמטרים של חומרים, הגדרות נומריות ותצורת פלט. במקרים רבים, sim.json כבר קיים כקובץ רגיל בתוך תיקיית הסימולציה.

כאשר מפעילים את OghmaNano מתוך MATLAB, הסקריפט קורא את הנתונים sim.json לזיכרון באמצעות תמיכת JSON של MATLAB, משנה פרמטר אחד או יותר, ושומר את נתוני JSON המעודכנים בחזרה בדיסק.כאשר מפעילים את OghmaNano מתוך MATLAB, הסקריפט קורא את הנתונים sim.json לזיכרון באמצעות תמיכת JSON של MATLAB, משנה פרמטר אחד או יותר, ושומר את נתוני JSON המעודכנים בחזרה בדיסק.

חשוב מכך, יש להפעיל את MATLAB oghma_core.exe כך שספריית העבודה שלו תוגדר לספריית הסימולציה – כלומר, לספרייה המכילה את sim.json (וגם את sim.oghma). מנוע הסימולציה תמיד קורא את קבצי הקלט שלו מספריית העבודה הנוכחית, ולכן אם ספריית העבודה אינה נכונה, הסימולציה תיכשל או תריץ את המודל הלא נכון.חשוב מכך, יש להפעיל את MATLAB oghma_core.exe כך שספריית העבודה שלו תוגדר לספריית הסימולציה – כלומר, לספרייה המכילה את sim.json (וגם את sim.oghma). מנוע הסימולציה תמיד קורא את קבצי הקלט שלו מספריית העבודה הנוכחית, ולכן אם ספריית העבודה אינה נכונה, הסימולציה תיכשל או תריץ את המודל הלא נכון.

חלוקת האחריות הזו נעשית במכוון ובאופן מפורש: MATLAB אחראית על הגדרת השינויים שיתרחשו בסימולציה, בעוד ש-OghmaNano אחראית על הפעלת המודל הפיזיקלי תוך שימוש בקבצים הקיימים בספרייה הנוכחית.חלוקת האחריות הזו נעשית במכוון ובאופן מפורש: MATLAB אחראית על הגדרת השינויים שיתרחשו בסימולציה, בעוד ש-OghmaNano אחראית על הפעלת המודל הפיזיקלי תוך שימוש בקבצים הקיימים בספרייה הנוכחית.

הדוגמה שלהלן ממחישה תהליך זה על ידי טעינת sim.json, שינוי ניידות הנשאים בשכבה הראשונה של ההתקן, שמירת התצורה המעודכנת בדיסק, ולאחר מכן הפעלת הסימולציה מתוך תיקיית הסימולציה.הדוגמה שלהלן ממחישה תהליך זה על ידי טעינת sim.json, שינוי ניידות הנשאים בשכבה הראשונה של ההתקן, שמירת התצורה המעודכנת בדיסק, ולאחר מכן הפעלת הסימולציה מתוך תיקיית הסימולציה.


% 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 מוגדרת כך שתבצע הדמיה של עקומת J–V, OghmaNano תיצור קבצי פלט בספריית הסימולציה, אשר יכילו נתונים כגון PCE, מקדם מילוי, \(J_{sc}\) ו-\(V_{oc}\).אם הסימולציה ב-sim.json מוגדרת כך שתבצע הדמיה של עקומת J–V, OghmaNano תיצור קבצי פלט בספריית הסימולציה, אשר יכילו נתונים כגון PCE, מקדם מילוי, \(J_{sc}\) ו-\(V_{oc}\).

3. חילוץ התוצאות3. חילוץ התוצאות

קובצי פלט רבים של OghmaNano כתובים בפורמט JSON. תבנית נפוצה היא לקרוא את sim_info.dat, לחלץ ערך מספרי המייצג מדד ביצועים (לדוגמה, Voc), ולצרף אותו לקובץ טקסט לצורך ניתוח עתידי.קובצי פלט רבים של OghmaNano כתובים בפורמט JSON. תבנית נפוצה היא לקרוא את sim_info.dat, לחלץ ערך מספרי המייצג מדד ביצועים (לדוגמה, Voc), ולצרף אותו לקובץ טקסט לצורך ניתוח עתידי.

הדוגמה שלהלן קוראת את הערך של sim_info.dat ומוסיפה את הערך של \(V_{oc}\) לקובץ טקסט נפרד.הדוגמה שלהלן קוראת את הערך של sim_info.dat ומוסיפה את הערך של \(V_{oc}\) לקובץ טקסט נפרד.


% 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. סימולציות מורכבות יותר3. סימולציות מורכבות יותר

במספר תהליכי עבודה הכוללים שימוש בסקריפטים, ייתכן שתרצו להריץ את אותה הדמיה בסיסית מספר פעמים, עם ערכי פרמטרים שונים, ולשמור כל הרצה בנפרד בתיקייה משלה. זוהי הדרך הפשוטה ביותר לשמור על פלט נקי ולמנוע מחיקה מקרית של תוצאות.במספר תהליכי עבודה הכוללים שימוש בסקריפטים, ייתכן שתרצו להריץ את אותה הדמיה בסיסית מספר פעמים, עם ערכי פרמטרים שונים, ולשמור כל הרצה בנפרד בתיקייה משלה. זוהי הדרך הפשוטה ביותר לשמור על פלט נקי ולמנוע מחיקה מקרית של תוצאות.

הדוגמה שלהלן יוצרת סדרה של תיקיות, כאשר כל תיקייה מתאימה לאחד מארבעת סוגי הניידות (1e-5, 1e-6, 1e-7, 1e-8). עבור כל תיקייה, היא מבצעת את הפעולות הבאות:הדוגמה שלהלן יוצרת סדרה של תיקיות, כאשר כל תיקייה מתאימה לאחד מארבעת סוגי הניידות (1e-5, 1e-6, 1e-7, 1e-8). עבור כל תיקייה, היא מבצעת את הפעולות הבאות:

  1. יוצר את התיקייה (אם היא עדיין לא קיימת).יוצר את התיקייה (אם היא עדיין לא קיימת).
  2. מעתיק את הגרסה הנוכחית של sim.json לספרייה זו.מעתיק את הגרסה הנוכחית של sim.json לספרייה זו.
  3. עורך את הנתונים המועתקים של sim.json כדי להגדיר את ערך הניידות הרצוי.עורך את הנתונים המועתקים של sim.json כדי להגדיר את ערך הניידות הרצוי.
  4. משנה את ספריית העבודה לספרייה הנוכחית.משנה את ספריית העבודה לספרייה הנוכחית.
  5. מפעיל את הפותר בספרייה זו, ומייצר פלט ששמור באופן מקומי עבור הרצה זו.מפעיל את הפותר בספרייה זו, ומייצר פלט ששמור באופן מקומי עבור הרצה זו.

תבנית זו היא הבסיס ליצירת סקריפטים לאוטומציה של משימות ב-OghmaNano: תיקייה אחת לכל הרצה, קובץ תצורה אחד לכל הרצה, ותיקיית פלט נקייה עבור כל ערך פרמטר.תבנית זו היא הבסיס ליצירת סקריפטים לאוטומציה של משימות ב-OghmaNano: תיקייה אחת לכל הרצה, קובץ תצורה אחד לכל הרצה, ותיקיית פלט נקייה עבור כל ערך פרמטר.


% 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. שליפת התוצאות4. שליפת התוצאות

לאחר הפעלת סדרת הדמיות בספריות נפרדות (לדוגמה mu_1e-05, mu_1e-06, ...), השלב הבא הוא לחלץ מדד ביצועים מרכזי מכל הדמיה ולהציג את המגמה הגרפית. דוגמה נפוצה היא לקרוא את מתח המעגל הפתוח \(V_{oc}\) מ-sim_info.dat בכל ספרייה ולשרטט אותו כנגד הניידות ההפוכה \(1/\mu\).לאחר הפעלת סדרת הדמיות בספריות נפרדות (לדוגמה mu_1e-05, mu_1e-06, ...), השלב הבא הוא לחלץ מדד ביצועים מרכזי מכל הדמיה ולהציג את המגמה הגרפית. דוגמה נפוצה היא לקרוא את מתח המעגל הפתוח \(V_{oc}\) מ-sim_info.dat בכל ספרייה ולשרטט אותו כנגד הניידות ההפוכה \(1/\mu\).

הסקריפט המצורף סורק קבוצה קבועה של תיקיות, שכל אחת מהן מתאימה לערכי ניידות 1e-5, 1e-6, 1e-7, 1e-8, ולכל תיקייה:הסקריפט המצורף סורק קבוצה קבועה של תיקיות, שכל אחת מהן מתאימה לערכי ניידות 1e-5, 1e-6, 1e-7, 1e-8, ולכל תיקייה:

  1. טען את הנתונים sim_info.dat בפורמט JSON.טען את הנתונים sim_info.dat בפורמט JSON.
  2. קטעים Voc.קטעים Voc.
  3. מחשב את \(1/\mu\) באמצעות הניידות המשויכת לספרייה זו.מחשב את \(1/\mu\) באמצעות הניידות המשויכת לספרייה זו.
  4. יוצר קובץ סיכום קצר (voc_vs_inv_mobility.dat).יוצר קובץ סיכום קצר (voc_vs_inv_mobility.dat).
  5. גרפים \(V_{oc}\) לעומת \(1/\mu\).גרפים \(V_{oc}\) לעומת \(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;