Formatul de fișier Oghma.Formatul de fișier Oghma.
1. Ce este JSON?1. Ce este JSON?
sim.json deschis în Firefox, care prezintă structura JSON subiacentă a unei simulări OghmaNano.Un exemplu de fișier sim.json deschis în Firefox, care prezintă structura JSON subiacentă a unei simulări OghmaNano.OghmaNano stochează informațiile despre simulări într-un fișier JSON. JSON (JavaScript Object Notation) este un format foarte simplu, bazat pe text, folosit pentru stocarea și transmiterea datelor structurate. Este utilizat pe scară largă în software-ul științific, deoarece este ușor de înțeles atât de oameni, cât și de mașini. Puteți vedea exemple generale de structuri JSON la https://json.org/example.html.OghmaNano stochează informațiile despre simulări într-un fișier JSON. JSON (JavaScript Object Notation) este un format foarte simplu, bazat pe text, folosit pentru stocarea și transmiterea datelor structurate. Este utilizat pe scară largă în software-ul științific, deoarece este ușor de înțeles atât de oameni, cât și de mașini. Puteți vedea exemple generale de structuri JSON la https://json.org/example.html.
Pentru a ilustra modul în care funcționează JSON, mai jos este prezentat un exemplu simplu. Un fișier JSON este construit din secțiuni care încep și se termină cu paranteze acolade { }. Fiecare secțiune conține elemente sau etichete, cum ar fi "color_of_dog", "dog_age" sau "dogs_toys". Aceste elemente trebuie întotdeauna să fie scrise între ghilimele duble și sunt urmate de două puncte :, apoi de valoarea corespunzătoare. Valorile textuale sunt plasate între ghilimele duble, în timp ce numerele, cum ar fi numerele întregi sau zecimale, sunt scrise fără ghilimele. În OghmaNano, valorile de tip boolean sunt stocate ca șiruri de caractere "true" sau "false". Pentru ca fișierul să fie valid, toate parantezele de deschidere și de închidere trebuie să fie aliniate corect. Elementele dintr-o secțiune sunt separate prin virgule, cu excepția ultimului element, care nu se termină cu o virgulă. ??.Pentru a ilustra modul în care funcționează JSON, mai jos este prezentat un exemplu simplu. Un fișier JSON este construit din secțiuni care încep și se termină cu paranteze acolade { }. Fiecare secțiune conține elemente sau etichete, cum ar fi "color_of_dog", "dog_age" sau "dogs_toys". Aceste elemente trebuie întotdeauna să fie scrise între ghilimele duble și sunt urmate de două puncte :, apoi de valoarea corespunzătoare. Valorile textuale sunt plasate între ghilimele duble, în timp ce numerele, cum ar fi numerele întregi sau zecimale, sunt scrise fără ghilimele. În OghmaNano, valorile de tip boolean sunt stocate ca șiruri de caractere "true" sau "false". Pentru ca fișierul să fie valid, toate parantezele de deschidere și de închidere trebuie să fie aliniate corect. Elementele dintr-o secțiune sunt separate prin virgule, cu excepția ultimului element, care nu se termină cu o virgulă. ??.
{
"color_of_dog": "brown",
"dog_age": 5,
"dogs_toys":
{
"rabbit": "true",
"stick": "false"
}
}
JSON.Exemplu de structură simplă JSON.OghmaNano utilizează aceleași principii JSON pentru a stoca toate datele de simulare. Aceste informații sunt conținute într-un fișier numit sim.json, care include toți parametrii dispozitivului, setările de simulare și configurația de ieșire. Fiecare simulare va avea propriul fișier sim.json. Deși puteți deschide acest fișier în orice editor de text, adesea este mai ușor să utilizați un vizualizator JSON dedicat, deoarece acesta va formata datele într-o structură arborescentă ușor de citit. Firefox are un vizualizator JSON integrat foarte bun. Un exemplu de fișier sim.json vizualizat în Firefox este prezentat mai jos, în ??.OghmaNano utilizează aceleași principii JSON pentru a stoca toate datele de simulare. Aceste informații sunt conținute într-un fișier numit sim.json, care include toți parametrii dispozitivului, setările de simulare și configurația de ieșire. Fiecare simulare va avea propriul fișier sim.json. Deși puteți deschide acest fișier în orice editor de text, adesea este mai ușor să utilizați un vizualizator JSON dedicat, deoarece acesta va formata datele într-o structură arborescentă ușor de citit. Firefox are un vizualizator JSON integrat foarte bun. Un exemplu de fișier sim.json vizualizat în Firefox este prezentat mai jos, în ??.
Un ultim aspect: deși sim.json este fișierul de configurare principal, nu este întotdeauna stocat separat. În schimb, OghmaNano îl include adesea într-un fișier sim.oghma, care este doar o arhivă ZIP standard – acest lucru se face pentru a economisi spațiu. Dacă redenumiți sim.oghma în sim.zip, îl puteți deschide cu Windows Explorer sau cu orice program de vizualizare a fișierelor ZIP și puteți extrage sim.json. Dacă plasați o copie a sim.json în același director de simulare și redenumiți arhiva înapoi la sim.oghma, OghmaNano va ignora versiunea arhivată a sim.json și va utiliza în schimb fișierul dvs. text simplu sim.json. Această funcție este extrem de utilă pentru automatizare, deoarece puteți edita direct sim.json folosind orice limbaj de programare, fără a fi nevoie să manipulați fișiere ZIP.Un ultim aspect: deși sim.json este fișierul de configurare principal, nu este întotdeauna stocat separat. În schimb, OghmaNano îl include adesea într-un fișier sim.oghma, care este doar o arhivă ZIP standard – acest lucru se face pentru a economisi spațiu. Dacă redenumiți sim.oghma în sim.zip, îl puteți deschide cu Windows Explorer sau cu orice program de vizualizare a fișierelor ZIP și puteți extrage sim.json. Dacă plasați o copie a sim.json în același director de simulare și redenumiți arhiva înapoi la sim.oghma, OghmaNano va ignora versiunea arhivată a sim.json și va utiliza în schimb fișierul dvs. text simplu sim.json. Această funcție este extrem de utilă pentru automatizare, deoarece puteți edita direct sim.json folosind orice limbaj de programare, fără a fi nevoie să manipulați fișiere ZIP.
2. Formatul de fișier OghmaNano.2. Formatul de fișier OghmaNano.
OghmaNano aplică exact aceste principii în fișierul de configurare pentru simulări, numit sim.json. Acest fișier conține tot ceea ce este necesar pentru a descrie structura unui dispozitiv, a defini simulările care trebuie efectuate și a configura algoritmii de rezolvare. Fiecare director de simulare va include propriul fișier sim.json. Deși puteți deschide acest fișier în orice editor de text, este adesea mai convenabil să utilizați un vizualizator JSON, cum ar fi Firefox, care prezintă automat datele într-o structură arborescentă formatată.OghmaNano aplică exact aceste principii în fișierul de configurare pentru simulări, numit sim.json. Acest fișier conține tot ceea ce este necesar pentru a descrie structura unui dispozitiv, a defini simulările care trebuie efectuate și a configura algoritmii de rezolvare. Fiecare director de simulare va include propriul fișier sim.json. Deși puteți deschide acest fișier în orice editor de text, este adesea mai convenabil să utilizați un vizualizator JSON, cum ar fi Firefox, care prezintă automat datele într-o structură arborescentă formatată.
La nivelul cel mai înalt, sim.json este organizat în câteva secțiuni principale. Aceste secțiuni se ramifică apoi în subsecțiuni detaliate, cum ar fi analizele JV, rulările EQE sau definițiile straturilor dispozitivelor. Principalele secțiuni de nivel superior prezente în formatul actual sunt prezentate în tabelul de mai jos: ??.La nivelul cel mai înalt, sim.json este organizat în câteva secțiuni principale. Aceste secțiuni se ramifică apoi în subsecțiuni detaliate, cum ar fi analizele JV, rulările EQE sau definițiile straturilor dispozitivelor. Principalele secțiuni de nivel superior prezente în formatul actual sunt prezentate în tabelul de mai jos: ??.
| SecțiuneSecțiune | ScopScop |
|---|---|
simsim | Metadate generale (de exemplu, versiune, mod de execuție, note)Metadate generale (de exemplu, versiune, mod de execuție, note) |
simssims | Toate definițiile simulărilor (JV, Suns-Voc, EQE, PL, în domeniul timpului, cu raze, FDTD, etc.)Toate definițiile simulărilor (JV, Suns-Voc, EQE, PL, în domeniul timpului, cu raze, FDTD, etc.) |
epitaxyepitaxy | Structura dispozitivului: straturi, contacte, geometrie, materiale.Structura dispozitivului: straturi, contacte, geometrie, materiale. |
mathmath | Setări și toleranțe pentru rezolvitorul numericSetări și toleranțe pentru rezolvitorul numeric |
opticaloptical | Modele optice, surse, detectoare, rețele.Modele optice, surse, detectoare, rețele. |
dumpdump | Setări pentru rezultate: nivel de detaliu, instrumente de diagnosticare, formate de fișiere.Setări pentru rezultate: nivel de detaliu, instrumente de diagnosticare, formate de fișiere. |
serverserver | Durata de execuție/paralelizare (fire de execuție, GPU, limite de timp)Durata de execuție/paralelizare (fire de execuție, GPU, limite de timp) |
sim.json.Au fost detectate secțiuni principale de nivel superior în sim.json.3. Particularități ale formatului JSON OghmaNano.3. Particularități ale formatului JSON OghmaNano.
-
Fișierul JSON OghmaNano nu acceptă liste JSON standard, de exemplu ["Roșu", "Verde", "Albastru"]. Dacă există o listă de elemente, aceasta este definită prin declararea inițială a segmentelor variabile, specificând numărul de elemente din listă, de exemplu, "segmente", 0. Fiecare element din listă este apoi stocat sub "segment0", "segment1" etc. Acest format permite OghmaNano să aloce memoria pentru citirea structurilor înainte de a efectua citirea propriu-zisă. Acest lucru poate fi observat în figura 14.1, unde există o listă cu un singur segment.Fișierul JSON OghmaNano nu acceptă liste JSON standard, de exemplu ["Roșu", "Verde", "Albastru"]. Dacă există o listă de elemente, aceasta este definită prin declararea inițială a segmentelor variabile, specificând numărul de elemente din listă, de exemplu, "segmente", 0. Fiecare element din listă este apoi stocat sub "segment0", "segment1" etc. Acest format permite OghmaNano să aloce memoria pentru citirea structurilor înainte de a efectua citirea propriu-zisă. Acest lucru poate fi observat în figura 14.1, unde există o listă cu un singur segment.
-
Multe elemente din fișierul JSON vor primi un număr de identificare, care este un cod hexazecimal format din 16 cifre; acesta poate fi folosit pentru a identifica în mod unic elementul. Un număr de identificare poate fi văzut și în figura 14.1. Aceste numere de identificare sunt generate aleatoriu, dar fiecare număr de identificare trebuie să fie unic. Numerele de identificare permit identificarea unică a obiectelor, de exemplu, a straturilor epitaxiale, chiar dacă au același nume.Multe elemente din fișierul JSON vor primi un număr de identificare, care este un cod hexazecimal format din 16 cifre; acesta poate fi folosit pentru a identifica în mod unic elementul. Un număr de identificare poate fi văzut și în figura 14.1. Aceste numere de identificare sunt generate aleatoriu, dar fiecare număr de identificare trebuie să fie unic. Numerele de identificare permit identificarea unică a obiectelor, de exemplu, a straturilor epitaxiale, chiar dacă au același nume.
4. Codificare4. Codificare
Fișierele .json citite/scrise de OghmaNano sunt întotdeauna stocate în formatul UTF-8. OghmaNano nu poate procesa UTF-16 sau alte standarde de codificare a textului. În prezent, aplicația Notepad de la Windows și majoritatea celorlalte aplicații utilizează în mod implicit UTF-8, astfel încât, dacă nu știți ce sunt aceste formate de stocare a textului, probabil că nu contează. Această problemă va apărea doar dacă începeți să generați programatic fișiere .oghma într-un limbaj precum C++ și utilizați un limbaj precum chineza sau rusa, care conțin caractere non-latine în alfabetul lor.Fișierele .json citite/scrise de OghmaNano sunt întotdeauna stocate în formatul UTF-8. OghmaNano nu poate procesa UTF-16 sau alte standarde de codificare a textului. În prezent, aplicația Notepad de la Windows și majoritatea celorlalte aplicații utilizează în mod implicit UTF-8, astfel încât, dacă nu știți ce sunt aceste formate de stocare a textului, probabil că nu contează. Această problemă va apărea doar dacă începeți să generați programatic fișiere .oghma într-un limbaj precum C++ și utilizați un limbaj precum chineza sau rusa, care conțin caractere non-latine în alfabetul lor.
5. Compatibilitatea cu versiunile anterioare și ulterioare ale formatului de fișier.5. Compatibilitatea cu versiunile anterioare și ulterioare ale formatului de fișier.
Se depun eforturi considerabile pentru a ne asigura că noile versiuni ale OghmaNano pot citi fișierele generate în versiunile mai vechi. Cu toate acestea, versiunile mai vechi ale OghmaNano s-ar putea să nu poată citi fișierele generate în versiunile mai noi. De fiecare dată când utilizatorul deschide un fișier sim.oghma folosind interfața grafică, formatul fișierului este verificat, iar dacă acesta diferă de cel utilizat în versiunea curentă, fișierul este actualizat și rescris pe disc. Dacă utilizați OghmaNano într-o configurație fără interfață grafică, apelând direct \(oghma\_core.exe\), atunci, înainte de a rula \(oghma\_core.exe\), asigurați-vă că ați deschis mai întâi fișierele sim.oghma din versiunile vechi ale modelului în interfața grafică, pentru a vă asigura că fișierul este în formatul corect.Se depun eforturi considerabile pentru a ne asigura că noile versiuni ale OghmaNano pot citi fișierele generate în versiunile mai vechi. Cu toate acestea, versiunile mai vechi ale OghmaNano s-ar putea să nu poată citi fișierele generate în versiunile mai noi. De fiecare dată când utilizatorul deschide un fișier sim.oghma folosind interfața grafică, formatul fișierului este verificat, iar dacă acesta diferă de cel utilizat în versiunea curentă, fișierul este actualizat și rescris pe disc. Dacă utilizați OghmaNano într-o configurație fără interfață grafică, apelând direct \(oghma\_core.exe\), atunci, înainte de a rula \(oghma\_core.exe\), asigurați-vă că ați deschis mai întâi fișierele sim.oghma din versiunile vechi ale modelului în interfața grafică, pentru a vă asigura că fișierul este în formatul corect.
6. Sfaturi6. Sfaturi
Dacă nu sunteți sigur unde este stocat un anumit parametru în fișierul OghmaNano sim.json, o metodă foarte eficientă este să comparați două versiuni ale fișierului și să vedeți ce modificări au fost efectuate. O modalitate de a face acest lucru este să utilizați un instrument de comparare a fișierelor, cum ar fi KDiff3.Dacă nu sunteți sigur unde este stocat un anumit parametru în fișierul OghmaNano sim.json, o metodă foarte eficientă este să comparați două versiuni ale fișierului și să vedeți ce modificări au fost efectuate. O modalitate de a face acest lucru este să utilizați un instrument de comparare a fișierelor, cum ar fi KDiff3.
Procesul este simplu:Procesul este simplu:
- Deschideți simularea în interfața utilizator OghmaNano.Deschideți simularea în interfața utilizator OghmaNano.
- Modificați parametrul relevant (de exemplu, schimbați grosimea stratului activ sau valoarea unei tensiuni) și salvați simularea.Modificați parametrul relevant (de exemplu, schimbați grosimea stratului activ sau valoarea unei tensiuni) și salvați simularea.
- Compară fișierul nou
sim.jsoncu versiunea anterioară folosind KDiff3 (sau un alt instrument de comparare a fișierelor).Compară fișierul nousim.jsoncu versiunea anterioară folosind KDiff3 (sau un alt instrument de comparare a fișierelor). - Caută liniile care diferă: acestea vor indica exact în ce parte a structurii JSON este stocat parametrul respectiv.Caută liniile care diferă: acestea vor indica exact în ce parte a structurii JSON este stocat parametrul respectiv.
Această tehnică reprezintă o metodă rapidă și eficientă de a localiza parametrii într-un fișier JSON, mai ales dacă nu sunteți sigur de calea acestora în cadrul fișierului. Este deosebit de utilă pentru simulări complexe, care conțin numeroase secțiuni imbricate.Această tehnică reprezintă o metodă rapidă și eficientă de a localiza parametrii într-un fișier JSON, mai ales dacă nu sunteți sigur de calea acestora în cadrul fișierului. Este deosebit de utilă pentru simulări complexe, care conțin numeroase secțiuni imbricate.
👉 Următorul pas: Acum, continuați cu explorarea instrumentului de scanare a parametrilor, unde puteți învăța cum să modificați sistematic parametrii simulării și să analizați rezultatele.👉 Următorul pas: Acum, continuați cu explorarea instrumentului de scanare a parametrilor, unde puteți învăța cum să modificați sistematic parametrii simulării și să analizați rezultatele.