Scripturi PythonScripturi Python
1. Introducere1. Introducere
În OghmaNano, scripturile Python funcționează prin modificarea 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 Python funcționează prin modificarea 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 Python.2. Executarea fișierelor de simulare cu Python.
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 Python, scriptul citește sim.json în memorie folosind biblioteca standard json a Python, modifică unul sau mai mulți parametri și scrie datele JSON actualizate înapoi pe disc.Atunci când se utilizează OghmaNano din Python, scriptul citește sim.json în memorie folosind biblioteca standard json a Python, modifică unul sau mai mulți parametri și scrie datele JSON actualizate înapoi pe disc.
În mod esențial, scriptul Python trebuie executat cu directorul său de lucru setat la directorul de simulare – adică, directorul care conține sim.json (și sim.oghma). Acesta este directorul din care este lansat oghma_core.exe.În mod esențial, scriptul Python trebuie executat cu directorul său de lucru setat la directorul de simulare – adică, directorul care conține sim.json (și sim.oghma). Acesta este directorul din care este lansat oghma_core.exe.
După actualizarea fișierului JSON, scriptul lansează oghma_core.exe din același director. 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.După actualizarea fișierului JSON, scriptul lansează oghma_core.exe din același director. 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ă: Python este responsabil pentru definirea modificărilor care vor avea loc î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ă: Python este responsabil pentru definirea modificărilor care vor avea loc î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.
import json
import os
import sys
f=open('sim.json') #open the sim.json file
lines=f.readlines()
f.close()
lines="".join(lines) #convert the text to a python json object
data = json.loads(lines)
#Edit a value (use firefox as a json viewer
# to help you figure out which value to edit)
# this time we are editing the mobility of layer 1
data['epitaxy']['segment1']['shape_dos']['mue_y']=1.0
#convert the json object back to a string
jstr = json.dumps(data, sort_keys=False, indent='\t')
#write it back to disk
f=open('sim.json',"w")
f.write(jstr)
f.close()
#run the simulation using oghma_core
os.system("oghma_core.exe")
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}\).
Exemplul de mai jos ilustrează modul în care se poate citi un fișier de ieșire în format JSON și se poate adăuga valoarea \(V_{oc}\) într-un fișier text separat.Exemplul de mai jos ilustrează modul în care se poate citi un fișier de ieșire în format JSON și se poate adăuga valoarea \(V_{oc}\) într-un fișier text separat.
f=open('sim_info.dat')
lines=f.readlines()
f.close()
lines="".join(lines)
data = json.loads(lines)
f=open('out.dat',"a")
f.write(str(data["Voc"])+"\n");
f.close()
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.
import json
import os
import shutil
# The script must be started in the base simulation directory
# (i.e. the directory containing the reference sim.json).
base_dir = os.getcwd()
mobilities = [1e-5, 1e-6, 1e-7, 1e-8]
for mu in mobilities:
# Create a directory name that is easy to read and sorts nicely
run_dir = os.path.join(base_dir, f"mu_{mu:.0e}")
os.makedirs(run_dir, exist_ok=True)
# Copy the base sim.json into the run directory
src_sim = os.path.join(base_dir, "sim.json")
dst_sim = os.path.join(run_dir, "sim.json")
shutil.copyfile(src_sim, dst_sim)
# Load the copied sim.json and edit the mobility in THAT copy
f = open(dst_sim)
lines = f.readlines()
f.close()
lines = "".join(lines)
data = json.loads(lines)
# Edit a value: set the mobility for the first device layer
data['epitaxy']['segment1']['shape_dos']['mue_y'] = mu
jstr = json.dumps(data, sort_keys=False, indent='\t')
f = open(dst_sim, "w")
f.write(jstr)
f.close()
# Change into the run directory and execute the solver there
os.chdir(run_dir)
# If your command is "augment.nano" instead, replace the string below.
os.system("oghma_core.exe")
# Return to the base directory for the next run
os.chdir(base_dir)
După execuția programului, fiecare director va conține rezultatele corespunzătoare valorii de mobilitate respective. În secțiunea următoare, vom extinde acest script pentru a colecta rezultatele cheie din fiecare execuție și a le agrega într-un singur fișier sumar.După execuția programului, fiecare director va conține rezultatele corespunzătoare valorii de mobilitate respective. În secțiunea următoare, vom extinde acest script pentru a colecta rezultatele cheie din fiecare execuție și a le agrega într-un singur fișier sumar.
Reprezentarea grafică a valorilor \(V_{oc}\) în funcție de inversa mobilității.Reprezentarea grafică a valorilor \(V_{oc}\) în funcție de inversa mobilității.
După ce ați efectuat o serie de simulări în directoare separate, următorul pas este, de obicei, să extrageți un indicator cheie de performanță din fiecare simulare și să vizualizați tendința. Un exemplu comun este să citiți tensiunea în circuit deschis \(V_{oc}\) din fișierul de ieșire JSON (sim_info.dat) și să o reprezentați grafic în funcție de mobilitatea inversă \(1/\mu\).După ce ați efectuat o serie de simulări în directoare separate, următorul pas este, de obicei, să extrageți un indicator cheie de performanță din fiecare simulare și să vizualizați tendința. Un exemplu comun este să citiți tensiunea în circuit deschis \(V_{oc}\) din fișierul de ieșire JSON (sim_info.dat) și să o reprezentați grafic în funcție de mobilitatea inversă \(1/\mu\).
Scriptul de mai jos analizează un set de directoare (de exemplu, mu_1e-05, mu_1e-06, ...) și, pentru fiecare director:Scriptul de mai jos analizează un set de directoare (de exemplu, mu_1e-05, mu_1e-06, ...) și, pentru fiecare director:
- Î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\).
import json
import os
# Optional: plotting (requires matplotlib)
import matplotlib.pyplot as plt
base_dir = os.getcwd()
# Mobilities must match the run directories you generated earlier
mobilities = [1e-5, 1e-6, 1e-7, 1e-8]
inv_mu = []
vocs = []
for mu in mobilities:
run_dir = os.path.join(base_dir, f"mu_{mu:.0e}")
info_path = os.path.join(run_dir, "sim_info.dat")
# Read the JSON output file and extract Voc
f = open(info_path)
lines = f.readlines()
f.close()
lines = "".join(lines)
data = json.loads(lines)
voc = data["Voc"]
inv_mu.append(1.0 / mu)
vocs.append(voc)
# Write a small summary table to disk
out = open("voc_vs_inv_mobility.dat", "w")
out.write("# inv_mobility(1/mu) Voc(V)\n")
for x, y in zip(inv_mu, vocs):
out.write(f"{x:.6e} {y}\n")
out.close()
# Plot Voc against inverse mobility
plt.plot(inv_mu, vocs, "o-")
plt.xlabel("Inverse mobility (1/μ)")
plt.ylabel("Open-circuit voltage Voc (V)")
plt.title("Voc vs inverse mobility")
plt.grid(True)
plt.tight_layout()
plt.show()
📺 Videoclipuri conexe📺 Videoclipuri conexe
Clipul video de mai jos demonstrează modul în care OghmaNano poate fi controlat prin intermediul scripturilor Python.Clipul video de mai jos demonstrează modul în care OghmaNano poate fi controlat prin intermediul scripturilor Python.
Notă: API-ul și interfața de scripting internă prezentate în videoclip nu mai sunt utilizate și nu mai sunt incluse în versiunile actuale, deoarece s-a dovedit că sunt dificil de întreținut. Fluxul de lucru actual și recomandat este utilizarea unui script Python extern pentru a edita direct fișierele de simulare JSON și apoi pentru a executa oghma_core.exe. Această abordare este mai simplă, mai robustă și mai ușor de întreținut. Este posibil să găsiți videoclipul util pentru a înțelege fluxul de lucru general și cazurile tipice de utilizare, dar pentru metoda actualizată, vă rugăm să urmați pașii descriși mai sus.Notă: API-ul și interfața de scripting internă prezentate în videoclip nu mai sunt utilizate și nu mai sunt incluse în versiunile actuale, deoarece s-a dovedit că sunt dificil de întreținut. Fluxul de lucru actual și recomandat este utilizarea unui script Python extern pentru a edita direct fișierele de simulare JSON și apoi pentru a executa oghma_core.exe. Această abordare este mai simplă, mai robustă și mai ușor de întreținut. Este posibil să găsiți videoclipul util pentru a înțelege fluxul de lucru general și cazurile tipice de utilizare, dar pentru metoda actualizată, vă rugăm să urmați pașii descriși mai sus.