osis-python 0.4.1__tar.gz → 0.4.4__tar.gz

{osis_python-0.4.1/src/osis_python.egg-info → osis_python-0.4.4}/PKG-INFO

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

{osis_python-0.4.1 → osis_python-0.4.4/src/osis_python.egg-info}/PKG-INFO

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

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

{osis_python-0.4.1 → osis_python-0.4.4}/src/pyosis/boundary/interface.py

@@ -46,7 +46,7 @@ def osis_boundary_general(nBd: int, eBoundaryType: Literal["GENERAL"]="GENERAL",
     pass
 
 @REGISTRY.register("Boundary")
-def osis_boundary_master_slave(nBd: int, eBoundaryType: Literal["MSTSLV"]="MSTSLV", nNode: int = 1, bX: bool = 1, bY: bool = 1, bZ: bool = 1, bRX: bool = 1, bRY: bool = 1, bRZ: bool = 1):
+def osis_boundary_master_slave(nBd: int, eBoundaryType: Literal["MSTSLV"]="MSTSLV", nNode: int = 1, bX: bool = 1, bY: bool = 1, bZ: bool = 1, bRX: bool = 1, bRY: bool = 1, bRZ: bool = 1, bCoincident: Literal[0, 1] | None = 1):
     '''
     ## 定义或修改主从约束
     pyosis.boundary.osis_boundary_master_slave
@@ -61,6 +61,7 @@ def osis_boundary_master_slave(nBd: int, eBoundaryType: Literal["MSTSLV"]="MSTSL
         bRX (bool): 0 = 释放，1 = 约束
         bRY (bool): 0 = 释放，1 = 约束
         bRZ (bool): 0 = 释放，1 = 约束
+        bCoincident: 0 = 仅同位移约束，默认1,可缺省
     Returns:
         tuple (bool, str): 是否成功，失败原因
     '''
@@ -69,7 +70,7 @@ def osis_boundary_master_slave(nBd: int, eBoundaryType: Literal["MSTSLV"]="MSTSL
 @REGISTRY.register("Boundary")
 def osis_boundary_rigid(nBd: int, eBoundaryType: Literal["RIGID"], nNodeI: int):
     '''
-    ## 定义或修改主从约束
+    ## 定义或修改刚性连接
     
     Args:
         nBd (int): 编号
@@ -95,10 +96,10 @@ def osis_boundary_release(nBd: int, eBoundaryType: Literal["RELEASE"],
     
     Args:
         nBd (int): 编号
-        eBoundaryType (str): 固定为 MSTSLV
+        eBoundaryType (str): 固定为 RELEASE
         \\*_state (bool): 
-            * 0 = 释放
-            * 1 = 约束
+            * 0 = 完全释放
+            * 1 = 完全约束
         F\\*i and M\\*i (float): 部分约束的大小，0-1之间，表示释放后残余的约束能力的百分比
     Returns:
         tuple (bool, str): 是否成功，失败原因

{osis_python-0.4.1 → osis_python-0.4.4}/src/pyosis/boundary/manager.py

@@ -659,11 +659,12 @@ class BoundaryManager:
         bRY: Literal[0, 1] = 1,
         bRZ: Literal[0, 1] = 1,
         no: int | None = None,
+        bCoincident: int | None = 1,
     ) -> MstSlvBoundary:
         """创建主从约束"""
         if no is None:
             no = self._next_no()
-        ok, err = osis_boundary_master_slave(no, "MSTSLV", nNode, bX, bY, bZ, bRX, bRY, bRZ)
+        ok, err = osis_boundary_master_slave(no, "MSTSLV", nNode, bX, bY, bZ, bRX, bRY, bRZ,bCoincident)
         if not ok:
             raise RuntimeError(f"创建主从约束 {no} 失败: {err}")
         return self.get(no)  # type: ignore[return-value]

{osis_python-0.4.1 → osis_python-0.4.4}/src/pyosis/element/interface.py

@@ -138,9 +138,9 @@ def osis_element_shell(nEle: int=1, eElementType: str="CABLE", bIsThin: bool=1,
     Args:
         nEle (int): 单元编号。从 1 开始编号，所有类型的单元均使用同一编号序列。
         eElementType (str): 不能修改，固定为 SHELL，不区分大小写
-        bIsThin (bool): 
+        bIsThin (bool): 0 = 厚壳，1 = 薄壳
         nMat (int): 材料编号。
-        nThk (int): 
+        nThk (int): 厚度编号
         nNode1 (int): 节点1编号。
         nNode1 (int): 节点2编号。
         nNode1 (int): 节点3编号。
@@ -152,11 +152,11 @@ def osis_element_shell(nEle: int=1, eElementType: str="CABLE", bIsThin: bool=1,
     pass
 
 @REGISTRY.register("ElementDel")
-def osis_element_del(nEle: int=1):
+def osis_element_del(nEle: int):
     """删除一个单元
 
     Args:
-        nEle (int): 单元编号，从 1 开始计数
+        nEle (int): 单元编号
 
     Returns:
         tuple (bool, str):
@@ -166,7 +166,7 @@ def osis_element_del(nEle: int=1):
     pass
 
 @REGISTRY.register("ElementMod")
-def osis_element_mod(nOld: int=1, nNew: int=2):
+def osis_element_mod(nOld: int, nNew: int):
     """修改一个单元的编号。单元编号存在时，交换
 
     Args:
@@ -205,13 +205,13 @@ def osis_element_group(strName: str="单元组1", eOP: Literal["c", "a", "s", "r
 @REGISTRY.register("TaperEle")
 def osis_taperele(
     nIndex: str,
-    strZType: Literal["0", "1"],
+    strZType: Literal[0, 1],
     dZTrans: float = 1.0,
-    strZpos: Literal["0", "1"] = "0",
+    strZpos: Literal[0, 1] = 0,
     dZdis: float = 0.0,
-    strYtype: Literal["0", "1"]="0",
+    strYtype: Literal[0, 1]=0,
     dYtrans: float = 1.0,
-    strYpos: Literal["0", "1"] = "0",
+    strYpos: Literal[0, 1] = 0,
     dYdis: float = 0.0,
     *eles: str,
 
@@ -221,25 +221,25 @@ def osis_taperele(
 
     Args:
         nIndex (str): 变截面单元组名称
-        strZType (str): 截面Z向过渡类型，
+        strZType (int): 截面Z向过渡类型，
             * 0=线性
             * 1=多项式
         dZTrans (float): ZType=0时默认1.0
-        strZpos (str):
+        strZpos (int):
             * 0=i
             * 1=j
             * ZType=0时默认i
         dZdis (float): 对称面距，ZType=0时默认0.0
-        strYtype (str): 截面Y向过渡类型
+        strYtype (int): 截面Y向过渡类型
             * 0=线性
             * 1=多项式
         dYtrans (float): YType=0时默认1.0
-        strYpos (str):
+        strYpos (int):
             * 0=i
             * 1=j
             * YType=0时默认i
         dYdis (float): 对称面距，YType=0时默认0.0
-        *eles (str): 单元组编号，示例：1,3,5to10
+        *eles (int | str | list): 单元组编号，示例：1,3,5to10
 
     Returns:
         tuple (bool, str): 返回一个元组，包含：
@@ -264,13 +264,13 @@ def osis_element_tapereledel(strIndex: str) -> tuple[bool, str]:
     pass
 
 @REGISTRY.register("TaperEleMod")
-def osis_element_taperelemod(strOldIndex: str, strNewIndex: str) -> tuple[bool, str]:
+def osis_element_taperelemod(old_name: str, new_name: str) -> tuple[bool, str]:
     """
     修改变截面组名称
 
     Args:
-        strOldIndex (str):
-        strNewIndex (str):
+        old_name (str):
+        new_name (str):
 
     Returns:
         tuple (bool, str): 返回一个元组，包含：

{osis_python-0.4.1 → osis_python-0.4.4}/src/pyosis/element/manager.py

@@ -386,18 +386,47 @@ class TaperEleGroupManager:
     def create(
         self,
         name: str,
-        z_type: Literal["0", "1"],
+        z_type: Literal[0, 1],
         z_trans: float = 1.0,
-        z_pos: Literal["0", "1"] = "0",
+        z_pos: Literal[0, 1] = 0,
         z_dis: float = 0.0,
-        y_type: Literal["0", "1"] = "0",
+        y_type: Literal[0, 1] = 0,
         y_trans: float = 1.0,
-        y_pos: Literal["0", "1"] = "0",
+        y_pos: Literal[0, 1] = 0,
         y_dis: float = 0.0,
         *eles: str,
 
     ) -> TaperEleGroup:
-        """创建变截面单元组"""
+        """
+        生成或修改变截面单元组
+
+        Args:
+            name (str): 变截面单元组名称
+            z_type (int): 截面Z向过渡类型，
+                * 0=线性
+                * 1=多项式
+            z_trans (float): ZType=0时默认1.0
+            z_pos (int):
+                * 0=i
+                * 1=j
+                * ZType=0时默认i
+            z_dis (float): 对称面距，ZType=0时默认0.0
+            y_type (int): 截面Y向过渡类型
+                * 0=线性
+                * 1=多项式
+            y_trans (float): YType=0时默认1.0
+            y_pos (int):
+                * 0=i
+                * 1=j
+                * YType=0时默认i
+            y_dis (float): 对称面距，YType=0时默认0.0
+            *eles (str): 单元组编号，示例：1,3,5to10
+
+        Returns:
+            tuple (bool, str): 返回一个元组，包含：
+                - bool: 操作是否成功
+                - str: 失败原因
+        """
         ok, err = osis_taperele(
             name,
             z_type,

{osis_python-0.4.1 → osis_python-0.4.4}/src/pyosis/live/grade.py

@@ -73,8 +73,25 @@ def osis_livegrade_fatigue(strName: str="活载-FATIGUE", eCode: str="JTGD60_201
     '''
     pass
 
+@REGISTRY.register("LiveGrade")
+def osis_livegrade_custom(strName: str, eCode: Literal["CUSTOM"] = "CUSTOM", eLiveLoadType: Literal["VG"] = "VG", nGrpNum: int = 1,
+                          veh_grp_layout=[]):
+    """定义或修改活载等级。
+
+    Args:
+        strName: 活载名称
+        eCode: 规范类型，固定为 CUSTOM
+        eLiveLoadType: 活载类型，轴载组为 VG
+        nGrpNum: 轴载组数
+        veh_grp_layout: 距左侧轴的轴距, 轴载
+
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    """
+    pass
+
 @REGISTRY.register("LiveGradeDel")
-def osis_livegrade_del(strName: str="活载1"):
+def osis_livegrade_del(strName: str):
     '''
     删除活载等级
     
@@ -89,7 +106,7 @@ def osis_livegrade_del(strName: str="活载1"):
 @REGISTRY.register("LiveGradeMod")
 def osis_livegrade_mod(strOldName: str, strNewName: str):
     '''
-    修改编号
+    修改名称
     
     Args:
         strOldName (str): 旧名称

{osis_python-0.4.1 → osis_python-0.4.4}/src/pyosis/live/manager.py

@@ -23,7 +23,7 @@ from .grade import (
     osis_livegrade_crowd,
     osis_livegrade_fatigue,
     osis_livegrade_del,
-    osis_livegrade_mod,
+    osis_livegrade_mod, osis_livegrade_custom,
 )
 from .analysis import (
     osis_live_analysis,
@@ -549,6 +549,39 @@ class LiveGradeManager:
             raise RuntimeError(f"创建疲劳荷载等级 {name} 失败: {err}")
         return self.get(name)
 
+    def create_custom(self,
+        name: str,
+        nGrpNum: int = 1,
+        veh_grp_layout: list[tuple[float, float]] = (),
+    ) -> LiveGrade:
+        """创建自定义活载等级
+        Args:
+            name: 活载等级名称
+            eCode: 规范类型，固定为 CUSTOM
+            eLiveLoadType: 活载类型，轴载组为 VG
+            nGrpNum: 轴载组数
+            veh_grp_layout: 距左侧轴的轴距, 轴载
+
+        Returns:
+            创建的 LiveGrade 对象
+
+        Raises:
+            RuntimeError: 创建失败时抛出异常
+        """
+        layout_flat: list[float] = []
+        for pair in veh_grp_layout:
+            if len(pair) != 2:
+                raise ValueError(
+                    f"veh_grp_layout 每项须为 (轴距, 轴载)，当前: {pair!r}"
+                )
+            layout_flat.extend((float(pair[0]), float(pair[1])))
+        ok, err = osis_livegrade_custom(
+            name, "CUSTOM","VG",nGrpNum, layout_flat
+        )
+        if not ok:
+            raise RuntimeError(f"创建自定义活载等级 {name} 失败: {err}")
+        return self.get(name)
+
     def delete(self, name: str) -> None:
         """删除活载等级
 

osis_python-0.4.4/src/pyosis/load/loadcase.py

@@ -0,0 +1,89 @@
+"""
+Interfaces of OSIS functions
+
+========
+
+荷载工况相关
+
+"""
+from typing import Literal
+from ..core import REGISTRY
+
+
+@REGISTRY.register("LoadCase")
+def osis_loadcase(strName: str="自定义工况1", eLoadCaseType: Literal["USER", "CS", "D", "PS", "EV", "EH", "SH", "CR", "B", "STL",
+    "L", "IF", "CF", "LS", "BRK", "CRL", "FL", "W1", "W2", "SF", "IP",
+    "WF1", "WF2", "T", "TG", "FR",
+    "CFS", "CFD", "CFV", "E"]="USER", dScalar: float=1.0, strPrompt: str =None):
+    '''
+    创建荷载工况
+
+    Args:
+        strName (str): 荷载工况名称
+        eLoadCaseType (str): 荷载工况类型，不区分大小写。 
+            * USER = 用户定义的荷载
+            * CS = 施工阶段荷载
+            * D = 结构重力
+            * PS = 预加力
+            * EV = 土的重量
+            * EH = 土侧压力
+            * SH = 收缩
+            * CR = 徐变
+            * B = 水浮力
+            * STL = 基础变位
+            * L = 汽车荷载
+            * IF = 汽车冲击力
+            * CF = 汽车离心率
+            * LS = 汽车引起的土侧压力
+            * BRK = 汽车制动力
+            * CRL = 人群荷载
+            * FL = 疲劳荷载
+            * W1 = 活载风
+            * W2 = 极限风
+            * SF = 流水压力
+            * IP = 冰压力
+            * WF1 = W1引起的波浪力
+            * WF2 = W2引起的波浪力
+            * T = 均匀温度
+            * TG = 梯度温度
+            * FR = 支座摩阻力
+            * CFS = 船舶的撞击作用
+            * CFD = 漂流物的撞击作用
+            * CFV = 汽车撞击作用
+            * E = 地震作用
+        dScalar (float): 系数，默认1.0
+        strPrompt (str): 说明，默认 None
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    
+    Example:
+        osis_loadcase("自重工况","USER",1.0,"Load")
+    '''
+    pass
+
+@REGISTRY.register('LoadCaseDel')
+def osis_loadcase_del(strName: str):
+    '''
+    删除荷载工况
+
+    Args:
+        strName (str): 荷载工况名称
+       
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    '''
+    pass
+
+@REGISTRY.register("LCMod")
+def osis_loadcase_mod(strOldName: str, strNewName: str):
+    '''
+    定义或修改荷载工况
+
+    Args:
+        strOldName (str): 旧名称
+        strNewName (str): 新名称
+       
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    '''
+    pass

{osis_python-0.4.1 → osis_python-0.4.4}/src/pyosis/load/manager.py

@@ -331,44 +331,41 @@ class LoadCase:
     def create_displacement(
             self,
             nEntity: int,
-            bDX: int = 1,
-            dDX: float = 0.0,
-            bDY: int = 0,
-            dDY: float = 0.0,
-            bDZ: int = 0,
-            dDZ: float = 0.0,
-            bRX: int = 0,
-            dRX: float = 0.0,
-            bRY: int = 0,
-            dRY: float = 0.0,
-            bRZ: int = 0,
-            dRZ: float = 0.0,
+            bX: int = 1,
+            Dx: float = 0.0,
+            bY: int = 0,
+            Dy: float = 0.0,
+            bZ: int = 0,
+            Dz: float = 0.0,
+            bRx: int = 0,
+            Rx: float = 0.0,
+            bRy: int = 0,
+            Ry: float = 0.0,
+            bRz: int = 0,
+            Rz: float = 0.0,
     ) -> LoadCase:
         """添加强迫位移
 
         Args:
-            nEntity: 节点编号
-            bDX, dDX: X向平动是否施加 (0/1)、位移值
-            bDY, dDY: Y向平动是否施加 (0/1)、位移值
-            bDZ, dDZ: Z向平动是否施加 (0/1)、位移值
-            bRX, dRX: 绕X转角是否施加 (0/1)、转角值
-            bRY, dRY: 绕Y转角是否施加 (0/1)、转角值
-            bRZ, dRZ: 绕Z转角是否施加 (0/1)、转角值
+            nEntity：节点编号
+            bX：UX方向，0 = 自由，1 = 强迫位移
+            Dx：强制位移在坐标系x方向的分量
+            bY：UY方向，0 = 自由，1 = 强迫位移
+            Dy：强制位移在坐标系y方向的分量
+            bZ：UZ方向，0 = 自由，1 = 强迫位移
+            Dz：强制位移在坐标系z方向的分量
+            bRx：RX方向，0 = 自由，1 = 强迫位移
+            Rx：绕坐标系x轴的强制旋转角度分量
+            bRy：RY方向，0 = 自由，1 = 强迫位移
+            Ry：绕坐标系y轴的强制旋转角度分量
+            bRz：RZ方向，0 = 自由，1 = 强迫位移
+            Rz：绕坐标系z轴的强制旋转角度分量
 
         Returns:
             更新后的 LoadCase 对象
         """
         ok, err = osis_load_displacement(
-            "DISPLACEMENT",
-            self.name,
-            nEntity,
-            bDX, dDX,
-            bDY, dDY,
-            bDZ, dDZ,
-            bRX, dRX,
-            bRY, dRY,
-            bRZ, dRZ,
-        )
+            "DISPLACEMENT",self.name,nEntity,bX,Dx,bY,Dy,bZ,Dz,bRx,Rx,bRy,Ry,bRz,Rz)
         if not ok:
             raise RuntimeError(f"添加强迫位移到工况 {self.name} 失败: {err}")
         return self.refresh()
@@ -606,7 +603,7 @@ class LoadCase:
         Returns:
             更新后的 LoadCase 对象
         """
-        raise Exception("暂不支持添加单元面荷载（方向向量）到工况")
+        # raise Exception("暂不支持添加单元面荷载（方向向量）到工况")
         ok, err = osis_load_surface_load_vector(
             "ESRFC", self.name, strEntity, strPlanei, strDir,
             strXi, strYi, strZi, strP1i, strP2i, strP3i, strP4i
@@ -1442,11 +1439,35 @@ class LoadCaseManager:
             name: 荷载工况名称
             load_case_type: 荷载工况类型
                 USER = 用户定义的荷载
-                D = 桥规中的荷编号1(结构重力)
-                DC = 结构和非结构附属荷载
-                DW = 铺装和设备荷载
-                DD = 桩端摩擦力
                 CS = 施工阶段荷载
+                D = 结构重力
+                PS = 预加力
+                EV = 土的重量
+                EH = 土侧压力
+                SH = 收缩
+                CR = 徐变
+                B = 水浮力
+                STL = 基础变位
+                L = 汽车荷载
+                IF = 汽车冲击力
+                CF = 汽车离心率
+                LS = 汽车引起的土侧压力
+                BRK = 汽车制动力
+                CRL = 人群荷载
+                FL = 疲劳荷载
+                W1 = 活载风
+                W2 = 极限风
+                SF = 流水压力
+                IP = 冰压力
+                WF1 = W1引起的波浪力
+                WF2 = W2引起的波浪力
+                T = 均匀温度
+                TG = 梯度温度
+                FR = 支座摩阻力
+                CFS = 船舶的撞击作用
+                CFD = 漂流物的撞击作用
+                CFV = 汽车撞击作用
+                E = 地震作用
             scalar: 系数，默认1.0
             prompt: 说明
 

{osis_python-0.4.1 → osis_python-0.4.4}/src/pyosis/load/static.py

@@ -133,11 +133,11 @@ def osis_load_surface_load(eType: str, strLc: str, strEntity: str, strPlanei:str
     创建或修改单元面荷载，不考虑边中节点荷载插值
 
     Args:
-        eType (str):
+        eType (str): 荷载类型，Type = ESRFC
         strLc (str): 荷载工况名称
         strEntity (str): 单元编号
         strPlanei (str): 面位置，板壳单元默认输入1，实体单元输入1,2,3,4,5,6
-        strDir (str):方向，默认为 VECTOR
+        strDir (str):方向，X,Y,Z
         strGlobalI (str):
             * 0 = 局部
             * 1 = 整体
@@ -184,32 +184,38 @@ def osis_load_displacement(
     eType: str = "DISPLACEMENT",
     strLCName: str = "自定义工况1",
     nEntity: int = 1,
-    bDX: int = 1,
-    dDX: float = 0.0,
-    bDY: int = 0,
-    dDY: float = 0.0,
-    bDZ: int = 0,
-    dDZ: float = 0.0,
-    bRX: int = 0,
-    dRX: float = 0.0,
-    bRY: int = 0,
-    dRY: float = 0.0,
-    bRZ: int = 0,
-    dRZ: float = 0.0,
+    bX:int = 1,
+    Dx: float = 0.0,
+    bY: int = 0,
+    Dy: float = 0.0,
+    bZ: int = 0,
+    Dz: float = 0.0,
+    bRx: int = 0,
+    Rx: float = 0.0,
+    bRy: int = 0,
+    Ry: float = 0.0,
+    bRz: int = 0,
+    Rz: float = 0.0,
 ):
     '''
-    创建或修改强迫位移（与 C++ AppendDisp 一致：工况名后为 6 组 b、d）
+    创建或修改强迫位移
 
     Args:
-        eType (str): 荷载类型，不区分大小写。固定为 DISPLACEMENT
+        Type：荷载类型，固定为 DISPLACEMENT
         strLCName (str): 荷载工况名称
-        nEntity (int): 节点编号
-        bDX, dDX: X 向平动是否施加 (0/1)、位移值
-        bDY, dDY: Y 向平动是否施加 (0/1)、位移值
-        bDZ, dDZ: Z 向平动是否施加 (0/1)、位移值
-        bRX, dRX: 绕 X 转角是否施加 (0/1)、转角值
-        bRY, dRY: 绕 Y 转角是否施加 (0/1)、转角值
-        bRZ, dRZ: 绕 Z 转角是否施加 (0/1)、转角值
+        nEntity：节点编号
+        bX：UX方向，0 = 自由，1 = 强迫位移
+        Dx：强制位移在坐标系x方向的分量
+        bY：UY方向，0 = 自由，1 = 强迫位移
+        Dy：强制位移在坐标系y方向的分量
+        bZ：UZ方向，0 = 自由，1 = 强迫位移
+        Dz：强制位移在坐标系z方向的分量
+        bRx：RX方向，0 = 自由，1 = 强迫位移
+        Rx：绕坐标系x轴的强制旋转角度分量
+        bRy：RY方向，0 = 自由，1 = 强迫位移
+        Ry：绕坐标系y轴的强制旋转角度分量
+        bRz：RZ方向，0 = 自由，1 = 强迫位移
+        Rz：绕坐标系z轴的强制旋转角度分量
 
     Returns:
         tuple (bool, str): 是否成功，失败原因
@@ -234,7 +240,7 @@ def osis_load_initial(
     dMZJ: float = 0,
 ):
     '''
-    创建或修改初始内力（与 C++ AppendInitial 一致：I 端与 J 端各 6 个分量）
+    创建或修改初始内力
 
     Args:
         eType (str): 荷载类型，不区分大小写。固定为 INITIAL
@@ -314,6 +320,12 @@ def osis_load_gtemp(eType: str="GTEMP", strLCName: str="自定义工况1", nEnti
             - T2 (float): H2处对应温度
     Returns:
         tuple (bool, str): 是否成功，失败原因
+
+    Notes:
+        R：从梁截面建模位置到温度变化点的距离
+        T：从梁顶到温度变化点的距离
+        C：从截面中心到温度变化点的距离
+        B：从梁底到温度变化点的距离
     '''
     pass
 

{osis_python-0.4.1 → osis_python-0.4.4}/src/pyosis/material/interface.py

@@ -60,7 +60,7 @@ def osis_material_steel(nMat: int, strName: str, eMaterialType: Literal["STEEL"]
 
 @REGISTRY.register('Material')
 def osis_material_prestressed(nMat: int, strName: str, eMaterialType: Literal["PRESTRESSED"], eCode: Literal["JTG3362_2018", "JTGD62_2004"], eGrade: str, dDmp: float):
-    """创建或修改材料。
+    """创建或修改预应力材料。
 
     Args:
         nMat (int): 材料编号
@@ -85,7 +85,7 @@ def osis_material_prestressed(nMat: int, strName: str, eMaterialType: Literal["P
 @REGISTRY.register('Material')
 def osis_material_rebar(nMat: int, strName: str, eMaterialType: Literal["REBAR"], eCode: Literal["JTG3362_2018", "JTGD62_2004"], 
                         eGrade: Literal["HPB300", "HRB400", "HRBF400", "RRB400", "HRB500"] | Literal["R235", "HRB335", "HRB400", "KL400"], dDmp: float):
-    """创建或修改钢筋
+    """创建或修改普通钢筋材料
 
     Args:
         nMat (int): 材料编号
@@ -108,7 +108,7 @@ def osis_material_rebar(nMat: int, strName: str, eMaterialType: Literal["REBAR"]
 
 @REGISTRY.register('Material')
 def osis_material_custom(nMat: int, strName: str, eMaterialType: Literal["CUSTOM"], dE: float=0, dG: float=0, dMu: float=0, dExpCoeff: float=0, dUnitWeight: float=0, dDensity: float=0, dDmp: float=0):
-    """创建或修改材料。
+    """创建或修改自定义材料。
 
     Args:
         nMat (int): 材料编号