osis-python 0.5.1__tar.gz → 0.5.3__tar.gz

{osis_python-0.5.1/src/osis_python.egg-info → osis_python-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: osis-python
-Version: 0.5.1
+Version: 0.5.3
 Summary: A Python client library for Osis APDL
 Author-email: "CCCC Highway Consultant Co. Ltd." <support@osisbim.com>
 License-Expression: MIT

{osis_python-0.5.1 → osis_python-0.5.3/src/osis_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: osis-python
-Version: 0.5.1
+Version: 0.5.3
 Summary: A Python client library for Osis APDL
 Author-email: "CCCC Highway Consultant Co. Ltd." <support@osisbim.com>
 License-Expression: MIT

{osis_python-0.5.1 → osis_python-0.5.3}/src/osis_python.egg-info/SOURCES.txt

@@ -23,7 +23,12 @@ src/pyosis/core/build.py
 src/pyosis/core/client.py
 src/pyosis/core/command.py
 src/pyosis/core/engine.py
+src/pyosis/core/exceptions.py
+src/pyosis/core/references.py
 src/pyosis/core/sync_apdl_cli.py
+src/pyosis/display/__init__.py
+src/pyosis/display/interface.py
+src/pyosis/display/manager.py
 src/pyosis/dynamic/__init__.py
 src/pyosis/dynamic/load_to_mass.py
 src/pyosis/dynamic/manager.py
@@ -104,4 +109,6 @@ src/pyosis/transfer/matrix.py
 src/pyosis/transfer/out_to_python.py
 src/pyosis/transfer/parser.py
 src/pyosis/transfer/routes.py
-src/pyosis/transfer/split.py
+src/pyosis/transfer/split.py
+tests/test_delete_occupied.py
+tests/test_project_manager.py

{osis_python-0.5.1 → osis_python-0.5.3}/src/pyosis/__init__.py

@@ -7,7 +7,7 @@ A library for extending OSIS functionality.
 A library that allows users to use CAE with great flexibility.
 """
 
-__version__ = "0.5.1"
+__version__ = "0.5.3"
 __author__ = "CCCC Highway Consultant Co. Ltd." # 中交公路规划设计院 - 工程技术研究中心 - lzh - wjh - myf
 
 from .core.engine import OSISEngine

{osis_python-0.5.1 → osis_python-0.5.3}/src/pyosis/boundary/manager.py

@@ -23,6 +23,7 @@ from typing import Any, Literal
 from enum import IntEnum
 
 from ..core.client import osis_client
+from ..core import get_references, raise_if_occupied
 from .interface import (
     osis_boundary_general,
     osis_boundary_elstcspt,
@@ -638,6 +639,10 @@ class BoundaryManager:
             return 1
         return max(bd.no for bd in boundaries) + 1
 
+    def get_dependencies(self, no: int) -> dict[str, list]:
+        """查询边界被谁引用"""
+        return get_references("Boundary", no=no)
+
     # ── 增删改 ────────────────────────────────
     def create(self, no: int | None, type: str, *args: Any, **kwargs: Any) -> Boundary:
         """创建边界（便捷入口，内部转发到对应 create_* 方法）
@@ -846,7 +851,14 @@ class BoundaryManager:
         return self.get(no)  # type: ignore[return-value]
 
     def delete(self, no: int) -> None:
-        """删除边界"""
+        """删除边界
+
+        Raises:
+            DependencyError: 存在依赖项时
+            RuntimeError: 删除失败时抛出异常
+        """
+        deps = self.get_dependencies(no)
+        raise_if_occupied("Boundary", deps, no=no)
         ok, err = osis_boundary_del(no)
         if not ok:
             raise RuntimeError(f"删除边界 {no} 失败: {err}")

{osis_python-0.5.1 → osis_python-0.5.3}/src/pyosis/core/__init__.py

@@ -10,3 +10,5 @@ OSISEngine中的函数，将会分发到各个模块，被再次封装，意图
 
 from .command import REGISTRY, osis_run, set_run_mode
 from .client import set_osis_port, set_osis_url
+from .exceptions import DependencyError
+from .references import get_references, raise_if_occupied

{osis_python-0.5.1 → osis_python-0.5.3}/src/pyosis/core/all_func.py

@@ -19,4 +19,5 @@ from ..settlement import *
 from ..stability import *
 
 from ..post import *
-from ..result import *
+from ..result import *
+from ..display import *

{osis_python-0.5.1 → osis_python-0.5.3}/src/pyosis/core/client.py

@@ -26,6 +26,8 @@ session.mount("https://", adapter)  # 如果你后续用HTTPS
 
 DEFAULT_PORT = 18080
 DEFAULT_URL = "http://localhost"
+DEFAULT_TIMEOUT = 300
+DEFAULT_SOLVE_TIMEOUT = 600
 
 def set_osis_url(url):
     '''
@@ -42,12 +44,19 @@ def set_osis_port(port):
     DEFAULT_PORT = port
 
 # ========== 通用客户端函数（复用连接池） ==========
-def osis_client(func_name: str, payload: dict, base_url=None) -> dict:
+def osis_client(
+    func_name: str,
+    payload: dict,
+    base_url=None,
+    timeout: float | None = None,
+) -> dict:
     """
     通用 OSIS 接口客户端（复用连接池，高效批量调用）
     Args:
         func_name: C++ 接口名（如 "OSIS_Run"）
         payload: 请求参数字典（自动序列化为 JSON）
+        base_url: url
+        timeout: HTTP 超时秒数，默认 DEFAULT_TIMEOUT
     Returns:
         异常时返回 (False, 错误信息)
     """
@@ -59,7 +68,7 @@ def osis_client(func_name: str, payload: dict, base_url=None) -> dict:
             url,
             data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
             headers={"Content-Type": "application/json; charset=utf-8"},
-            timeout=300,
+            timeout=timeout if timeout is not None else DEFAULT_TIMEOUT,
         )
 
         data = None

{osis_python-0.5.1 → osis_python-0.5.3}/src/pyosis/core/command.py

@@ -19,7 +19,11 @@ from .client import osis_client
 #         f.write(f"[{timestamp}] {text}\n")
 #         f.close()
 
-def osis_run(strCmd: str="", mode: Literal["stash", "exec"]="exec") -> tuple[bool, str]:
+def osis_run(
+    strCmd: str = "",
+    mode: Literal["stash", "exec"] = "exec",
+    timeout: float | None = None,
+) -> tuple[bool, str]:
     """
     http 模拟 C++ 原生 OSIS_Run 函数
     Args:
@@ -27,11 +31,16 @@ def osis_run(strCmd: str="", mode: Literal["stash", "exec"]="exec") -> tuple[boo
         mode: 运行模式，此参数为了同时执行多条命令提高效率
             * 使用 stash 仅会将命令流存到OSIS中，不会执行
             * 收到 exec 信号才会执行暂存包括当前的所有命令流。
+        timeout: HTTP 超时秒数，默认由 osis_client 决定
 
     Returns:
         tuple (bool, str): 是否成功，失败原因
     """
-    response = osis_client("OSIS_Run", locals())
+    response = osis_client(
+        "OSIS_Run",
+        {"strCmd": strCmd, "mode": mode},
+        timeout=timeout,
+    )
     return response['success'], response['error']
     
 def _log(text, log_dir="pyosis_logs"):

{osis_python-0.5.1 → osis_python-0.5.3}/src/pyosis/core/engine.py

@@ -41,6 +41,7 @@ from ..stability.manager import StabilityManager, stability_manager
 from ..dynamic.manager import DynamicManager, dynamic_manager
 from ..post.manager import PostManager, post_manager
 from ..result.manager import ResultManager, result_manager
+from ..display.manager import DisplayManager, display_manager
 from ..general.interface import (
     osis_matrix,
     output_result_for_calc_book,
@@ -69,7 +70,7 @@ class OSISEngine:
         - tendon:    钢束管理器（含 prop/shape 子管理器）
         - live:      活载管理器（含 grade/lane/case 子管理器）
         - geometry:  几何管理器（三维样条曲线）
-        - property:  属性管理器（坐标系、收缩徐变、阻尼等）
+        - prop:      属性管理器（property 坐标系、收缩徐变、阻尼等）
         - thickness: 厚度管理器（壳厚度特性）
         - control:   控制管理器（全局参数、分析设置）
         - project:   项目管理器（创建、打开、保存项目）
@@ -78,6 +79,7 @@ class OSISEngine:
         - dynamic:   动力分析管理器（荷载转换质量、模态、反应谱）
         - post:      后处理管理器（荷载组合、规范验算、结果显示）
         - result:    结果导出管理器（工况结果、包络结果、验算结果）
+        - display:   显示管理器（边界 / 荷载 / 钢束显隐等）
 
     通用操作可直接通过 engine 调用：
         - run(), solve(), replot(), clear(), clc()
@@ -114,6 +116,9 @@ class OSISEngine:
         ### 后处理 ###
         self._post = post_manager
         self._result = result_manager
+        
+        ### 显示 ###
+        self._display = display_manager
 
         # OSIS端口与网址
         if port is None:
@@ -228,6 +233,13 @@ class OSISEngine:
         """结果导出管理器（工况结果、包络结果、验算结果）"""
         return self._result
 
+    ### 显示 ###
+
+    @property
+    def display(self) -> DisplayManager:
+        """显示管理器（边界 / 荷载 / 钢束显隐等）"""
+        return self._display
+
     # ──────────────────────────────────────────
     # 通用操作（直接暴露 general 和 core 的函数）
     # ──────────────────────────────────────────
@@ -246,9 +258,13 @@ class OSISEngine:
         if not ok:
             raise RuntimeError(f"执行失败: {err}")
 
-    def solve(self) -> None:
-        """求解工程"""
-        ok, err = osis_solve()
+    def solve(self, timeout: float | None = None) -> None:
+        """求解工程
+
+        Args:
+            timeout: HTTP 超时秒数，默认 600（10 分钟）
+        """
+        ok, err = osis_solve(timeout=timeout)
         if not ok:
             raise RuntimeError(f"求解失败: {err}")
 
@@ -293,9 +309,14 @@ class OSISEngine:
     # 便捷方法（委托给 project manager）
     # ──────────────────────────────────────────
 
-    def save_project(self) -> None:
-        """保存当前项目"""
-        self._project.save()
+    def save_project(self, filepath: str = "") -> None:
+        """保存项目
+
+        Args:
+            filepath: 工程文件路径。为空时使用当前项目路径；
+                非空时使用传入路径。
+        """
+        self._project.save(filepath)
 
     def new_project(self, type: int = 1, filepath: str = "") -> None:
         """新建项目
@@ -314,6 +335,10 @@ class OSISEngine:
         """
         self._project.open(filepath)
 
+    def close(self) -> None:
+        """关闭 OSIS 软件"""
+        self._project.close()
+
     # ──────────────────────────────────────────
     # 便捷方法（委托给 control manager）
     # ──────────────────────────────────────────

osis_python-0.5.3/src/pyosis/core/exceptions.py

@@ -0,0 +1,32 @@
+"""
+pyosis 自定义异常
+"""
+
+class DependencyError(RuntimeError):
+    """删除实体时存在依赖项
+
+    Attributes:
+        entity_type: 实体类型字符串，如 "Material"
+        id_value: 实体编号（int）或名称（str）
+        no: 按编号寻址时的编号，否则为 None
+        name: 按名称寻址时的名称，否则为 None
+        dependencies: 依赖关系字典
+    """
+    def __init__(self, entity_type: str, id_value: int | str, dependencies: dict[str, list]):
+        self.entity_type = entity_type
+        self.id_value = id_value
+        self.dependencies = dependencies
+        if isinstance(id_value, int):
+            self.no = id_value
+            self.name = None
+            label = f"#{id_value}"
+        else:
+            self.no = None
+            self.name = id_value
+            label = id_value
+
+        lines = [f"无法删除 {entity_type} {label}，存在以下依赖:"]
+        for kind, refs in dependencies.items():
+            if refs:
+                lines.append(f"  - {kind}: {refs}")
+        super().__init__("\n".join(lines))

osis_python-0.5.3/src/pyosis/core/references.py

@@ -0,0 +1,87 @@
+"""
+通用引用查询客户端封装
+
+后端 C++ 暴露 /GetReferences 接口，根据 entityType 字符串分派
+到对应 Info 类的 getRelated* 方法。
+"""
+from __future__ import annotations
+from typing import Literal
+from .client import osis_client
+from .exceptions import DependencyError
+
+# 支持的实体类型（与 C++ GetReferences.cpp 中的 if-else 分支对齐）
+EntityType = Literal[
+    "Material", "Section", "Node", "Element", "Boundary",
+    "TendonShape", "TendonProp", "LoadCase", "LiveGrade", "LiveLane",
+    "CoorSys", "CreepShrink", "PUCurve", "ShellThickness",
+    "Damping", "Spline",
+]
+
+
+"""
+通用引用查询客户端封装
+后端 /GetReferences 统一字符串协议：{entityType, idKey("no"|"name"), idValue}
+"""
+
+
+
+def get_references(entity_type: str, *, no: int | None = None, name: str | None = None) -> dict[str, list]:
+    """查询某个实体被哪些其他实体引用
+
+    Args:
+        entity_type: 实体类型，如 "Material" / "Node" / "TendonShape" / "LoadCase"
+        no:  按编号寻址时传（Material/Section/Node/Element）
+        name: 按名称寻址时传（TendonShape/LoadCase/...）
+        no 与 name 二选一。
+
+    Returns:
+        引用关系字典，如 {"elements":[101,102], "loads":["自重"], ...}
+        无依赖时返回空字典。
+
+    Raises:
+        ValueError: no/name 都没传，或都传了
+        RuntimeError: 查询失败
+    """
+    if no is not None and name is not None:
+        raise ValueError("no 与 name 只能传一个")
+    if no is None and name is None:
+        raise ValueError("必须提供 no 或 name")
+
+    if no is not None:
+        id_key, id_value = "no", str(no)
+    else:
+        id_key, id_value = "name", name
+
+    resp = osis_client("GetReferences", {
+        "entityType": entity_type,
+        "idKey": id_key,
+        "idValue": id_value,
+    })
+    if not resp.get("success"):
+        raise RuntimeError(f"查询 {entity_type}({id_key}={id_value}) 引用失败: {resp.get('error')}")
+    return resp.get("data") or {}
+
+
+def raise_if_occupied(
+    entity_type: str,
+    deps: dict[str, list],
+    *,
+    no: int | None = None,
+    name: str | None = None,
+) -> None:
+    """存在非空依赖时抛出 DependencyError。
+
+    Args:
+        entity_type: 实体类型，如 "Material" / "TendonShape"
+        deps: get_references / get_dependencies 返回的依赖字典
+        no: 按编号寻址时传
+        name: 按名称寻址时传
+    """
+    non_empty = {k: v for k, v in deps.items() if v}
+    if not non_empty:
+        return
+    if no is None and name is None:
+        raise ValueError("必须提供 no 或 name")
+    id_value = no if no is not None else name
+    raise DependencyError(entity_type, id_value, non_empty)
+

osis_python-0.5.3/src/pyosis/display/__init__.py

@@ -0,0 +1,8 @@
+"""
+pyosis.display
+
+显示控制（显隐、视图方向、显示开关等）
+"""
+
+from .interface import *
+from .manager import DisplayManager, display_manager

osis_python-0.5.3/src/pyosis/display/interface.py

@@ -0,0 +1,103 @@
+"""显示控制命令接口
+
+控制边界、荷载、钢束显隐，以及视图方向、显示开关等。
+"""
+
+from typing import Literal, Sequence, Union
+
+from ..core import REGISTRY
+
+
+@REGISTRY.register("DispCtrl")
+def osis_disp_ctrl(
+    eObject: Literal["bc", "boundary", "lg", "load", "td", "tendon"],
+    eType: str,
+    ids: Union[str, int, Sequence[Union[str, int]]],
+    bShow: Literal[0, 1] = 1,
+):
+    """控制边界 / 荷载 / 钢束的显示与隐藏。
+
+    格式: ``dispctrl,<Object>,<Type>,<Number/Name...>,<0|1>``
+
+    Args:
+        eObject (str): 对象类型
+            * ``bc`` / ``boundary`` = 边界
+            * ``lg`` / ``load`` = 荷载
+            * ``td`` / ``tendon`` = 钢束
+        eType (str): 子类型
+            * 边界: ``all``, ``general``, ``mstslv``, ``release``, ``elstcspt``,
+              ``generalelstcspt``, ``rigid``, ``secfactor``
+            * 荷载: ``all``, ``gravity``, ``nforce``, ``line``, ``pointforce``,
+              ``pointmoment``, ``displacement``, ``initial``, ``utemp``, ``gtemp``,
+              ``pst``, ``cforce``, ``elementsurface``
+            * 钢束: 通常为 ``all``
+        ids: 编号或名称
+            * ``all`` = 全部
+            * 单个编号 / 名称，或多个组成的序列（如 ``[1, 2, "3to10"]``、``["T1", "T2"]``）
+        bShow (int): ``0`` = 隐藏，``1`` = 显示
+
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+
+    Examples:
+        >>> # 显示全部边界
+        >>> osis_disp_ctrl("bc", "all", "all", 1)
+        >>> # 显示一般边界 1、2、3to10
+        >>> osis_disp_ctrl("bc", "general", [1, 2, "3to10"], 1)
+        >>> # 显示全部节点力荷载
+        >>> osis_disp_ctrl("lg", "nforce", "all", 1)
+        >>> # 显示名为 DeadLoad 的荷载
+        >>> osis_disp_ctrl("lg", "all", "DeadLoad", 1)
+        >>> # 隐藏钢束 1、2、3to10
+        >>> osis_disp_ctrl("td", "all", [1, 2, "3to10"], 0)
+        >>> # 显示钢束 T1、T2
+        >>> osis_disp_ctrl("td", "all", ["T1", "T2"], 1)
+    """
+    pass
+
+
+@REGISTRY.register("/control")
+def osis_control(
+    eAction: str,
+    eArg: str | None = None,
+):
+    """视图 / 界面控制命令。
+
+    格式: ``/control,<Action>[,<Arg>]``
+
+    Args:
+        eAction (str): 子命令
+            * ``view`` = 切换视图方向（配合 eArg）
+            * 其他如 ``quickCreateModel`` 等
+        eArg (str | None): 子命令参数
+            * 当 eAction 为 ``view`` 时: ``standard`` / ``top`` / ``right`` / ``front``
+
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+
+    Examples:
+        >>> osis_control("view", "standard")
+        >>> osis_control("view", "top")
+        >>> osis_control("view", "right")
+        >>> osis_control("view", "front")
+    """
+    pass
+
+
+@REGISTRY.register("Plsm")
+def osis_plsm(bFlag: Literal[0, 1] = 1):
+    """显示开关（Plsm）。
+
+    格式: ``plsm,<0|1>``
+
+    Args:
+        bFlag (int): ``0`` = 关，``1`` = 开
+
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+
+    Examples:
+        >>> osis_plsm(1)
+        >>> osis_plsm(0)
+    """
+    pass

osis_python-0.5.3/src/pyosis/display/manager.py

@@ -0,0 +1,115 @@
+"""显示管理器 - 控制显隐、视图方向与显示开关
+
+设计理念：
+- 隐藏底层命令接口细节，提供原生 Python 风格 API
+- 无状态设计，操作直接提交到 OSIS
+
+用法:
+    >>> from pyosis.display import display_manager
+    >>> display_manager.disp_ctrl("bc", "all", "all", 1)
+    >>> display_manager.set_view("top")
+    >>> display_manager.set_plsm(1)
+"""
+
+from __future__ import annotations
+
+from typing import Literal, Sequence, Union
+
+from .interface import osis_control, osis_disp_ctrl, osis_plsm
+
+
+class DisplayManager:
+    """显示管理器
+
+    控制边界 / 荷载 / 钢束显隐、视图方向与显示开关。
+    """
+
+    def disp_ctrl(
+        self,
+        obj: Literal["bc", "boundary", "lg", "load", "td", "tendon"],
+        type: str,
+        ids: Union[str, int, Sequence[Union[str, int]]],
+        show: Literal[0, 1] = 1,
+    ) -> None:
+        """控制边界 / 荷载 / 钢束的显示与隐藏。
+
+        Args:
+            obj: 对象类型
+                * ``bc`` / ``boundary`` = 边界
+                * ``lg`` / ``load`` = 荷载
+                * ``td`` / ``tendon`` = 钢束
+            type: 子类型（``all`` 或具体类型，见 ``osis_disp_ctrl`` 文档）
+            ids: 编号或名称（``all`` / 单个 / 序列）
+            show: ``0`` = 隐藏，``1`` = 显示
+
+        Raises:
+            RuntimeError: 操作失败时抛出异常
+
+        Examples:
+            >>> display_manager.disp_ctrl("bc", "all", "all", 1)
+            >>> display_manager.disp_ctrl("bc", "general", [1, 2, "3to10"], 1)
+            >>> display_manager.disp_ctrl("lg", "nforce", "all", 1)
+            >>> display_manager.disp_ctrl("td", "all", ["T1", "T2"], 1)
+        """
+        ok, err = osis_disp_ctrl(obj, type, ids, show)
+        if not ok:
+            raise RuntimeError(f"显示控制失败: {err}")
+
+    def control(self, action: str, arg: str | None = None) -> None:
+        """视图 / 界面控制（对应 ``/control,...``）。
+
+        Args:
+            action: 子命令，如 ``view``、``quickCreateModel``
+            arg: 子命令参数；``view`` 时为 ``standard`` / ``top`` / ``right`` / ``front``
+
+        Raises:
+            RuntimeError: 操作失败时抛出异常
+        """
+        ok, err = osis_control(action, arg)
+        if not ok:
+            raise RuntimeError(f"界面控制失败: {err}")
+
+    def set_view(
+        self,
+        view: Literal["standard", "top", "right", "front"] = "standard",
+    ) -> None:
+        """切换视图方向。
+
+        Args:
+            view: ``standard`` / ``top`` / ``right`` / ``front``
+
+        Raises:
+            RuntimeError: 操作失败时抛出异常
+
+        Examples:
+            >>> display_manager.set_view("top")
+            >>> display_manager.set_view("front")
+        """
+        self.control("view", view)
+
+    def set_plsm(self, enabled: Literal[0, 1] = 1) -> None:
+        """显示开关（Plsm）。
+
+        Args:
+            enabled: ``0`` = 关，``1`` = 开
+
+        Raises:
+            RuntimeError: 操作失败时抛出异常
+
+        Examples:
+            >>> display_manager.set_plsm(1)
+            >>> display_manager.set_plsm(0)
+        """
+        ok, err = osis_plsm(enabled)
+        if not ok:
+            raise RuntimeError(f"设置 Plsm 失败: {err}")
+
+    def __repr__(self) -> str:
+        return "DisplayManager()"
+
+
+# ═════════════════════════════════════════════
+# 全局单例
+# ═════════════════════════════════════════════
+
+display_manager = DisplayManager()

{osis_python-0.5.1 → osis_python-0.5.3}/src/pyosis/dynamic/manager.py

@@ -579,7 +579,7 @@ class RspecAnalManager:
 
     def _load(self) -> list[RspecAnal]:
         """从服务端加载所有反应谱工况信息"""
-        resp = osis_client("GetAllSeisRespSpecInfo", {})
+        resp = osis_client("GetAllRespSpecInfo", {})
         if not resp['success']:
             raise RuntimeError(f"{resp['error']}")
         rsp = [RspecAnal._from_dict(d) for d in resp.get("data", [])]
@@ -594,7 +594,7 @@ class RspecAnalManager:
             names = [str(name)]
         if not isinstance(names, list):
             raise TypeError(f"不支持的名称类型: {type(name)}")
-        resp = osis_client("GetSeisRespSpecByNames", {"name": names})
+        resp = osis_client("GetRespSpecInfoByNames", {"name": names})
         if not resp['success']:
             raise RuntimeError(f"{resp['error']}")
         rsp = [RspecAnal._from_dict(d) if d else None for d in resp.get("data", [])]

{osis_python-0.5.1 → osis_python-0.5.3}/src/pyosis/element/manager.py

@@ -15,6 +15,7 @@ from dataclasses import dataclass, field
 from typing import Any, Literal
 from enum import Enum
 from ..core.client import osis_client
+from ..core import get_references, raise_if_occupied
 from .interface import (
     osis_element_beam3d,
     osis_element_truss,
@@ -555,6 +556,10 @@ class ElementManager:
         ele_no = [ele.no for ele in elements]
         return max(ele_no) + 1
 
+    def get_dependencies(self, no: int) -> dict[str, list]:
+        """查询单元被谁引用"""
+        return get_references("Element", no=no)
+
     # ── 增删改 ────────────────────────────────
     def create(self, no: int | None, type: str, *args: Any, **kwargs: Any) -> Element:
         """创建单元（便捷入口，内部转发到对应 create_* 方法）
@@ -699,7 +704,14 @@ class ElementManager:
         return self.get(no)
 
     def delete(self, no: int) -> None:
-        """删除单元"""
+        """删除单元
+
+        Raises:
+            DependencyError: 存在依赖项时
+            RuntimeError: 删除失败时抛出异常
+        """
+        deps = self.get_dependencies(no)
+        raise_if_occupied("Element", deps, no=no)
         ok, err = osis_element_del(no)
         if not ok:
             raise RuntimeError(f"删除单元 {no} 失败: {err}")