Oghma dosya biçimiOghma dosya biçimi
1. JSON nedir?1. JSON nedir?
sim.json dosyası örneği, bir OghmaNano simülasyonunun temelindeki JSON yapısını göstermektedir.Firefox'ta açılan bir sim.json dosyası örneği, bir OghmaNano simülasyonunun temelindeki JSON yapısını göstermektedir.OghmaNano, simülasyon bilgilerini bir JSON dosyası içinde saklar. JSON (JavaScript Nesne Gösterimi), yapılandırılmış verileri depolamak ve iletmek için kullanılan çok basit, metin tabanlı bir formattır. Hem insanlar tarafından kolayca okunabilir olması hem de makineler tarafından kolayca işlenebilir olması nedeniyle bilimsel yazılımlarda yaygın olarak kullanılır. JSON yapılarının genel örneklerini https://json.org/example.html adresinde görebilirsiniz.OghmaNano, simülasyon bilgilerini bir JSON dosyası içinde saklar. JSON (JavaScript Nesne Gösterimi), yapılandırılmış verileri depolamak ve iletmek için kullanılan çok basit, metin tabanlı bir formattır. Hem insanlar tarafından kolayca okunabilir olması hem de makineler tarafından kolayca işlenebilir olması nedeniyle bilimsel yazılımlarda yaygın olarak kullanılır. JSON yapılarının genel örneklerini https://json.org/example.html adresinde görebilirsiniz.
JSON'un nasıl çalıştığını göstermek için aşağıda basit bir örnek verilmiştir. Bir JSON dosyası, kıvrımlı parantezlerle { } başlayan ve biten bölümlerden oluşur. Her bölüm, "color_of_dog", "dog_age" veya "dogs_toys" gibi belirteçler veya etiketler içerir. Bu belirteçler her zaman çift tırnak içinde yazılmalı ve ardından iki nokta : ile ilişkili veri değeri gelmelidir. Metin değerleri çift tırnak içine alınırken, tam sayılar veya ondalık sayılar gibi sayılar tırnak kullanılmadan yazılır. OghmaNano'da, mantıksal değerlere benzer değerler "true" veya "false" dizeleri olarak saklanır. Dosyanın geçerli olabilmesi için tüm açılış ve kapanış parantezleri doğru şekilde hizalanmalıdır. Bir bölüm içindeki öğeler virgülle ayrılır; ancak son öğe virgülle bitmez. ??.JSON'un nasıl çalıştığını göstermek için aşağıda basit bir örnek verilmiştir. Bir JSON dosyası, kıvrımlı parantezlerle { } başlayan ve biten bölümlerden oluşur. Her bölüm, "color_of_dog", "dog_age" veya "dogs_toys" gibi belirteçler veya etiketler içerir. Bu belirteçler her zaman çift tırnak içinde yazılmalı ve ardından iki nokta : ile ilişkili veri değeri gelmelidir. Metin değerleri çift tırnak içine alınırken, tam sayılar veya ondalık sayılar gibi sayılar tırnak kullanılmadan yazılır. OghmaNano'da, mantıksal değerlere benzer değerler "true" veya "false" dizeleri olarak saklanır. Dosyanın geçerli olabilmesi için tüm açılış ve kapanış parantezleri doğru şekilde hizalanmalıdır. Bir bölüm içindeki öğeler virgülle ayrılır; ancak son öğe virgülle bitmez. ??.
{
"color_of_dog": "brown",
"dog_age": 5,
"dogs_toys":
{
"rabbit": "true",
"stick": "false"
}
}
JSON yapısının örneği.Basit bir JSON yapısının örneği.OghmaNano, tüm simülasyon verilerini depolamak için aynı JSON ilkelerini kullanır. Bu bilgiler, cihaz parametrelerinin, simülasyon ayarlarının ve çıktı yapılandırmasının tamamını içeren sim.json adlı bir dosyada bulunur. Her simülasyonun kendi sim.json dosyası olacaktır. Bu dosyayı herhangi bir metin düzenleyicide açabilirsiniz, ancak genellikle özel bir JSON görüntüleyici kullanmak daha kolaydır, çünkü bu görüntüleyici verileri kolayca okunabilir bir ağaç yapısı şeklinde biçimlendirir. Firefox'ta kullanışlı bir yerleşik JSON görüntüleyici bulunur. Firefox'ta görüntülenen bir sim.json dosyası örneği aşağıda ??'de gösterilmiştir.OghmaNano, tüm simülasyon verilerini depolamak için aynı JSON ilkelerini kullanır. Bu bilgiler, cihaz parametrelerinin, simülasyon ayarlarının ve çıktı yapılandırmasının tamamını içeren sim.json adlı bir dosyada bulunur. Her simülasyonun kendi sim.json dosyası olacaktır. Bu dosyayı herhangi bir metin düzenleyicide açabilirsiniz, ancak genellikle özel bir JSON görüntüleyici kullanmak daha kolaydır, çünkü bu görüntüleyici verileri kolayca okunabilir bir ağaç yapısı şeklinde biçimlendirir. Firefox'ta kullanışlı bir yerleşik JSON görüntüleyici bulunur. Firefox'ta görüntülenen bir sim.json dosyası örneği aşağıda ??'de gösterilmiştir.
Son bir nokta: sim.json temel yapılandırma dosyası olsa da, her zaman tek başına saklanmaz. Bunun yerine, OghmaNano genellikle bunu bir sim.oghma dosyası içinde paketler; bu da sadece standart bir ZIP arşividir; bu, yerden tasarruf etmek içindir. sim.oghma'ü sim.zip olarak yeniden adlandırırsanız, Windows Gezgini veya herhangi bir ZIP görüntüleyici ile açabilir ve sim.json'i çıkarabilirsiniz. sim.json'nın bir kopyasını aynı simülasyon dizinine yerleştirip arşivi tekrar sim.oghma olarak yeniden adlandırırsanız, OghmaNano, sim.json'in arşivlenmiş sürümünü yok sayar ve bunun yerine düz metin sim.json dosyanızı kullanır. Bu özellik, herhangi bir programlama dili kullanarak sim.json'u doğrudan düzenleyebileceğiniz ve ZIP dosyalarını değiştirmeye gerek kalmayacağı için otomasyon için son derece kullanışlıdır.Son bir nokta: sim.json temel yapılandırma dosyası olsa da, her zaman tek başına saklanmaz. Bunun yerine, OghmaNano genellikle bunu bir sim.oghma dosyası içinde paketler; bu da sadece standart bir ZIP arşividir; bu, yerden tasarruf etmek içindir. sim.oghma'ü sim.zip olarak yeniden adlandırırsanız, Windows Gezgini veya herhangi bir ZIP görüntüleyici ile açabilir ve sim.json'i çıkarabilirsiniz. sim.json'nın bir kopyasını aynı simülasyon dizinine yerleştirip arşivi tekrar sim.oghma olarak yeniden adlandırırsanız, OghmaNano, sim.json'in arşivlenmiş sürümünü yok sayar ve bunun yerine düz metin sim.json dosyanızı kullanır. Bu özellik, herhangi bir programlama dili kullanarak sim.json'u doğrudan düzenleyebileceğiniz ve ZIP dosyalarını değiştirmeye gerek kalmayacağı için otomasyon için son derece kullanışlıdır.
2. OghmaNano dosya formatı2. OghmaNano dosya formatı
OghmaNano, simülasyon yapılandırma dosyasında, yani sim.json adlı dosyada tam olarak bu ilkeleri uygular. Bu dosya, bir cihazın yapısını tanımlamak, gerçekleştirilecek simülasyonları belirlemek ve çözümleyicileri yapılandırmak için gereken her şeyi içerir. Her simülasyon dizini, kendi sim.json dosyasını içerecektir. Bu dosyayı herhangi bir metin düzenleyicide açabilirsiniz, ancak genellikle Firefox gibi bir JSON görüntüleyici kullanmak daha pratiktir; bu, verileri otomatik olarak biçimlendirilmiş bir ağaç görünümü şeklinde sunar.OghmaNano, simülasyon yapılandırma dosyasında, yani sim.json adlı dosyada tam olarak bu ilkeleri uygular. Bu dosya, bir cihazın yapısını tanımlamak, gerçekleştirilecek simülasyonları belirlemek ve çözümleyicileri yapılandırmak için gereken her şeyi içerir. Her simülasyon dizini, kendi sim.json dosyasını içerecektir. Bu dosyayı herhangi bir metin düzenleyicide açabilirsiniz, ancak genellikle Firefox gibi bir JSON görüntüleyici kullanmak daha pratiktir; bu, verileri otomatik olarak biçimlendirilmiş bir ağaç görünümü şeklinde sunar.
En üst düzeyde, sim.json az sayıda üst düzey bölümden oluşur. Bu bölümler daha sonra daha ayrıntılı alt bölümlere ayrılır; örneğin, ortak girişim analizleri, EQE testleri veya cihaz katmanı tanımları gibi. Mevcut formatta yer alan ana üst düzey bölümler aşağıdaki tabloda özetlenmiştir: ??.En üst düzeyde, sim.json az sayıda üst düzey bölümden oluşur. Bu bölümler daha sonra daha ayrıntılı alt bölümlere ayrılır; örneğin, ortak girişim analizleri, EQE testleri veya cihaz katmanı tanımları gibi. Mevcut formatta yer alan ana üst düzey bölümler aşağıdaki tabloda özetlenmiştir: ??.
| BölümBölüm | AmaçAmaç |
|---|---|
simsim | Genel meta veriler (örneğin, sürüm, çalışma modu, notlar)Genel meta veriler (örneğin, sürüm, çalışma modu, notlar) |
simssims | Tüm simülasyon tanımları (JV, Suns-Voc, EQE, PL, zaman alanı, ışın izleme, FDTD vb.)Tüm simülasyon tanımları (JV, Suns-Voc, EQE, PL, zaman alanı, ışın izleme, FDTD vb.) |
epitaxyepitaxy | Cihaz yapısı: katmanlar, bağlantı noktaları, geometri, malzemelerCihaz yapısı: katmanlar, bağlantı noktaları, geometri, malzemeler |
mathmath | Sayısal çözümleyici ayarları ve tolerans değerleriSayısal çözümleyici ayarları ve tolerans değerleri |
opticaloptical | Optik modeller, ışık kaynakları, algılayıcılar, ağlarOptik modeller, ışık kaynakları, algılayıcılar, ağlar |
dumpdump | Çıktı ayarları: ayrıntı düzeyi, testler, dosya formatlarıÇıktı ayarları: ayrıntı düzeyi, testler, dosya formatları |
serverserver | Çalışma süresi/paralelleştirme (iş parçacıkları, GPU, zaman sınırlamaları)Çalışma süresi/paralelleştirme (iş parçacıkları, GPU, zaman sınırlamaları) |
sim.json belgesinde önemli üst düzey bölümler tespit edildi.Bu sim.json belgesinde önemli üst düzey bölümler tespit edildi.3. OghmaNano JSON formatının özellikleri ve dikkat çekici yönleri3. OghmaNano JSON formatının özellikleri ve dikkat çekici yönleri
-
OghmaNano JSON dosyası, standart JSON listelerini desteklemez, örneğin ["Kırmızı", "Yeşil", "Mavi"]. Eğer bir öğe listesi varsa, öncelikle değişken segmentleri tanımlanarak, listedeki öğe sayısıyla birlikte örneğin "segmentler", 0 şeklinde belirtilir. Listedeki her bir öğe daha sonra "segment0", "segment1" vb. altında saklanır. Bu format, OghmaNano'nun, okuma işleminden önce yapıları okumak için gereken belleği tahsis etmesini sağlar. Bu durum, 1 segment içeren bir liste bulunan 14.1 şeklindeki görselde görülebilir.OghmaNano JSON dosyası, standart JSON listelerini desteklemez, örneğin ["Kırmızı", "Yeşil", "Mavi"]. Eğer bir öğe listesi varsa, öncelikle değişken segmentleri tanımlanarak, listedeki öğe sayısıyla birlikte örneğin "segmentler", 0 şeklinde belirtilir. Listedeki her bir öğe daha sonra "segment0", "segment1" vb. altında saklanır. Bu format, OghmaNano'nun, okuma işleminden önce yapıları okumak için gereken belleği tahsis etmesini sağlar. Bu durum, 1 segment içeren bir liste bulunan 14.1 şeklindeki görselde görülebilir.
-
JSON dosyasındaki birçok öğeye, 16 haneli onaltılık bir koddan oluşan bir kimlik numarası atanacaktır; bu, öğeyi benzersiz bir şekilde tanımlamak için kullanılabilir. Bir kimlik numarası ayrıca 14.1 şekilinde de görülebilir. Bu kimlik numaraları rastgele oluşturulur, ancak her kimlik numarası benzersiz olmalıdır. Kimlik numaraları, örneğin epitaksi katmanları gibi nesnelerin, aynı ada sahip olsalar bile benzersiz bir şekilde tanımlanmasını sağlar.JSON dosyasındaki birçok öğeye, 16 haneli onaltılık bir koddan oluşan bir kimlik numarası atanacaktır; bu, öğeyi benzersiz bir şekilde tanımlamak için kullanılabilir. Bir kimlik numarası ayrıca 14.1 şekilinde de görülebilir. Bu kimlik numaraları rastgele oluşturulur, ancak her kimlik numarası benzersiz olmalıdır. Kimlik numaraları, örneğin epitaksi katmanları gibi nesnelerin, aynı ada sahip olsalar bile benzersiz bir şekilde tanımlanmasını sağlar.
4. Kodlama4. Kodlama
OghmaNano tarafından okunan/yazılan .json dosyaları her zaman UTF-8 formatında saklanır. OghmaNano, UTF-16 veya diğer herhangi bir metin kodlama standardını desteklemez. Günümüzde Windows Not Defteri ve çoğu diğer uygulama varsayılan olarak UTF-8 kullanır, bu nedenle bu metin depolama formatlarının ne olduğunu bilmiyorsanız, bu muhtemelen bir sorun teşkil etmez. Bu durum, C++ gibi bir dilde programatik olarak .oghma dosyaları oluşturmaya başlarsanız ve alfabesinde Latin olmayan karakterler bulunan Çince veya Rusça gibi bir dil kullanırsanız ortaya çıkabilir.OghmaNano tarafından okunan/yazılan .json dosyaları her zaman UTF-8 formatında saklanır. OghmaNano, UTF-16 veya diğer herhangi bir metin kodlama standardını desteklemez. Günümüzde Windows Not Defteri ve çoğu diğer uygulama varsayılan olarak UTF-8 kullanır, bu nedenle bu metin depolama formatlarının ne olduğunu bilmiyorsanız, bu muhtemelen bir sorun teşkil etmez. Bu durum, C++ gibi bir dilde programatik olarak .oghma dosyaları oluşturmaya başlarsanız ve alfabesinde Latin olmayan karakterler bulunan Çince veya Rusça gibi bir dil kullanırsanız ortaya çıkabilir.
5. Dosya formatının eski ve yeni sürümlerle uyumluluğu5. Dosya formatının eski ve yeni sürümlerle uyumluluğu
OghmaNano'nun yeni sürümlerinin, eski sürümlerde oluşturulan dosyaları okuyabildiğinden emin olmak için önemli çaba gösterilmektedir. Ancak, OghmaNano'nun eski sürümleri, daha yeni sürümlerde oluşturulan dosyaları okuyamayabilir. Kullanıcı her seferinde GUI aracını kullanarak bir sim.oghma dosyası açtığında, dosya formatı kontrol edilir ve mevcut sürümde kullanılan formattan farklıysa, dosya güncellenir ve tekrar diske yazılır. OghmaNano'yu \(oghma\_core.exe\)'i doğrudan çağırarak başsız bir yapılandırmada kullanıyorsanız, \(oghma\_core.exe\)'yi çalıştırmadan önce eski model sürümlerinden gelen sim.oghma dosyalarını açarken, dosyanın doğru formatta olduğundan emin olmak için öncelikle GUI'de açtığınızdan emin olun.OghmaNano'nun yeni sürümlerinin, eski sürümlerde oluşturulan dosyaları okuyabildiğinden emin olmak için önemli çaba gösterilmektedir. Ancak, OghmaNano'nun eski sürümleri, daha yeni sürümlerde oluşturulan dosyaları okuyamayabilir. Kullanıcı her seferinde GUI aracını kullanarak bir sim.oghma dosyası açtığında, dosya formatı kontrol edilir ve mevcut sürümde kullanılan formattan farklıysa, dosya güncellenir ve tekrar diske yazılır. OghmaNano'yu \(oghma\_core.exe\)'i doğrudan çağırarak başsız bir yapılandırmada kullanıyorsanız, \(oghma\_core.exe\)'yi çalıştırmadan önce eski model sürümlerinden gelen sim.oghma dosyalarını açarken, dosyanın doğru formatta olduğundan emin olmak için öncelikle GUI'de açtığınızdan emin olun.
6. İpuçları6. İpuçları
OghmaNano sim.json dosyasındaki belirli bir parametrenin nerede saklandığından emin değilseniz, oldukça etkili bir yöntem, dosyanın iki farklı sürümünü karşılaştırmak ve hangi değişikliklerin yapıldığını görmektir. Bunu yapmanın bir yolu, KDiff3 gibi bir dosya karşılaştırma aracı kullanmaktır.OghmaNano sim.json dosyasındaki belirli bir parametrenin nerede saklandığından emin değilseniz, oldukça etkili bir yöntem, dosyanın iki farklı sürümünü karşılaştırmak ve hangi değişikliklerin yapıldığını görmektir. Bunu yapmanın bir yolu, KDiff3 gibi bir dosya karşılaştırma aracı kullanmaktır.
İşlem oldukça basittir:İşlem oldukça basittir:
- Simülasyonunuzu OghmaNano kullanıcı arayüzünde açın.Simülasyonunuzu OghmaNano kullanıcı arayüzünde açın.
- İlgili parametreyi ayarlayın (örneğin, aktif katmanın kalınlığını veya bir voltaj ayarını değiştirin) ve simülasyonu kaydedin.İlgili parametreyi ayarlayın (örneğin, aktif katmanın kalınlığını veya bir voltaj ayarını değiştirin) ve simülasyonu kaydedin.
- Yeni
sim.jsondosyasını, KDiff3 (veya başka bir karşılaştırma aracı) kullanarak önceki sürümüyle karşılaştırın.Yenisim.jsondosyasını, KDiff3 (veya başka bir karşılaştırma aracı) kullanarak önceki sürümüyle karşılaştırın. - Farklı olan satırları bulun: bunlar, söz konusu parametrenin JSON yapısı içindeki tam olarak nerede saklandığını gösterecektir.Farklı olan satırları bulun: bunlar, söz konusu parametrenin JSON yapısı içindeki tam olarak nerede saklandığını gösterecektir.
Bu teknik, JSON dosyasındaki parametrelerin yolunu tam olarak bilmediğiniz durumlarda, bu parametreleri hızlı ve güvenilir bir şekilde bulmanızı sağlar. Özellikle çok sayıda iç içe geçmiş bölüm içeren karmaşık simülasyonlar için kullanışlıdır.Bu teknik, JSON dosyasındaki parametrelerin yolunu tam olarak bilmediğiniz durumlarda, bu parametreleri hızlı ve güvenilir bir şekilde bulmanızı sağlar. Özellikle çok sayıda iç içe geçmiş bölüm içeren karmaşık simülasyonlar için kullanışlıdır.
👉 Bir sonraki adım: Şimdi Parametre Tarama aracını kullanmaya devam edin; burada simülasyon parametrelerini sistematik olarak nasıl değiştirebileceğinizi ve sonuçları nasıl analiz edebileceğinizi öğrenebilirsiniz.👉 Bir sonraki adım: Şimdi Parametre Tarama aracını kullanmaya devam edin; burada simülasyon parametrelerini sistematik olarak nasıl değiştirebileceğinizi ve sonuçları nasıl analiz edebileceğinizi öğrenebilirsiniz.