s3dgraphy 1.6.0.dev59__tar.gz → 1.6.0.dev60__tar.gz

{s3dgraphy-1.6.0.dev59/src/s3dgraphy.egg-info → s3dgraphy-1.6.0.dev60}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: s3dgraphy
-Version: 1.6.0.dev59
+Version: 1.6.0.dev60
 Summary: 3D Stratigraphic Graph Management Library for archaeological and heritage applications
 Author-email: Emanuel Demetrescu <emanuel.demetrescu@cnr.it>
 Maintainer-email: Emanuel Demetrescu <emanuel.demetrescu@cnr.it>

{s3dgraphy-1.6.0.dev59 → s3dgraphy-1.6.0.dev60}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "s3dgraphy"
-version = "1.6.0.dev59"
+version = "1.6.0.dev60"
 description = "3D Stratigraphic Graph Management Library for archaeological and heritage applications"
 readme = "README.md"
 requires-python = ">=3.9"

{s3dgraphy-1.6.0.dev59 → s3dgraphy-1.6.0.dev60}/src/s3dgraphy/JSON_config/datamodel_translations.json

@@ -695,7 +695,7 @@
   },
   "GraphNode": {
    "description": {
-    "en": "Represents the EM graph itself as a node, used as anchor for graph-wide metadata (author, license, embargo, default epoch, project-level provenance). Enables graph-level inheritance for metadata propagation: values declared on the GraphNode become defaults for all contained nodes unless overridden. Targeted by has_author, has_license, has_embargo edges to carry global defaults. In HDT-O terms (D7.1) an EM graph IS a Heritage Proposition Set (HC16) — a named graph carrying formal assertions about a heritage entity. Connectable via contains_proposition_set (HP33) to one or more HDTNode (HC2 Heritage Digital Twin) instances.",
+    "en": "Represents the EM graph itself as a node, used as anchor for graph-wide metadata (author, license, embargo, default epoch, project-level provenance). Enables graph-level inheritance for metadata propagation: values declared on the GraphNode become defaults for all contained nodes unless overridden. Targeted by has_author, has_license, has_embargo edges to carry global defaults. In HDT-O terms (D7.1) an EM graph is a Heritage Proposition Set (HC16) — a named graph carrying formal assertions about a heritage entity — and it corresponds one to one to the study that created it (StudyNode, HC9, through study_produced_proposition_set / HP25). «A graph is a study» (StratiGraph D3.1 §3.3, D3.2 §3.5) names that correspondence; the two classes stay distinct, an activity and its content. The graph is not the digital twin: an HDTNode (HC2) gathers all the digital information about an asset at any scale. Connectable via contains_proposition_set (HP33) to one or more HDTNode (HC2 Heritage Digital Twin) instances.",
     "validated_it": false,
     "validated_el": false,
     "validated_he": false,
@@ -704,7 +704,7 @@
     "validated_ro": false,
     "validated_fr": false,
     "validated_de": false,
-    "it": "Rappresenta il grafo EM stesso come nodo, usato come ancora per i metadati a livello di grafo (autore, licenza, embargo, epoca predefinita, provenienza a livello di progetto). Consente l'ereditarietà a livello di grafo per la propagazione dei metadati: i valori dichiarati sul GraphNode diventano valori predefiniti per tutti i nodi contenuti, salvo ridefinizione. È destinazione degli archi has_author, has_license, has_embargo che portano i valori predefiniti globali. In termini HDT-O (D7.1) un grafo EM È un Heritage Proposition Set (HC16) — un grafo nominato che porta asserzioni formali su un'entità patrimoniale. Collegabile tramite contains_proposition_set (HP33) a una o più istanze di HDTNode (HC2 Heritage Digital Twin).",
+    "it": "Rappresenta il grafo EM stesso come nodo, usato come ancora per i metadati a livello di grafo (autore, licenza, embargo, epoca predefinita, provenienza a livello di progetto). Consente l'ereditarietà a livello di grafo per la propagazione dei metadati: i valori dichiarati sul GraphNode diventano valori predefiniti per tutti i nodi contenuti, salvo ridefinizione. È destinazione degli archi has_author, has_license, has_embargo che portano i valori predefiniti globali. In termini HDT-O (D7.1) un grafo EM è un Heritage Proposition Set (HC16) — un grafo nominato che porta asserzioni formali su un'entità patrimoniale — e corrisponde uno a uno allo studio che lo ha creato (StudyNode, HC9, tramite study_produced_proposition_set / HP25). «Un grafo è uno studio» (StratiGraph D3.1 §3.3, D3.2 §3.5) nomina questa corrispondenza; le due classi restano distinte, un'attività e il suo contenuto. Il grafo non è il gemello digitale: un HDTNode (HC2) raccoglie tutte le informazioni digitali su un bene, a qualunque scala. Collegabile tramite contains_proposition_set (HP33) a una o più istanze di HDTNode (HC2 Heritage Digital Twin).",
     "el": "Αναπαριστά τον ίδιο τον γράφο EM ως κόμβο, που χρησιμοποιείται ως άγκυρα για μεταδεδομένα επιπέδου γράφου (συντάκτης, άδεια, embargo, προεπιλεγμένη εποχή, προέλευση επιπέδου έργου). Επιτρέπει την κληρονομικότητα σε επίπεδο γράφου για τη διάδοση μεταδεδομένων: οι τιμές που δηλώνονται στον GraphNode γίνονται προεπιλογές για όλους τους περιεχόμενους κόμβους, εκτός αν παρακαμφθούν. Αποτελεί στόχο των ακμών has_author, has_license, has_embargo για τη μεταφορά καθολικών προεπιλογών. Με όρους HDT-O (D7.1) ένας γράφος EM ΕΙΝΑΙ ένα Heritage Proposition Set (HC16) — ένας ονομασμένος γράφος που φέρει τυπικές διατυπώσεις για μια οντότητα πολιτιστικής κληρονομιάς. Μπορεί να συνδεθεί μέσω contains_proposition_set (HP33) με ένα ή περισσότερα στιγμιότυπα HDTNode (HC2 Heritage Digital Twin).",
     "he": "מייצג את גרף ה־EM עצמו כצומת, המשמש עוגן למטא־דאטה ברמת הגרף כולו (מחבר, רישיון, אמברגו, תקופת ברירת מחדל, מקור (provenance) ברמת הפרויקט). מאפשר ירושה ברמת הגרף להפצת מטא־דאטה: ערכים המוצהרים ב־GraphNode הופכים לברירות מחדל לכל הצמתים הכלולים בו, אלא אם נדרסו. יעד של הקשתות has_author, has_license, has_embargo הנושאות ברירות מחדל גלובליות. במונחי HDT-O (D7.1) גרף EM הוא Heritage Proposition Set (HC16) — גרף בעל שם הנושא קביעות פורמליות על ישות מורשת. ניתן לחבר אותו באמצעות contains_proposition_set (HP33) למופע אחד או יותר של HDTNode (HC2 Heritage Digital Twin).",
     "es": "Representa el propio grafo EM como un nodo, utilizado como ancla para los metadatos de todo el grafo (autor, licencia, embargo, época por defecto, procedencia a nivel de proyecto). Permite la herencia a nivel de grafo para la propagación de metadatos: los valores declarados en el GraphNode se convierten en valores por defecto para todos los nodos contenidos, salvo que se sobrescriban. Es el destino de las aristas has_author, has_license y has_embargo que transportan los valores globales por defecto. En términos de HDT-O (D7.1), un grafo EM ES un Heritage Proposition Set (HC16) — un grafo con nombre que contiene afirmaciones formales sobre una entidad patrimonial. Se puede conectar mediante contains_proposition_set (HP33) a una o más instancias de HDTNode (HC2 Heritage Digital Twin).",
@@ -1939,7 +1939,7 @@
   },
   "StudyNode": {
    "description": {
-    "en": "HC9 Study (HDT-O, ECHOES D7.1): a scholarly activity (research/analysis/documentation, any domain) about a Heritage Entity (HC1), with a disciplinary focus, that produces documentary outputs contributing to an HDT. In EM a study heads a proposition set (HC16/em:EMGraph). Chain: Project -includes(crm:P9)-> Study -was_about(HP23)-> HeritageEntity ; Study -produced(HP25)-> GraphNode. HDT-O-view node: not shown in the stratigrapher palette.",
+    "en": "HC9 Study (HDT-O, ECHOES D7.1): a scholarly activity (research/analysis/documentation, any domain) about a Heritage Entity (HC1), with a disciplinary focus, that produces documentary outputs contributing to an HDT. In EM one study corresponds to one graph: the study is the investigation, the graph (HC16/em:EMGraph) its content, created through HP25 — the sense of «a graph is a study» (StratiGraph D3.1 §3.3, D3.2 §3.5). The two stay distinct classes. Chain: Project -includes(crm:P9)-> Study -was_about(HP23)-> HeritageEntity ; Study -produced(HP25)-> GraphNode. HDT-O-view node: not shown in the stratigrapher palette.",
     "validated_it": false,
     "validated_el": false,
     "validated_he": false,
@@ -1948,7 +1948,7 @@
     "validated_ro": false,
     "validated_fr": false,
     "validated_de": false,
-    "it": "HC9 Study (HDT-O, ECHOES D7.1): un'attività scientifica (ricerca/analisi/documentazione, in qualsiasi ambito) su un'Entità patrimoniale (HC1), con un orientamento disciplinare, che produce esiti documentari che contribuiscono a un HDT. In EM uno studio è a capo di un proposition set (HC16/em:EMGraph). Catena: Project -includes(crm:P9)-> Study -was_about(HP23)-> HeritageEntity ; Study -produced(HP25)-> GraphNode. Nodo della vista HDT-O: non mostrato nella palette dello stratigrafo.",
+    "it": "HC9 Study (HDT-O, ECHOES D7.1): un'attività scientifica (ricerca/analisi/documentazione, in qualsiasi ambito) su un'Entità patrimoniale (HC1), con un orientamento disciplinare, che produce esiti documentari che contribuiscono a un HDT. In EM uno studio corrisponde a un grafo: lo studio è l'indagine, il grafo (HC16/em:EMGraph) il suo contenuto, creato tramite HP25 — il senso di «un grafo è uno studio» (StratiGraph D3.1 §3.3, D3.2 §3.5). Le due classi restano distinte. Catena: Project -includes(crm:P9)-> Study -was_about(HP23)-> HeritageEntity ; Study -produced(HP25)-> GraphNode. Nodo della vista HDT-O: non mostrato nella palette dello stratigrafo.",
     "el": "HC9 Study (HDT-O, ECHOES D7.1): μια επιστημονική δραστηριότητα (έρευνα/ανάλυση/τεκμηρίωση, σε οποιοδήποτε πεδίο) σχετικά με μια Οντότητα Πολιτιστικής Κληρονομιάς (HC1), με συγκεκριμένη επιστημονική εστίαση, που παράγει τεκμηριωτικά αποτελέσματα τα οποία συμβάλλουν σε ένα HDT. Στο EM μια μελέτη τίθεται επικεφαλής ενός συνόλου προτάσεων (HC16/em:EMGraph). Αλυσίδα: Project -includes(crm:P9)-> Study -was_about(HP23)-> HeritageEntity ; Study -produced(HP25)-> GraphNode. Κόμβος προβολής HDT-O: δεν εμφανίζεται στην παλέτα του στρωματογράφου.",
     "he": "HC9 Study (HDT-O, ECHOES D7.1): פעילות מדעית (מחקר/ניתוח/תיעוד, בכל תחום) על ישות מורשת (HC1), בעלת מוקד דיסציפלינרי, המפיקה תוצרים תיעודיים התורמים ל־HDT. ב־EM מחקר עומד בראש מערך קביעות (HC16/em:EMGraph). שרשרת: Project -includes(crm:P9)-> Study -was_about(HP23)-> HeritageEntity ; Study -produced(HP25)-> GraphNode. צומת של תצוגת HDT-O: אינו מוצג בלוח הכלים של הסטרטיגרף.",
     "es": "HC9 Study (HDT-O, ECHOES D7.1): una actividad académica (investigación/análisis/documentación, de cualquier ámbito) sobre una entidad patrimonial (HC1), con un enfoque disciplinar, que produce resultados documentales que contribuyen a un HDT. En EM un estudio encabeza un conjunto de proposiciones (HC16/em:EMGraph). Cadena: Project -includes(crm:P9)-> Study -was_about(HP23)-> HeritageEntity ; Study -produced(HP25)-> GraphNode. Nodo de la vista HDT-O: no se muestra en la paleta del estratígrafo.",
@@ -5683,6 +5683,44 @@
     "ro": "Are geamănul digital",
     "fr": "A un jumeau numérique",
     "de": "Hat digitalen Zwilling"
+   },
+   "ui_phrase_as_source": {
+    "en": "{node} whose digital twin is {x}",
+    "validated_it": false,
+    "validated_el": false,
+    "validated_he": false,
+    "validated_es": false,
+    "validated_pl": false,
+    "validated_ro": false,
+    "validated_fr": false,
+    "validated_de": false,
+    "it": "{node} di cui {x} è il gemello digitale",
+    "el": "{node} του οποίου ψηφιακό δίδυμο είναι το {x}",
+    "he": "{node} שהתאום הדיגיטלי שלו הוא {x}",
+    "es": "{node} cuyo gemelo digital es {x}",
+    "pl": "{node}, którego cyfrowym bliźniakiem jest {x}",
+    "ro": "{node} al cărui geamăn digital este {x}",
+    "fr": "{node} dont {x} est le jumeau numérique",
+    "de": "{node}, dessen digitaler Zwilling {x} ist"
+   },
+   "ui_phrase_as_target": {
+    "en": "{node} digital twin of {x}",
+    "validated_it": false,
+    "validated_el": false,
+    "validated_he": false,
+    "validated_es": false,
+    "validated_pl": false,
+    "validated_ro": false,
+    "validated_fr": false,
+    "validated_de": false,
+    "it": "{node} gemello digitale di {x}",
+    "el": "{node} ψηφιακό δίδυμο του {x}",
+    "he": "{node} תאום דיגיטלי של {x}",
+    "es": "{node} gemelo digital de {x}",
+    "pl": "{node} jako cyfrowy bliźniak {x}",
+    "ro": "{node} geamăn digital al {x}",
+    "fr": "{node} jumeau numérique de {x}",
+    "de": "{node} als digitaler Zwilling von {x}"
    }
   },
   "has_digital_twin_component": {

{s3dgraphy-1.6.0.dev59 → s3dgraphy-1.6.0.dev60}/src/s3dgraphy/JSON_config/em.ttl

@@ -47,8 +47,8 @@
     dcterms:creator "Emanuele Demetrescu" ;
     dcterms:license <https://creativecommons.org/licenses/by/4.0/> ;
     dcterms:issued "2026-05-23"^^xsd:date ;
-    owl:versionInfo "1.6.17" ;
-    rdfs:comment "Formal ontology for Extended Matrix (EM): a human-readable layout for knowledge graphs of archaeological stratigraphy and virtual reconstruction. Extends CIDOC-CRM, CRMarchaeo, CRMinf, CRMdig, CRMgeo, with PROV-O for agent provenance and HDT-O for digital-twin granularity. This file declares the em: classes and properties introduced in s3dgraphy v1.6.0. v1.6.17 (2026-10-17, MICRO le alternative e la trasformazione, decided by E.D.): section 20 — the transformation of a 3D object (a representation model or a semantic shape) in the frame of the study: em:position, em:rotationDegrees, em:scale and em:pivot as rdf:JSON arrays of three numbers, em:rotationOrder and em:upAxis as strings (node datamodel 1.6.31, properties.transform). v1.6.16 (2026-10-10, MICRO le entità spaziotemporali, decided by E.D.): no new term — em:firstAttestedInEpoch and em:survivesInEpoch widen their domain from crmarchaeo:A8_Stratigraphic_Unit to crm:E77_Persistent_Item, because a document (E31) and a person (E21) are placed in the lanes of the matrix like a unit (connections 1.6.38); A8 is an E77, so every triple already emitted stays type-correct. v1.6.15 (2026-10-04, D1, decided by E.D.): section 19 — the level of a version of an asset (em:lodLevel, computed from its chain, written on export), its uses (em:use) and seven measures (em:trisPerM2, em:texelDensityDD, em:textureCount, em:textureSidePx, em:uvRatio, em:reductionFromLod0, em:geometricErrorM). v1.6.14 (2026-10-02, dev30, decided by E.D. on the dev29 report): section 18 — em:retrievedFrom, where a retrieval came from (D1), and em:membersDigest, the digest of a file_set with a predicate of its own (D4; em:digestCovers stays for compatibility). v1.6.13 (2026-10-02, dev29, measured on San Pietro): seven DatatypeProperties, section 17 — how the bytes of a resource are packed and what its digest covers (em:packaging, em:tier, em:digestCovers, em:contentDigest) and what a DTC step declares (em:technique, em:parameters, em:software, the last two rdf:JSON): the round trip em.json → TTL → em.json lost all seven. v1.6.12 (2026-11-01, dev28, decided by E.D. 2026-10-01): no new term — em:authMode admits a third value, 'declared' (an iD typed in a tool's preferences and checked by nobody), with no em:attestedBy. v1.6.11 (2026-10-31, dev27, decided by E.D. 2026-10-01): ten properties. Section 15, several addresses of ONE resource (em:hasAddress to <resource>/address/<i>, em:locator, em:checkedAt, em:reachable) and a dated digest (em:checksumAt); section 16, how the hand of a signature had entered (em:createdVia, em:modifiedVia, em:validatedVia to <node>/auth/<stamp>, em:authMode orcid | node_password, em:attestedBy the StratiGraph node). The language of the content of a resource leaves as dcterms:language: no em: term. v1.6.10 (2026-10-29, MICRO le traduzioni, decided by E.D. 2026-10-01): six DatatypeProperties for the language of the original and its translations (section 14) — em:originalLanguage on any node, which says which literal is the original once translations share its predicate, and em:sourceLanguage, em:translatedField, em:translationMethod, em:sourceDigest, em:reviewRequested on a TranslationNode, which is a plain crm:E33_Linguistic_Object reached by crm:P73_has_translation: CIDOC has the class and the relation, so no em: class is added. v1.6.9 (2026-10-18, MICRO la risorsa e i suoi file): em:ResourceFile, ONE FILE of a resource (node datamodel 1.6.17), a subclass of crmdig:D1_Digital_Object; the resource is composed of its files by crm:P106_is_composed_of (connections has_file, 1.6.30). A distinct URI because a DTC output resource is already typed crmdig:D1, and a file typed only D1 would read back as a resource. v1.6.2 (2026-09-21, CIDOC repair pass): the eight terms the datamodels cited and this file never defined are declared in section 12; em:NodeGroup and em:ParadataNodeGroup leave the undeclared crm:E78_Collection for crm:E73_Information_Object and crm:E89_Propositional_Object; em:SemanticShape leaves crmgeo:SP5 for crm:E73_Information_Object, provisionally; crmarchaeo:AP11_has_physical_relation becomes AP11_has_physical_relation_to, the name CRMarchaeo has used since 2.0; and em:RepresentationModel says what a representation model IS. v1.6.5 (2026-10-20, MICRO la definizione dell\'unita\'): em:hasDefinition, the DEFINIZIONE of a stratigraphic unit as a subproperty of crm:P2_has_type — declared for the node datamodel 1.6.9 entry StratigraphicNode.properties.definition, not emitted by default (owl:versionInfo was left at 1.6.2 by the 1.6.3/1.6.4 passes and is realigned here). v1.6.8 (2026-10-11, MICRO la geometria per origine): the vertices of a 3D reading (point, line, polyline) are data of the region (node datamodel 1.6.15, AnnotationRegionNode.coords) and leave for RDF as ONE GeoSPARQL 1.1 literal: <region> geo:hasGeometry <region>/geometry, a geo:Geometry with geo:asWKT '<CRS IRI> POINT Z (x y z)' | 'MULTIPOINT Z (...)' | 'LINESTRING Z (...)'^^geo:wktLiteral. WHY GeoSPARQL and not em: terms: the WKT literal is the standard every triplestore with a spatial index reads, and it is the 3D twin of the Media Fragment a 2D region already emits (a string a consumer outside EM can act on); CRMgeo was built to meet GeoSPARQL at exactly this point (SP5 Geometric Place Expression ~ geo:Geometry), and an em:coords literal would say the same thing to nobody. The CRS travels INSIDE the literal, so it cannot be separated from the numbers: em:LocalSceneFrame (declared here) for the scene-local frame, the OGC EPSG IRI for a projected one. em:vertexCount stays (the count of a .glb resource above the threshold). The .glb of a reading is no longer a SemanticShape's rdfs:seeAlso: above coords.inline_max_vertices (500) it is a ResourceNode the region reaches with has_linked_resource (crm:P67_refers_to), and a proxy's .glb is likewise a proxy_model ResourceNode (connections 1.6.28-1.6.29). v1.6.7 (2026-09-30, MICRO la cattura in RDF): no em: term added — the acquisition of a digital object is typed by its KIND. A capture is not a transfer: crmdig:D2_Digitization_Process for a photograph or a laser scan, crmdig:D11_Digital_Measurement_Event for a topographic or GNSS survey, crm:E65_Creation for a field drawing or a recording sheet (made by hand; the file is their copy, so no D7 machine event is asserted); a retrieval (download, local import, URI, ingest) stays crmdig:D12_Data_Transfer_Event. The rule is data (em_visual_rules 1.6.24, dtc_kinds.acquisition.<kind>.mapping). v1.6.6 (2026-10-07, MICRO la misura in RDF): the place of a reading gets its quote and its measure. The quote of a passage reuses W3C Web Annotation (oa:hasSelector -> oa:TextQuoteSelector, oa:exact) — the only standard term for a quote, which has no fragment-string form; its offsets stay the RFC 5147 em:hasSelector 'char=s,e'. The length of a line or polyline reuses CIDOC (crm:P43_has_dimension -> crm:E54_Dimension, P90_has_value xsd:double, P91_has_unit -> a QUDT unit IRI); two em: terms are new, em:vertexCount and em:crs, for what neither vocabulary says. The .glb of a 3D reading is not described here: its URL is the rdfs:seeAlso of the SemanticShape the region reaches with em:hasSemanticShape, and no coordinate enters RDF."@en ;
+    owl:versionInfo "1.6.18" ;
+    rdfs:comment "Formal ontology for Extended Matrix (EM): a human-readable layout for knowledge graphs of archaeological stratigraphy and virtual reconstruction. Extends CIDOC-CRM, CRMarchaeo, CRMinf, CRMdig, CRMgeo, with PROV-O for agent provenance and HDT-O for digital-twin granularity. This file declares the em: classes and properties introduced in s3dgraphy v1.6.0. v1.6.18 (2026-10-20, decided by E.D.): no new term — the comment of em:EMGraph, and in hdto_extension.ttl those of hdto:HC9_Study and hdto:HP25_has_created, state how «a graph is a study» (StratiGraph D3.1 §3.3, D3.2 §3.5) is read: one graph corresponds one to one to the study that created it, the two classes stay distinct because E2 and E77 are disjoint, and the graph is not the digital twin (HC2). v1.6.17 (2026-10-17, MICRO le alternative e la trasformazione, decided by E.D.): section 20 — the transformation of a 3D object (a representation model or a semantic shape) in the frame of the study: em:position, em:rotationDegrees, em:scale and em:pivot as rdf:JSON arrays of three numbers, em:rotationOrder and em:upAxis as strings (node datamodel 1.6.31, properties.transform). v1.6.16 (2026-10-10, MICRO le entità spaziotemporali, decided by E.D.): no new term — em:firstAttestedInEpoch and em:survivesInEpoch widen their domain from crmarchaeo:A8_Stratigraphic_Unit to crm:E77_Persistent_Item, because a document (E31) and a person (E21) are placed in the lanes of the matrix like a unit (connections 1.6.38); A8 is an E77, so every triple already emitted stays type-correct. v1.6.15 (2026-10-04, D1, decided by E.D.): section 19 — the level of a version of an asset (em:lodLevel, computed from its chain, written on export), its uses (em:use) and seven measures (em:trisPerM2, em:texelDensityDD, em:textureCount, em:textureSidePx, em:uvRatio, em:reductionFromLod0, em:geometricErrorM). v1.6.14 (2026-10-02, dev30, decided by E.D. on the dev29 report): section 18 — em:retrievedFrom, where a retrieval came from (D1), and em:membersDigest, the digest of a file_set with a predicate of its own (D4; em:digestCovers stays for compatibility). v1.6.13 (2026-10-02, dev29, measured on San Pietro): seven DatatypeProperties, section 17 — how the bytes of a resource are packed and what its digest covers (em:packaging, em:tier, em:digestCovers, em:contentDigest) and what a DTC step declares (em:technique, em:parameters, em:software, the last two rdf:JSON): the round trip em.json → TTL → em.json lost all seven. v1.6.12 (2026-11-01, dev28, decided by E.D. 2026-10-01): no new term — em:authMode admits a third value, 'declared' (an iD typed in a tool's preferences and checked by nobody), with no em:attestedBy. v1.6.11 (2026-10-31, dev27, decided by E.D. 2026-10-01): ten properties. Section 15, several addresses of ONE resource (em:hasAddress to <resource>/address/<i>, em:locator, em:checkedAt, em:reachable) and a dated digest (em:checksumAt); section 16, how the hand of a signature had entered (em:createdVia, em:modifiedVia, em:validatedVia to <node>/auth/<stamp>, em:authMode orcid | node_password, em:attestedBy the StratiGraph node). The language of the content of a resource leaves as dcterms:language: no em: term. v1.6.10 (2026-10-29, MICRO le traduzioni, decided by E.D. 2026-10-01): six DatatypeProperties for the language of the original and its translations (section 14) — em:originalLanguage on any node, which says which literal is the original once translations share its predicate, and em:sourceLanguage, em:translatedField, em:translationMethod, em:sourceDigest, em:reviewRequested on a TranslationNode, which is a plain crm:E33_Linguistic_Object reached by crm:P73_has_translation: CIDOC has the class and the relation, so no em: class is added. v1.6.9 (2026-10-18, MICRO la risorsa e i suoi file): em:ResourceFile, ONE FILE of a resource (node datamodel 1.6.17), a subclass of crmdig:D1_Digital_Object; the resource is composed of its files by crm:P106_is_composed_of (connections has_file, 1.6.30). A distinct URI because a DTC output resource is already typed crmdig:D1, and a file typed only D1 would read back as a resource. v1.6.2 (2026-09-21, CIDOC repair pass): the eight terms the datamodels cited and this file never defined are declared in section 12; em:NodeGroup and em:ParadataNodeGroup leave the undeclared crm:E78_Collection for crm:E73_Information_Object and crm:E89_Propositional_Object; em:SemanticShape leaves crmgeo:SP5 for crm:E73_Information_Object, provisionally; crmarchaeo:AP11_has_physical_relation becomes AP11_has_physical_relation_to, the name CRMarchaeo has used since 2.0; and em:RepresentationModel says what a representation model IS. v1.6.5 (2026-10-20, MICRO la definizione dell\'unita\'): em:hasDefinition, the DEFINIZIONE of a stratigraphic unit as a subproperty of crm:P2_has_type — declared for the node datamodel 1.6.9 entry StratigraphicNode.properties.definition, not emitted by default (owl:versionInfo was left at 1.6.2 by the 1.6.3/1.6.4 passes and is realigned here). v1.6.8 (2026-10-11, MICRO la geometria per origine): the vertices of a 3D reading (point, line, polyline) are data of the region (node datamodel 1.6.15, AnnotationRegionNode.coords) and leave for RDF as ONE GeoSPARQL 1.1 literal: <region> geo:hasGeometry <region>/geometry, a geo:Geometry with geo:asWKT '<CRS IRI> POINT Z (x y z)' | 'MULTIPOINT Z (...)' | 'LINESTRING Z (...)'^^geo:wktLiteral. WHY GeoSPARQL and not em: terms: the WKT literal is the standard every triplestore with a spatial index reads, and it is the 3D twin of the Media Fragment a 2D region already emits (a string a consumer outside EM can act on); CRMgeo was built to meet GeoSPARQL at exactly this point (SP5 Geometric Place Expression ~ geo:Geometry), and an em:coords literal would say the same thing to nobody. The CRS travels INSIDE the literal, so it cannot be separated from the numbers: em:LocalSceneFrame (declared here) for the scene-local frame, the OGC EPSG IRI for a projected one. em:vertexCount stays (the count of a .glb resource above the threshold). The .glb of a reading is no longer a SemanticShape's rdfs:seeAlso: above coords.inline_max_vertices (500) it is a ResourceNode the region reaches with has_linked_resource (crm:P67_refers_to), and a proxy's .glb is likewise a proxy_model ResourceNode (connections 1.6.28-1.6.29). v1.6.7 (2026-09-30, MICRO la cattura in RDF): no em: term added — the acquisition of a digital object is typed by its KIND. A capture is not a transfer: crmdig:D2_Digitization_Process for a photograph or a laser scan, crmdig:D11_Digital_Measurement_Event for a topographic or GNSS survey, crm:E65_Creation for a field drawing or a recording sheet (made by hand; the file is their copy, so no D7 machine event is asserted); a retrieval (download, local import, URI, ingest) stays crmdig:D12_Data_Transfer_Event. The rule is data (em_visual_rules 1.6.24, dtc_kinds.acquisition.<kind>.mapping). v1.6.6 (2026-10-07, MICRO la misura in RDF): the place of a reading gets its quote and its measure. The quote of a passage reuses W3C Web Annotation (oa:hasSelector -> oa:TextQuoteSelector, oa:exact) — the only standard term for a quote, which has no fragment-string form; its offsets stay the RFC 5147 em:hasSelector 'char=s,e'. The length of a line or polyline reuses CIDOC (crm:P43_has_dimension -> crm:E54_Dimension, P90_has_value xsd:double, P91_has_unit -> a QUDT unit IRI); two em: terms are new, em:vertexCount and em:crs, for what neither vocabulary says. The .glb of a 3D reading is not described here: its URL is the rdfs:seeAlso of the SemanticShape the region reaches with em:hasSemanticShape, and no coordinate enters RDF."@en ;
     owl:imports <http://www.cidoc-crm.org/cidoc-crm/> ,
                 <http://www.cidoc-crm.org/extensions/crminf/> ,
                 <http://www.cidoc-crm.org/extensions/crmarchaeo/> ,
@@ -421,7 +421,7 @@ em:EMGraph
     a owl:Class ;
     rdfs:label "EM Graph"@en ;
     rdfs:subClassOf crm:E73_Information_Object , prov:Bundle , hdto:HC16_Heritage_Proposition_Set ;
-    rdfs:comment "The Extended Matrix project graph as (a) a single information artifact (E73), (b) a bundle of triples (prov:Bundle), and (c) a Heritage Proposition Set in HDT-O terms (hdto:HC16) — i.e. a named graph carrying formal assertions about heritage. Anchor for graph-level metadata: default author, license, embargo, epoch, project provenance. In RDF serialization this is the named-graph IRI carrying graph-wide assertions; values declared on the EMGraph become defaults inherited by all contained nodes unless overridden locally. An em:EMGraph can be attached to one or more hdto:HC2_Heritage_Digital_Twin instances via hdto:HP33_contains (and its inverse HP33i_is_proposition_set_of). Maps to: Python GraphNode (node_type='graph')."@en .
+    rdfs:comment "The Extended Matrix project graph as (a) a single information artifact (E73), (b) a bundle of triples (prov:Bundle), and (c) a Heritage Proposition Set in HDT-O terms (hdto:HC16) — i.e. a named graph carrying formal assertions about heritage. One graph, one study: an Extended Matrix graph corresponds one to one to the study that created it (hdto:HC9_Study, Python StudyNode, through hdto:HP25_has_created); the study is about a heritage entity (hdto:HP23_was_about) and may form part of a project (hdto:HC13, crm:P9_consists_of). This is what StratiGraph D3.1 §3.3 and D3.2 §3.5 state as «a graph is a study: its content is a proposition set». The sentence names a correspondence, not a shared class: em:EMGraph is deliberately not a subclass of hdto:HC9, because HC9 is a crm:E65 Creation (an E2 Temporal Entity, the investigation as an act) and HC16 a crminf:I4 Proposition Set (an E77 Persistent Item, what the act asserts), two classes CIDOC CRM keeps disjoint. Nor is the graph the digital twin: an hdto:HC2_Heritage_Digital_Twin gathers all the digital information about a heritage asset at any scale, a whole building or one inscribed block, and can contain the proposition sets of several studies. Anchor for graph-level metadata: default author, license, embargo, epoch, project provenance. In RDF serialization this is the named-graph IRI carrying graph-wide assertions; values declared on the EMGraph become defaults inherited by all contained nodes unless overridden locally. An em:EMGraph can be attached to one or more hdto:HC2_Heritage_Digital_Twin instances via hdto:HP33_contains (and its inverse HP33i_is_proposition_set_of). Maps to: Python GraphNode (node_type='graph')."@en .
 
 
 # ============================================================================

{s3dgraphy-1.6.0.dev59 → s3dgraphy-1.6.0.dev60}/src/s3dgraphy/JSON_config/em_visual_rules.json

@@ -1,6 +1,6 @@
 {
   "formal_language": "EM",
-  "version": "1.6.37",
+  "version": "1.6.38",
   "_note_material_vs_qualia_color": [
     "DUE COSE DIVERSE CHE SI CHIAMANO ENTRAMBE color. Non confonderle: e gia successo.",
     "1) QUI, in node_styles.<tipo>.style.material.rgba_color — il COLORE DEL MATERIALE BLENDER del proxy 3D, in float LINEARI. UNA sola chiave: `rgba_color`. Fino a S8 il file ne usava due (`color` sui 13 tipi stratigrafici, `rgba_color` sugli altri) e get_material_color() ne leggeva una sola, restituendo None per 21 tipi su 38; ora sono unificate e la vecchia `color` e letta solo come tolleranza verso file scritti prima. Un tipo che non diventa mai una mesh NON ha material affatto (i contenitori di gruppo, e da S7 i dieci nodi che rendono per icona): per loro get_material_color() torna None, ed e corretto.",
@@ -9,6 +9,7 @@
     "In breve: qui si decide di che colore DISEGNARE una US; li si registra di che colore ERA."
   ],
   "_changelog": {
+    "1.6.38": "THE HDT-O GLYPHS (MICRO glifi HDT-O, 20 Oct 2026). graph (HC16), hdt (HC2), heritage_entity (HC1), study (HC9), project (HC13) join 2d_render_glyph_types.types (aspect 1.0) and get their 2d_glyphs entries, generated from src/2D/hdto/*.svg: the ornaments' grammar in a square plate, as EMStudio drew them in its pending hdto-glyphs.ts (which can now go: the datamodel wins). New table 2d_render_glyph_types.hdto_glyphs: class, HDT-O class and what each pictogram shows, en/it. src/2D/graph.svg, the GRAPH style's declared file, is unchanged.",
     "1.6.37": "THE ALTERNATIVES OF A 3D OBJECT: THE COMMON HAT (MICRO le alternative e la trasformazione, E.D. 17 Oct 2026). New block `alternatives`: a set of alternatives is the 3D resources with the same hat (the has_linked_resource from an RM, or from an RM container since connections 1.6.41, to their asset); reasons lod, fidelity, packaging computed; two nested levels, RM and container; the diagnoses two_hats, partial_coverage, epochs. Replaces the alternative of a container computed from the DTC (16 Oct). A view: nothing in em.json or RDF. Read by s3dgraphy.resources.alternatives.alternative_sets.",
     "1.6.36": "THE RM IS BOUND TO THE EPOCH ONLY DIRECTLY (MICRO lo spazio 3D 2, Parte 0, E.D. 16 Oct 2026). threed_instances.representation_model loses `via_property`: an epoch reaches its model only by a direct has_representation_model, the one form the connections datamodel admits (a property is not a source of has_representation_model) and the only one in the data (the 99 RMs of Templu Mare v2). «×N» counts the epochs bound directly.",
     "1.6.35": "RM AND PROXY AMONG THE COMPUTED INSTANCES (MICRO lo spazio 3D, E.D. 11 Oct 2026). New block threed_instances: the proxy of a unit (geometry property → has_semantic_shape → SemanticShape) is drawn in the paradata group of the property, beside it; a representation model is drawn in the paradata group of each epoch that has it (has_representation_model, directly or through an epoch property), with the number of its epochs («×N»). A view: nothing in em.json or RDF. Read by s3dgraphy.paradata_view.threed_instances and units_without_3d.",
@@ -65,12 +66,60 @@
       "SE",
       "representation_model",
       "representation_model_doc",
-      "representation_model_sf"
+      "representation_model_sf",
+      "graph",
+      "hdt",
+      "heritage_entity",
+      "study",
+      "project"
     ],
     "sheet_types": [
       "document"
     ],
     "_sheet_types_comment": "1.6.21 · types that have a `2d_glyphs` entry (drawn from paths, box = height x aspect like every glyph) but are NOT centred icons, because their LABEL is written ON the drawing. Only the document. WHY NOT IN `types`: being in `types` is a promise about the LABEL as well as the drawing, and every consumer reads it that way. EMStudio (measured 2026-10-02, read-only): a `types` member resolves through glyphs.ts GLYPH_TYPES, so svg-export.ts would print its name UNDER the glyph, and the renderer's generic glyph branch clips an 'over' label to the glyph width minus 10 — at 32 x 0.636 = 20.4 units that is ~10 units, an ellipsis. The document's name sits on the sheet (node_styles.DOC.label_position = 'over'; yEd palette: internal label, centred; EMStudio renderer.ts draws it at 62% of the sheet height, unclipped). Listing it in `types` would squash that label to '…', so it gets a list of its own. What the list does NOT change: the layout box (em-core gives `document` the EM3 box from SHEET_TYPES_PENDING and reads `aspect.document`, whichever list it is in).",
+    "hdto_glyphs": {
+      "_comment": "1.6.38 · the HDT-O layer drawn as glyphs (MICRO glifi HDT-O, 20 Oct 2026; drawings by EMStudio, MICRO-PULIZIA-INTERFACCIA p.3, until then a pending file of its own, hdto-glyphs.ts). The same grammar as the ornaments (author, licence, embargo): a grey pictogram (`ground`, #6E6E6E) in a #333333 frame (`ink`, stroke 7 on the 128 grid), but in a SQUARE plate — the square says «a node of the cultural context», the pictogram says which. Listed in `types` (centred glyph, label under it, box = height × aspect 1.0). Sources in src/2D/hdto/ (glyphs_from_svg reads that folder first for these types: src/2D/graph.svg stays the GRAPH style's declared file, unplated). `class` = the s3Dgraphy class, `hdto` = the HDT-O class the node projects to; `description` = what the pictogram shows, per language.",
+      "graph": {
+        "class": "GraphNode",
+        "hdto": "HC16 Heritage Proposition Set (em:EMGraph)",
+        "description": {
+          "en": "Three nodes and their edges: the graph, one of the proposition sets a digital twin gathers.",
+          "it": "Tre nodi e i loro archi: il grafo, uno degli insiemi di proposizioni che un gemello digitale raccoglie."
+        }
+      },
+      "hdt": {
+        "class": "HDTNode",
+        "hdto": "HC2 Heritage Digital Twin",
+        "description": {
+          "en": "The thing (a filled house) and its copy (an outlined house): the digital twin of a heritage entity, at any scale — a site, a building, a single unit.",
+          "it": "La cosa (una casa piena) e la sua copia (una casa contornata): il gemello digitale di un bene, a qualunque scala — un sito, un edificio, una sola unità."
+        }
+      },
+      "heritage_entity": {
+        "class": "HeritageEntityNode",
+        "hdto": "HC1 Heritage Entity",
+        "description": {
+          "en": "A façade — pediment, architrave, three columns, step: the heritage entity, the thing studied.",
+          "it": "Una facciata — frontone, architrave, tre colonne, gradino: il bene, la cosa studiata."
+        }
+      },
+      "study": {
+        "class": "StudyNode",
+        "hdto": "HC9 Study",
+        "description": {
+          "en": "A lens: the study about a heritage entity, which produces the proposition sets.",
+          "it": "Una lente: lo studio su un bene, che produce gli insiemi di proposizioni."
+        }
+      },
+      "project": {
+        "class": "ProjectNode",
+        "hdto": "HC13 Project",
+        "description": {
+          "en": "A flag: the project that includes the studies.",
+          "it": "Una bandiera: il progetto che comprende gli studi."
+        }
+      }
+    },
     "data_glyphs": {
       "_comment": "1.6.32 · glyphs a node takes from its DATA, not from its type: the RM container, the proxy, the tileset and the VERSIONS of a 3D asset (resources/versions.py: the master and the versions derived from it, `data.tier`). Keyed like `dtc:<kind>`: the key is the `2d_glyphs` entry, `glyph` its authored SVG. A consumer resolves a node in this order: its node_type in `types`/`sheet_types` → its `data.dtc_kind` → the FIRST entry of this table whose `when` matches → its shape. `when` is a list of alternatives (any may match); inside one alternative every field must match one of its values. Fields: `node_type`; `data.<field>` (the value as a string, or any item of a list); `url_ext` — the extension of `data.url`, lower case, with its dot, after dropping a query and a trailing slash; `url_name` — the last segment of `data.url`, lower case. MEASURED on Templu Mare v2 (9 Oct 2026, 1555 nodes): no resource carries a `data.format`, so the file's kind comes from `media_type`, the URL's extension and `packaging` — 196 `.glb` distributions → version:gltf, 33 OBJ `file_set` → version:mesh, a `.3tz` and a `tileset.json` → version:tiles, 99 `application/x-blender` datablock masters → version:scene. The format's acronym (GLB, 3TZ, BLEND) is NOT in the glyph: a consumer writes it as text when there is room.",
       "container": {
@@ -358,7 +407,12 @@
       "version:tiles": 1.0,
       "version:gltf": 1.0,
       "version:scene": 1.0,
-      "version:mesh": 1.0
+      "version:mesh": 1.0,
+      "graph": 1.0,
+      "hdt": 1.0,
+      "heritage_entity": 1.0,
+      "study": 1.0,
+      "project": 1.0
     },
     "_aspect_correction_1_6_18": "author 0.875 → 0.984 (2026-09-30). 0.875 was measured from src/2D/author.svg (448×512), a Font Awesome silhouette that is NOT the palette pictogram; the pictogram (author.png, 126×128, redrawn as src/2D/bozze/author.svg) is 0.984, the same as author_ai. The drawing wins (2d_glyphs rule), and the layout reads this number. Until EMStudio draws 2d_glyphs, sync-datamodels.sh will WARN on author, because icons.ts still resolves the FA author.svg.",
     "_aspect_correction_1_6_21": "document declared for the first time: 0.636, from src/2D/document.svg (16.11 x 25.34) — the drawing wins (2d_glyphs rule). It agrees with the yEd palette's document node (35 x 55 = 0.636) and with document.png (128 x 199 = 0.643, within the 2% sync-datamodels.sh tolerates). EMStudio's 0.78 (em-core geometry.rs SHEET_TYPES_PENDING, shape-geom.ts DOC_SHEET_ASPECT) measured the sheet its renderer drew by hand, 23.4 x 30, which is not the manual's: both read this key when it exists, so the sheet narrows from 24.96 to 20.35 units at the 32-unit node height."
@@ -1078,6 +1132,208 @@
         46.81
       ]
     },
+    "graph": {
+      "viewBox": [
+        0,
+        0,
+        128.0,
+        128.0
+      ],
+      "aspect": 1.0,
+      "layers": [
+        {
+          "d": "M18 4L110 4C117.73 4 124 10.27 124 18L124 110C124 117.73 117.73 124 110 124L18 124C10.27 124 4 117.73 4 110L4 18C4 10.27 10.27 4 18 4Z",
+          "role": "paper",
+          "fill": "#FFFFFF"
+        },
+        {
+          "d": "M18 4L110 4C117.73 4 124 10.27 124 18L124 110C124 117.73 117.73 124 110 124L18 124C10.27 124 4 117.73 4 110L4 18C4 10.27 10.27 4 18 4Z",
+          "role": "ink",
+          "stroke": "#333333",
+          "stroke_width": 7.0
+        },
+        {
+          "d": "M64 46L64 64M64 64L42 86M64 64L86 86",
+          "role": "ground",
+          "stroke": "#6E6E6E",
+          "stroke_width": 7.0,
+          "line_cap": "round",
+          "line_join": "round"
+        },
+        {
+          "d": "M74 36C74 41.52 69.52 46 64 46C58.48 46 54 41.52 54 36C54 30.48 58.48 26 64 26C69.52 26 74 30.48 74 36ZM46 92C46 97.52 41.52 102 36 102C30.48 102 26 97.52 26 92C26 86.48 30.48 82 36 82C41.52 82 46 86.48 46 92ZM102 92C102 97.52 97.52 102 92 102C86.48 102 82 97.52 82 92C82 86.48 86.48 82 92 82C97.52 82 102 86.48 102 92Z",
+          "role": "paper",
+          "fill": "#FFFFFF"
+        },
+        {
+          "d": "M74 36C74 41.52 69.52 46 64 46C58.48 46 54 41.52 54 36C54 30.48 58.48 26 64 26C69.52 26 74 30.48 74 36ZM46 92C46 97.52 41.52 102 36 102C30.48 102 26 97.52 26 92C26 86.48 30.48 82 36 82C41.52 82 46 86.48 46 92ZM102 92C102 97.52 97.52 102 92 102C86.48 102 82 97.52 82 92C82 86.48 86.48 82 92 82C97.52 82 102 86.48 102 92Z",
+          "role": "ground",
+          "stroke": "#6E6E6E",
+          "stroke_width": 6.0
+        }
+      ],
+      "source": "src/2D/hdto/graph.svg"
+    },
+    "hdt": {
+      "viewBox": [
+        0,
+        0,
+        128.0,
+        128.0
+      ],
+      "aspect": 1.0,
+      "layers": [
+        {
+          "d": "M18 4L110 4C117.73 4 124 10.27 124 18L124 110C124 117.73 117.73 124 110 124L18 124C10.27 124 4 117.73 4 110L4 18C4 10.27 10.27 4 18 4Z",
+          "role": "paper",
+          "fill": "#FFFFFF"
+        },
+        {
+          "d": "M18 4L110 4C117.73 4 124 10.27 124 18L124 110C124 117.73 117.73 124 110 124L18 124C10.27 124 4 117.73 4 110L4 18C4 10.27 10.27 4 18 4Z",
+          "role": "ink",
+          "stroke": "#333333",
+          "stroke_width": 7.0
+        },
+        {
+          "d": "M20 62L41 42L62 62L62 96L20 96Z",
+          "role": "ground",
+          "fill": "#6E6E6E"
+        },
+        {
+          "d": "M68 62L89 42L110 62L110 96L68 96Z",
+          "role": "ground",
+          "stroke": "#6E6E6E",
+          "stroke_width": 5.0,
+          "line_cap": "round",
+          "line_join": "round"
+        },
+        {
+          "d": "M78 76L100 76M78 86L100 86",
+          "role": "ground",
+          "stroke": "#6E6E6E",
+          "stroke_width": 4.0,
+          "line_cap": "round",
+          "line_join": "round"
+        }
+      ],
+      "source": "src/2D/hdto/hdt.svg"
+    },
+    "heritage_entity": {
+      "viewBox": [
+        0,
+        0,
+        128.0,
+        128.0
+      ],
+      "aspect": 1.0,
+      "layers": [
+        {
+          "d": "M18 4L110 4C117.73 4 124 10.27 124 18L124 110C124 117.73 117.73 124 110 124L18 124C10.27 124 4 117.73 4 110L4 18C4 10.27 10.27 4 18 4Z",
+          "role": "paper",
+          "fill": "#FFFFFF"
+        },
+        {
+          "d": "M18 4L110 4C117.73 4 124 10.27 124 18L124 110C124 117.73 117.73 124 110 124L18 124C10.27 124 4 117.73 4 110L4 18C4 10.27 10.27 4 18 4Z",
+          "role": "ink",
+          "stroke": "#333333",
+          "stroke_width": 7.0
+        },
+        {
+          "d": "M22 48L64 24L106 48Z",
+          "role": "ground",
+          "fill": "#6E6E6E"
+        },
+        {
+          "d": "M26 52L102 52L102 58L26 58Z",
+          "role": "ground",
+          "fill": "#6E6E6E"
+        },
+        {
+          "d": "M33 62L43 62L43 90L33 90ZM59 62L69 62L69 90L59 90ZM85 62L95 62L95 90L85 90Z",
+          "role": "ground",
+          "fill": "#6E6E6E"
+        },
+        {
+          "d": "M24 94L104 94L104 104L24 104Z",
+          "role": "ground",
+          "fill": "#6E6E6E"
+        }
+      ],
+      "source": "src/2D/hdto/heritage_entity.svg"
+    },
+    "study": {
+      "viewBox": [
+        0,
+        0,
+        128.0,
+        128.0
+      ],
+      "aspect": 1.0,
+      "layers": [
+        {
+          "d": "M18 4L110 4C117.73 4 124 10.27 124 18L124 110C124 117.73 117.73 124 110 124L18 124C10.27 124 4 117.73 4 110L4 18C4 10.27 10.27 4 18 4Z",
+          "role": "paper",
+          "fill": "#FFFFFF"
+        },
+        {
+          "d": "M18 4L110 4C117.73 4 124 10.27 124 18L124 110C124 117.73 117.73 124 110 124L18 124C10.27 124 4 117.73 4 110L4 18C4 10.27 10.27 4 18 4Z",
+          "role": "ink",
+          "stroke": "#333333",
+          "stroke_width": 7.0
+        },
+        {
+          "d": "M84 54C84 68.36 72.36 80 58 80C43.64 80 32 68.36 32 54C32 39.64 43.64 28 58 28C72.36 28 84 39.64 84 54Z",
+          "role": "ground",
+          "stroke": "#6E6E6E",
+          "stroke_width": 8.0
+        },
+        {
+          "d": "M78 74L102 98",
+          "role": "ground",
+          "stroke": "#6E6E6E",
+          "stroke_width": 13.0,
+          "line_cap": "round",
+          "line_join": "round"
+        }
+      ],
+      "source": "src/2D/hdto/study.svg"
+    },
+    "project": {
+      "viewBox": [
+        0,
+        0,
+        128.0,
+        128.0
+      ],
+      "aspect": 1.0,
+      "layers": [
+        {
+          "d": "M18 4L110 4C117.73 4 124 10.27 124 18L124 110C124 117.73 117.73 124 110 124L18 124C10.27 124 4 117.73 4 110L4 18C4 10.27 10.27 4 18 4Z",
+          "role": "paper",
+          "fill": "#FFFFFF"
+        },
+        {
+          "d": "M18 4L110 4C117.73 4 124 10.27 124 18L124 110C124 117.73 117.73 124 110 124L18 124C10.27 124 4 117.73 4 110L4 18C4 10.27 10.27 4 18 4Z",
+          "role": "ink",
+          "stroke": "#333333",
+          "stroke_width": 7.0
+        },
+        {
+          "d": "M38 24L38 106",
+          "role": "ground",
+          "stroke": "#6E6E6E",
+          "stroke_width": 7.0,
+          "line_cap": "round",
+          "line_join": "round"
+        },
+        {
+          "d": "M42 28L98 28L85 46L98 64L42 64Z",
+          "role": "ground",
+          "fill": "#6E6E6E"
+        }
+      ],
+      "source": "src/2D/hdto/project.svg"
+    },
     "document": {
       "viewBox": [
         0,
@@ -6250,16 +6506,24 @@
       "property_type": "geometry",
       "shape_edge": "has_semantic_shape",
       "file_edge": "has_linked_resource",
-      "file_types": ["proxy_model"],
+      "file_types": [
+        "proxy_model"
+      ],
       "membership": "is_in_paradata_nodegroup",
       "group_edge": "has_paradata_nodegroup",
       "beside": "property"
     },
     "representation_model": {
       "kind": "rm",
-      "holders": ["EpochNode"],
+      "holders": [
+        "EpochNode"
+      ],
       "edge": "has_representation_model",
-      "masters": ["RepresentationModelNode", "RepresentationModelDocNode", "RepresentationModelSpecialFindNode"],
+      "masters": [
+        "RepresentationModelNode",
+        "RepresentationModelDocNode",
+        "RepresentationModelSpecialFindNode"
+      ],
       "group_edge": "has_paradata_nodegroup",
       "count_word": "×{n}"
     },

{s3dgraphy-1.6.0.dev59 → s3dgraphy-1.6.0.dev60}/src/s3dgraphy/JSON_config/hdto_extension.ttl

@@ -10,7 +10,7 @@
 @prefix dcterms:   <http://purl.org/dc/terms/> .
 
 # ============================================================================
-# HDT-O — Heritage Digital Twin Ontology — s3dgraphy alignment layer (v0.3)
+# HDT-O — Heritage Digital Twin Ontology — s3dgraphy alignment layer (v0.5)
 # ============================================================================
 #
 # Reconciled with ECHOES Deliverable D7.1 "The Digital Commons" (May 2024).
@@ -22,7 +22,7 @@
 #          Namespace placeholder (w3id.org/hdto/) — to be replaced when the
 #          official HDT-O resolvable IRI is published by the ECHOES consortium.
 # Author:  Emanuele Demetrescu (s3dgraphy v1.6.0 integration)
-# Date:    2026-09-30 (v0.3; v0.2 2026-05-23)
+# Date:    2026-10-20 (v0.5; v0.4 2026-10-10; v0.3 2026-09-30; v0.2 2026-05-23)
 #
 # v0.3 (2026-09-30): the two declarations this file carried against D7.1 final
 #          are corrected. HC9 Study becomes a subclass of crm:E65 Creation (was
@@ -34,6 +34,13 @@
 #          (was crm:E1 CRM Entity), as the official RDFS says
 #          (HDT_v2.0.1.rdf, ECHOES D7.1: HC1_Heritage_Entity rdfs:subClassOf
 #          crm:E70_Thing). Node datamodel 1.6.28.
+# v0.5 (2026-10-20, decided by E.D.): no new term. The comments of HC9 Study
+#          and HP25 has created say how «a graph is a study» (StratiGraph
+#          D3.1 §3.3, D3.2 §3.5) is read: one Extended Matrix graph
+#          corresponds one to one to the study that created it; the study
+#          (E65 Creation, an E2) and the graph (HC16, an E77) stay distinct
+#          classes; neither is the digital twin (HC2). owl:versionInfo,
+#          left at 0.2 by the v0.3 and v0.4 passes, is realigned. CRMem 1.6.18.
 # License: CC-BY-4.0
 #
 # What this file does:
@@ -63,7 +70,7 @@
     dcterms:source <https://www.echoes-eccch.eu/> ;
     dcterms:license <https://creativecommons.org/licenses/by/4.0/> ;
     dcterms:issued "2026-05-23"^^xsd:date ;
-    owl:versionInfo "0.2-aligned-with-D7.1" ;
+    owl:versionInfo "0.5-aligned-with-D7.1" ;
     rdfs:comment "Subset of HDT-O classes and properties (HC1, HC2, HC5, HC9, HC13, HC14, HC15, HC16, HC17; HP1, HP3, HP23, HP25, HP29, HP33) needed by s3dgraphy v1.6.0 to express granularity of heritage digital twins, the Project→Study→proposition-set framing, HC1 part-whole (crm:P46i), and Type-A annotations (HC5 on representations, HC17 on paradata). Aligned with ECHOES Deliverable D7.1 (May 2024). The namespace (w3id.org/hdto/) is a placeholder pending the official ECHOES publication."@en .
 
 
@@ -108,7 +115,7 @@ hdto:HC9_Study
     a owl:Class ;
     rdfs:label "Study"@en ;
     rdfs:subClassOf crm:E65_Creation ;
-    rdfs:comment "A scholarly activity (research, analysis or documentation, in any SSH / natural / exact-science domain) about a Heritage Entity (HC1), explicating a disciplinary focus and the part of the entity investigated. A study is about (HP23) one or more HC1 and has created (HP25) documentary outputs (crm:E31 Document) — in s3dgraphy the EM proposition set (HC16 / em:EMGraph). A subclass of crm:E65 Creation: the study is the scholarly act, and its documentary output is a separate thing joined to it by HP25, so a report, a field note or a metadata record is never an HC9. ECHOES D7.1 (final, V1.0)."@en .
+    rdfs:comment "A scholarly activity (research, analysis or documentation, in any SSH / natural / exact-science domain) about a Heritage Entity (HC1), explicating a disciplinary focus and the part of the entity investigated. A study is about (HP23) one or more HC1 and has created (HP25) documentary outputs (crm:E31 Document) — in s3dgraphy the EM proposition set (HC16 / em:EMGraph). A subclass of crm:E65 Creation: the study is the scholarly act, and its documentary output is a separate thing joined to it by HP25, so a report, a field note or a metadata record is never an HC9. In the Extended Matrix one study corresponds one to one to one graph: the study is the act, the em:EMGraph (HC16) what it asserts, joined by HP25. This is the sense of «a graph is a study» in StratiGraph D3.1 §3.3 and D3.2 §3.5: a correspondence between an E2 Temporal Entity and an E77 Persistent Item, which CIDOC CRM keeps disjoint, not a shared class. Neither is the digital twin (HC2), which gathers all the digital information about an asset at any scale. ECHOES D7.1 (final, V1.0)."@en .
 
 hdto:HC13_Project
     a owl:Class ;
@@ -200,7 +207,7 @@ hdto:HP25_has_created
     rdfs:domain hdto:HC9_Study ;
     rdfs:range crm:E31_Document ;
     rdfs:subPropertyOf crm:P94_has_created ;
-    rdfs:comment "Associates an HC9 Study with the persistent documentary output it created (crm:E31 Document). Per D7.1 (subproperty of crm:E65.P94 has created; one-to-many, necessary, dependent). In s3dgraphy the created output is the EM proposition set (HC16 / em:EMGraph, an E73 Information Object)."@en .
+    rdfs:comment "Associates an HC9 Study with the persistent documentary output it created (crm:E31 Document). Per D7.1 (subproperty of crm:E65.P94 has created; one-to-many, necessary, dependent). In s3dgraphy the created output is the EM proposition set (HC16 / em:EMGraph, an E73 Information Object): the graph the study writes, which is why an Extended Matrix graph and its study come one to one (StratiGraph D3.1 §3.3: «a graph is a study: its content is a proposition set»)."@en .
 
 # Project → Study containment: D7.1 declares no direct HC13→HC9 property.
 # s3dgraphy expresses "Project includes Study" with crm:P9_consists_of