Ana Sayfa Örnekler Ekran görüntüleri Kullanım kılavuzu Bluesky logosu YouTube ☰
OghmaNano Optoelektronik cihazlar ve fotonik sistemler için çoklu fizik simülasyon platformu İNDİR Hızlı Başlangıç Kılavuzu

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:

  1. Dizin mevcut değilse, dizini oluşturur.Dizin mevcut değilse, dizini oluşturur.
  2. Mevcut sim.json dosyasının bir kopyasını belirtilen dizine kopyalar.Mevcut sim.json dosyasının bir kopyasını belirtilen dizine kopyalar.
  3. Kopyalanan sim.json'i düzenleyerek hedef hareketliliği ayarlar.Kopyalanan sim.json'i düzenleyerek hedef hareketliliği ayarlar.
  4. Çalışma dizinini belirtilen dizine değiştirir.Çalışma dizinini belirtilen dizine değiştirir.
  5. Çö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:

  1. Yükler sim_info.dat JSON formatında.Yükler sim_info.dat JSON formatında.
  2. Alıntılar Voc.Alıntılar Voc.
  3. Bu dizinle ilişkili hareketlilik değerini kullanarak \(1/\mu\) hesaplar.Bu dizinle ilişkili hareketlilik değerini kullanarak \(1/\mu\) hesaplar.
  4. Küçük bir özet dosyası oluşturur (voc_vs_inv_mobility.dat).Küçük bir özet dosyası oluşturur (voc_vs_inv_mobility.dat).
  5. \(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.

OghmaNano'da bir perovskit güneş hücresi simülasyonu için Python betiği oluşturmaOghmaNano'da bir perovskit güneş hücresi simülasyonu için Python betiği oluşturma