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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: osis-python
-Version: 0.5.1
+Version: 0.5.2
 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.2/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.2
 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.2}/src/osis_python.egg-info/SOURCES.txt

@@ -23,6 +23,8 @@ 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/dynamic/__init__.py
 src/pyosis/dynamic/load_to_mass.py
@@ -104,4 +106,5 @@ 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

{osis_python-0.5.1 → osis_python-0.5.2}/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.2"
 __author__ = "CCCC Highway Consultant Co. Ltd." # 中交公路规划设计院 - 工程技术研究中心 - lzh - wjh - myf
 
 from .core.engine import OSISEngine

{osis_python-0.5.1 → osis_python-0.5.2}/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.2}/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.2}/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.2}/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.2}/src/pyosis/core/engine.py

@@ -69,7 +69,7 @@ class OSISEngine:
         - tendon:    钢束管理器（含 prop/shape 子管理器）
         - live:      活载管理器（含 grade/lane/case 子管理器）
         - geometry:  几何管理器（三维样条曲线）
-        - property:  属性管理器（坐标系、收缩徐变、阻尼等）
+        - prop:      属性管理器（property 坐标系、收缩徐变、阻尼等）
         - thickness: 厚度管理器（壳厚度特性）
         - control:   控制管理器（全局参数、分析设置）
         - project:   项目管理器（创建、打开、保存项目）
@@ -246,9 +246,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}")
 

osis_python-0.5.2/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.2/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.1 → osis_python-0.5.2}/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.2}/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}")

{osis_python-0.5.1 → osis_python-0.5.2}/src/pyosis/general/interface.py

@@ -1,6 +1,6 @@
 from typing import Any, Dict, Literal, List, Union, Sequence
 from ..core import REGISTRY, osis_run
-from ..core.client import osis_client
+from ..core.client import DEFAULT_SOLVE_TIMEOUT, osis_client
 
 def osis_matrix(matrix_name: str, matrix_data: Union[List, int, float, str]):
     """
@@ -11,7 +11,7 @@ def osis_matrix(matrix_name: str, matrix_data: Union[List, int, float, str]):
         matrix_data: 任意维度的列表（1维/2维/3维/...）或单个数值（0维）
     
     Returns:
-        OSIS DSL格式的字符串（拼接后的完整命令）
+        tuple (bool, str): 是否成功，失败原因
     
     Example:
         >>> # 2维矩阵示例
@@ -92,14 +92,10 @@ def osis_matrix(matrix_name: str, matrix_data: Union[List, int, float, str]):
                 new_indices = indices + [idx]
                 generate_assignments(elem, new_indices)
         else:
-            # 处理数值赋值
             value = data
-            
-            # 格式化数值
-            if isinstance(value, int) or isinstance(value, float):
+            if isinstance(value, (int, float)):
                 val_str = str(value)
             else:
-                # 其他类型尝试转为string
                 val_str = f"\"{value}\""
             idx_parts = list(indices)
             if not is_charn:
@@ -107,17 +103,11 @@ def osis_matrix(matrix_name: str, matrix_data: Union[List, int, float, str]):
                     idx_parts.append(0)
             idx_str = ",".join(map(str, idx_parts))
             assign_cmd = f"{matrix_name}[{idx_str}] = {val_str}"
-            # _log(assign_cmd)
-            # osis_run(assign_cmd, "stash")
             all_cmds.append(assign_cmd)
-    
-    # 开始递归生成赋值语句（OSIS索引从0开始）
+
     generate_assignments(matrix_data, [])
-    # osis_run()
-    # 返回拼接后的完整命令字符串
-    # str_cmds = "\n".join(all_cmds)
+
     str_cmds = ";".join(all_cmds)
-    # _log(str_cmds)
     return osis_run(str_cmds, "exec")
 
 def output_result_for_calc_book():
@@ -154,12 +144,18 @@ def osis_clc():
     """
     pass
 
-@REGISTRY.register("Solve")
-def osis_solve():
+def osis_solve(timeout: float | None = None):
     """
     求解工程
-    
+
+    Args:
+        timeout: HTTP 超时秒数，默认 600（10 分钟）
+
     Returns:
         tuple (bool, str): 是否成功，失败原因
     """
-    pass
+    return osis_run(
+        "Solve;",
+        "exec",
+        timeout=timeout if timeout is not None else DEFAULT_SOLVE_TIMEOUT,
+    )

{osis_python-0.5.1 → osis_python-0.5.2}/src/pyosis/geometry/manager.py

@@ -19,6 +19,7 @@ from enum import Enum
 from typing import Literal, Any
 
 from ..core.client import osis_client
+from ..core import get_references, raise_if_occupied
 from .interface import (
     osis_spline3d_general,
     osis_spline3d_natural,
@@ -286,6 +287,10 @@ class GeometryManager:
             raise RuntimeError(f"创建3D圆弧 {name} 失败: {err}")
         return self.get(name)
 
+    def get_dependencies(self, name: str) -> dict[str, list]:
+        """查询几何样条被谁引用"""
+        return get_references("Spline", name=name)
+
     def delete(self, name: str) -> None:
         """删除三维样条曲线
 
@@ -293,8 +298,11 @@ class GeometryManager:
             name: 曲线名称
 
         Raises:
+            DependencyError: 存在依赖项时
             RuntimeError: 删除失败时抛出异常
         """
+        deps = self.get_dependencies(name)
+        raise_if_occupied("Spline", deps, name=name)
         ok, err = osis_spline3d_del(name)
         if not ok:
             raise RuntimeError(f"删除样条曲线 {name} 失败: {err}")

{osis_python-0.5.1 → osis_python-0.5.2}/src/pyosis/live/manager.py

@@ -17,6 +17,7 @@ from dataclasses import dataclass, field
 from typing import Literal, Any
 
 from ..core.client import osis_client
+from ..core import get_references, raise_if_occupied
 from .grade import (
     osis_livegrade_highway,
     osis_livegrade_vehicle,
@@ -499,6 +500,10 @@ class LiveGradeManager:
         ]
         return grades
 
+    def get_dependencies(self, name: str) -> dict[str, list]:
+        """查询活载等级被谁引用"""
+        return get_references("LiveGrade", name=name)
+
     def create(
             self,
             name: str,
@@ -713,8 +718,11 @@ class LiveGradeManager:
             name: 活载等级名称
 
         Raises:
+            DependencyError: 存在依赖项时
             RuntimeError: 删除失败时抛出异常
         """
+        deps = self.get_dependencies(name)
+        raise_if_occupied("LiveGrade", deps, name=name)
         ok, err = osis_livegrade_del(name)
         if not ok:
             raise RuntimeError(f"删除活载等级 {name} 失败: {err}")
@@ -815,6 +823,10 @@ class LaneManager:
         ]
         return lanes
 
+    def get_dependencies(self, name: str) -> dict[str, list]:
+        """查询车道被谁引用"""
+        return get_references("LiveLane", name=name)
+
     def create(
         self,
         name: str,
@@ -966,8 +978,11 @@ class LaneManager:
             name: 车道名称
 
         Raises:
+            DependencyError: 存在依赖项时
             RuntimeError: 删除失败时抛出异常
         """
+        deps = self.get_dependencies(name)
+        raise_if_occupied("LiveLane", deps, name=name)
         ok, err = osis_lane_del(name)
         if not ok:
             raise RuntimeError(f"删除车道 {name} 失败: {err}")

{osis_python-0.5.1 → osis_python-0.5.2}/src/pyosis/load/manager.py

@@ -17,6 +17,7 @@ from typing import Literal, Any
 from enum import Enum
 
 from ..core.client import osis_client
+from ..core import get_references, raise_if_occupied
 from .loadcase import (
     osis_loadcase,
     osis_loadcase_del,
@@ -38,6 +39,7 @@ from .tendon import (
     osis_tendon_shape_mod,
     osis_layout_tendons,
     osis_wipe_tendons,
+    osis_bottom_tendons,
 )
 from .static import (
     osis_load_gravity,
@@ -860,6 +862,17 @@ class TendonShape:
         if not ok:
             raise RuntimeError(f"擦除钢束 {self.name} 失败: {err}")
 
+    def bottom(self, b_bot: int, *bot: int) -> None:
+        """定义是否沿梁单元底板布置钢束形状
+
+        Args:
+            b_bot: 0=不沿底板布置，1=沿底板布置
+            *bot: 底板布置对应的样条曲线行号，数量不限（Bot_i, Bot_j, ...）
+        """
+        ok, err = osis_bottom_tendons(self.name, b_bot, *bot)
+        if not ok:
+            raise RuntimeError(f"设置钢束 {self.name} 底板布置失败: {err}")
+
     def rename(self, new_name: str) -> None:
         """重命名钢束形状
 
@@ -897,6 +910,10 @@ class TendonPropManager:
         ]
         return props
 
+    def get_dependencies(self, name: str) -> dict[str, list]:
+        """查询钢束特性被谁引用"""
+        return get_references("TendonProp", name=name)
+
     def create(
         self,
         name: str,
@@ -1207,8 +1224,11 @@ class TendonPropManager:
             name: 钢束特性名称
 
         Raises:
+            DependencyError: 存在依赖项时
             RuntimeError: 删除失败时抛出异常
         """
+        deps = self.get_dependencies(name)
+        raise_if_occupied("TendonProp", deps, name=name)
         ok, err = osis_tendon_prop_del(name)
         if not ok:
             raise RuntimeError(f"删除钢束特性 {name} 失败: {err}")
@@ -1308,6 +1328,10 @@ class TendonShapeManager:
         ]
         return shapes
 
+    def get_dependencies(self, name: str) -> dict[str, list]:
+        """查询钢束形状被谁引用"""
+        return get_references("TendonShape", name=name)
+
     def create(
         self,
         name: str,
@@ -1463,8 +1487,11 @@ class TendonShapeManager:
             name: 钢束形状名称
 
         Raises:
+            DependencyError: 存在依赖项时
             RuntimeError: 删除失败时抛出异常
         """
+        deps = self.get_dependencies(name)
+        raise_if_occupied("TendonShape", deps, name=name)
         ok, err = osis_tendon_shape_del(name)
         if not ok:
             raise RuntimeError(f"删除钢束形状 {name} 失败: {err}")
@@ -1628,6 +1655,10 @@ class LoadCaseManager:
         ]
         return loadcases
 
+    def get_dependencies(self, name: str) -> dict[str, list]:
+        """查询荷载工况被谁引用"""
+        return get_references("LoadCase", name=name)
+
     # ── 增删改 ────────────────────────────────
 
     def create(
@@ -1690,8 +1721,11 @@ class LoadCaseManager:
             name: 荷载工况名称
 
         Raises:
+            DependencyError: 存在依赖项时
             RuntimeError: 删除失败时抛出异常
         """
+        deps = self.get_dependencies(name)
+        raise_if_occupied("LoadCase", deps, name=name)
         ok, err = osis_loadcase_del(name)
         if not ok:
             raise RuntimeError(f"删除荷载工况 {name} 失败: {err}")

{osis_python-0.5.1 → osis_python-0.5.2}/src/pyosis/load/tendon.py

@@ -328,3 +328,21 @@ def osis_wipe_tendons(strShapeName: str):
         tuple (bool, str): 是否成功，失败原因
     '''
     pass
+
+@REGISTRY.register("BottomTS")
+def osis_bottom_tendons(TdShapeName: str, bBot: int, *Bot: int):
+    '''
+    定义是否沿梁单元底板布置钢束形状
+
+    Args:
+        TdShapeName (str): 钢束形状名称
+        bBot (int): 是否沿底板布置
+            * 0 = 不沿底板布置
+            * 1 = 沿底板布置
+        *Bot (int): 底板布置钢束对应的样条曲线行号，数量不限
+            （如 Bot_i, Bot_j, Bot_k, ...）
+
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    '''
+    pass

{osis_python-0.5.1 → osis_python-0.5.2}/src/pyosis/material/manager.py

@@ -23,7 +23,7 @@ from .interface import (
     osis_material_del,
     osis_material_mod,
 )
-
+from ..core import get_references, raise_if_occupied
 
 # ──────────────────────────────────────────────
 # 数据类
@@ -118,6 +118,10 @@ class MaterialManager:
 
         return materials
 
+    def get_dependencies(self, no: int) -> dict[str, list]:
+        """查询材料被谁引用"""
+        return get_references("Material", no=no)
+
     def _next_no(self) -> int:
         """生成下一个可用材料编号
 
@@ -342,8 +346,11 @@ class MaterialManager:
             no: 材料编号
 
         Raises:
+            DependencyError: 存在依赖项时（force=False 才会抛）
             RuntimeError: 删除失败时抛出异常
         """
+        deps = self.get_dependencies(no)
+        raise_if_occupied("Material", deps, no=no)
         ok, err = osis_material_del(no)
         if not ok:
             raise RuntimeError(f"删除材料 {no} 失败: {err}")