s3dgraphy 1.6.0.dev24__tar.gz → 1.6.0.dev26__tar.gz

{s3dgraphy-1.6.0.dev24/src/s3dgraphy.egg-info → s3dgraphy-1.6.0.dev26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: s3dgraphy
-Version: 1.6.0.dev24
+Version: 1.6.0.dev26
 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>
@@ -35,7 +35,7 @@ Requires-Dist: pandas>=2.0.0
 Requires-Dist: lxml>=4.9.0
 Requires-Dist: openpyxl>=3.0.0
 Requires-Dist: networkx>=3.0
-Requires-Dist: dtcstamp>=0.1.0
+Requires-Dist: dtcstamp>=0.1.2
 Provides-Extra: rdf
 Requires-Dist: rdflib>=7.0; extra == "rdf"
 Provides-Extra: rdf-embedded

{s3dgraphy-1.6.0.dev24 → s3dgraphy-1.6.0.dev26}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "s3dgraphy"
-version = "1.6.0.dev24"
+version = "1.6.0.dev26"
 description = "3D Stratigraphic Graph Management Library for archaeological and heritage applications"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -56,7 +56,7 @@ dependencies = [
     # the four above. It has zero dependencies of its own and is one module, so
     # it can also simply be copied; s3dgraphy depends on it rather than
     # vendoring it, because two copies of a format rule drift.
-    "dtcstamp>=0.1.0",
+    "dtcstamp>=0.1.2",  # 0.1.1 lacks stamp_description: import s3dgraphy.stamp fails (MICRO-DTCSTAMP-012)
 ]
 
 [project.urls]

{s3dgraphy-1.6.0.dev24 → s3dgraphy-1.6.0.dev26}/src/s3dgraphy/JSON_config/datamodel_translations.json

@@ -2057,6 +2057,46 @@
     "de": "TSU"
    }
   },
+  "TranslationNode": {
+   "description": {
+    "en": "ONE TRANSLATION of one text field of one node (E.D. 2026-10-01, «Le traduzioni»). The ORIGINAL stays a string in its own field, in the language it was written in — data.lang on the node says which, else the study's working language — and a translation never overwrites it: the original is testimony. Each translation is a node of its own, reached from the translated node by has_translation (reverse is_translation_of). Fields in data: lang (the language of ARRIVAL, BCP 47 — the same key as every node's data.lang, so its own text takes its tag by the ordinary cascade); from_lang (the language of DEPARTURE, the original's WHEN it was translated: written, because the original can change); field (the translated field in the CRDT's vocabulary: description, or data.<key> — a PropertyNode's value is data.value; name is never translated, names are invariant identities); text; method (manual | ai | edition); source_digest ('sha256:<hex>' of the original text translated, NFC + UTF-8: when the original changes the digests differ and the translation is «da riallineare», which no signature clears); review_requested (true when the translator asks for a review, «da rivedere»). WHO translated is has_author (an AuthorNode); WHEN is the editorial stamp created_at. An AI translation carries data.ai_assisted and stays among the warnings until a person verifies it (data.validated_by / validated_at, the same two fields that close a requested review: ai_validation.verify). A translation from a published EDITION reaches the DocumentNode of that edition with extracted_from: a published translation is a source, Vitruvius read through a translator is an interpretation.",
+    "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": "UNA TRADUZIONE di un campo di testo di un nodo (E.D. 1 ott 2026, «Le traduzioni»). L'ORIGINALE resta una stringa nel suo campo, nella lingua in cui è nato (data.lang del nodo, altrimenti la lingua dello studio), e una traduzione non lo sovrascrive mai: l'originale è testimonianza. Ogni traduzione è un nodo, raggiunto da has_translation, con lang (arrivo), from_lang (partenza, scritta perché l'originale può cambiare), field (description o data.<chiave>; il nome non si traduce), text, method (manual | ai | edition), source_digest (sha256 dell'originale tradotto: se cambia, la traduzione è «da riallineare») e review_requested («da rivedere»). Chi ha tradotto: has_author; una traduzione AI resta tra gli avvisi finché una persona non la verifica (validated_by); da un'edizione: extracted_from verso il DocumentNode.",
+    "el": "ΜΙΑ ΜΕΤΑΦΡΑΣΗ ενός πεδίου κειμένου ενός κόμβου (E.D. 1/10/2026). Το ΠΡΩΤΟΤΥΠΟ μένει συμβολοσειρά στο πεδίο του, στη γλώσσα όπου γράφτηκε (data.lang του κόμβου, αλλιώς η γλώσσα της μελέτης), και η μετάφραση δεν το αντικαθιστά ποτέ. Κάθε μετάφραση είναι κόμβος, που συνδέεται με has_translation, με lang (άφιξη), from_lang (αφετηρία), field, text, method (manual | ai | edition), source_digest (sha256 του πρωτοτύπου: αν αλλάξει, η μετάφραση χρειάζεται ευθυγράμμιση) και review_requested. Ποιος μετέφρασε: has_author· μια μετάφραση AI μένει στις προειδοποιήσεις ώσπου να την επαληθεύσει ένα πρόσωπο (validated_by)· από έκδοση: extracted_from προς τον DocumentNode.",
+    "he": "תרגום אחד של שדה טקסט אחד של צומת (E.D. 1.10.2026). המקור נשאר מחרוזת בשדה שלו, בשפה שבה נכתב (data.lang של הצומת, אחרת שפת המחקר), ותרגום לעולם אינו דורס אותו. כל תרגום הוא צומת, המחובר ב-has_translation, עם lang (שפת היעד), from_lang (שפת המקור), field, text, method (manual | ai | edition), source_digest (sha256 של המקור: אם השתנה, התרגום דורש יישור) ו-review_requested. מי תרגם: has_author; תרגום AI נשאר באזהרות עד שאדם מאמת אותו (validated_by); ממהדורה: extracted_from אל ה-DocumentNode.",
+    "es": "UNA TRADUCCIÓN de un campo de texto de un nodo (E.D. 1 oct 2026). El ORIGINAL sigue siendo una cadena en su campo, en la lengua en que se escribió (data.lang del nodo, si no la del estudio), y una traducción nunca lo sobrescribe. Cada traducción es un nodo, alcanzado por has_translation, con lang (llegada), from_lang (partida), field, text, method (manual | ai | edition), source_digest (sha256 del original: si cambia, la traducción está «por realinear») y review_requested («por revisar»). Quién tradujo: has_author; una traducción IA queda entre los avisos hasta que una persona la verifica (validated_by); de una edición: extracted_from hacia el DocumentNode.",
+    "pl": "JEDNO TŁUMACZENIE jednego pola tekstowego węzła (E.D. 1.10.2026). ORYGINAŁ pozostaje ciągiem w swoim polu, w języku, w którym powstał (data.lang węzła, w przeciwnym razie język badania), a tłumaczenie nigdy go nie nadpisuje. Każde tłumaczenie jest węzłem, osiąganym przez has_translation, z lang (docelowy), from_lang (źródłowy), field, text, method (manual | ai | edition), source_digest (sha256 oryginału: gdy się zmieni, tłumaczenie wymaga uzgodnienia) i review_requested. Kto przetłumaczył: has_author; tłumaczenie AI pozostaje wśród ostrzeżeń, dopóki osoba go nie zweryfikuje (validated_by); z wydania: extracted_from do DocumentNode.",
+    "ro": "O TRADUCERE a unui câmp de text al unui nod (E.D. 1 oct 2026). ORIGINALUL rămâne un șir în câmpul său, în limba în care a fost scris (data.lang al nodului, altfel limba studiului), iar o traducere nu îl suprascrie niciodată. Fiecare traducere este un nod, atins prin has_translation, cu lang (sosire), from_lang (plecare), field, text, method (manual | ai | edition), source_digest (sha256 al originalului: dacă se schimbă, traducerea trebuie realiniată) și review_requested. Cine a tradus: has_author; o traducere AI rămâne printre avertismente până o verifică o persoană (validated_by); dintr-o ediție: extracted_from către DocumentNode.",
+    "fr": "UNE TRADUCTION d'un champ de texte d'un nœud (E.D. 1er oct. 2026). L'ORIGINAL reste une chaîne dans son champ, dans la langue où il a été écrit (data.lang du nœud, sinon celle de l'étude), et une traduction ne l'écrase jamais. Chaque traduction est un nœud, atteint par has_translation, avec lang (arrivée), from_lang (départ), field, text, method (manual | ai | edition), source_digest (sha256 de l'original : s'il change, la traduction est « à réaligner ») et review_requested (« à revoir »). Qui a traduit : has_author ; une traduction IA reste parmi les avertissements jusqu'à ce qu'une personne la vérifie (validated_by) ; d'une édition : extracted_from vers le DocumentNode.",
+    "de": "EINE ÜBERSETZUNG eines Textfelds eines Knotens (E.D. 1.10.2026). Das ORIGINAL bleibt eine Zeichenkette in seinem Feld, in der Sprache, in der es geschrieben wurde (data.lang des Knotens, sonst die Sprache der Studie), und eine Übersetzung überschreibt es nie. Jede Übersetzung ist ein Knoten, erreicht über has_translation, mit lang (Ziel), from_lang (Ausgang), field, text, method (manual | ai | edition), source_digest (sha256 des Originals: ändert es sich, ist die Übersetzung neu abzugleichen) und review_requested. Wer übersetzt hat: has_author; eine KI-Übersetzung bleibt unter den Warnungen, bis eine Person sie prüft (validated_by); aus einer Edition: extracted_from zum DocumentNode."
+   },
+   "label": {
+    "en": "Translation",
+    "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": "Traduzione",
+    "el": "Μετάφραση",
+    "he": "תרגום",
+    "es": "Traducción",
+    "pl": "Tłumaczenie",
+    "ro": "Traducere",
+    "fr": "Traduction",
+    "de": "Übersetzung"
+   }
+  },
   "UnknownNode": {
    "description": {
     "en": "Fallback node for unrecognized types. This type of node should not normally appear in the system but serves exclusively to handle anomalies in the data.",
@@ -6289,6 +6329,65 @@
     "de": "Hat Zeitzweig"
    }
   },
+  "has_translation": {
+   "label": {
+    "en": "Has translation",
+    "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": "Ha la traduzione",
+    "el": "Έχει μετάφραση",
+    "he": "יש תרגום",
+    "es": "Tiene la traducción",
+    "pl": "Ma tłumaczenie",
+    "ro": "Are traducerea",
+    "fr": "A pour traduction",
+    "de": "Hat die Übersetzung"
+   },
+   "ui_phrase_as_source": {
+    "en": "{node} translated as {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} tradotto come {x}",
+    "el": "{node} μεταφρασμένο ως {x}",
+    "he": "{node} מתורגם כ־{x}",
+    "es": "{node} traducido como {x}",
+    "pl": "{node} przetłumaczone jako {x}",
+    "ro": "{node} tradus ca {x}",
+    "fr": "{node} traduit par {x}",
+    "de": "{node} übersetzt als {x}"
+   },
+   "ui_phrase_as_target": {
+    "en": "{node} translation 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} traduzione di {x}",
+    "el": "{node} μετάφραση του {x}",
+    "he": "{node} תרגום של {x}",
+    "es": "{node} traducción de {x}",
+    "pl": "{node} tłumaczenie {x}",
+    "ro": "{node} traducere a {x}",
+    "fr": "{node} traduction de {x}",
+    "de": "{node} Übersetzung von {x}"
+   }
+  },
   "has_visual_reference": {
    "ui_phrase_as_source": {
     "en": "{node} shown in {x}",

{s3dgraphy-1.6.0.dev24 → s3dgraphy-1.6.0.dev26}/src/s3dgraphy/JSON_config/em.ttl

@@ -46,8 +46,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.9" ;
-    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.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.10" ;
+    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.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/> ,
@@ -817,5 +817,53 @@ em:hasDefinition
     rdfs:comment "The DEFINITION of a stratigraphic unit — strato di crollo, riempimento, taglio: the DEFINIZIONE box of the US sheet — as a concept of a controlled vocabulary (a SKOS concept, typed crm:E55_Type). It is a TYPE of the unit and nothing more, which is why it narrows crm:P2_has_type rather than widening anything: every em:hasDefinition triple IS a P2_has_type triple, and a CIDOC-only consumer reading the entailment loses nothing. What the subproperty adds is the ability to tell, in SPARQL, the definition from any other type a unit may carry. NOT EMITTED BY DEFAULT: the exporter writes crm:P2_has_type directly (node datamodel StratigraphicNode.properties.definition.rdf.with_concept), because an unreasoned store would otherwise not see the P2 edge at all; the switch is one line in that entry. A definition that carries only a label and no concept URI projects to nothing (rdf.label_only = null): a word is not a concept. Maps to: node_datamodel StratigraphicNode.properties.definition (em.json data.definition), inherited by every stratigraphic subtype."@en .
 
 # ============================================================================
-# End of em.ttl v1.6.7
+# 14. THE LANGUAGE OF THE ORIGINAL, AND ITS TRANSLATIONS — CRMem v1.6.10
+#     Decided by E.D. on 2026-10-01 («Le traduzioni»): the original stays a
+#     string in its field; each translation is a node (crm:E33, reached by
+#     crm:P73_has_translation). CIDOC names the class and the relation; these
+#     six terms say what it does not.
+# ============================================================================
+
+em:originalLanguage
+    a owl:DatatypeProperty ;
+    rdfs:label "original language"@en ;
+    rdfs:range xsd:string ;
+    rdfs:comment "The language the node's ORIGINAL texts are written in, as a BCP 47 tag ('la', 'it', 'und'). Written whenever the node itself declares one (em.json data.lang), equal to the study's working language or not, so a reader can tell the original literal from its translations — they share the predicate (dcterms:description \"…\"@la beside \"…\"@it) — and the round trip em.json → RDF → em.json gives data.lang back exactly where it was. NOT crm:P72_has_language: its domain is E33 Linguistic Object, and the node (a stratigraphic unit, a document) is not the text; the TranslationNode, which IS one, carries P72. Absent when the node declares nothing: its texts then take the study's language (dcterms:language on the graph), and saying 'original' would be a claim nobody made. Maps to: node_datamodel Node.properties.lang (em.json data.lang)."@en .
+
+em:sourceLanguage
+    a owl:DatatypeProperty ;
+    rdfs:label "source language"@en ;
+    rdfs:domain crm:E33_Linguistic_Object ;
+    rdfs:range xsd:string ;
+    rdfs:comment "The language a translation was made FROM: the original's language at the moment of translating, as a BCP 47 tag. Recorded on the translation and not read off the original later, because the original can change. crm:P72_has_language on the same node is the language it was translated INTO. Maps to: node_datamodel TranslationNode.properties.from_lang (data.from_lang)."@en .
+
+em:translatedField
+    a owl:DatatypeProperty ;
+    rdfs:label "translated field"@en ;
+    rdfs:domain crm:E33_Linguistic_Object ;
+    rdfs:range xsd:string ;
+    rdfs:comment "WHICH text of the translated node this translation translates, in the field vocabulary of the em.json CRDT: 'description', or 'data.<key>' (a PropertyNode's value is 'data.value'). Needed because crm:P73_has_translation runs from the node, and a node can hold more than one text; never 'name', names being invariant identities. Maps to: node_datamodel TranslationNode.properties.field (data.field)."@en .
+
+em:translationMethod
+    a owl:DatatypeProperty ;
+    rdfs:label "translation method"@en ;
+    rdfs:domain crm:E33_Linguistic_Object ;
+    rdfs:range xsd:string ;
+    rdfs:comment "How a translation was made: 'manual' (a person), 'ai' (a model, and the node then carries em:aiAssistedBy until a person verifies it, em:validatedBy), or 'edition' (taken from a published translation, which the node reaches as a source). A closed list of three, a literal until a vocabulary of translation methods exists to point at. Maps to: node_datamodel TranslationNode.properties.method (data.method)."@en .
+
+em:sourceDigest
+    a owl:DatatypeProperty ;
+    rdfs:label "source digest"@en ;
+    rdfs:domain crm:E33_Linguistic_Object ;
+    rdfs:range xsd:string ;
+    rdfs:comment "The digest of the original text a translation translated, 'sha256:<hex>' over the NFC, UTF-8 text. When the original changes the digests differ and the translation is 'to realign': it no longer translates what the node says, and the exporter stops writing its literal beside the original's (its own resource still leaves). Same form as em:checksum, which is a digest of bytes; this one is of a text. Maps to: node_datamodel TranslationNode.properties.source_digest (data.source_digest)."@en .
+
+em:reviewRequested
+    a owl:DatatypeProperty ;
+    rdfs:label "review requested"@en ;
+    rdfs:range xsd:boolean ;
+    rdfs:comment "The author of a piece of content asks a person to review it («da rivedere»): true, or absent. Closed — not removed — by em:validatedBy / em:validatedAt, the same signature that clears AI-assisted content: the request stays written, and the signature says it was done and by whom. Introduced for translations made by hand; the field is generic. Maps to: node_datamodel TranslationNode.properties.review_requested (data.review_requested)."@en .
+
+# ============================================================================
+# End of em.ttl v1.6.10
 # ============================================================================

{s3dgraphy-1.6.0.dev24 → s3dgraphy-1.6.0.dev26}/src/s3dgraphy/JSON_config/em_qualia_types.json

@@ -1,11 +1,11 @@
 {
     "metadata": {
-      "version": "1.6.2",
-      "last_updated": "2026-09-28",
+      "version": "1.6.5",
+      "last_updated": "2026-10-01",
       "maintainers": ["Emanuel Demetrescu"],
       "license": "CC-BY-SA-4.0",
       "license_note": "Share-alike per allinearsi agli strumenti terminologici da cui questo datamodel prende gli ancoraggi (ICCD CC BY-SA 3.0 IT) e perche' una derivazione resti aperta. Gli identificatori AAT/CIDOC citati nei `mappings` sono RIFERIMENTI, non contenuto incorporato: lo share-alike non si propaga ai vocabolari altrui, che mantengono i propri termini.",
-      "changelog": "v1.6.2: added two descriptive qualia of the stratigraphic unit asked for by the DAI record (iDAI.field Layer, D7/D8) — proposte da Cowork per E.D., 28 set 2026, dalla scheda DAI: `feature_shape` (spatial; the shape in plan or section named with a term, AAT 300056273, E55_Type) and `boundary_distinctness` (material; how sharp the limits are: abrupt / clear / gradual / diffuse, E55_Type, no AAT evident). Both controlled vocabularies with indicative seed values; templates declare their own. v1.6.1: added the spatial qualia `geometry` — the PROXY as a quale. The geometry-without-material of a unit becomes a PropertyNode whose payload is a SemanticShapeNode (has_semantic_shape), so the proxy inherits the paradata chain a lone node could not have, and one proxy can be synthesised from several sources. CIDOC default crmgeo:SP5_Geometric_Place_Expression, flagged `confirm_with: Felicetti` (E36 is the alternative, to be decided together with em:AnnotationRegion). v1.6.0: version realigned to the EM language version (EM 1.6) — supersedes the standalone 4.x line (last was 4.2), so all EM JSON config files now share the 1.6.x scheme. Added optional `rationale` + `example` fields to qualia entries (a plain-language why + a concrete case), shown by the EMStudio vocabulary picker when creating a PropertyNode. Seeded for the temporal qualia (absolute_time_start / absolute_time_end / dating_method); to be filled in for the rest incrementally. Prior (4.x) history: v4.2 added rationale/example scaffolding; v4.1: expanded spatial elevation qualia for pyArchInit us_table quote (all E54_Dimension): elevation_relative, elevation_min_absolute, elevation_max_absolute, elevation_min_relative, elevation_max_relative, elevation_min_usm, elevation_max_usm (the generic 'elevation' = absolute MASL, used by quota_abs). Each pyArchInit quota column maps to its own qualia id so they don't collide on the single-PropertyNode-per-property_name rule. v4.0: verified all v3.0 CIDOC-CRM mappings (correct). Expanded with: volume, area, circumference in dimensional; color, texture, finish, patina, hardness, porosity in material; damage_type, fragility, completeness in state; tool_marks, joining_technique in technical; bounding_box, footprint_area in spatial; duration, terminus_post_quem, terminus_ante_quem, relative_chronology in temporal; ceremonial_function, ritual_function, defensive_function, domestic_function, symbolic_function in telic; school, workshop, period_attribution in stylistic. NEW subcategories: iconographic + semantic under cultural_interpretive (iconographic_subject, narrative_content, iconographic_program, aesthetic_value, religious_significance, monumental_status, attribution). Added provenance_history, exhibition_history, publication_history under administrative; NEW ownership subcategory (current_custodian, ownership_chain). NEW CATEGORY epistemic — meta-qualia central to EM paradata model (confidence_level, certainty_level, uncertainty_factors, methodology_used, validation_method, source_quality, primary_contributor, review_status, last_modified)."
+      "changelog": "v1.6.5 (MICRO le traduzioni, 2026-10-29, decided by E.D. 2026-10-01, domanda 3): the doubtful qualia, MEASURED. contextual.administrative.intervention_history is prose (a history of conservation interventions) and gains `natural_language: true`. provenance_history, exhibition_history, publication_history and contextual.ownership.ownership_chain are `object_chain` WITHOUT a schema: no field of theirs is declared and no code reads a structure, so what a PropertyNode stores is ONE string (the chain as written) — the whole string is marked. cultural_interpretive.semantic.attribution is an `object` WITH separate fields (attributed_to: an E39 Actor reference, attribution_type: a closed list, confidence: a float): none of them is a note, so nothing is marked — the rule is to mark only the note, and this object has none. Its value today travels as one string (\"attributed to Phidias\") and leaves untagged; marking it would need a `note` field in its schema, which is E.D.'s to add. inventory_number stays a code. v1.6.4 (MICRO la lingua dei dati, 2026-10-27, decided by E.D. 2026-09-28): cultural_interpretive.iconographic.narrative_content gains `natural_language: true` — its value is prose and leaves in RDF with its language tag (crm:P90_has_value \"la guerra di Troia\"@it), the language coming from the property node's data.lang, else the study's working language. data_type alone does not say it: inventory_number is a string too, and it is a CODE, so it is not marked and never tagged. No other quale marked: the ones whose value may be prose (intervention_history, attribution, the *_history and ownership_chain object chains) are waiting for E.D. v1.6.3 (MICRO em.ttl nel datamodel, 2026-10-26, decided by E.D. 2026-10-01 — every em: term of em.ttl is cited by a datamodel): epistemic.confidence.confidence_level.mappings gains specialised_alternative 'em:confidenceLevel', the em.ttl literal form of the same scalar, declared and NOT emitted (the exporter keeps crminf:I6_Belief_Value via J5). Mapping text only, no quale changed. v1.6.2: added two descriptive qualia of the stratigraphic unit asked for by the DAI record (iDAI.field Layer, D7/D8) — proposte da Cowork per E.D., 28 set 2026, dalla scheda DAI: `feature_shape` (spatial; the shape in plan or section named with a term, AAT 300056273, E55_Type) and `boundary_distinctness` (material; how sharp the limits are: abrupt / clear / gradual / diffuse, E55_Type, no AAT evident). Both controlled vocabularies with indicative seed values; templates declare their own. v1.6.1: added the spatial qualia `geometry` — the PROXY as a quale. The geometry-without-material of a unit becomes a PropertyNode whose payload is a SemanticShapeNode (has_semantic_shape), so the proxy inherits the paradata chain a lone node could not have, and one proxy can be synthesised from several sources. CIDOC default crmgeo:SP5_Geometric_Place_Expression, flagged `confirm_with: Felicetti` (E36 is the alternative, to be decided together with em:AnnotationRegion). v1.6.0: version realigned to the EM language version (EM 1.6) — supersedes the standalone 4.x line (last was 4.2), so all EM JSON config files now share the 1.6.x scheme. Added optional `rationale` + `example` fields to qualia entries (a plain-language why + a concrete case), shown by the EMStudio vocabulary picker when creating a PropertyNode. Seeded for the temporal qualia (absolute_time_start / absolute_time_end / dating_method); to be filled in for the rest incrementally. Prior (4.x) history: v4.2 added rationale/example scaffolding; v4.1: expanded spatial elevation qualia for pyArchInit us_table quote (all E54_Dimension): elevation_relative, elevation_min_absolute, elevation_max_absolute, elevation_min_relative, elevation_max_relative, elevation_min_usm, elevation_max_usm (the generic 'elevation' = absolute MASL, used by quota_abs). Each pyArchInit quota column maps to its own qualia id so they don't collide on the single-PropertyNode-per-property_name rule. v4.0: verified all v3.0 CIDOC-CRM mappings (correct). Expanded with: volume, area, circumference in dimensional; color, texture, finish, patina, hardness, porosity in material; damage_type, fragility, completeness in state; tool_marks, joining_technique in technical; bounding_box, footprint_area in spatial; duration, terminus_post_quem, terminus_ante_quem, relative_chronology in temporal; ceremonial_function, ritual_function, defensive_function, domestic_function, symbolic_function in telic; school, workshop, period_attribution in stylistic. NEW subcategories: iconographic + semantic under cultural_interpretive (iconographic_subject, narrative_content, iconographic_program, aesthetic_value, religious_significance, monumental_status, attribution). Added provenance_history, exhibition_history, publication_history under administrative; NEW ownership subcategory (current_custodian, ownership_chain). NEW CATEGORY epistemic — meta-qualia central to EM paradata model (confidence_level, certainty_level, uncertainty_factors, methodology_used, validation_method, source_quality, primary_contributor, review_status, last_modified)."
     },
     "qualia_categories": [
       {
@@ -982,6 +982,7 @@
                   "cidoc_crm": "E73_Information_Object"
                 },
                 "data_type": "string_or_reference",
+                "natural_language": true,
                 "expected_extractors": ["iconographic_analysis", "literary_comparison"]
               },
               {
@@ -1105,7 +1106,8 @@
                 "mappings": {
                   "getty_aat": "300379504",
                   "cidoc_crm": "E11_Modification"
-                }
+                },
+                "natural_language": true
               },
               {
                 "id": "conservation_status",
@@ -1148,6 +1150,7 @@
                   "cidoc_crm": "E12_Production"
                 },
                 "data_type": "object_chain",
+                "natural_language": true,
                 "expected_extractors": ["archival_research", "provenance_research"]
               },
               {
@@ -1159,6 +1162,7 @@
                   "cidoc_crm": "E7_Activity"
                 },
                 "data_type": "object_chain",
+                "natural_language": true,
                 "expected_extractors": ["archival_research", "museum_documentation"]
               },
               {
@@ -1170,6 +1174,7 @@
                   "cidoc_crm": "E31_Document"
                 },
                 "data_type": "object_chain",
+                "natural_language": true,
                 "expected_extractors": ["bibliographic_research", "citation_analysis"]
               }
             ]
@@ -1197,6 +1202,7 @@
                   "cidoc_crm": "E8_Acquisition"
                 },
                 "data_type": "object_chain",
+                "natural_language": true,
                 "expected_extractors": ["archival_research", "provenance_research"]
               }
             ]
@@ -1218,7 +1224,9 @@
                 "name": "Confidence Level",
                 "description": "Numerical confidence in the assertion (0-100%). The EM-canonical scalar for paradata-supported claims. CRM mapping changed 2026-07-10: was E54_Dimension; a confidence is the value a belief is held with, i.e. crminf:I6_Belief_Value (see WP3 coverage analysis G5 / Appendix C). The RDF exporter's qualia-precedence rule types the PropertyNode accordingly.",
                 "mappings": {
-                  "cidoc_crm": "crminf:I6_Belief_Value"
+                  "cidoc_crm": "crminf:I6_Belief_Value",
+                  "specialised_alternative": "em:confidenceLevel",
+                  "specialised_alternative_note": "1.6.3: em:confidenceLevel (em.ttl, xsd:decimal on any E1) is the plain-literal form of the same number, declared for a reader that wants the scalar without the CRMinf belief. NOT emitted: the RDF exporter types the PropertyNode crminf:I6_Belief_Value and links it with J5_holds_to_be (_emit_belief_propositions). Putting it in cidoc_crm's place would be the switch, and is E.D.'s decision."
                 },
                 "data_type": "percentage",
                 "range": [0, 100],

{s3dgraphy-1.6.0.dev24 → s3dgraphy-1.6.0.dev26}/src/s3dgraphy/JSON_config/em_visual_rules.json

@@ -1,6 +1,6 @@
 {
   "formal_language": "EM",
-  "version": "1.6.27",
+  "version": "1.6.28",
   "_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.28": "THE TRANSLATION NODE (MICRO le traduzioni, 29 Oct 2026, decision of E.D. 1 Oct 2026). node_styles.TRANSL for TranslationNode: the narrative's neutral grey and its glyph (src/2D/narrative.svg, SHARED, declared by 2d_file_vect — the way UL / USN / USNt share US.png), with a DASHED border so a translation does not read as a narrative. Choosing a mark of its own is an act of EM iconography and is left to E.D.; no file_3d, no material: a translation never becomes a mesh.",
     "1.6.27": "THE GLYPH OF THE FILE (MICRO-REVISIONE, 20 Oct 2026, decision of E.D. 30 Sep 2026: Claude draws it). node_styles.FILE.2d_file_vect: src/2D/link.svg -> src/2D/resource_file.svg, a sheet with a folded corner and the digest sign inside the 2017 DTC circle. WHERE, MEASURED: a resource takes its sign from node_styles.<KEY>.2d_file_vect (LINK -> src/2D/link.svg), a FILE, which EMStudio's icons.ts resolves (declaration, then src/2D/<node_type>.svg) and sync-datamodels.sh vendors from the top level of src/2D/. It is NOT a DTC glyph (dtc_kinds name the glyphs of DTC kinds, and a file is a node type, not a kind) and NOT a 2d_glyphs entry: LINK is not in 2d_render_glyph_types either, and joining that list would change how the label is laid out, which nobody asked. Still no .glb (as before). The dashed border and the LINK colour stay.",
     "1.6.26": "THE FILE OF A RESOURCE (MICRO-RISORSA-FILE, 18 Oct 2026, decision of E.D. 30 Sep 2026). node_styles += FILE for ResourceFileNode (node datamodel 1.6.17): the LINK chain glyph and colour with a DASHED border — a file is a member of the resource it hangs from, the same family and not a second resource. NO NEW GLYPH: it reuses src/2D/link.svg, declares no .glb (LINK's src/3D/link.glb is itself among the missing 3D models, and a new type must not add to that gap), and a sign of its own is left to E.D.",
     "1.6.25": "THE EIGHT DTC GLYPHS APPROVED (E.D., 30 Sep 2026; MICRO-GEOMETRIA-ORIGINE part 1). The eight drafts of 1.6.23 moved from src/2D/bozze/dtc_<glyph>.svg to src/2D/dtc/<glyph>.svg (12_gnss_survey … 19_vectorization), the BOZZA word removed from their comment, glyphs_from_svg --write rerun: their 2d_glyphs entries no longer carry draft: true. src/2D/bozze/ is empty again. Still without a glyph (open): the four recoveries download, local_import, uri_reference, ingest.",
@@ -3336,6 +3337,17 @@
       },
       "label_position": "over"
     },
+    "TRANSL": {
+      "_comment": "TranslationNode (MICRO le traduzioni, E.D. 2026-10-01): one translation of one text field — a crm:E33 like the narrative, hence its grey and, until E.D. draws a mark of its own, its glyph (declared sharing). DASHED, unlike NARR's solid: the translation stands beside an original, it is not an authored object over the graph.",
+      "2d_file_vect": "src/2D/narrative.svg",
+      "style": {
+        "border_color": "#5A5A66",
+        "fill_color": "#F2F2F5",
+        "border_style": "dashed",
+        "shape": "rounded_rectangle"
+      },
+      "label_position": "over"
+    },
     "LINK": {
       "file_3d": "src/3D/link.glb",
       "2d_file_vect": "src/2D/link.svg",

{s3dgraphy-1.6.0.dev24 → s3dgraphy-1.6.0.dev26}/src/s3dgraphy/JSON_config/node_registry.generated.json

@@ -1,6 +1,6 @@
 {
  "_generated": "by `python -m s3dgraphy.tools.sync_node_datamodel` — DO NOT hand-edit. The flat class hierarchy (parent/node_type/description) is derived from the Python Node subclasses; hand-authored semantics and CIDOC mappings live in s3Dgraphy_node_datamodel.json.",
- "s3Dgraphy_data_model_version": "1.6.17",
+ "s3Dgraphy_data_model_version": "1.6.20",
  "node_types": {
   "ActivityNodeGroup": {
    "parent": "GroupNode",
@@ -277,6 +277,11 @@
    "node_type": "TSU",
    "description": ""
   },
+  "TranslationNode": {
+   "parent": "Node",
+   "node_type": "translation",
+   "description": "ONE TRANSLATION of one text field of one node — a text, not a value."
+  },
   "UnknownNode": {
    "parent": "StratigraphicNode",
    "node_type": "unknown",