s3dgraphy 1.6.0.dev9__tar.gz → 1.6.0.dev11__tar.gz

{s3dgraphy-1.6.0.dev9/src/s3dgraphy.egg-info → s3dgraphy-1.6.0.dev11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: s3dgraphy
-Version: 1.6.0.dev9
+Version: 1.6.0.dev11
 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.dev9 → s3dgraphy-1.6.0.dev11}/pyproject.toml

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

{s3dgraphy-1.6.0.dev9 → s3dgraphy-1.6.0.dev11}/src/s3dgraphy/JSON_config/em.ttl

@@ -199,8 +199,8 @@ em:SeriesOfNonStructuralVirtualSU
 em:StratigraphicEvent
     a owl:Class ;
     rdfs:label "Stratigraphic Event (SE)"@en ;
-    rdfs:subClassOf crm:E5_Event ;
-    rdfs:comment "An event that creates, modifies, or destroys a stratigraphic unit (e.g. an earthquake causing a plaster collapse, an act of demolition). More general than crmarchaeo:A4 (Genesis: formation only) or A5 (Modification only): the EM concept spans formation, modification and destruction. May be enriched by a 3D simulation (em:RepresentationModel) of the event itself. Maps to: Python StratigraphicEventNode (node_type='SE')."@en .
+    rdfs:subClassOf crmarchaeo:A5_Stratigraphic_Modification ;
+    rdfs:comment "An event that creates, modifies, or destroys a stratigraphic unit (e.g. an earthquake causing a plaster collapse, an act of demolition). Re-anchored 2026-07-11 from generic crm:E5_Event to crmarchaeo:A5_Stratigraphic_Modification: formation is A4 (subclass of A5), modification is A5, destruction is A5-as-disturbance (AP8) plus A4 genesis of the resulting A3 interface; E5 remains reachable transitively via A5 < S18 < E5. Cf. Guillem et al. 2024 (SWODCH). May be enriched by a 3D simulation (em:RepresentationModel) of the event itself. Maps to: Python StratigraphicEventNode (node_type='SE')."@en .
 
 em:TransformationSU
     a owl:Class ;
@@ -438,5 +438,42 @@ em:physicallyEquals
 
 
 # ============================================================================
-# End of em.ttl v1.6.0
+# v1.6.1 additions (2026-07-10) — serialisation-completeness pass
+# (WP3 coverage analysis, sections 10 / B.1 / B.2). New edge subproperties;
+# no class changes.
+# ============================================================================
+
+em:hasVisualReference
+    a owl:ObjectProperty ;
+    rdfs:label "has visual reference"@en ;
+    rdfs:subPropertyOf crm:P138i_has_representation ;
+    rdfs:domain em:Paradata ;
+    rdfs:range crm:E36_Visual_Item ;
+    rdfs:comment "The paradata node (property / extractor / combiner) is visually illustrated or anchored by a visual document (plate, photograph, annotated image). Distinct from em: extraction sourcing (P67/J7): a visual reference shows, an extraction source justifies. The RDF exporter co-types the target document as E36_Visual_Item. Maps to: connections_datamodel edge 'has_visual_reference'."@en .
+
+em:survivesInEpoch
+    a owl:ObjectProperty ;
+    rdfs:subPropertyOf crm:P132_spatiotemporally_overlaps_with ;
+    rdfs:label "survives in epoch"@en ;
+    rdfs:domain crmarchaeo:A8_Stratigraphic_Unit ;
+    rdfs:range crm:E4_Period ;
+    rdfs:comment "The unit's spacetime volume (via P196_defines) overlaps the epoch's: survival through (part of) an epoch is overlap, not containment. Epoch attribution is an interpretive act; its justification travels in the epoch's and edge's paradata chain. Maps to: connections_datamodel edge 'survive_in_epoch'."@en .
+
+em:firstAttestedInEpoch
+    a owl:ObjectProperty ;
+    rdfs:subPropertyOf crm:P10_falls_within ;
+    rdfs:label "first attested in epoch"@en ;
+    rdfs:domain crmarchaeo:A8_Stratigraphic_Unit ;
+    rdfs:range crm:E4_Period ;
+    rdfs:comment "Documented shortcut: the unit was brought into existence (P92i, genesis event / SE node) during the epoch (event P10_falls_within epoch; crmarchaeo:AP25_occurs_during where an SE node is present). Declared subPropertyOf P10 on the unit's defining spacetime volume (P196). Maps to: connections_datamodel edge 'has_first_epoch'."@en .
+
+em:hasAuthor
+    a owl:ObjectProperty ;
+    rdfs:subPropertyOf prov:wasAttributedTo ;
+    rdfs:label "has author"@en ;
+    rdfs:range em:Author ;
+    rdfs:comment "Domain-neutral authorship attribution (any graph entity to a human or AI author). Replaces the earlier P94_has_created reading (invalid domain/range for physical units) and L10_had_input (digital machine events, not authorship). Maps to: connections_datamodel edge 'has_author'."@en .
+
+# ============================================================================
+# End of em.ttl v1.6.1
 # ============================================================================

{s3dgraphy-1.6.0.dev9 → s3dgraphy-1.6.0.dev11}/src/s3dgraphy/JSON_config/em_qualia_types.json

@@ -1,10 +1,10 @@
 {
     "metadata": {
-      "version": "4.0",
-      "last_updated": "2026-05-23",
+      "version": "1.6.0",
+      "last_updated": "2026-07-15",
       "maintainers": ["Emanuel Demetrescu"],
       "license": "CC-BY-4.0",
-      "changelog": "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.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": [
       {
@@ -421,7 +421,7 @@
               {
                 "id": "elevation",
                 "name": "Elevation",
-                "description": "Height above sea level",
+                "description": "Height above sea level (absolute / MASL). pyArchInit us_table.quota_abs maps here — it is the absolute single-point elevation.",
                 "mappings": {
                   "getty_aat": "300447457",
                   "cidoc_crm": "E54_Dimension"
@@ -430,6 +430,90 @@
                 "units": ["m", "ft"],
                 "expected_extractors": ["gps_survey", "total_station_survey", "leveling"]
               },
+              {
+                "id": "elevation_relative",
+                "name": "Relative Elevation",
+                "description": "Elevation measured relative to a local site datum (not sea level). pyArchInit us_table.quota_relativa. Distinct from 'elevation' (absolute MASL).",
+                "mappings": {
+                  "getty_aat": "300447457",
+                  "cidoc_crm": "E54_Dimension"
+                },
+                "data_type": "float",
+                "units": ["m", "cm"],
+                "expected_extractors": ["total_station_survey", "leveling"]
+              },
+              {
+                "id": "elevation_min_absolute",
+                "name": "Minimum Absolute Elevation",
+                "description": "Lowest absolute elevation (height above sea level) of the element's vertical extent. pyArchInit us_table.quota_min_abs.",
+                "mappings": {
+                  "getty_aat": "300447457",
+                  "cidoc_crm": "E54_Dimension"
+                },
+                "data_type": "float",
+                "units": ["m"],
+                "expected_extractors": ["gps_survey", "total_station_survey", "leveling"]
+              },
+              {
+                "id": "elevation_max_absolute",
+                "name": "Maximum Absolute Elevation",
+                "description": "Highest absolute elevation (height above sea level) of the element's vertical extent. pyArchInit us_table.quota_max_abs.",
+                "mappings": {
+                  "getty_aat": "300447457",
+                  "cidoc_crm": "E54_Dimension"
+                },
+                "data_type": "float",
+                "units": ["m"],
+                "expected_extractors": ["gps_survey", "total_station_survey", "leveling"]
+              },
+              {
+                "id": "elevation_min_relative",
+                "name": "Minimum Relative Elevation",
+                "description": "Lowest elevation relative to the local site datum. pyArchInit us_table.quota_min_rel.",
+                "mappings": {
+                  "getty_aat": "300447457",
+                  "cidoc_crm": "E54_Dimension"
+                },
+                "data_type": "float",
+                "units": ["m", "cm"],
+                "expected_extractors": ["total_station_survey", "leveling"]
+              },
+              {
+                "id": "elevation_max_relative",
+                "name": "Maximum Relative Elevation",
+                "description": "Highest elevation relative to the local site datum. pyArchInit us_table.quota_max_rel.",
+                "mappings": {
+                  "getty_aat": "300447457",
+                  "cidoc_crm": "E54_Dimension"
+                },
+                "data_type": "float",
+                "units": ["m", "cm"],
+                "expected_extractors": ["total_station_survey", "leveling"]
+              },
+              {
+                "id": "elevation_min_usm",
+                "name": "Minimum Elevation (USM)",
+                "description": "Lowest recorded elevation of a masonry unit (USM). pyArchInit us_table.quota_min_usm.",
+                "mappings": {
+                  "getty_aat": "300447457",
+                  "cidoc_crm": "E54_Dimension"
+                },
+                "data_type": "float",
+                "units": ["m", "cm"],
+                "expected_extractors": ["total_station_survey", "leveling"]
+              },
+              {
+                "id": "elevation_max_usm",
+                "name": "Maximum Elevation (USM)",
+                "description": "Highest recorded elevation of a masonry unit (USM). pyArchInit us_table.quota_max_usm.",
+                "mappings": {
+                  "getty_aat": "300447457",
+                  "cidoc_crm": "E54_Dimension"
+                },
+                "data_type": "float",
+                "units": ["m", "cm"],
+                "expected_extractors": ["total_station_survey", "leveling"]
+              },
               {
                 "id": "arrangement",
                 "name": "Arrangement",
@@ -487,7 +571,9 @@
                   "cidoc_crm": "E52_Time-Span"
                 },
                 "data_type": "date",
-                "format": "YYYY-MM-DD"
+                "format": "YYYY-MM-DD",
+                "rationale": "The earliest calendar date at which the element's time-span begins (the begin-of-the-begin). Anchors an epoch or unit on the absolute timeline; pair it with Absolute Time — End to bound the span. Negative years = BCE.",
+                "example": "-27 — start of the Augustan phase of the sanctuary (27 BCE)."
               },
               {
                 "id": "absolute_time_end",
@@ -497,7 +583,9 @@
                   "cidoc_crm": "E52_Time-Span"
                 },
                 "data_type": "date",
-                "format": "YYYY-MM-DD"
+                "format": "YYYY-MM-DD",
+                "rationale": "The latest calendar date at which the element's time-span ends (the end-of-the-end). Together with the start it delimits the absolute chronology of an epoch or unit. Negative years = BCE.",
+                "example": "476 — end of the Late Antique phase (fall of the Western Roman Empire)."
               },
               {
                 "id": "dating_method",
@@ -517,7 +605,9 @@
                   "historical_sources",
                   "stylistic_analysis"
                 ],
-                "expected_extractors": ["dating_analysis", "laboratory_analysis"]
+                "expected_extractors": ["dating_analysis", "laboratory_analysis"],
+                "rationale": "How the chronology was established — records the reliability and paradata behind a date so the reasoning can be judged.",
+                "example": "c14 for a hearth dated by radiocarbon; stratigraphy for a wall dated by its position in the sequence."
               },
               {
                 "id": "duration",
@@ -1067,9 +1157,9 @@
               {
                 "id": "confidence_level",
                 "name": "Confidence Level",
-                "description": "Numerical confidence in the assertion (0-100%). The EM-canonical scalar for paradata-supported claims.",
+                "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": "E54_Dimension"
+                  "cidoc_crm": "crminf:I6_Belief_Value"
                 },
                 "data_type": "percentage",
                 "range": [0, 100],

{s3dgraphy-1.6.0.dev9 → s3dgraphy-1.6.0.dev11}/src/s3dgraphy/JSON_config/em_visual_rules.json

@@ -1,7 +1,9 @@
 {
   "formal_language": "EM",
-  "version": "1.5.3",
+  "version": "1.6.1",
   "_changelog": {
+    "1.6.1": "Fix border_color to the correct sRGB display hex against the EM 1.3 standard colour table. ROOT CAUSE: border_color was generated by writing the LINEAR material.color straight to hex (0.328 -> 0x54 -> #540909) instead of converting linear->sRGB (0.328 -> 0.608 -> 0x9B -> #9B3333). material.color stays LINEAR (Blender convention); border_color is the sRGB display value = the EM 1.3 standard Hex column. Corrected borders: US/serSU/TSU #540909->#9B3333, SF #AF8208->#D8BD30, VSF #70581E->#B19F61, USVs/serUSVs #0546CC->#248FE7, USVn/serUSVn #083107->#31792D, USN #8C8C8C->#C4C4C4 (sRGB of its 0.55 grey). US/USVs/USVn/SF/VSF now match the EM 1.3 table exactly; TSU (US-red material) and USN follow the same rule. Also reverted USVs/USVn/serUSVs/serUSVn material.color, which an earlier dev8 pass had wrongly overwritten with sRGB values, back to the canonical LINEAR values (USVs/serUSVs 0.018,0.275,0.799; USVn/serUSVn 0.031,0.191,0.026). fill_color unchanged (US/SF white, USVs/USVn black per the 2D icons). Then completed full coherence (EM 1.5 table for USD + 'RSF is red like US'): recomputed the last linear-as-hex materials to true LINEAR so sRGB(material)==border_color for EVERY type (and Blender 3D now matches the 2D display) — RSF material (0.608,0.2,0.2)->(0.328,0.033,0.033)=US red (border #9B3333); USD/serUSD material (0.847,0.392,0)->(0.687,0.127,0)=sRGB^-1(#D86400) (border #D86400 unchanged). Net rule for the whole file: material.color = LINEAR, border_color = sRGB(material) = the EM standard Hex.",
+    "1.6.0": "Version realigned to track the EM language version (EM 1.6); supersedes the 1.5.x line. Added canonical group-container styles for ActivityNodeGroup, ParadataNodeGroup and TimeBranchNodeGroup (mirroring the existing LocationNodeGroup pattern): neutral grey container (fill #F5F5F5, dashed #000000 border, roundrectangle) distinguished by the group title-tab colour in `label_background` — Activity #CCFFFF, Paradata #FFCC99, TimeBranch #99CC00 (green). Sourced from the point-of-truth palette template (templates/em_palette_template.graphml, nodes Att.[xx] / US[xxx]_PD / TB.0), aligning em_visual_rules with the GraphML palette. Previously ParadataNodeGroup and TimeBranchNodeGroup both resolved through the shared grey 'GRAPH' style and could not be told apart; ActivityNodeGroup rendered via the legacy purple-ellipse 'ANG'. Legacy 'ANG' and 'GRAPH' styles retained unchanged for back-compat with other consumers.",
     "1.5.3": "Fix USD / serUSD material colour: RGB was (0.549, 0.103, 0.0) = #8C1A00 (red), should be #D86400 (orange) to match the canonical USD documentary colour used in the GraphML palette template, node_registry defaults and document_variant_styles.observable. USD border_color also corrected from #8C1A00 to #D86400 (serUSD border was already correct).",
     "1.5.2": "Added RSF (Reused Special Find / spolia) node style — octagon, red border (#9B3333), white fill. Sibling of SF/VSF, distinguished by border colour. Originating DP: DP-26.",
     "1.5.1": "Added LocationNodeGroup node style (dashed roundrectangle, kind-based border colour) and is_in_location edge style with primary_modifier override.",
@@ -20,10 +22,11 @@
             "a": 1.0
           }
         },
-        "border_color": "#540909",
+        "border_color": "#9B3333",
         "fill_color": "#F0F0F0",
         "border_style": "solid",
-        "shape": "rectangle"
+        "shape": "rectangle",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -40,10 +43,11 @@
             "a": 1.0
           }
         },
-        "border_color": "#083107",
+        "border_color": "#31792D",
         "fill_color": "#000000",
         "border_style": "solid",
-        "shape": "hexagon"
+        "shape": "hexagon",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -60,10 +64,11 @@
             "a": 1.0
           }
         },
-        "border_color": "#0546CC",
-        "fill_color": "#CCCCCC",
+        "border_color": "#248FE7",
+        "fill_color": "#000000",
         "border_style": "solid",
-        "shape": "parallelogram"
+        "shape": "parallelogram",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -80,10 +85,11 @@
             "a": 1.0
           }
         },
-        "border_color": "#70581E",
+        "border_color": "#B19F61",
         "fill_color": "#CCCCCC",
         "border_style": "solid",
-        "shape": "octagon"
+        "shape": "octagon",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -100,10 +106,11 @@
             "a": 1.0
           }
         },
-        "border_color": "#AF8208",
+        "border_color": "#D8BD30",
         "fill_color": "#CCCCCC",
         "border_style": "solid",
-        "shape": "octagon"
+        "shape": "octagon",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -114,16 +121,17 @@
       "style": {
         "material": {
           "color": {
-            "r": 0.608,
-            "g": 0.200,
-            "b": 0.200,
+            "r": 0.328,
+            "g": 0.033,
+            "b": 0.033,
             "a": 1.0
           }
         },
         "border_color": "#9B3333",
         "fill_color": "#FFFFFF",
         "border_style": "solid",
-        "shape": "octagon"
+        "shape": "octagon",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -134,8 +142,8 @@
       "style": {
         "material": {
           "color": {
-            "r": 0.847,
-            "g": 0.392,
+            "r": 0.687,
+            "g": 0.127,
             "b": 0.0,
             "a": 1.0
           }
@@ -143,7 +151,8 @@
         "border_color": "#D86400",
         "fill_color": "#F5F5F5",
         "border_style": "solid",
-        "shape": "rounded_rectangle"
+        "shape": "rounded_rectangle",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -160,10 +169,11 @@
             "a": 1.0
           }
         },
-        "border_color": "#540909",
+        "border_color": "#9B3333",
         "fill_color": "#EFEFEF",
         "border_style": "solid",
-        "shape": "ellipse"
+        "shape": "ellipse",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -174,8 +184,8 @@
       "style": {
         "material": {
           "color": {
-            "r": 0.847,
-            "g": 0.392,
+            "r": 0.687,
+            "g": 0.127,
             "b": 0.0,
             "a": 1.0
           }
@@ -183,7 +193,8 @@
         "border_color": "#D86400",
         "fill_color": "#FFFFFF",
         "border_style": "solid",
-        "shape": "ellipse"
+        "shape": "ellipse",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -200,10 +211,11 @@
             "a": 1.0
           }
         },
-        "border_color": "#083107",
+        "border_color": "#31792D",
         "fill_color": "#000000",
         "border_style": "solid",
-        "shape": "ellipse"
+        "shape": "ellipse",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -220,10 +232,11 @@
             "a": 1.0
           }
         },
-        "border_color": "#0546CC",
+        "border_color": "#248FE7",
         "fill_color": "#000000",
         "border_style": "solid",
-        "shape": "ellipse"
+        "shape": "ellipse",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -240,10 +253,11 @@
             "a": 1.0
           }
         },
-        "border_color": "#808080",
+        "border_color": "#9B3333",
         "fill_color": "#DDDDDD",
         "border_style": "dotted",
-        "shape": "rectangle"
+        "shape": "rectangle",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -263,7 +277,8 @@
         "border_color": "#000000",
         "fill_color": "#FFFFFF",
         "border_style": "solid",
-        "shape": "diamond"
+        "shape": "diamond",
+        "border_width": 4
       },
       "label_position": "center"
     },
@@ -283,7 +298,8 @@
         "border_color": "#000000",
         "fill_color": "#FFFFFF",
         "border_style": "dashed",
-        "shape": "triangle"
+        "shape": "triangle",
+        "border_width": 4
       },
       "label_position": "over"
     },
@@ -662,13 +678,50 @@
             "a": 1.0
           }
         },
-        "border_color": "#540909",
+        "border_color": "#C4C4C4",
         "fill_color": "#F0F0F0",
         "border_style": "dashed",
-        "shape": "rectangle"
+        "shape": "rectangle",
+        "border_width": 4
       },
       "label_position": "over"
     },
+    "ActivityNodeGroup": {
+      "_comment": "yEd group-folder rendering for an activity (logical grouping of stratigraphic actions). Canonical EM palette (point of truth = templates/em_palette_template.graphml, node 'Att.[xx]'): neutral grey container, dashed black border, distinguished by the CYAN group title-tab (label_background). Supersedes the legacy 'ANG' purple-ellipse style for group-container rendering; ANG kept for back-compat with other consumers.",
+      "style": {
+        "shape": "roundrectangle",
+        "fill_color": "#F5F5F5",
+        "border_color": "#000000",
+        "border_style": "dashed",
+        "border_width": 1.0,
+        "label_background": "#CCFFFF",
+        "label_position": "top"
+      }
+    },
+    "ParadataNodeGroup": {
+      "_comment": "yEd group-folder rendering for a paradata node group (holds all paradata of a stratigraphic unit). Canonical EM palette (point of truth = em_palette_template.graphml, node 'US[xxx]_PD'): neutral grey container, dashed black border, distinguished by the PEACH group title-tab (label_background). Supersedes routing through the shared 'GRAPH' grey style; GRAPH kept for the graph-metadata container.",
+      "style": {
+        "shape": "roundrectangle",
+        "fill_color": "#F5F5F5",
+        "border_color": "#000000",
+        "border_style": "dashed",
+        "border_width": 1.0,
+        "label_background": "#FFCC99",
+        "label_position": "top"
+      }
+    },
+    "TimeBranchNodeGroup": {
+      "_comment": "yEd group-folder rendering for a time branch (alternative reconstructive hypotheses; two TB can be linked by contrasts_with). Canonical EM palette (point of truth = em_palette_template.graphml, node 'TB.0'): neutral grey container, dashed black border, distinguished by the GREEN group title-tab (label_background). Distinct from ParadataNodeGroup, which the legacy shared 'GRAPH' alias could not express.",
+      "style": {
+        "shape": "roundrectangle",
+        "fill_color": "#F5F5F5",
+        "border_color": "#000000",
+        "border_style": "dashed",
+        "border_width": 1.0,
+        "label_background": "#99CC00",
+        "label_position": "top"
+      }
+    },
     "LocationNodeGroup": {
       "_comment": "yEd group-folder rendering for spatial / locational membership. Dashed round-rectangle to read clearly as a *group container* and to stay distinct from the solid-rectangle stratigraphic units. Border colour varies by 'kind' (toponym / study / functional). When several is_in_location memberships exist on the same node, only the one with is_primary=true is drawn as a folder; the others are emitted as labels/badges (yEd cannot stack overlapping group folders). See em_data and the Location concept page in the manual.",
       "style": {
@@ -939,4 +992,4 @@
       "label": "Included in Timebranch"
     }
   }
-}
+}