Αναφορά για την προηγμένη μορφή αρχείου προσομοίωσης OghmaNano.

Αυτή η σελίδα περιγράφει λεπτομερώς τη μορφή αρχείου OghmaNano sim.json: τη δομή των ορισμών συσκευών, τα ηλεκτρικά και οπτικά μοντέλα υλικών, τα σενάρια Lua, τη διάχυση, τις επαφές, τις σαρώσεις τάσης, τη δημιουργία πλέγματος και τις αριθμητικές ρυθμίσεις. Περιλαμβάνει επίσης μια αναζητήσιμη αναφορά των παραμέτρων και των κλειδιών JSON. Πρόκειται για μια προηγμένη τεχνική αναφορά και όχι για μια εισαγωγή στην JSON ή για οδηγίες σχετικά με το άνοιγμα αρχείων σε ένα πρόγραμμα περιήγησης ιστού.

Το παρόν εγχειρίδιο απευθύνεται τόσο σε ανθρώπους όσο και σε βοηθούς τεχνητής νοημοσύνης. Οι χρήστες μπορούν να ανατρέξουν στους πίνακες και τα παραδείγματα κατά την επεξεργασία των προσομοιώσεων. Οι βοηθοί τεχνητής νοημοσύνης μπορούν να χρησιμοποιήσουν τις τεκμηριωμένες διαδρομές και τα επισημασμένα πλαίσια καθοδήγησης κατά τη μετατροπή μιας υπάρχουσας, λειτουργικής προσομοίωσης σε μια νέα συσκευή. Η ίδια σελίδα HTML χρησιμεύει ως εγχειρίδιο αναφοράς και για τις δύο ομάδες χρηστών.

Πεδίο εφαρμογής: Οι ιεραρχικές διαδρομές που έχουν επισημανθεί ως επαληθευμένες προέρχονται από ένα λειτουργικό παράδειγμα του OghmaNano v8.1. Ο κατάλογος των συμβόλων περιλαμβάνει επίσης ονόματα που έχουν ληφθεί από το παρεχόμενο λεξικό παραμέτρων· αυτά δεν είναι απαραίτητα όλες επεξεργάσιμες διαδρομές σε κάθε έκδοση ή τύπο προσομοίωσης.

1. Χρήση αυτής της πηγής αναφοράς σε συνδυασμό με έναν βοηθό τεχνητής νοημοσύνης.

Αυτή η τεχνική αναφορά προορίζεται τόσο για ανθρώπους που χρησιμοποιούν το λογισμικό όσο και για βοηθούς τεχνητής νοημοσύνης που δημιουργούν ή τροποποιούν προσομοιώσεις OghmaNano. Περιγράφει τις διαδρομές JSON που παρατηρούνται σε ένα λειτουργικό παράδειγμα OghmaNano v8.1 και περιλαμβάνει το παρεχόμενο λεξικό παραμέτρων. Πρόκειται για μια αναφορά και όχι για ένα εκτελέσιμο σχήμα ή για αντικατάσταση ενός λειτουργικού αρχείου προσομοίωσης. Δεν υποστηρίζονται όλες οι πιθανές δομές συσκευών ή τα φυσικά μοντέλα.

Ο πλήρης κατάλογος των διακριτικών βρίσκεται στην ενότητα ενότητα 11. Πολλές καταχωρήσεις λεξικού είναι ετικέτες για εξόδους ή στοιχεία ελέγχου GUI και όχι άμεσα επεξεργάσιμα κλειδιά στο παρεχόμενο δείγμα· μια καταχώρηση στον κατάλογο δεν αποτελεί από μόνη της απόδειξη για μια επεξεργάσιμη διαδρομή JSON.

2. Επιλογή αντικειμένων ανώτατου επιπέδου και προσομοίωσης.

Το παράδειγμα που χρησιμοποιείται περιέχει επίσης τα ανώτερα αντικείμενα electrical_solver, thermal, exciton, fits, parasitic, hard_limit, perovskite, singlet, circuit, gl, gui_config, world, ml και scans, καθώς και μεταδεδομένα εγγράφου. Η παρουσία και το περιεχόμενο αυτών των τμημάτων μπορεί να διαφέρουν ανάλογα με τις εκδόσεις και τους τύπους προσομοίωσης. Μην διαγράφετε ένα άγνωστο τμήμα απλώς και μόνο επειδή δεν είναι σχετικό με τη νέα συσκευή.

{
  "sim": { "simmode": "segment0@jv" },
  "sims": {
    "jv": {
      "segments": 1,
      "segment0": {
        "config": { "Vstart": 0.0, "Vstop": 2.2, "Vstep": 0.025 }
      }
    }
  }
}

Το απόσπασμα που παρουσιάζεται παραπάνω απεικονίζει τις υπάρχουσες διαδρομές· δεν αποτελεί ένα πλήρες αρχείο προσομοίωσης.

3. Τμηματοποίηση συλλογών, αναγνωριστικών και τύπων δεδομένων.

Οι συλλογές αναπαρίστανται από ένα αριθμητικό πεδίο segments και από διαδοχικά αριθμημένα αντικείμενα segment0, segment1 κ.ο.κ. Μια συλλογή που δηλώνει τέσσερα τμήματα πρέπει να περιέχει ακριβώς τα τέσσερα αντίστοιχα θυγατρικά αντικείμενα τμημάτων. Τα αντικείμενα μπορούν να περιέχουν πεδία id που χρησιμοποιούνται για την αναγνώρισή τους. Όταν αντιγράφετε ή δημιουργείτε ένα νέο αντικείμενο, εκχωρήστε ένα νέο, μοναδικό αναγνωριστικό όπου απαιτείται· διατηρήστε τα αναγνωριστικά για τα αντικείμενα που δεν έχουν αλλάξει.

{
  "segments": 2,
  "segment0": { "name": "Layer A", "id": "id0123456789abcdef" },
  "segment1": { "name": "Layer B", "id": "idfedcba9876543210" }
}

4. Επίταξη: γεωμετρία, σύνθεση και προσθήκη προσμίξεων.

Οι ορισμοί των στρώσεων αποθηκεύονται στη θέση epitaxy.segmentX (με το X να ξεκινά από το μηδέν), ενώ οι επαφές αποθηκεύονται ξεχωριστά στη θέση epitaxy.contacts.segmentX. Στο παρεχόμενο παράδειγμα λειτουργίας GaAs, το y0 είναι η αρχική θέση και το dy είναι το πάχος της στρώσης, και οι δύο σε μέτρα. Διατηρήστε τις άκρες των στρώσεων συνεχείς, εκτός εάν η συσκευή περιλαμβάνει σκόπιμα ένα φυσικό κενό.

Μια ομοιόμορφη περιοχή τύπου p έχει θετικές τιμές για τα Na0 και Na1, καθώς και για το Nd0 = Nd1 = 0. Μια ομοιόμορφη περιοχή τύπου n χρησιμοποιεί τις τιμές Nd0 και Nd1 αντί αυτών. Μια εγγενής περιοχή μπορεί να χρησιμοποιήσει μηδενική τιμή για όλες τις τέσσερις παραμέτρους προσθήκης. Ελέγξτε εάν υπάρχουν επιπλέον προσθήκες ή ενεργά ηλεκτρικά πεδία στην επιφάνεια πριν από την επεξεργασία.

Ηλεκτρικές διεπαφές, σήραγγες και ανασυνδυασμός.

Οι συνθήκες της ηλεκτρικής διεπαφής στο OghmaNano αποθηκεύονται στην ενότητα epitaxy.segmentX.layer_interface. Αυτές οι παράμετροι ελέγχουν επιπλέον μηχανισμούς μεταφοράς και ανασύνθεσης φορέων σε ετεροσυνδέσεις ημιαγωγών.

Από προεπιλογή, το OghmaNano χρησιμοποιεί την προσέγγιση της διάχυσης-μεταφοράς για τον υπολογισμό της μεταφοράς σε διεπαφές. Η αγωγιμότητα και οι μετατοπίσεις της ζώνης σθένους επηρεάζουν φυσικά τη ροή των φορέων, με μεγάλα ενεργειακά εμπόδια να περιορίζουν τη μεταφορά. Μπορούν να ενεργοποιηθούν πρόσθετοι μηχανισμοί διεπαφής όταν η απλή προσέγγιση της διάχυσης-μεταφοράς δεν περιγράφει επαρκώς τη συσκευή.

Άμεση διάνοιξη σήραγγας

Η άμεση σήραγγα παρέχει μια επιπλέον διαδρομή μεταφοράς μέσω ενεργειακών φραγμών. Η OghmaNano χρησιμοποιεί την απλοποιημένη έκφραση:

Εδώ, τα \(A\) και \(B\) είναι παράμετροι σήραγγας, το \(V\) είναι η εφαρμοσμένη τάση και το \(\phi\) είναι το ύψος του φραγμού. Η εκθετική εξάρτηση σημαίνει ότι η σήραγγα επηρεάζεται σημαντικά από την μετατόπιση της ζώνης. Οι σχετικές παράμετροι JSON περιλαμβάνουν τα dir_tunnel_e, dir_tunnel_h, dir_tunnel_e_A και dir_tunnel_h_A.

Μεταφορά με τη βοήθεια διεπιφανειών

Για οργανικές και διαταραγμένες ημιαγωγικές διεπιφάνειες, η OghmaNano παρέχει φαινομενολογικά μοντέλα μεταφοράς φορέων. Τα ηλεκτρονικά και οπτικά ρεύματα περιγράφονται από:

Οι συντελεστές \(T_e\) και \(T_h\) ελέγχουν τη μεταφορά ηλεκτρονίων και οπών διαμέσου της διεπιφάνειας. Αυτοί οι μηχανισμοί σχετίζονται με τα interface_tunnel_e, interface_tunnel_h, interface_Ge και interface_Gh.

Ανασυνδυασμός διεπιφάνειας

Το OghmaNano υποστηρίζει επίσης την ανασυνδυασμό στην επιφάνεια, συμπεριλαμβανομένου του ανασυνδυασμού Shockley-Read-Hall (SRH) μέσω των καταστάσεων παγίδευσης στην επιφάνεια. Ο τοπικός ρυθμός ανασυνδυασμού SRH είναι:

Οι πυκνότητες των παγίδων διεπιφάνειας καθορίζονται ανά μονάδα επιφάνειας (m-2). Η OghmaNano κατανέμει αυτές τις παγίδες στα σημεία του πλέγματος που είναι γειτονικά με τη διεπιφάνεια. Σχετικές παράμετροι περιλαμβάνουν τις ss_srh_enabled_interface, ss_srh_Nt2 και τις αντίστοιχες παραμέτρους παγίδων. Η διεπιφάνεια περιέχει επίσης τις interface_model και interface_eh_tau για πρόσθετες ρυθμίσεις ανασυνδυασμού.

Για τις πλήρεις εξισώσεις, τους ορισμούς των παραμέτρων και τη φυσική ερμηνεία, ανατρέξτε στην τεκμηρίωση της θεωρίας της διεπαφής ημιαγωγών OghmaNano.

Ανασυνδυασμός σε διασύνδεση και τανδেম ηλιακά κύτταρα.

Το OghmaNano υποστηρίζει την ανασύνθεση ηλεκτρονίων-οπών μεταξύ των φορέων σε αντίθετες πλευρές μιας ημιαγωγικής διεπαφής. Αυτό είναι χρήσιμο για τη μοντελοποίηση της περιοχής ανασύνθεσης μεταξύ δύο υποκυψελών σε μια πολυεπίπεδη ηλιακή κυψέλη.

Υποστηρίζονται δύο ανεξάρτητες κατευθύνσεις ανασυνδυασμού:

Εδώ, τα \(L\) και \(R\) προσδιορίζουν τις αριστερή και δεξιά πλευρές της διεπιφάνειας. Οι συντελεστές \(K\) έχουν μονάδες m4s-1, δίνοντας ροές ανασύνθεσης σε m-2s-1. Κάθε γεγονός αφαιρεί ένα ηλεκτρόνιο και μία οπή από τις αντίθετες πλευρές της διεπιφάνειας.

Η ροή ανασύνθεσης ενσωματώνεται απευθείας στις εξισώσεις συνέχειας των ηλεκτρονίων και των οπών, με αναλυτικές παραγώγους Jacobian για τον επιλυτή Newton.

Κινητικότητα διεπαφής

Οι κινητικότητες των ηλεκτρονίων και των οπών σε μια διεπιφάνεια μπορούν να τροποποιηθούν ανεξάρτητα χρησιμοποιώντας τις παραμέτρους interface_mobility_e και interface_mobility_h. Οι αντίστοιχοι συντελεστές διάχυσης προσαρμόζονται αναλόγως.

Θέτοντας και τις δύο κινητικότητες σε μηδέν, εμποδίζεται η συμβατική μεταφορά μέσω διάχυσης στην επιφάνεια επαφής. Η ανασυνδυασμός στην επιφάνεια επαφής μπορεί στη συνέχεια να παρέχει την ηλεκτρική σύνδεση μεταξύ δύο υποκυψελών χωρίς να εισάγει μια τεχνητή λεπτή στρώση ανασυνδυασμού.

ενωτική περιοχή ανασυνδυασμού

Για δύο υποκύτταρα τύπου n-i-p που είναι διατεταγμένα από αριστερά προς τα δεξιά, οι οπές από το αριστερό υποκύτταρο ανασυνδυάζονται με τα ηλεκτρόνια από το δεξιό υποκύτταρο. Αυτό αντιστοιχεί στην ανασύνδεση από δεξιά προς τα αριστερά.

       Subcell 1                     Subcell 2

    n | absorber | p   ||   n | absorber | p
                       ||
                 Recombination
                   interface

                 p(L) + n(R)

Τα παρακάτω τμήματα διαμόρφωσης JSON απενεργοποιούν τη συμβατική μεταφορά και ενεργοποιούν την ισχυρή ανασύνθεση από δεξιά προς αριστερά:

"layer_interface": {
    "interface_mobility_e_enabled": "True",
    "interface_mobility_e": 0.0,
    "interface_mobility_h_enabled": "True",
    "interface_mobility_h": 0.0,

    "interface_cross_rec_l2r_enabled": "True",
    "interface_cross_rec_l2r": 1e-29,
    "interface_cross_rec_r2l_enabled": "True",
    "interface_cross_rec_r2l": 1e-7
}

Οι συντελεστές ανασυνδυασμού εξαρτώνται από τη συσκευή. Οι παραπάνω τιμές απεικονίζουν μια συγκεκριμένη λειτουργική διαμόρφωση.

5. Σενάρια Lua για ηλεκτρικά υλικά.

Στο παραδειγματικό κύκλωμα GaAs, κάθε ημιαγωγική στρώση ενεργοποιεί το ηλεκτρικό μοντέλο υλικού Lua χρησιμοποιώντας το αντικείμενο program που είναι ενσωματωμένο στο shape_dos. Το όνομα του αρχείου βρίσκεται στο default_program_path. Το ενσωματωμένο πεδίο program είναι μια κενή συμβολοσειρά σε αυτό το παράδειγμα. Η διαδρομή του σεναρίου είναι σχετική με τη βάση δεδομένων ηλεκτρικών υλικών, χωρίς να περιλαμβάνει την αρχική διαδρομή ./ στο παρατηρούμενο παράδειγμα.

"shape_dos": {
  "program": {
    "enabled": "True",
    "program": "",
    "default_program_path": "Inorganic/AlGaAs/AlGaAs.lua",
    "font_size": 12
  }
}

Αυτό απεικονίζει τα ενσωματωμένα πεδία επιλογής σεναρίου. Σε ένα πραγματικό επίπεδο, αφήστε όλα τα υπόλοιπα υπάρχοντα πεδία shape_dos στη θέση τους.

Αντικατάσταση των παραμέτρων υλικού της Lua.

Το OghmaNano επιτρέπει την αντικατάσταση των μεμονωμένων παραμέτρων υλικών που υπολογίζονται από σενάρια Lua, χρησιμοποιώντας το epitaxy.segmentX.shape_dos.db_overrides. Αυτό επιτρέπει τη χρήση τυπικών μοντέλων υλικών, ενώ παράλληλα ρυθμίζονται συγκεκριμένες παράμετροι, όπως οι ρυθμοί ανασύνθεσης ή οι κινητικότητες των φορέων, χωρίς να τροποποιείται η παγκόσμια βάση δεδομένων υλικών.

Για παράδειγμα, για να αντικαταστήσετε τον συντελεστή ακτινοβολιακής ανασύνθεσης:

"free_to_free_recombination": 1e-16,
"db_overrides": {
    "free_to_free_recombination": "true",
    "Eg": "false",
    "Xi": "false"
}

6. Σύνολα δεδομένων οπτικών υλικών και εκπομπή.

Το οπτικό σύνολο δεδομένων για μια επιταχιακή στρώση επιλέγεται στο epitaxy.segmentX.absorption.nk_data. Η παρεχόμενη λίστα οπτικών υλικών περιέχει διαδρομές που τελειώνουν στο /alpha.csv. Για να αποκτήσετε την αναφορά καταλόγου που χρησιμοποιείται στο nk_data, αφαιρέστε αυτό το επίθημα. Το ηλεκτρικό μοντέλο Lua και το οπτικό σύνολο δεδομένων είναι ξεχωριστές αναφορές και δεν χρειάζεται να έχουν πανομοιότυπες διαδρομές.

Το x = 0.315 οπτικό σύνολο δεδομένων αποτελεί μια κατά προσέγγιση αναπαράσταση της σύνθεσης για ένα x = 0.30 ηλεκτρικό μοντέλο AlGaAs. Μην το περιγράφετε σιωπηλά ως μια ακριβή αντιστοιχία. Χρησιμοποιήστε το πλέγμα μηκών κύματος κάτω από το optical.mesh.mesh_l όταν οι οπτικές υπολογισμοί απαιτούν ένα κατάλληλο φάσμα. Το παράδειγμα περιέχει επίσης optical.mesh.mesh_y για το οπτικό χωρικό του πλέγμα.

Σε μια LED που λειτουργεί με ηλεκτρικό ρεύμα, η εξωτερική οπτική φωτεινότητα μπορεί να απενεργοποιηθεί χρησιμοποιώντας την υπάρχουσα διαμόρφωση της πηγής φωτός· το δείγμα περιέχει optical.light_sources.Psun. Η στρώση περιέχει επίσης shape_pl.pl_emission_enabled και τις σχετικές ρυθμίσεις εκπομπής. Η ενεργοποίηση της εξόδου εκπομπής, από μόνη της, δεν αποτελεί απόδειξη ότι το μοντέλο επιλύει το σχήμα της φασματικής γραμμής, τη φυσική της αυθόρμητης εκπομπής ή την εξωτερική κβαντική απόδοση. Επιβεβαιώστε ποιες επιλογές υποστηρίζονται στην επιλεγμένη λειτουργία προσομοίωσης.

7. Επαφές και πολικότητα τάσης.

Οι ηλεκτρικές επαφές ορίζονται σύμφωνα με το epitaxy.contacts, και όχι μέσω της αλλαγής της προσμείξης μιας τυχαίας στρώσης. Το παρεχόμενο αρχείο εργασίας περιέχει δύο επαφές, με ξεχωριστά ενσωματωμένα αντικείμενα contact. Η άνω ακροδέκτριά του βρίσκεται στο y0 και η κάτω ακροδέκτριά του στο y1. Η πραγματική πολικότητα της τάσης ακολουθεί τις ρυθμίσεις applied_voltage_type σε αυτές τις ακροδέκτριες.

Η παράμετρος applied_voltage_type καθορίζει τον τρόπο με τον οποίο εφαρμόζεται η τάση σε κάθε επαφή. Μια επαφή που έχει ρυθμιστεί στην τιμή "change" λαμβάνει την εφαρμοζόμενη τάση, ενώ μια επαφή που έχει ρυθμιστεί στην τιμή "ground" διατηρείται στα 0 V. Επομένως, μια θετική εφαρμοζόμενη τάση καθιστά την επαφή "change" θετική σε σχέση με την επαφή "ground".

"contacts": {
  "segments": 2,
  "segment0": {
    "contact": {
      "position": "y0",
      "applied_voltage_type": "change",
      "majority": "hole",
      "minority": "electron",
      "majority_model": "ohmic",
      "minority_model": "ohmic"
    }
  },
  "segment1": {
    "contact": {
      "position": "y1",
      "applied_voltage_type": "ground",
      "majority": "electron",
      "minority": "hole",
      "majority_model": "ohmic",
      "minority_model": "ohmic"
    }
  }
}

Τμήμα επικοινωνίας: τα πεδία που παραλείπονται εξακολουθούν να είναι απαραίτητα στο πραγματικό λειτουργικό παράδειγμα.

8. Συνέπεια της ηλεκτρικής και οπτικής διασύνδεσης.

Για το παρεχόμενο παράδειγμα διάχυσης-μεταφοράς, το ηλεκτρικό πλέγμα στον άξονα y βρίσκεται κάτω από το electrical_solver.mesh.mesh_y. Κάθε τμήμα του πλέγματος έχει ένα len σε μέτρα, points, mul, left_right, id και τα αντίστοιχα πεδία. Το οπτικό χωρικό πλέγμα είναι ένα διαφορετικό αντικείμενο κάτω από το optical.mesh.mesh_y. Η αλλαγή του πάχους μιας στρώσης δεν εγγυάται ότι έχουν ενημερωθεί όλες οι ρυθμίσεις του πλέγματος.

"mesh_y": {
  "enabled": "True",
  "auto": "True",
  "icon_": "y",
  "segments": 4,
  "segment0": { "len": 2e-7, "points": 30.0 },
  "segment1": { "len": 3e-7, "points": 50.0 },
  "segment2": { "len": 2e-7, "points": 30.0 },
  "segment3": { "len": 1e-7, "points": 20.0 }
}

Τα πεδία που εμφανίζονται παραπάνω δείχνουν τα μήκη πλέγματος και τον αριθμό σημείων για μια τετραστρωματική συσκευή 800 nm· αυτό δεν είναι ένα πλήρες αντικείμενο mesh_y.

9. Φυσική ερμηνεία και αβάσιμοι ισχυρισμοί.

Ένα αρχείο JSON που μπορεί να αναλυθεί απλώς επιβεβαιώνει τη συντακτική εγκυρότητα. Η μεταφορά μέσω διάχυσης-παρασυρμού, οι ιδιότητες των υλικών, η ακτινοβολική ανασυνδυασμός και η οπτική είναι ξεχωριστά θέματα μοντελοποίησης. Για παράδειγμα, μια διπλή ετεροδομή AlGaAs/GaAs απαιτεί κατάλληλο περιορισμό των φορέων σε και τις δύο διεπαφές, και όχι απλώς μια φαινομενικά εύλογη λίστα στρώσεων. Ελέγξτε το ενεργειακό χάσμα, τη συγγένεια των ηλεκτρονίων και τις παραμέτρους μεταφοράς που υπολογίζονται από τα σενάρια υλικών για τη ζητούμενη σύνθεση και θερμοκρασία.

Πιο σύνθετες συσκευές, όπως τα ηλιακά κύτταρα TOPCon, τα MOSFET, τα διπολικά τρανζίστορ και οι LED με κβαντικές περιοχές, ενδέχεται να απαιτούν φαινόμενα σήραγγας, ηλεκτροστατική συμπεριφορά οξειδίων, επαφές πολλαπλών ακροδεκτών, κβαντικό περιορισμό, παγίδες διεπιφάνειας ή πρόσθετες συνοριακές συνθήκες, τις οποίες μια συγκεκριμένη αρχική προσομοίωση ενδέχεται να μην υποστηρίζει. Εάν η απαιτούμενη φυσική δεν αποδεικνύεται μέσω ενός λειτουργικού παραδείγματος ή της σχετικής τεκμηρίωσης, εντοπίστε το κενό αντί να επινοείτε πεδία JSON. Οι υπολογισμοί οπτικής εκπομπής δεν θα πρέπει να παρουσιάζονται ως βαθμονομημένη απόδοση της συσκευής χωρίς κατάλληλα μοντέλα ανασύνθεσης και εξαγωγής.

10. Λίστα ελέγχου επικύρωσης και αντιμετώπιση προβλημάτων.

Αφού επεξεργαστείτε ένα αρχείο προσομοίωσης, ελέγξτε την εγκυρότητα της σύνταξης JSON, τη δομή όλων των συλλογών τμημάτων, τους τύπους κλειδιών σε σχέση με το αρχικό αρχείο και τυχόν φυσικούς περιορισμούς που αφορούν συγκεκριμένες συσκευές. Για παράδειγμα, το ακόλουθο απόσπασμα κώδικα Python ελέγχει τις συνήθεις συλλογές segments χωρίς να απαιτεί τη χρήση των API του OghmaNano. Δεν εγγυάται ότι το OghmaNano θα εκτελέσει το μοντέλο.

import json
import re
from pathlib import Path

sim = json.loads(Path("sim.json").read_text(encoding="utf-8"))

def check_segments(obj, location="root"):
    if isinstance(obj, dict):
        if isinstance(obj.get("segments"), int):
            count = obj["segments"]
            actual = {
                int(key[7:]) for key in obj
                if re.fullmatch(r"segment[0-9]+", key)
            }
            expected = set(range(count))
            if actual != expected:
                raise ValueError((location, count, sorted(actual)))
        for key, value in obj.items():
            check_segments(value, location + "." + key)

check_segments(sim)
print("JSON and segment counts look consistent")

Εάν η θέση ή η σημασία ενός token στο αρχείο JSON δεν είναι σαφής, επεξεργαστείτε το αντίστοιχο στοιχείο στο γραφικό περιβάλλον, αποθηκεύστε το αρχείο και συγκρίνετε τις εκδόσεις πριν και μετά την επεξεργασία sim.json. Αυτό είναι πιο αξιόπιστο από το να προσπαθήσετε να συμπεράνετε τις διαδρομές μόνο από τα ονόματα των παραμέτρων.

11. Ολοκληρωμένη αναφορά των διαθέσιμων JSON tokens του OghmaNano (Α–Ζ)

Αυτό είναι το κεντρικό, αναζητήσιμο εγχειρίδιο αναφοράς για τις μεταβλητές παραμέτρων και τα δομικά κλειδιά JSON του OghmaNano. Συνδυάζει και τις 985 εγγραφές από το παρεχόμενο λεξικό παραμέτρων με 382 επιπλέον κλειδιά που παρατηρήθηκαν στο λειτουργικό παράδειγμα OghmaNano v8.1 sim.json. Και οι 1.367 εγγραφές είναι οργανωμένες αλφαβητικά: δεν υπάρχει ξεχωριστή λίστα για αναζήτηση δομικών στοιχείων ή σεναρίων υλικών.

Οι περιγραφές, οι μονάδες και οι δηλωμένες επιλογές για τα διακριτικά του λεξικού προέρχονται από το παρεχόμενο λεξικό. Τα διακριτικά που βρίσκονται μόνο στην ενεργή προσομοίωση περιλαμβάνονται με συντηρητικές περιγραφές, όπου η σημασία τους δεν έχει επαληθευτεί. Μια καταχωρημένη διαδρομή JSON και ένας τύπος δεδομένων είναι παρατηρήσεις από ένα λειτουργικό παράδειγμα, και όχι μια υπόσχεση ότι το ίδιο όνομα είναι έγκυρο σε κάθε θέση ή σε κάθε έκδοση του OghmaNano. Ορισμένα διακριτικά είναι πεδία εξόδου ή στοιχεία ελέγχου διεπαφής χρήστη και όχι επεξεργάσιμες είσοδοι προσομοίωσης. Τρεις καταχωρήσεις λεξικού (Ra[0-9], Rq[0-9] και Rp[0-9]) είναι πρότυπα διακριτικών.