Acasă Exemple Capturi de ecran Manual de utilizare Logo-ul Bluesky YouTube ☰
OghmaNano Platformă de simulare multifizică pentru dispozitive optoelectronice și sisteme fotonice. DESCARCĂ Ghid de utilizare rapidă

Crearea de scripturi în PowerShell.Crearea de scripturi în PowerShell.

1. Introducere1. Introducere

În OghmaNano, scripturile PowerShell funcționează prin editarea directă a fișierelor de configurare ale 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 PowerShell funcționează prin editarea directă a fișierelor de configurare ale 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 ajutorul PowerShell.2. Executarea fișierelor de simulare cu ajutorul PowerShell.

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 din PowerShell, scriptul citește sim.json în memorie, modifică unul sau mai mulți parametri și scrie datele JSON actualizate înapoi pe disc.Atunci când se utilizează OghmaNano din PowerShell, scriptul citește sim.json în memorie, modifică unul sau mai mulți parametri și scrie datele JSON actualizate înapoi pe disc.

În mod esențial, PowerShell trebuie să ruleze oghma_core.exe cu directorul său 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.În mod esențial, PowerShell trebuie să ruleze oghma_core.exe cu directorul său 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ă: PowerShell este responsabil pentru definirea modificărilor care vor fi aplicate în simulare, în timp ce OghmaNano este responsabil pentru executarea simulării fizice, utilizând fișierele prezente în directorul curent.Această împărțire a responsabilităților este intenționată și explicită: PowerShell este responsabil pentru definirea modificărilor care vor fi aplicate în simulare, în timp ce OghmaNano este responsabil pentru executarea simulării fizice, utilizând 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 = Join-Path $sim_dir "sim.json"
$txt = Get-Content -Path $sim_path -Raw
$data = $txt | ConvertFrom-Json

# Edit a value: mobility of segment1 (same JSON path as the Python/MATLAB pages)
$data.epitaxy.segment1.shape_dos.mue_y = 1.0

# Write sim.json back to disk
$out = $data | ConvertTo-Json -Depth 200
Set-Content -Path $sim_path -Value $out -Encoding UTF8

# Run the simulation (working directory must be the simulation folder)
$orig_dir = Get-Location
Set-Location $sim_dir
& "oghma_core.exe"
Set-Location $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 = Join-Path $sim_dir "sim_info.dat"

$txt = Get-Content -Path $info_path -Raw
$info = $txt | ConvertFrom-Json
$voc = $info.Voc

# Append to a text file (one Voc per line)
$out_path = Join-Path $sim_dir "out.dat"
Add-Content -Path $out_path -Value ("{0}" -f $voc)

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:

  1. Creează directorul (dacă acesta nu există deja).Creează directorul (dacă acesta nu există deja).
  2. Copiază fișierul sim.json în directorul respectiv.Copiază fișierul sim.json în directorul respectiv.
  3. Modifică sim.json copiat pentru a seta valoarea dorită a mobilității.Modifică sim.json copiat pentru a seta valoarea dorită a mobilității.
  4. Modifică directorul de lucru, astfel încât acesta să devină directorul specificat.Modifică directorul de lucru, astfel încât acesta să devină directorul specificat.
  5. 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 = (Get-Location).Path

$mobilities = @(1e-5, 1e-6, 1e-7, 1e-8)
$src_sim = Join-Path $base_dir "sim.json"

foreach ($mu in $mobilities) {
    $run_name = ("mu_{0:0e}" -f $mu)
    $run_dir  = Join-Path $base_dir $run_name

    if (-not (Test-Path -Path $run_dir -PathType Container)) {
        New-Item -ItemType Directory -Path $run_dir | Out-Null
    }

    # Copy the base sim.json into the run directory
    $dst_sim = Join-Path $run_dir "sim.json"
    Copy-Item -Path $src_sim -Destination $dst_sim -Force

    # Load the copied sim.json and edit the mobility in THAT copy
    $txt  = Get-Content -Path $dst_sim -Raw
    $data = $txt | ConvertFrom-Json
    $data.epitaxy.segment1.shape_dos.mue_y = [double]$mu

    $out = $data | ConvertTo-Json -Depth 200
    Set-Content -Path $dst_sim -Value $out -Encoding UTF8

    # Change into the run directory and execute the solver there
    Push-Location $run_dir
    & "oghma_core.exe"
    Pop-Location
}

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:

  1. Încarcă sim_info.dat în format JSON.Încarcă sim_info.dat în format JSON.
  2. Fragmente Voc.Fragmente Voc.
  3. Calculează \(1/\mu\) folosind mobilitatea asociată cu directorul respectiv.Calculează \(1/\mu\) folosind mobilitatea asociată cu directorul respectiv.
  4. 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).
  5. 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 = (Get-Location).Path

$mobilities = @(1e-5, 1e-6, 1e-7, 1e-8)

$inv_mu = @()
$vocs   = @()

foreach ($mu in $mobilities) {
    $run_dir = Join-Path $base_dir ("mu_{0:0e}" -f $mu)
    $info_path = Join-Path $run_dir "sim_info.dat"

    if (-not (Test-Path -Path $info_path -PathType Leaf)) {
        throw ("Missing sim_info.dat in: {0}" -f $run_dir)
    }

    $txt  = Get-Content -Path $info_path -Raw
    $info = $txt | ConvertFrom-Json

    $vocs   += [double]$info.Voc
    $inv_mu += (1.0 / [double]$mu)
}

# Write a small summary table to disk
$out_path = Join-Path $base_dir "voc_vs_inv_mobility.dat"
"# inv_mobility(1/mu)    Voc(V)" | Set-Content -Path $out_path -Encoding UTF8
for ($i = 0; $i -lt $mobilities.Count; $i++) {
    ("{0:e6}    {1}" -f $inv_mu[$i], $vocs[$i]) | Add-Content -Path $out_path -Encoding UTF8
}

# Plot Voc vs inverse mobility
# PowerShell does not have a built-in plotting window. The simplest workflow is to
# load voc_vs_inv_mobility.dat into your plotting tool of choice (MATLAB, Python, Excel, etc.).