Acasă Exemple Capturi de ecran Manual de utilizare Logo-ul Bluesky YouTube ☰
OghmaNano Platformă de simulare multifizică pentru dispozitive optoelectronice și sisteme fotonice. DESCARCĂ Ghid de utilizare rapidă

Formatul de fișier Oghma.Formatul de fișier Oghma.

1. Ce este JSON?1. Ce este JSON?

OghmaNano sim.json file opened in the Firefox browser showing structured JSON parameters
Un exemplu de fișier 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"
  }
}
Exemplu de structură simplă 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: ??.

Current top-level sections in sim.json
SecțiuneSecțiune ScopScop
simsimMetadate generale (de exemplu, versiune, mod de execuție, note)Metadate generale (de exemplu, versiune, mod de execuție, note)
simssimsToate 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.)
epitaxyepitaxyStructura dispozitivului: straturi, contacte, geometrie, materiale.Structura dispozitivului: straturi, contacte, geometrie, materiale.
mathmathSetări și toleranțe pentru rezolvitorul numericSetări și toleranțe pentru rezolvitorul numeric
opticalopticalModele optice, surse, detectoare, rețele.Modele optice, surse, detectoare, rețele.
dumpdumpSetă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.
serverserverDurata 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)
Au fost detectate secțiuni principale de nivel superior în 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.

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:

  1. Deschideți simularea în interfața utilizator OghmaNano.Deschideți simularea în interfața utilizator OghmaNano.
  2. 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.
  3. Compară fișierul nou sim.json cu versiunea anterioară folosind KDiff3 (sau un alt instrument de comparare a fișierelor).Compară fișierul nou sim.json cu versiunea anterioară folosind KDiff3 (sau un alt instrument de comparare a fișierelor).
  4. 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.