s3dgraphy 1.6.0.dev102__tar.gz → 1.6.0.dev104__tar.gz

{s3dgraphy-1.6.0.dev102/src/s3dgraphy.egg-info → s3dgraphy-1.6.0.dev104}/PKG-INFO

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

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

s3dgraphy-1.6.0.dev104/src/s3dgraphy/JSON_config/em_basemap_sources.json

@@ -0,0 +1,79 @@
+{
+  "metadata": {
+    "version": "1.6.0",
+    "last_updated": "2026-11-12",
+    "description": "The catalogue of the BASE MAPS an EM client may draw under its places: XYZ tile sources, each with its licence and whether its terms let a copy be kept OFFLINE. One catalogue for EMStudio (frontend/src/geoglobe.ts SOURCES, where it was born, 23 Oct 2026) and StratiField (the map of a room). Not datamodel: no node, no edge, nothing exported. NIGHT impronte di saggi e tagli (12 Nov 2026): moved here from EMStudio's literal, VERBATIM (the four entries of geoglobe.ts SOURCES at EMStudio main, 12 Nov 2026), so the two clients read one list.",
+    "consumers": {
+      "stratigraph-chatbot": "sync-basi.sh copies this file into app/basi.json; the node's tile bridge (GET /v1/tiles/{source}/{z}/{x}/{y}) serves only what is listed here, caches on disk, never prefetches a source with offline:false.",
+      "EMStudio": "NOT YET: geoglobe.ts still holds its literal. To read it from here: add `cp \"$CFG/em_basemap_sources.json\" \"$DST/\"` to frontend/scripts/sync-datamodels.sh and `import BASEMAPS from './assets/em_basemap_sources.json'; export const SOURCES: GeoSource[] = BASEMAPS.sources as GeoSource[];` in geoglobe.ts (the fields are the GeoSource interface's, one for one)."
+    },
+    "fields": "id, kind (imagery|terrain), label, url (XYZ template, {z}/{x}/{y}), minZoom, maxZoom, tileSize, format, attribution, licence, licenceUrl, offline (may a copy be kept: the SOURCE's terms, not ours), offlineNote, encoding (terrarium), planet (a PMTiles of the planet)"
+  },
+  "default_imagery": "s2cloudless-2016",
+  "default_terrain": "mapterhorn",
+  "sources": [
+    {
+      "id": "s2cloudless-2016",
+      "kind": "imagery",
+      "label": "Sentinel-2 cloudless 2016 (EOX)",
+      "url": "https://tiles.maps.eox.at/wmts/1.0.0/s2cloudless_3857/default/GoogleMapsCompatible/{z}/{y}/{x}.jpg",
+      "minZoom": 0,
+      "maxZoom": 15,
+      "tileSize": 256,
+      "format": "jpg",
+      "attribution": "Sentinel-2 cloudless 2016 © EOX IT Services GmbH (contains modified Copernicus Sentinel data 2016), CC BY 4.0",
+      "licence": "CC BY 4.0",
+      "licenceUrl": "https://creativecommons.org/licenses/by/4.0/",
+      "offline": true,
+      "offlineNote": "CC BY 4.0: copying is allowed with the attribution; later years (2018–2025) are CC BY-NC-SA and are left out"
+    },
+    {
+      "id": "osm",
+      "kind": "imagery",
+      "label": "OpenStreetMap",
+      "url": "https://tile.openstreetmap.org/{z}/{x}/{y}.png",
+      "minZoom": 0,
+      "maxZoom": 19,
+      "tileSize": 256,
+      "format": "png",
+      "attribution": "© OpenStreetMap contributors (ODbL)",
+      "licence": "ODbL 1.0 (data), CC BY-SA 2.0 (tiles)",
+      "licenceUrl": "https://www.openstreetmap.org/copyright",
+      "offline": false,
+      "offlineNote": "the OSMF tile usage policy forbids «download for offline» and any prefetch: online only"
+    },
+    {
+      "id": "mapterhorn",
+      "kind": "terrain",
+      "label": "Mapterhorn (Copernicus GLO-30 + open national DEMs)",
+      "url": "https://tiles.mapterhorn.com/{z}/{x}/{y}.webp",
+      "minZoom": 0,
+      "maxZoom": 16,
+      "tileSize": 512,
+      "format": "webp",
+      "encoding": "terrarium",
+      "planet": "https://download.mapterhorn.com/planet.pmtiles",
+      "attribution": "Terrain © Mapterhorn — Copernicus GLO-30 © DLR e.V. 2010-2014 and © Airbus Defence and Space GmbH 2014-2018 provided under COPERNICUS by the EU and ESA, and national open DEMs (mapterhorn.com/attribution)",
+      "licence": "open data, per source (Copernicus full free and open licence; national CC BY 4.0 / OGL); code BSD-3",
+      "licenceUrl": "https://mapterhorn.com/attribution",
+      "offline": true,
+      "offlineNote": "Mapterhorn publishes its PMTiles for download; the attribution goes with the copy"
+    },
+    {
+      "id": "aws-terrarium",
+      "kind": "terrain",
+      "label": "Terrain Tiles (AWS Open Data, Mapzen)",
+      "url": "https://s3.amazonaws.com/elevation-tiles-prod/terrarium/{z}/{x}/{y}.png",
+      "minZoom": 0,
+      "maxZoom": 15,
+      "tileSize": 256,
+      "format": "png",
+      "encoding": "terrarium",
+      "attribution": "Terrain Tiles (AWS Open Data): SRTM, GMTED2010 and 3DEP courtesy of the U.S. Geological Survey; EU-DEM produced using Copernicus data; ETOPO1 NOAA; and others (github.com/tilezen/joerd attribution)",
+      "licence": "per source, attribution required (tilezen/joerd attribution.md)",
+      "licenceUrl": "https://github.com/tilezen/joerd/blob/master/docs/attribution.md",
+      "offline": true,
+      "offlineNote": "open data on AWS: copying is allowed with the attribution list"
+    }
+  ]
+}

{s3dgraphy-1.6.0.dev102 → s3dgraphy-1.6.0.dev104}/src/s3dgraphy/JSON_config/em_qualia_types.json

@@ -1,11 +1,11 @@
 {
     "metadata": {
-      "version": "1.6.10",
-      "last_updated": "2026-10-10",
+      "version": "1.6.11",
+      "last_updated": "2026-11-12",
       "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.10 (MICRO lab sito Sarmizegetusa, 30 Oct 2026, on the proposal «Il GIS dentro l'em.json» (b)): spatial gains `footprint` — the extent in plan of a PLACE (the site, a district, a topographic unit) as a GeoSPARQL WKT literal with its CRS INSIDE the value (`<http://www.opengis.net/def/crs/EPSG/0/3844> POLYGON ((…))`, POLYGON or MULTIPOLYGON, 2D or Z), so the frame cannot be separated from the numbers; not GeoJSON (RFC 7946 is WGS 84 only). Inline up to 500 vertices (the AnnotationRegionNode limit); above, a GIS layer (ResourceNode url_type gis_layer) referenced instead. A property like any other, so the footprint has its paradata chain (extractor extracted_from the proxies of the units it outlines, a layer, a document). In RDF the value leaves as P90 AND as geo:hasGeometry → geo:asWKT (s3dgraphy.geometry.wkt.polygon_to_wkt, s3dgraphy.gis.set_footprint). v1.6.9 (MICRO le entità spaziotemporali, decided by E.D. 2026-10-10): absolute_time_start and absolute_time_end gain `owner_names` — the name the quale takes on an owner whose time is not a unit's: on an author (a person) «Date of birth» and «Date of death», on an AI author «Release date» and «Retirement date». E.D.: the end of a person is said with a decent word («scomparso», never «terminato»). The quale, its mapping and its value do not change; only the label a client shows (datamodel_translations 1.10, fields label_author and label_author_ai of the qualia section; s3dgraphy.tools.datamodel_i18n.qualia_label(id, lang, owner=…)). The rationale of the two qualia now names persons and documents beside epochs and units. v1.6.8 (MICRO badge PD e cronologia, part 5, 2026-10-09): a top-level `property_names` block — the EM property NAMES in use that are not a quale, each with its English `name` (the source of its label in datamodel_translations.json, section `property_names`) and a `description`: `definition` (the property of the EM GraphML templates that says what the unit is, 75 PropertyNodes in the files at hand, measured) and `material` (the same fact as the quale `material_type`, under the name of the yEd tradition: `quale` says so; 26 PropertyNodes as `material` / `Material`). They give a client the readable label of a property by its name; they are NOT qualia: no mapping, no class, nothing exported to RDF changes (the exporter reads `qualia_categories` only). Keys starting with `_` are notes. v1.6.7 (MICRO le decisioni della sera, 2026-10-05, asked by E.D. 2026-10-04): contextual.administrative gains `alternative_label` — another label of the element in a source (a numbering of another excavation, of a thesis), analogous to skos:altLabel, projected as crm:P1_is_identified_by → E41_Appellation. The first quale declared `repeatable: true`: one PropertyNode per label, never a list in one value, and the merger keys it with its value (two labels are two claims). Its source is the ordinary paradata chain (property has_data_provenance → extractor extracted_from → document); an optional data.scheme names the numbering. The element's own label (area.settore.tipoNumero) is unchanged. s3dgraphy.labels writes and reads them. v1.6.6 (dev27, 2026-10-31, decided by E.D. 2026-10-01): cultural_interpretive.semantic.attribution gains an optional `note` in its schema and `natural_language_fields: [\"note\"]` — the object is not text, its note is, and only the note carries a language tag (rdf_exporter._Datamodel.natural_language_fields). 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)."
+      "changelog": "v1.6.11 (NIGHT impronte di saggi e tagli, decided by E.D. 2026-11-11): `footprint` declares WHO may carry it — `applies_to`: the site (LocationNodeGroup level sito), the operational places of an excavation (LocationNodeGroup kind study: area, settore, saggio, quadrato), a LandscapeUnitNode, and the NEGATIVE unit (NegativeStratigraphicUnit, USN / US-): a cut is the interface a subtraction of matter left (CRMarchaeo A3), and its outline in plan is a fact of the excavation a plan draws. `not_applies_to`: the positive unit (its geometry is the proxy, quale `geometry`) and the neutral unit USNt (a designed void, nothing was cut). Above 500 vertices the full geometry stays in its gis_layer and the inline value is simplified, the tolerance in the paradata. Read by s3dgraphy.gis.footprint; no mapping changed, no em: term added. v1.6.10 (MICRO lab sito Sarmizegetusa, 30 Oct 2026, on the proposal «Il GIS dentro l'em.json» (b)): spatial gains `footprint` — the extent in plan of a PLACE (the site, a district, a topographic unit) as a GeoSPARQL WKT literal with its CRS INSIDE the value (`<http://www.opengis.net/def/crs/EPSG/0/3844> POLYGON ((…))`, POLYGON or MULTIPOLYGON, 2D or Z), so the frame cannot be separated from the numbers; not GeoJSON (RFC 7946 is WGS 84 only). Inline up to 500 vertices (the AnnotationRegionNode limit); above, a GIS layer (ResourceNode url_type gis_layer) referenced instead. A property like any other, so the footprint has its paradata chain (extractor extracted_from the proxies of the units it outlines, a layer, a document). In RDF the value leaves as P90 AND as geo:hasGeometry → geo:asWKT (s3dgraphy.geometry.wkt.polygon_to_wkt, s3dgraphy.gis.set_footprint). v1.6.9 (MICRO le entità spaziotemporali, decided by E.D. 2026-10-10): absolute_time_start and absolute_time_end gain `owner_names` — the name the quale takes on an owner whose time is not a unit's: on an author (a person) «Date of birth» and «Date of death», on an AI author «Release date» and «Retirement date». E.D.: the end of a person is said with a decent word («scomparso», never «terminato»). The quale, its mapping and its value do not change; only the label a client shows (datamodel_translations 1.10, fields label_author and label_author_ai of the qualia section; s3dgraphy.tools.datamodel_i18n.qualia_label(id, lang, owner=…)). The rationale of the two qualia now names persons and documents beside epochs and units. v1.6.8 (MICRO badge PD e cronologia, part 5, 2026-10-09): a top-level `property_names` block — the EM property NAMES in use that are not a quale, each with its English `name` (the source of its label in datamodel_translations.json, section `property_names`) and a `description`: `definition` (the property of the EM GraphML templates that says what the unit is, 75 PropertyNodes in the files at hand, measured) and `material` (the same fact as the quale `material_type`, under the name of the yEd tradition: `quale` says so; 26 PropertyNodes as `material` / `Material`). They give a client the readable label of a property by its name; they are NOT qualia: no mapping, no class, nothing exported to RDF changes (the exporter reads `qualia_categories` only). Keys starting with `_` are notes. v1.6.7 (MICRO le decisioni della sera, 2026-10-05, asked by E.D. 2026-10-04): contextual.administrative gains `alternative_label` — another label of the element in a source (a numbering of another excavation, of a thesis), analogous to skos:altLabel, projected as crm:P1_is_identified_by → E41_Appellation. The first quale declared `repeatable: true`: one PropertyNode per label, never a list in one value, and the merger keys it with its value (two labels are two claims). Its source is the ordinary paradata chain (property has_data_provenance → extractor extracted_from → document); an optional data.scheme names the numbering. The element's own label (area.settore.tipoNumero) is unchanged. s3dgraphy.labels writes and reads them. v1.6.6 (dev27, 2026-10-31, decided by E.D. 2026-10-01): cultural_interpretive.semantic.attribution gains an optional `note` in its schema and `natural_language_fields: [\"note\"]` — the object is not text, its note is, and only the note carries a language tag (rdf_exporter._Datamodel.natural_language_fields). 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)."
     },
     "property_names": {
       "_note": "EM property names in use that are not a quale (v1.6.8): the readable label of a property is looked up by its name here when no quale has that id. Not vocabulary terms: no mapping, no data_type, no RDF class.",
@@ -588,7 +588,7 @@
               {
                 "id": "footprint",
                 "name": "Footprint",
-                "description": "The extent in plan of a place — a site, a district, a topographic unit — as a WKT literal with its CRS inside the value (GeoSPARQL wktLiteral): POLYGON or MULTIPOLYGON, 2D or Z. Inline up to 500 vertices; above, a GIS layer referenced by the place.",
+                "description": "The extent in plan of a place — a site, an excavation area, a saggio, a district, a topographic unit — or of a CUT (a negative unit, US-), as a WKT literal with its CRS inside the value (GeoSPARQL wktLiteral): POLYGON or MULTIPOLYGON, 2D or Z. Inline up to 500 vertices; above, the full geometry stays in a GIS layer (ResourceNode url_type gis_layer, its feature named by feature_key) and the value inline is that geometry simplified, the tolerance declared in its paradata. Who may carry it is declared in `applies_to`; a positive unit may NOT — its geometry is the proxy (quale `geometry`).",
                 "mappings": {
                   "cidoc_crm": "SP5_Geometric_Place_Expression",
                   "cidoc_crm_namespace": "crmgeo",
@@ -599,8 +599,19 @@
                 "format": "<CRS IRI> POLYGON ((x y, …)) | MULTIPOLYGON (((…)), …), optionally Z",
                 "inline_max_vertices": 500,
                 "rationale": "A site, a district, the area a survey walked: places of the Landscape Graph have an extent before they have a stratigraphy, and a footprint is how the globe and the top view of the 3D space draw them. As a property it has the chain every quale has, so «where does this outline come from» is answered by the graph: the proxies of the units it encloses, a layer, a plan.",
-                "example": "Templu Mare (Ulpia Traiana Sarmizegetusa): the podium of the temple, the convex hull in plan of the proxies of SU001–SU004, a POLYGON Z in EPSG:3844 on the site's LocationNodeGroup.",
-                "expected_extractors": ["geometric_calculation", "gis_analysis", "drawing_measurement"]
+                "example": "Templu Mare (Ulpia Traiana Sarmizegetusa): the podium of the temple, the convex hull in plan of the proxies of SU001–SU004, a POLYGON Z in EPSG:3844 on the site's LocationNodeGroup. A pyArchInit excavation: the polygons of pyarchinit_sondaggi on the saggi, of pyarchinit_ripartizioni_spaziali on the areas, of pyunitastratigrafiche on the cuts only (EPSG of the layer).",
+                "expected_extractors": ["geometric_calculation", "gis_analysis", "drawing_measurement"],
+                "applies_to": [
+                  {"node_type": "LocationNodeGroup", "where": {"level": "sito"}, "what": "the site (D-LG4): the place a study took place at"},
+                  {"node_type": "LocationNodeGroup", "where": {"kind": "study"}, "what": "the operational places of the excavation — area, settore, saggio, quadrato (pyArchInit's columns; the importer writes the column as `level`). A saggio is a study AND a place (nodes 1.6.29)"},
+                  {"node_type": "LandscapeUnitNode", "what": "a topographic unit, a district of the Landscape Graph"},
+                  {"node_type": "NegativeStratigraphicUnit", "what": "a CUT (USN, displayed US-): the outline in plan of the interface a subtraction of matter left (CRMarchaeo A3). A cut is a surface, not a body: its extent in plan is what a plan draws of it, and it may outlive what filled it"}
+                ],
+                "not_applies_to": [
+                  {"node_type": "StratigraphicUnit", "why": "a positive unit is a BODY of matter: its geometry is the proxy, quale `geometry` (a PropertyNode whose payload is a SemanticShapeNode). Its outline in plan is a view of the proxy, not a second geometry beside it"},
+                  {"node_type": "NeutralStratigraphicUnit", "why": "a USNt is a void that was DESIGNED (a window, a niche): no matter was taken away, so there is no cut to outline. Its geometry, when drawn, is the proxy"}
+                ],
+                "_applies_to_note": "1.6.11 (NIGHT impronte di saggi e tagli, decided by E.D. 2026-11-11). Read by s3dgraphy.gis.footprint (may_have_footprint): a node matches an entry when its node_type is the entry's or a subclass of it, and every key of `where` equals the node's attribute. `not_applies_to` is checked FIRST and its `why` is the refusal a writer gives. Other LocationNodeGroups (a toponym above the site, a functional place) are neither admitted nor refused here: a writer refuses them as not declared."
               },
               {
                 "id": "geometry",