Python betik diliPython betik dili
1. Giriş1. Giriş
OghmaNano'da, Python 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 çalışır. Bu bölüm, bu iş akışını ayrıntılı olarak açıklamaktadır.OghmaNano'da, Python 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 çalışır. Bu bölüm, bu iş akışını ayrıntılı olarak açıklamaktadır.
2. Python ile simülasyon dosyalarını çalıştırma2. Python 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.
OghmaNano'yu Python üzerinden çalıştırdığınızda, betik, Python'ın standart json kütüphanesini kullanarak sim.json'i belleğe yükler, bir veya daha fazla parametreyi değiştirir ve güncellenmiş JSON verisini tekrar diske yazar.OghmaNano'yu Python üzerinden çalıştırdığınızda, betik, Python'ın standart json kütüphanesini kullanarak sim.json'i belleğe yükler, bir veya daha fazla parametreyi değiştirir ve güncellenmiş JSON verisini tekrar diske yazar.
Önemli olarak, Python betiğinin, çalışma dizininin simülasyon dizinine ayarlanarak çalıştırılması gerekir; yani, sim.json (ve sim.oghma) dosyalarını içeren dizin. oghma_core.exe, bu dizinden başlatılır.Önemli olarak, Python betiğinin, çalışma dizininin simülasyon dizinine ayarlanarak çalıştırılması gerekir; yani, sim.json (ve sim.oghma) dosyalarını içeren dizin. oghma_core.exe, bu dizinden başlatılır.
JSON dosyası güncellendikten sonra, betik oghma_core.exe'i aynı dizinden başlatır. 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.JSON dosyası güncellendikten sonra, betik oghma_core.exe'i aynı dizinden başlatır. 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çıktır: Python, simülasyonda hangi değişikliklerin yapılacağını tanımlamaktan sorumludur; OghmaNano ise mevcut dizindeki dosyalarda bulunan verileri kullanarak fiziksel hesaplamaları gerçekleştirmekten sorumludur.Bu sorumlulukların ayrılması kasıtlı ve açıktır: Python, simülasyonda hangi değişikliklerin yapılacağını tanımlamaktan 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.
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")
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.
Aşağıdaki örnek, bir JSON çıktı dosyasının nasıl okunacağını ve \(V_{oc}\) değerinin ayrı bir metin dosyasına nasıl ekleneceğini göstermektedir.Aşağıdaki örnek, bir JSON çıktı dosyasının nasıl okunacağını ve \(V_{oc}\) değerinin ayrı bir metin dosyasına nasıl ekleneceğini göstermektedir.
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. 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ü.
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)
Her bir çalıştırma işleminden sonra, her dizin, o hareketlilik değerine karşılık gelen çıktıları içerecektir. Bir sonraki bölümde, bu betiği genişleterek her bir çalıştırmadan elde edilen önemli sonuçları toplayacak ve bunları tek bir özet dosyasında birleştireceğiz.Her bir çalıştırma işleminden sonra, her dizin, o hareketlilik değerine karşılık gelen çıktıları içerecektir. Bir sonraki bölümde, bu betiği genişleterek her bir çalıştırmadan elde edilen önemli sonuçları toplayacak ve bunları tek bir özet dosyasında birleştireceğiz.
\(V_{oc}\)'i ters hareketliliğe karşı çizerek grafik oluşturma\(V_{oc}\)'i ters hareketliliğe karşı çizerek grafik oluşturma
Ayrı dizinlerde bir dizi simülasyon çalıştırdıktan sonra, genellikle bir sonraki adım, her bir çalıştırmadan önemli bir performans ölçütü elde etmek ve bu ölçütün eğilimini görselleştirmektir. Yaygın bir örnek, JSON çıktı dosyasından (sim_info.dat) açık devre voltajını (\(V_{oc}\)) okumak ve bunu ters hareketliliğe (\(1/\mu\)) karşı çizerek göstermektir.Ayrı dizinlerde bir dizi simülasyon çalıştırdıktan sonra, genellikle bir sonraki adım, her bir çalıştırmadan önemli bir performans ölçütü elde etmek ve bu ölçütün eğilimini görselleştirmektir. Yaygın bir örnek, JSON çıktı dosyasından (sim_info.dat) açık devre voltajını (\(V_{oc}\)) okumak ve bunu ters hareketliliğe (\(1/\mu\)) karşı çizerek göstermektir.
Aşağıdaki betik, bir dizi çalıştırma dizinini (örneğin mu_1e-05, mu_1e-06, ...) tarar ve her bir dizin için şunları yapar:Aşağıdaki betik, bir dizi çalıştırma dizinini (örneğin mu_1e-05, mu_1e-06, ...) tarar ve her bir 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.
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()
📺 İlgili video📺 İlgili video
Aşağıdaki video, OghmaNano'nun Python betikleri kullanılarak nasıl kontrol edilebileceğini göstermektedir.Aşağıdaki video, OghmaNano'nun Python betikleri kullanılarak nasıl kontrol edilebileceğini göstermektedir.
Not: Videoda gösterilen API ve dahili komut dosyası arayüzü artık kullanımdan kaldırılmıştır ve güncellenmemiştir, çünkü bakımının zor olduğu anlaşılmıştır. Şu anki ve önerilen yöntem, harici bir Python komut dosyası kullanarak JSON simülasyon dosyalarını doğrudan düzenlemek ve ardından oghma_core.exe'i çalıştırmaktır. Bu yaklaşım daha basit, daha sağlam ve bakımı daha kolaydır. Videonun genel iş akışını ve tipik kullanım senaryolarını anlamak için hala faydalı olabileceğini unutmayın, ancak en güncel yöntem için yukarıda açıklanan adımları izleyin.Not: Videoda gösterilen API ve dahili komut dosyası arayüzü artık kullanımdan kaldırılmıştır ve güncellenmemiştir, çünkü bakımının zor olduğu anlaşılmıştır. Şu anki ve önerilen yöntem, harici bir Python komut dosyası kullanarak JSON simülasyon dosyalarını doğrudan düzenlemek ve ardından oghma_core.exe'i çalıştırmaktır. Bu yaklaşım daha basit, daha sağlam ve bakımı daha kolaydır. Videonun genel iş akışını ve tipik kullanım senaryolarını anlamak için hala faydalı olabileceğini unutmayın, ancak en güncel yöntem için yukarıda açıklanan adımları izleyin.