capellambse_context_diagrams

The Context Diagrams model extension.

This extension adds a new property to many model elements called context_diagram, which allows access automatically generated diagrams of an element's "context".

The context of an element is defined as the collection of the element itself, its ports, the exchanges that flow into or out of the ports, as well as the ports on the other side of the exchange and the ports' direct parent elements.

The element of interest uses the regular styling (configurable via function), other elements use a white background color to distinguish them.

init

init() -> None

Initialize the extension.

Source code in src/capellambse_context_diagrams/__init__.py

def init() -> None:
    """Initialize the extension."""
    register_classes()
    register_interface_context()
    register_physical_port_context()
    register_tree_view()
    register_realization_view()
    register_data_flow_view()
    register_cable_tree_view()
    register_diagram_layout_accessor()
    register_functional_chain_view()

install_elk

install_elk() -> None

Install an ELK.js binary.

When rendering a context diagram, elk.js will be installed automatically into a persistent local cache directory. This function may be called while building a container, starting a server or similar tasks in order to prepare the elk.js execution environment ahead of time.

Source code in src/capellambse_context_diagrams/__init__.py

def install_elk() -> None:
    """Install an ELK.js binary.

    When rendering a context diagram, elk.js will be installed
    automatically into a persistent local cache directory. This function
    may be called while building a container, starting a server or
    similar tasks in order to prepare the elk.js execution environment
    ahead of time.
    """
    if shutil.which("deno") and "dev" in metadata.version(
        "capellambse_context_diagrams"
    ):
        return

    _elkjs.elk_manager.spawn_process()

register_cable_tree_view

register_cable_tree_view() -> None

Add the cable_tree_view attribute to PhysicalLinks.

Source code in src/capellambse_context_diagrams/__init__.py

def register_cable_tree_view() -> None:
    """Add the `cable_tree_view` attribute to `PhysicalLink`s."""
    cs.PhysicalLink.cable_tree = context.CableTreeAccessor(
        DiagramType.PAB.value, {}
    )

register_classes

register_classes() -> None

Add the context_diagram property to the relevant model objects.

Source code in src/capellambse_context_diagrams/__init__.py

def register_classes() -> None:
    """Add the `context_diagram` property to the relevant model objects."""
    cap: dict[str, CSSdef] = {
        "fill": [COLORS["_CAP_Entity_Gray_min"], COLORS["_CAP_Entity_Gray"]],
        "stroke": COLORS["dark_gray"],
        "text_fill": COLORS["black"],
    }
    capstyle.STYLES["Missions Capabilities Blank"].update(
        {"Box.Capability": cap, "Box.Mission": cap}
    )
    capstyle.STYLES["Operational Capabilities Blank"][
        "Box.OperationalCapability"
    ] = cap
    circle_style: dict[str, CSSdef] = {
        "fill": COLORS["_CAP_xAB_Function_Border_Green"],
    }
    class_: type[m.ModelElement]
    for (
        class_,
        dgcls,
        default_render_params,
    ) in _registry.CONTEXT_DIAGRAM_CLASSES:
        class_.context_diagram = context.ContextAccessor(
            dgcls.value, default_render_params
        )
        capstyle.STYLES[dgcls.value]["Circle.FunctionalExchange"] = (
            circle_style
        )

register_data_flow_view

register_data_flow_view() -> None

Add the data_flow_view attribute to Capabilitys.

Source code in src/capellambse_context_diagrams/__init__.py

def register_data_flow_view() -> None:
    """Add the `data_flow_view` attribute to ``Capability``s."""
    capstyle.STYLES["Operational Activity Interaction Blank"] = (
        capstyle.STYLES["Operational Entity Blank"]
        | capstyle.STYLES["Operational Activity Interaction Blank"]
    )
    capstyle.STYLES["System Data Flow Blank"] = (
        capstyle.STYLES["System Architecture Blank"]
        | capstyle.STYLES["System Data Flow Blank"]
    )
    capstyle.STYLES["Logical Data Flow Blank"] = (
        capstyle.STYLES["Logical Architecture Blank"]
        | capstyle.STYLES["Logical Data Flow Blank"]
    )

    class_: type[m.ModelElement]
    for class_, dgcls, default_render_params in _registry.DATAFLOW_CLASSES:
        accessor = context.DataFlowAccessor(dgcls.value, default_render_params)
        class_.data_flow_view = accessor

register_diagram_layout_accessor

register_diagram_layout_accessor() -> None

Add the auto_layout attribute to Diagrams.

Source code in src/capellambse_context_diagrams/__init__.py

def register_diagram_layout_accessor() -> None:
    """Add the `auto_layout` attribute to `Diagram`s."""
    m.set_accessor(
        m.Diagram,
        "auto_layout",
        context.DiagramLayoutAccessor(_registry.DIAGRAM_LAYOUT_PARAMS),
    )

register_functional_chain_view

register_functional_chain_view() -> None

Add the context_diagram attribute to FunctionalChains.

Source code in src/capellambse_context_diagrams/__init__.py

def register_functional_chain_view() -> None:
    """Add the ``context_diagram`` attribute to ``FunctionalChain``s."""
    for (
        class_,
        dgclasses,
        default_render_params,
    ) in _registry.FUNCTIONAL_CHAIN_CONTEXT_CLASSES:
        class_.context_diagram = context.FunctionalChainContextAccessor(
            dgclasses, default_render_params
        )

register_interface_context

register_interface_context() -> None

Add the context_diagram property to interface model objects.

Source code in src/capellambse_context_diagrams/__init__.py

def register_interface_context() -> None:
    """Add the `context_diagram` property to interface model objects."""
    class_: type[m.ModelElement]
    for (
        class_,
        dgclasses,
        default_render_params,
    ) in _registry.INTERFACE_CONTEXT_CLASSES:
        class_.context_diagram = context.InterfaceContextAccessor(
            dgclasses, default_render_params
        )

    port_alloc_output_style: dict[str, CSSdef] = {
        "fill": COLORS["_CAP_xAB_Function_Border_Green"],
        "stroke": COLORS["_CAP_xAB_Function_Border_Green"],
        "stroke-dasharray": "2",
        "text_fill": COLORS["black"],
    }
    port_alloc_input_style: dict[str, CSSdef] = {
        "fill": COLORS["dark_orange"],
        "stroke": COLORS["dark_orange"],
        "stroke-dasharray": "2",
        "text_fill": COLORS["black"],
    }
    for dt in (m.DiagramType.SAB, m.DiagramType.LAB, m.DiagramType.PAB):
        capstyle.STYLES[dt.value]["Edge.PortInputAllocation"] = (
            port_alloc_input_style
        )
        capstyle.STYLES[dt.value]["Edge.PortOutputAllocation"] = (
            port_alloc_output_style
        )

register_physical_port_context

register_physical_port_context() -> None

Add the context_diagram attribute to PhysicalPorts.

Source code in src/capellambse_context_diagrams/__init__.py

def register_physical_port_context() -> None:
    """Add the `context_diagram` attribute to `PhysicalPort`s."""
    cs.PhysicalPort.context_diagram = context.PhysicalPortContextAccessor(
        DiagramType.PAB.value, {}
    )

register_realization_view

register_realization_view() -> None

Add the realization_view attribute to various objects.

Adds realization_view to Activities, Functions and Components of all layers.

Source code in src/capellambse_context_diagrams/__init__.py

def register_realization_view() -> None:
    """Add the ``realization_view`` attribute to various objects.

    Adds ``realization_view`` to Activities, Functions and Components
    of all layers.
    """
    styles: dict[str, dict[str, capstyle.CSSdef]] = {}
    for class_, dgcls, _ in _registry.REALIZATION_VIEW_CLASSES:
        class_.realization_view = context.RealizationViewContextAccessor(
            "RealizationView Diagram"
        )
        styles.update(capstyle.STYLES.get(dgcls.value, {}))

    capstyle.STYLES["RealizationView Diagram"] = styles
    capstyle.STYLES["RealizationView Diagram"].update(
        capstyle.STYLES["__GLOBAL__"]
    )
    capstyle.STYLES["RealizationView Diagram"]["Edge.Realization"] = {
        "stroke": capstyle.COLORS["dark_gray"],
        "marker-end": "FineArrowMark",
        "stroke-dasharray": "5",
    }

register_tree_view

register_tree_view() -> None

Add the tree_view attribute to Classes.

Source code in src/capellambse_context_diagrams/__init__.py

def register_tree_view() -> None:
    """Add the ``tree_view`` attribute to ``Class``es."""
    information.Class.tree_view = context.ClassTreeAccessor(
        DiagramType.CDB.value
    )