osis-python 0.6.3__tar.gz → 0.6.5__tar.gz

{osis_python-0.6.3/src/osis_python.egg-info → osis_python-0.6.5}/PKG-INFO

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

{osis_python-0.6.3 → osis_python-0.6.5/src/osis_python.egg-info}/PKG-INFO

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

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

{osis_python-0.6.3 → osis_python-0.6.5}/src/pyosis/core/build.py

@@ -533,8 +533,8 @@ SECTION_TYPE_MAP = {
     "LSHAPE": "create_Lshape",
     "TSHAPE": "create_Tshape",
     "ROUNDEDEND": "create_rounded_end",
-    "STEELI": "create_steel_i",
-    "STEELBOX": "create_steel_box",
+    "STEELBEAMI": "create_steel_i",
+    "STEELBEAMBOX": "create_steel_box",
     "STEELBOXTHREECELL": "create_steel_box_three_cell",
     "STEELBOXITF": "create_steel_box_itf",
     "STEELCANTIBOX": "create_steel_canti_box",

{osis_python-0.6.3 → osis_python-0.6.5}/src/pyosis/display/interface.py

@@ -60,6 +60,7 @@ def osis_disp_ctrl(
 def osis_control(
     eAction: str,
     eArg: str | None = None,
+    *dValues,
 ):
     """视图 / 界面控制命令。
 
@@ -70,7 +71,9 @@ def osis_control(
             * ``view`` = 切换视图方向（配合 eArg）
             * 其他如 ``quickCreateModel`` 等
         eArg (str | None): 子命令参数
-            * 当 eAction 为 ``view`` 时: ``standard`` / ``top`` / ``right`` / ``front``
+            * 当 eAction 为 ``view`` 时: ``standard`` / ``top`` / ``right`` /
+              ``front`` / ``zoom`` / ``move``
+        dValues: 附加参数
 
     Returns:
         tuple (bool, str): 是否成功，失败原因
@@ -80,6 +83,7 @@ def osis_control(
         >>> osis_control("view", "top")
         >>> osis_control("view", "right")
         >>> osis_control("view", "front")
+        >>> osis_control("view", "zoom", 0.8)
     """
     pass
 
@@ -101,3 +105,24 @@ def osis_plsm(bFlag: Literal[0, 1] = 1):
         >>> osis_plsm(0)
     """
     pass
+
+@REGISTRY.register("jpeg")
+def osis_jpeg(path: str = "image"):
+    """截图工具。
+
+    格式: ``jpeg,path``
+
+    Args:
+        path (str): 图片保存路径/文件名。文件扩展名固定为 ``.jpg``。
+            当仅传入文件名（不含目录分隔符）时，图片默认保存到
+            ``<project_dir>/image/{path}.jpg``；
+            传入完整路径（如 ``D:\\reports\\fig1``）则保存到对应位置。
+
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+
+    Examples:
+        >>> osis_jpeg("IMG_盖梁裂缝宽度计算结果图")
+        >>> osis_jpeg(r"D:\\reports\\fig1")
+    """
+    pass

{osis_python-0.6.3 → osis_python-0.6.5}/src/pyosis/display/manager.py

@@ -15,7 +15,7 @@ from __future__ import annotations
 
 from typing import Literal, Sequence, Union
 
-from .interface import osis_control, osis_disp_ctrl, osis_plsm
+from .interface import osis_control, osis_disp_ctrl, osis_plsm, osis_jpeg
 
 
 class DisplayManager:
@@ -55,28 +55,45 @@ class DisplayManager:
         if not ok:
             raise RuntimeError(f"显示控制失败: {err}")
 
-    def control(self, action: str, arg: str | None = None) -> None:
+    def control(self, action: str, arg: str | None = None, *values) -> None:
         """视图 / 界面控制（对应 ``/control,...``）。
 
         Args:
             action: 子命令，如 ``view``、``quickCreateModel``
-            arg: 子命令参数；``view`` 时为 ``standard`` / ``top`` / ``right`` / ``front``
+            arg: 子命令参数；``view`` 时为 ``standard`` / ``top`` / ``right`` /
+                ``front`` / ``zoom`` / ``move``
+            *values: 附加参数。``view`` 子命令下：
+                * ``zoom``: 缩放系数（值越小模型越小）
+                * ``move``: (x, y) 像素偏移
 
         Raises:
             RuntimeError: 操作失败时抛出异常
+
+        Examples:
+            >>> display_manager.control("view", "top")
+            >>> display_manager.control("view", "zoom", 0.8)
+            >>> display_manager.control("view", "move", 30, 10)
         """
-        ok, err = osis_control(action, arg)
+        ok, err = osis_control(action, arg, *values)
         if not ok:
             raise RuntimeError(f"界面控制失败: {err}")
 
     def set_view(
         self,
-        view: Literal["standard", "top", "right", "front"] = "standard",
+        view: Literal["standard", "top", "right", "front", "zoom", "move"] = "standard",
+        *values,
     ) -> None:
         """切换视图方向。
 
         Args:
-            view: ``standard`` / ``top`` / ``right`` / ``front``
+            view: 视图
+                * ``standard``: 标准视图
+                * ``top``: 俯视
+                * ``right``: 右视
+                * ``front``: 前视
+                * ``zoom``: 缩放（附加系数：值越小模型越小）
+                * ``move``: 平移（附加参数：x, y）
+            *values: ``zoom`` 时为缩放系数，``move`` 时为 x, y 像素偏移
 
         Raises:
             RuntimeError: 操作失败时抛出异常
@@ -84,8 +101,10 @@ class DisplayManager:
         Examples:
             >>> display_manager.set_view("top")
             >>> display_manager.set_view("front")
+            >>> display_manager.set_view("zoom", 0.8)
+            >>> display_manager.set_view("move", 30, 10)
         """
-        self.control("view", view)
+        self.control("view", view, *values)
 
     def set_plsm(self, enabled: Literal[0, 1] = 1) -> None:
         """显示开关（Plsm）。
@@ -104,6 +123,28 @@ class DisplayManager:
         if not ok:
             raise RuntimeError(f"设置 Plsm 失败: {err}")
 
+    def capture(self, path: str) -> None:
+        """截图工具（对应 ``jpeg,...``）。
+
+        把当前画面截图保存到 ``path``。文件扩展名固定为 ``.jpg``。
+        若仅传入文件名（不含目录分隔符），图片默认保存到
+        ``<project_dir>/image/{path}.jpg``；传入完整路径则保存到对应位置。
+
+        Args:
+            path: 图片保存路径或文件名
+
+        Raises:
+            RuntimeError: 截图失败时抛出异常
+
+        Examples:
+            >>> display_manager.capture("D:\\reports\\fig1.jpg")
+            >>> display_manager.capture("crack.jpg")    # 保存到 <project_dir>/image/crack.jpg
+            >>> display_manager.capture("crack")        # 保存到 <project_dir>/image/crack.jpg
+        """
+        ok, err = osis_jpeg(path)
+        if not ok:
+            raise RuntimeError(f"截图失败: {err}")
+
     def __repr__(self) -> str:
         return "DisplayManager()"
 

{osis_python-0.6.3 → osis_python-0.6.5}/src/pyosis/load/manager.py

@@ -7,7 +7,7 @@
 
 支持的荷载类型：
 - 荷载工况（USER, D, DC, DW, DD, CS）
-- 静力荷载（自重、节点荷载、线荷载、面荷载、强迫位移、初始内力、温度荷载、预应力、索力）
+- 静力荷载（自重、节点荷载、线荷载、面荷载、平面荷载、强迫位移、初始内力、温度荷载、预应力、索力）
 """
 
 from __future__ import annotations
@@ -54,11 +54,45 @@ from .static import (
     osis_load_gtemp,
     osis_load_pst,
     osis_load_cforce,
+    osis_load_plane,
+    osis_planar_load_point,
+    osis_planar_load_line,
+    osis_planar_load_area,
+    osis_planar_load_copy,
     osis_load_del,
     osis_load_mod,
 )
 
 
+# ──────────────────────────────────────────────
+# 内部工具
+# ──────────────────────────────────────────────
+
+def _flatten_params(items: list | None, size: int, label: str) -> list:
+    """将平铺列表或分组列表统一展平（内部使用）
+
+    items 既支持 [v1, v2, v3, ...] 平铺形式，也支持 [[v1, v2, v3], ...] 分组形式，
+    每组必须包含 size 个参数，返回展平后的列表。
+
+    Raises:
+        ValueError: 分组内参数数量不为 size 或平铺数量不是 size 的整数倍
+    """
+    if not items:
+        return []
+    # 分组形式：元素为 list/tuple
+    if any(isinstance(it, (list, tuple)) for it in items):
+        flat = []
+        for it in items:
+            if not isinstance(it, (list, tuple)) or len(it) != size:
+                raise ValueError(f"{label} 必须按每组 {size} 个参数填入，当前为 {it!r}")
+            flat.extend(it)
+        return flat
+    # 平铺形式
+    if len(items) % size != 0:
+        raise ValueError(f"{label} 必须按每组 {size} 个参数平铺填入，当前数量为 {len(items)}")
+    return list(items)
+
+
 # ──────────────────────────────────────────────
 # 数据类
 # ──────────────────────────────────────────────
@@ -216,6 +250,7 @@ class LoadCase:
             CONCENTRATED -> create_concentrated_force
             SURFACE      -> create_surface_load
             SURFACE_VEC  -> create_surface_load_vector
+            PLANE        -> create_plane_load
             PTF/PTM      -> create_concentrated_force (is_moment)
 
         Args:
@@ -245,6 +280,7 @@ class LoadCase:
             # "PTM":          self.create_concentrated_force,
             "SURFACE":      self.create_surface_load,
             "SURFACE_VEC":  self.create_surface_load_vector,
+            "PLANE":        self.create_plane_load,
         }
         type_key = type.strip().upper()
 
@@ -735,6 +771,78 @@ class LoadCase:
             )
         return self.refresh()
 
+    def create_plane_load(
+            self,
+            planar_load_name: str,
+            elem_type: str,
+            p1: tuple[float, float, float] = (0.0, 0.0, 0.0),
+            p2: tuple[float, float, float] = (1.0, 0.0, 0.0),
+            p3: tuple[float, float, float] = (0.0, 1.0, 0.0),
+            tolerance: float = 0.0,
+            load_position: Literal[0, 1] = 1,
+            elem_group: str = "",
+            load_surface: str = "",
+            direction: Literal["SurfaceN", "ElementN", "GlobalX", "GlobalY", "GlobalZ"] = "SurfaceN",
+            projection: Literal["NoProjection", "LoadDir", "LoadPlane"] = "NoProjection",
+            copy_op: Literal[0, 1] = 0,
+            copy_dir: Literal["X", "Y", "Z"] = "X",
+            copies: list | None = None,
+    ) -> LoadCase:
+        '''布置平面荷载（需先由 osis_planar_load_* 定义平面荷载）
+
+        Args:
+            planar_load_name (str): 定义的平面荷载名称，由 PlanarLoad 定义
+            elem_type (str): 要加载平面荷载的单元类型
+            p1 (tuple): 加载平面原点在整体坐标系中的坐标 (x, y, z)
+            p2 (tuple): 平面坐标系x轴上的任意点在整体坐标系中的坐标 (x, y, z)
+            p3 (tuple): 平面坐标系x-y平面上任意点在整体坐标系中的坐标 (x, y, z)
+            tolerance (float): 决定平面坐标系坐标的容许误差
+            load_position (int): 加载对象
+                * 1 = 加载平面上的单元
+                * 0 = 单元组
+            elem_group (str): 单元组名称，load_position = 0 时必填
+            load_surface (str): 实体单元加载面（1~6），平面单元无用填 ""
+            direction (str): 平面荷载加载方向
+                * SurfaceN = 法向（加载平面）
+                * ElementN = 法向（单元）
+                * GlobalX = 整体坐标系X
+                * GlobalY = 整体坐标系Y
+                * GlobalZ = 整体坐标系Z
+            projection (str): 投影选项
+                * NoProjection = 不投影
+                * LoadDir = 荷载方向
+                * LoadPlane = 加载平面
+            copy_op (int): 是否根据输入间距将平面荷载以相同大小复制到其他区域
+                * 1 = 复制
+                * 0 = 不复制
+            copy_dir (str): 复制方向，X、Y、Z
+            copies (list): 复制的次数与距离，支持两种形式：
+                * 分组：[[CopyCount1, CopyDistance1], ...]
+                * 平铺：[CopyCount1, CopyDistance1, ...]
+                每组包含2个参数：复制的次数, 复制的距离
+
+        Returns:
+            更新后的 LoadCase 对象
+
+        Raises:
+            ValueError: load_position = 0 未填 elem_group，或 copies 参数数量不成对
+            RuntimeError: 布置失败时抛出异常
+        '''
+        if load_position == 0 and not elem_group:
+            raise ValueError("load_position = 0（按单元组加载）时必须指定 elem_group")
+
+        flat_copies = _flatten_params(copies, 2, "copies") if copy_op == 1 else []
+
+        ok, err = osis_load_plane(
+            "Plane", self.name, planar_load_name, elem_type,
+            p1[0], p1[1], p1[2], p2[0], p2[1], p2[2], p3[0], p3[1], p3[2],
+            tolerance, load_position, elem_group, load_surface,
+            direction, projection, copy_op, copy_dir, flat_copies,
+        )
+        if not ok:
+            raise RuntimeError(f"布置平面荷载 {planar_load_name} 到工况 {self.name} 失败: {err}")
+        return self.refresh()
+
     # ── 荷载删除 ──────────────────────────────
 
     def delete(
@@ -1763,7 +1871,7 @@ class TendonManager:
 class LoadCaseManager:
     """荷载工况管理器
 
-    统一管理荷载工况的创建、删除、修改和查询。
+    统一管理荷载工况的创建、删除、修改和查询，兼平面荷载的定义（PlanarLoad）。
 
     用法:
         >>> from pyosis.load import loadcase_manager
@@ -1884,6 +1992,141 @@ class LoadCaseManager:
             raise RuntimeError(f"重命名荷载工况 {old_name} -> {new_name} 失败: {err}")
         return self.get(new_name)
 
+    # ── 平面荷载定义 ────────────────────────
+
+    def planar_load_point(self, name: str, description: str = "", points: list = None) -> str:
+        '''定义平面荷载（集中荷载）
+
+        Args:
+            name (str): 荷载名称
+            description (str): 荷载说明
+            points (list): 集中荷载的坐标与数值，支持两种形式：
+                * 分组：[[x1, y1, F1], [x2, y2, F2], ...]
+                * 平铺：[x1, y1, F1, x2, y2, F2, ...]
+                每组包含3个参数：x坐标, y坐标, 荷载数值，组数不限
+
+        Returns:
+            荷载名称字符串
+
+        Raises:
+            ValueError: points 为空或参数数量不符
+            RuntimeError: 创建失败时抛出异常
+        '''
+        flat = _flatten_params(points, 3, "points")
+        if not flat:
+            raise ValueError("points 不能为空，至少需要一组 [x, y, F]")
+        ok, err = osis_planar_load_point(name, description, "Point", flat)
+        if not ok:
+            raise RuntimeError(f"创建平面荷载（集中荷载）{name} 失败: {err}")
+        return name
+
+    def planar_load_line(
+            self,
+            name: str,
+            description: str = "",
+            uniform: Literal[0, 1] = 1,
+            force_type: Literal[0, 1] = 1,
+            x1: float = 0.0,
+            y1: float = 0.0,
+            f1: float = 100,
+            x2: float = 1.0,
+            y2: float = 0.0,
+            f2: float = 100,
+    ) -> str:
+        '''定义平面荷载（线荷载）
+
+        Args:
+            name (str): 荷载名称
+            description (str): 荷载说明
+            uniform (int): 1 = 均布荷载，0 = 非均布荷载
+            force_type (int): 1 = 力，0 = 弯矩
+            x1 (float): 线荷载起点的x坐标
+            y1 (float): 线荷载起点的y坐标
+            f1 (float): 线荷载起点的荷载数值
+            x2 (float): 线荷载终点的x坐标
+            y2 (float): 线荷载终点的y坐标
+            f2 (float): 线荷载终点的荷载数值
+
+        Returns:
+            荷载名称字符串
+
+        Raises:
+            RuntimeError: 创建失败时抛出异常
+        '''
+        ok, err = osis_planar_load_line(
+            name, description, "Line", uniform, force_type, x1, y1, f1, x2, y2, f2
+        )
+        if not ok:
+            raise RuntimeError(f"创建平面荷载（线荷载）{name} 失败: {err}")
+        return name
+
+    def planar_load_area(
+            self,
+            name: str,
+            description: str = "",
+            uniform: Literal[0, 1] = 1,
+            points: list = None,
+    ) -> str:
+        '''定义平面荷载（面荷载）
+
+        Args:
+            name (str): 荷载名称
+            description (str): 荷载说明
+            uniform (int): 1 = 均布荷载，0 = 非均布荷载
+            points (list): 面荷载各点处的坐标与数值（3点或4点），支持两种形式：
+                * 分组：[[x1, y1, F1], [x2, y2, F2], ...]
+                * 平铺：[x1, y1, F1, x2, y2, F2, ...]
+                每组包含3个参数：x坐标, y坐标, 荷载数值
+
+        Returns:
+            荷载名称字符串
+
+        Raises:
+            ValueError: points 点数不为 3 或 4，或参数数量不符
+            RuntimeError: 创建失败时抛出异常
+        '''
+        flat = _flatten_params(points, 3, "points")
+        n_point_num = len(flat) // 3
+        if n_point_num not in (3, 4):
+            raise ValueError(f"面荷载点数必须为 3 或 4，当前为 {n_point_num}")
+        ok, err = osis_planar_load_area(name, description, "Area", uniform, n_point_num, flat)
+        if not ok:
+            raise RuntimeError(f"创建平面荷载（面荷载）{name} 失败: {err}")
+        return name
+
+    def planar_load_copy(
+            self,
+            name: str,
+            direction: Literal["X", "Y"] = "X",
+            copies: list = None,
+    ) -> str:
+        '''复制平面荷载
+
+        Args:
+            name (str): 荷载名称
+            direction (str): 复制方向
+                * X
+                * Y
+            copies (list): 复制的次数与距离，支持两种形式：
+                * 分组：[[CopyCount1, CopyDistance1], ...]
+                * 平铺：[CopyCount1, CopyDistance1, ...]
+                每组包含2个参数：复制的次数, 复制的距离
+
+        Returns:
+            荷载名称字符串
+
+        Raises:
+            ValueError: copies 为空或参数数量不成对
+            RuntimeError: 复制失败时抛出异常
+        '''
+        flat = _flatten_params(copies, 2, "copies")
+        if not flat:
+            raise ValueError("copies 不能为空，至少需要一组 [次数, 距离]")
+        ok, err = osis_planar_load_copy(name, direction, flat)
+        if not ok:
+            raise RuntimeError(f"复制平面荷载 {name} 失败: {err}")
+        return name
+
     # ── 查询 ──────────────────────────────────
 
     def get(self, name: str | list[str]) -> LoadCase | list[LoadCase | None] | None:

{osis_python-0.6.3 → osis_python-0.6.5}/src/pyosis/load/static.py

@@ -370,6 +370,137 @@ def osis_load_cforce(eType: str="CFORCE", strLCName: str="自定义工况1", nEn
     '''
     pass
 
+@REGISTRY.register("PlanarLoad")
+def osis_planar_load_point(strName: str="平面荷载1", strDescription: str="", eType: Literal["Point"]="Point", points: list=None):
+    '''
+    创建或修改平面荷载（集中荷载）
+
+    Args:
+        strName (str): 荷载名称
+        strDescription (str): 荷载说明
+        eType (str): 荷载类型，不区分大小写。固定为 Point = 集中荷载
+        points (list): 集中荷载的坐标与数值，按顺序平铺填入：
+            [x1, y1, F1, x2, y2, F2, ...]
+            每组包含3个参数：x坐标, y坐标, 荷载数值，组数不限
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    '''
+    pass
+
+@REGISTRY.register("PlanarLoad")
+def osis_planar_load_line(strName: str="平面荷载1", strDescription: str="", eType: Literal["Line"]="Line",
+                          bUniform: Literal[0, 1]=1, bForceType: Literal[0, 1]=1,
+                          dX1: float=0.0, dY1: float=0.0, dF1: float=100,
+                          dX2: float=1.0, dY2: float=0.0, dF2: float=100):
+    '''
+    创建或修改平面荷载（线荷载）
+
+    Args:
+        strName (str): 荷载名称
+        strDescription (str): 荷载说明
+        eType (str): 荷载类型，不区分大小写。固定为 Line = 线荷载
+        bUniform (int): 1 = 均布荷载，0 = 非均布荷载
+        bForceType (int): 1 = 力，0 = 弯矩
+        dX1 (float): 线荷载起点的x坐标
+        dY1 (float): 线荷载起点的y坐标
+        dF1 (float): 线荷载起点的荷载数值
+        dX2 (float): 线荷载终点的x坐标
+        dY2 (float): 线荷载终点的y坐标
+        dF2 (float): 线荷载终点的荷载数值
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    '''
+    pass
+
+@REGISTRY.register("PlanarLoad")
+def osis_planar_load_area(strName: str="平面荷载1", strDescription: str="", eType: Literal["Area"]="Area",
+                          bUniform: Literal[0, 1]=1, nPointNum: Literal[3, 4]=3, points: list=None):
+    '''
+    创建或修改平面荷载（面荷载）
+
+    Args:
+        strName (str): 荷载名称
+        strDescription (str): 荷载说明
+        eType (str): 荷载类型，不区分大小写。固定为 Area = 面荷载
+        bUniform (int): 1 = 均布荷载，0 = 非均布荷载
+        nPointNum (int): 点数，3 = 3点，4 = 4点，其他输入非法
+        points (list): 面荷载各点处的坐标与数值，按顺序平铺填入：
+            [x1, y1, F1, x2, y2, F2, x3, y3, F3]（nPointNum = 3）
+            [x1, y1, F1, x2, y2, F2, x3, y3, F3, x4, y4, F4]（nPointNum = 4）
+            每组包含3个参数：x坐标, y坐标, 荷载数值
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    '''
+    pass
+
+@REGISTRY.register("PlanarLoadCopy")
+def osis_planar_load_copy(strName: str="平面荷载1", eDir: Literal["X", "Y"]="X", copies: list=None):
+    '''
+    复制平面荷载
+
+    Args:
+        strName (str): 荷载名称
+        eDir (str): 复制方向
+            * X
+            * Y
+        copies (list): 复制的次数与距离，按顺序平铺填入：
+            [CopyCount1, CopyDistance1, ..., CopyCountN, CopyDistanceN]
+            每组包含2个参数：复制的次数, 复制的距离
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    '''
+    pass
+
+@REGISTRY.register("Load")
+def osis_load_plane(eType: Literal["Plane"]="Plane", strLCName: str="自定义工况1", strPlanarLoadName: str="平面荷载1",
+                    strElemType: str="",
+                    dP1x: float=0.0, dP1y: float=0.0, dP1z: float=0.0,
+                    dP2x: float=1.0, dP2y: float=0.0, dP2z: float=0.0,
+                    dP3x: float=0.0, dP3y: float=1.0, dP3z: float=0.0,
+                    dTolerance: float=0.0,
+                    bLoadPosition: Literal[0, 1]=1, strElemGroup: str="", strLoadSurface: str="",
+                    eDir: Literal["SurfaceN", "ElementN", "GlobalX", "GlobalY", "GlobalZ"]="SurfaceN",
+                    eProjectionOp: Literal["NoProjection", "LoadDir", "LoadPlane"]="NoProjection",
+                    bCopyOp: Literal[0, 1]=0, eCopyDir: str="", copies: list=None):
+    '''
+    布置平面荷载
+
+    Args:
+        eType (str): 荷载类型，不区分大小写。固定为 Plane = 平面荷载
+        strLCName (str): 荷载工况名称
+        strPlanarLoadName (str): 定义的平面荷载名称，由 PlanarLoad 定义
+        strElemType (str): 要加载平面荷载的单元类型
+        dP1x/dP1y/dP1z (float): 加载平面原点P1在整体坐标系中的坐标
+        dP2x/dP2y/dP2z (float): 平面坐标系x轴上的任意点P2在整体坐标系中的坐标
+        dP3x/dP3y/dP3z (float): 平面坐标系x-y平面上任意点P3在整体坐标系中的坐标
+        dTolerance (float): 决定平面坐标系坐标的容许误差
+        bLoadPosition (int): 加载对象
+            * 1 = 加载平面上的单元
+            * 0 = 单元组
+        strElemGroup (str): 单元组名称，bLoadPosition = 0 时有效，无效时填 ""
+        strLoadSurface (str): 实体单元加载面（1~6），平面单元无用，填 ""
+        eDir (str): 平面荷载加载方向
+            * SurfaceN = 法向（加载平面）
+            * ElementN = 法向（单元）
+            * GlobalX = 整体坐标系X
+            * GlobalY = 整体坐标系Y
+            * GlobalZ = 整体坐标系Z
+        eProjectionOp (str): 投影选项
+            * NoProjection = 不投影
+            * LoadDir = 荷载方向
+            * LoadPlane = 加载平面
+        bCopyOp (int): 是否根据输入间距将平面荷载以相同大小复制到其他区域
+            * 1 = 复制
+            * 0 = 不复制
+        eCopyDir (str): 复制方向，X、Y、Z。bCopyOp = 0 时填 ""
+        copies (list): 复制的次数与距离，按顺序平铺填入：
+            [CopyCount1, CopyDistance1, ..., CopyCountN, CopyDistanceN]
+            每组包含2个参数：复制的次数, 复制的距离
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    '''
+    pass
+
 @REGISTRY.register("LoadDel")
 def osis_load_del(eType: Literal["GRAVITY", "NFORCE", "LINE", "DISPLACEMENT", "INITIAL", "UTEMP", "GTEMP", "PST", "CFORCE"]="NFORCE", strLCName: str="自定义工况1", entity: int|str=1):
     '''

{osis_python-0.6.3 → osis_python-0.6.5}/src/pyosis/property/component_thickness.py

@@ -9,7 +9,10 @@ def osis_assign_component_thickness(dThickness: float, strOp: Literal['a', 's',
 
     Args:
         dThickness (float): 构件理论厚度
-        strOp (str): 操作；a = 添加，s = 替换，r = 移除；
+        strOp (str): 操作
+            * a = 添加，再次调用会覆盖旧参数
+            * s = 替换
+            * r = 移除
         *strElem (str): 待分配单元的编号。注：定义、修改、删除 elem支持的格式：*to*
 
     Returns:

{osis_python-0.6.3 → osis_python-0.6.5}/src/pyosis/property/manager.py

@@ -890,11 +890,14 @@ class PropertyManager:
         Args:
             thickness (float): 构件理论厚度
             op (str): 操作
-                * a = 添加
+                * a = 添加，再次调用会覆盖旧参数
                 * s = 替换
                 * r = 移除
             *elems (str|int): 待分配单元的编号。定义、修改、删除 elem 支持的格式：*to*
 
+        Examples:
+            >>> assign_component_thickness(0.2, s, 1, 2, 3)     # 将 1 2 3号单元的厚度修改为 0.2
+
         Raises:
             RuntimeError: 分配失败时抛出
         '''

{osis_python-0.6.3 → osis_python-0.6.5}/src/pyosis/section/manager.py

@@ -100,8 +100,8 @@ class SectionType(Enum):
     RIBBEDSLAB = 13  # 肋板式
     CUSTOM = 14  # 常规自定义截面
 
-    STEELI = 21  # 工字钢梁截面
-    STEELBOX = 22  # 箱型钢梁截面
+    STEELBEAMI = 21  # 工字钢梁截面
+    STEELBEAMBOX = 22  # 箱型钢梁截面
     STEELBOXTHREECELL = 23  # 单箱单/三室钢梁截面
     STEELBOXITF = 24  # 单箱单室斜顶板钢梁界面
     STEELCANTIBOX = 25  # 悬臂单箱单/双室钢梁界面
@@ -112,9 +112,26 @@ class SectionType(Enum):
     COMPOSITESTEELI = 41  # 钢-工字型组合截面
     COMPOSITESTEELTROUGH = 42  # 钢-槽型组合截面
     COMPOSITESTEELBOX = 43  # 钢-箱型组合截面
-    COMPOSITECUSTOM = 44  # 自定义组合截面
 
-    NUMERICAL = 51  # 数值截面
+    COMPOSITECUSTOM = 61  # 自定义组合截面
+
+    NUMERICAL = 71  # 数值截面
+
+    BUDOUBLEANGLE = 81  # 双角钢截面
+    BUDOUBLEC = 82  # 双槽钢截面
+    BUDOUBLEH = 83  # 双H型钢截面
+    BUDOUBLECWEB1 = 84  # 双槽钢+腹板截面1
+    BUDOUBLECWEB2 = 85  # 双槽钢+腹板截面2
+    BUHWITHPLATES = 86  # H型钢+双板截面
+
+    STEELL = 100  # 型钢-L型
+    STEELC = 101  # 型钢-槽型
+    STEELI = 102  # 型钢-工字型
+    STEELBOX = 103  # 型钢-箱型
+    STEELT = 104  # 型钢-T型
+    STEELCC = 105  # 型钢-双C型
+    STEELCIRCULARHOLLOW = 106  # 型钢-圆管
+    STEELZ = 107  # 型钢-Z型
 
 @dataclass(frozen=False)
 class Rebar:
@@ -1105,7 +1122,7 @@ class SectionManager:
         Args:
             no: 截面编号，None 则自动分配
             name: 截面名称
-            type: OSIS 截面类型，如 "CIRCLE" / "RECT" / "STEELBOX" 等
+            type: OSIS 截面类型，如 "CIRCLE" / "RECT" / "STEELBEAMBOX" 等
             *args: 按位置传给对应 create_* 的参数
             **kwargs: 按关键字传给对应 create_* 的参数
         Raises:
@@ -1127,8 +1144,8 @@ class SectionManager:
             "TGIRDER": self.create_TGirder,
             "HOLLOWSLAB": self.create_hollowslab,
             "CUSTOM": self.create_custom,
-            "STEELI": self.create_steel_i,
-            "STEELBOX": self.create_steel_box,
+            "STEELBEAMI": self.create_steel_i,
+            "STEELBEAMBOX": self.create_steel_box,
             "STEELBOXTHREECELL": self.create_steel_box_three_cell,
             "STEELBOXITF": self.create_steel_box_itf,
             "STEELCANTIBOX": self.create_steel_canti_box,
@@ -1918,7 +1935,7 @@ class SectionManager:
         tw: float,
         web_rib_pos: Literal["Left", "Right", "Both"] = "Both",
     ) -> Section:
-        """创建工字形钢截面(STEELI)。
+        """创建工字钢梁截面(STEELBEAMI)。
 
         Args:
             no: 截面编号，不填则自动分配
@@ -1933,7 +1950,7 @@ class SectionManager:
         """
         if no is None:
             no = self._next_no()
-        ok, err = osis_section_steel_i(no, name, "STEELI", h, bt, bb, tt, tb, tw, web_rib_pos)
+        ok, err = osis_section_steel_i(no, name, "STEELBEAMI", h, bt, bb, tt, tb, tw, web_rib_pos)
         if not ok:
             raise RuntimeError(f"创建工字形钢截面 {no} 失败: {err}")
         return self.get(no)
@@ -1952,7 +1969,7 @@ class SectionManager:
         tw: float,
         same_layout: Literal[0, 1] = 1,
     ) -> Section:
-        """创建箱型钢截面(STEELBOX)。
+        """创建箱型钢梁截面(STEELBEAMBOX)。
 
         Args:
             no: 截面编号，不填则自动分配
@@ -1969,7 +1986,7 @@ class SectionManager:
         """
         if no is None:
             no = self._next_no()
-        ok, err = osis_section_steel_box(no, name, "STEELBOX", h, bt, bct, bb, bcb, tt, tb, tw, same_layout)
+        ok, err = osis_section_steel_box(no, name, "STEELBEAMBOX", h, bt, bct, bb, bcb, tt, tb, tw, same_layout)
         if not ok:
             raise RuntimeError(f"创建箱型钢截面 {no} 失败: {err}")
         return self.get(no)

{osis_python-0.6.3 → osis_python-0.6.5}/src/pyosis/section/steel.py

@@ -2,15 +2,15 @@ from typing import Any, Dict, Literal, List
 from ..core import REGISTRY
 
 @REGISTRY.register("Section")
-def osis_section_steel_i(Index: int, Name: str, Type: Literal["STEELI"], 
-                         H: float, Bt: float, Bb: float, Tt: float, Tb: float, Tw: float, 
+def osis_section_steel_i(Index: int, Name: str, Type: Literal["STEELBEAMI"],
+                         H: float, Bt: float, Bb: float, Tt: float, Tb: float, Tw: float,
                          WebRibPos: Literal["Left", "Right", "Both"]):
-    """定义或修改工字形截面。
+    """定义或修改工字钢梁截面。
 
     Args:
         Index (int): 编号。
         Name (str): 截面名。
-        Type (str): 截面类型，固定为 STEELI。
+        Type (str): 截面类型，固定为 STEELBEAMI。
         H (float): 梁高。
         Bt (float): 上翼缘宽度。
         Bb (float): 下翼缘宽度。
@@ -27,15 +27,15 @@ def osis_section_steel_i(Index: int, Name: str, Type: Literal["STEELI"],
     pass
 
 @REGISTRY.register("Section")
-def osis_section_steel_box(Index: int, Name: str, Type: Literal["STEELBOX"], 
-                           H: float, Bt: float, Bct: float, Bb: float, Bcb: float, 
+def osis_section_steel_box(Index: int, Name: str, Type: Literal["STEELBEAMBOX"],
+                           H: float, Bt: float, Bct: float, Bb: float, Bcb: float,
                            Tt: float, Tb: float, Tw: float, SameLayout: Literal[0, 1]):
-    """定义或修改箱型截面。
+    """定义或修改箱型钢梁截面。
 
     Args:
         Index (int): 编号。
         Name (str): 截面名。
-        Type (str): 截面类型，固定为 STEELBOX。
+        Type (str): 截面类型，固定为 STEELBEAMBOX。
         H (float): 梁高。
         Bt (float): 上翼缘宽度。
         Bct (float): 上翼缘悬出宽。