Source code for s3dgraphy.nodes.stratigraphic_node

# 3dgraphy/nodes/stratigraphic_node.py

from .base_node import Node

[docs] class StratigraphicNode(Node): """ Base class for all stratigraphic units within the graph structure. Inherits from Node and provides additional functionality specific to stratigraphy. """ node_type = "StratigraphicNode"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = None self.label = None self.detailed_description = None # To avoid conflict with `description`
[docs] class StratigraphicUnit(StratigraphicNode): node_type = "US"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "white rectangle" self.label = "US (or SU)" self.detailed_description = "Stratigraphic Unit (SU) or negative stratigraphic unit."
[docs] class StructuralVirtualStratigraphicUnit(StratigraphicNode): node_type = "USVs"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "black parallelogram" self.label = "USV/s" self.detailed_description = "Structural Virtual Stratigraphic Unit (USV/s)."
[docs] class SeriesOfStratigraphicUnit(StratigraphicNode): node_type = "serSU"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "white ellipse" self.label = "US series" self.detailed_description = "Series of Stratigraphic Units (SU)."
[docs] class SeriesOfNonStructuralVirtualStratigraphicUnit(StratigraphicNode): node_type = "serUSVn"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "black ellipse green border" self.label = "USVn series" self.detailed_description = "Series of non-structural Virtual Stratigraphic Units."
[docs] class SeriesOfStructuralVirtualStratigraphicUnit(StratigraphicNode): node_type = "serUSVs"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "black ellipse blue border" self.label = "USVs series" self.detailed_description = "Series of Structural Virtual Stratigraphic Units."
[docs] class SeriesOfDocumentaryStratigraphicUnit(StratigraphicNode): node_type = "serUSD"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "white ellipse with orange border" self.label = "USD series" self.detailed_description = "Series of Documentary Stratigraphic Units (USD)."
[docs] class NonStructuralVirtualStratigraphicUnit(StratigraphicNode): node_type = "USVn"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "black hexagon" self.label = "USV/n" self.detailed_description = "Non-structural Virtual Stratigraphic Unit (USV/n)."
[docs] class SpecialFindUnit(StratigraphicNode): node_type = "SF"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "white octagon" self.label = "Special Find" self.detailed_description = "Not in situ element that needs repositioning."
[docs] class VirtualSpecialFindUnit(StratigraphicNode): node_type= "VSF"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "black octagon" self.label = "Virtual Special Find" self.detailed_description = "Hypothetical reconstruction of a fragmented Special Find."
[docs] class ReusedSpecialFind(StratigraphicNode): """Reused Special Find (RSF) — re-used architectural / decorative element (spolia) in archaeological reconstructions. Typological cousin of :class:`SpecialFindUnit` (SF) and :class:`VirtualSpecialFindUnit` (VSF): all three render as octagons. RSF is distinguished by its **red** border (``#9B3333``) and a white fill, marking the element as physically present *and* re-deployed out of its original construction context. Originating Development Project: DP-26 (spolia project, last DP before the EM 1.5 cut). Visual stencil shipped in the palette template at ``templates/em_palette_template.graphml``. """ node_type = "RSF"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "white octagon red border" self.label = "Reused Special Find" self.detailed_description = ( "Re-used architectural or decorative element (spolia) in " "archaeological reconstructions. A physical find observed " "in situ but originally produced for a different context.")
[docs] class DocumentaryStratigraphicUnit(StratigraphicNode): node_type = "USD"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "white round rectangle" self.label = "USD" self.detailed_description = "Documentary Stratigraphic Unit."
[docs] class TransformationStratigraphicUnit(StratigraphicNode): node_type = "TSU"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "dotted white rectangle" self.label = "TSU" self.detailed_description = "Transformation Unit."
[docs] class WorkingUnit(StratigraphicNode): node_type = "UL"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "white rectangle with orange border" self.label = "UL" self.detailed_description = "Working Unit. Traces of stone working, toolmarks, reworkings on architectural surfaces."
[docs] class NegativeStratigraphicUnit(StratigraphicNode): """Negative Stratigraphic Unit (US negativa / USN). Describes a *lacuna*, a removal, or an interface that marks the absence of matter rather than its presence — e.g. a pit cut, an erosion surface, a demolition void. Distinct from a plain :class:`StratigraphicUnit` (which is positive by default), but equally observable on the ground: it is a *real* stratigraphic element, hence classified in the ``real`` family alongside :class:`StratigraphicUnit` and :class:`DocumentaryStratigraphicUnit`. """ node_type = "USN"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "white dashed rectangle" self.label = "Negative SU" self.detailed_description = ( "Negative Stratigraphic Unit — a lacuna, removal, or " "interface that marks absence rather than matter " "(e.g., a pit cut, an erosion surface, a demolition void).")
[docs] class ContinuityNode(StratigraphicNode): node_type = "BR"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "black rhombus" self.label = "continuity node" self.detailed_description = "End of life of a US/USV."
[docs] class StratigraphicEventNode(StratigraphicNode): node_type = "SE"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "to be defined" self.label = "stratigraphic event node" self.detailed_description = "A stratigraphic event is the process or event that leads to the formation or alteration of a stratigraphic unit. It is distinct from the unit itself, which represents the result or outcome of the event. The event can be thought of as a precursor and can be paired with its resulting unit to provide a more detailed temporal range. This allows for the documentation of both the initial moment of action (e.g., the start of construction, a collapse, or an incision) and the final state (the resulting unit that persists over time)."
[docs] class UnknownNode(StratigraphicNode): node_type = "unknown"
[docs] def __init__(self, node_id, name, description=""): super().__init__(node_id, name, description) self.symbol = "question mark" self.label = "Unknown node" self.detailed_description = "Fallback node for unrecognized types."