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

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

{osis_python-0.4.0 → 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.0 → 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.0 → osis_python-0.4.4}/src/pyosis/core/__init__.py

@@ -9,3 +9,4 @@ OSISEngine中的函数，将会分发到各个模块，被再次封装，意图
 """
 
 from .command import REGISTRY, osis_run, set_run_mode
+from .client import set_osis_port, set_osis_url

{osis_python-0.4.0 → osis_python-0.4.4}/src/pyosis/core/client.py

@@ -24,6 +24,23 @@ session = requests.Session()
 session.mount("http://", adapter)
 session.mount("https://", adapter)  # 如果你后续用HTTPS
 
+DEFAULT_PORT = 18080
+DEFAULT_URL = "http://localhost"
+
+def set_osis_url(url):
+    '''
+    设置OSIS默认网址
+    '''
+    global DEFAULT_URL
+    DEFAULT_URL = url
+
+def set_osis_port(port):
+    '''
+    设置要连接的OSIS端口
+    '''
+    global DEFAULT_PORT
+    DEFAULT_PORT = port
+
 # ========== 通用客户端函数（复用连接池） ==========
 def osis_client(func_name: str, payload: dict, base_url=None) -> dict:
     """
@@ -34,7 +51,7 @@ def osis_client(func_name: str, payload: dict, base_url=None) -> dict:
     Returns:
         异常时返回 (False, 错误信息)
     """
-    base_url = base_url or os.environ.get("OSIS_URL", "http://localhost:18080")
+    base_url = base_url or os.environ.get("OSIS_URL", f"{DEFAULT_URL}:{DEFAULT_PORT}")
     url = f"{base_url}/{func_name}"
 
     try:

{osis_python-0.4.0 → osis_python-0.4.4}/src/pyosis/core/engine.py

@@ -19,6 +19,7 @@
 
 from __future__ import annotations
 
+import os
 from typing import Any
 
 from ..material.manager import MaterialManager, material_manager
@@ -48,6 +49,7 @@ from ..general.interface import (
     osis_solve,
 )
 from .command import osis_run
+from .client import set_osis_port, set_osis_url
 
 
 class OSISEngine:
@@ -81,7 +83,12 @@ class OSISEngine:
         - matrix(), output_result_for_calc_book()
     """
 
-    def __init__(self) -> None:
+    def __init__(self, port=None, url="http://localhost") -> None:
+        '''
+        Args:
+            port (int): OSIS 端口号，为 `None` 自动尝试加载 `OSIS_HTTP_PORT` 环境变量，加载失败将设为默认值 18080
+            url (str): OSIS 网址
+        '''
         # 引用全局单例管理器
         self._material = material_manager
         self._section = section_manager
@@ -103,6 +110,15 @@ class OSISEngine:
         self._post = post_manager
         self._result = result_manager
 
+        # OSIS端口与网址
+        if port is None:
+            self._port = os.environ.get("OSIS_HTTP_PORT", 18080)     # 如果设置了环境变量
+        else:
+            self._port = port
+        self._url = url
+        set_osis_url(self._url)
+        set_osis_port(self._port)
+
     # ──────────────────────────────────────────
     # 子管理器属性
     # ──────────────────────────────────────────
@@ -306,7 +322,7 @@ class OSISEngine:
             path (str): 完整文件名
          
         Notes: 
-            path 中如果不输入绝对路径的话，默认使用程序执行文件所在的路径，比如“D:\Rbin\X.sml”。
+            path 中如果不输入绝对路径的话，默认使用程序执行文件所在的路径，比如“D:\\Rbin\\X.sml”。
         """
         self.control.import_apdl(path)
 

{osis_python-0.4.0 → osis_python-0.4.4}/src/pyosis/dynamic/load_to_mass.py

@@ -42,12 +42,12 @@ def osis_ltm_anal_del(strName: str):
 
 
 @REGISTRY.register("LTMAnalMod")
-def osis_ltm_anal_mod(nOld: int, nNew: int):
-    """修改荷载转换质量编号。
+def osis_ltm_anal_mod(old_name: str, new_name: str):
+    """修改荷载转换质量名称。
 
     Args:
-        nOld (int): 旧编号
-        nNew (int): 新编号
+        old_name (str): 旧名称
+        new_name (str): 新名称
 
     Returns:
         tuple (bool, str): 返回一个元组，包含：

{osis_python-0.4.0 → osis_python-0.4.4}/src/pyosis/dynamic/manager.py

@@ -138,16 +138,16 @@ class LoadToMassManager:
         if not ok:
             raise RuntimeError(f"删除荷载转换质量 {name} 失败: {err}")
 
-    def renumber_ltm(self, old_no: int, new_no: int) -> None:
-        """修改荷载转换质量编号。
+    def rename_ltm(self, old_name: str, new_name: str) -> None:
+        """修改荷载转换质量名称。
 
         Args:
-            old_no: 旧编号
-            new_no: 新编号
+            old_name: 旧名称
+            new_name: 新名称
         """
-        ok, err = osis_ltm_anal_mod(old_no, new_no)
+        ok, err = osis_ltm_anal_mod(old_name, new_name)
         if not ok:
-            raise RuntimeError(f"修改荷载转换质量编号 {old_no} -> {new_no} 失败: {err}")
+            raise RuntimeError(f"修改荷载转换质量名称 {old_name} -> {new_name} 失败: {err}")
 
     def add_ltm(
         self,
@@ -298,7 +298,7 @@ class SeisRspSpecManager:
             names = [str(name)]
         if not isinstance(names, list):
             raise TypeError(f"不支持的名称类型: {type(name)}")
-        resp = osis_client("GetSeisRspSpecInfoByNames", {"name": names})
+        resp = osis_client("GetSeisRspSpecByNames", {"name": names})
         if not resp['success']:
             raise RuntimeError(f"{resp['error']}")
         rsp = [SeisRspSpec._from_dict(d) if d else None for d in resp.get("data", [])]
@@ -327,8 +327,13 @@ class SeisRspSpecManager:
             g: 输入g值
             spectrum_data: 反应谱数据列表，每个元素为 (周期, 谱值) 元组
         """
-        n_num = len(spectrum_data)
-        ok, err = osis_seis_rsp_spec_import(name, spec_type, g, n_num, spectrum_data)
+        if spectrum_data and isinstance(spectrum_data[0], tuple):
+            n_num = len(spectrum_data)
+            flat = [v for pair in spectrum_data for v in pair]
+        else:
+            flat = list(spectrum_data)
+            n_num = len(flat) // 2
+        ok, err = osis_seis_rsp_spec_import(name, spec_type, g, 0, n_num, flat)
         if not ok:
             raise RuntimeError(f"创建地震反应谱 {name} 失败: {err}")
 
@@ -368,7 +373,7 @@ class SeisRspSpecManager:
             delta_t: 周期间隔
         """
         ok, err = osis_seis_rsp_spec_code(
-            name, spec_type, g,
+            name, spec_type, g,1,
             code, bridge_type, is_long_span, level, intensity,
             site, direction, period, ksi, t, delta_t
         )
@@ -385,16 +390,16 @@ class SeisRspSpecManager:
         if not ok:
             raise RuntimeError(f"删除地震反应谱 {name} 失败: {err}")
 
-    def renumber_rsp_spec(self, old_no: int, new_no: int) -> None:
-        """修改地震反应谱编号。
+    def rename_rsp_spec(self, old_name: str, new_name: str) -> None:
+        """修改地震反应谱名称。
 
         Args:
-            old_no: 旧编号
-            new_no: 新编号
+            old_name: 旧名称
+            new_name: 新名称
         """
-        ok, err = osis_seis_rsp_spec_mod(old_no, new_no)
+        ok, err = osis_seis_rsp_spec_mod(old_name, new_name)
         if not ok:
-            raise RuntimeError(f"修改地震反应谱编号 {old_no} -> {new_no} 失败: {err}")
+            raise RuntimeError(f"修改地震反应谱名称 {old_name} -> {new_name} 失败: {err}")
 
 @dataclass(frozen=False)
 class RspecAnal:
@@ -510,16 +515,16 @@ class RspecAnalManager:
         if not ok:
             raise RuntimeError(f"删除反应谱工况 {name} 失败: {err}")
 
-    def renumber_rspec_anal(self, old_no: int, new_no: int) -> None:
-        """修改反应谱工况编号。
+    def rename_rspec_anal(self, old_name: str, new_name: str) -> None:
+        """修改反应谱工况名称。
 
         Args:
-            old_no: 旧编号
-            new_no: 新编号
+            old_name: 旧名称
+            new_name: 新名称
         """
-        ok, err = osis_rspec_anal_mod(old_no, new_no)
+        ok, err = osis_rspec_anal_mod(old_name, new_name)
         if not ok:
-            raise RuntimeError(f"修改反应谱工况编号 {old_no} -> {new_no} 失败: {err}")
+            raise RuntimeError(f"修改反应谱工况名称 {old_name} -> {new_name} 失败: {err}")
 
 class DynamicManager:
     """动力分析管理器

{osis_python-0.4.0 → osis_python-0.4.4}/src/pyosis/dynamic/seismic.py

@@ -18,6 +18,7 @@ def osis_seis_rsp_spec_import(
     strName: str,
     strType: Literal["N", "A", "V", "D"],
     dG: float,
+    inputType: int,
     nNum: int,
     spectrum_data: list[tuple[float, float]],
 ):
@@ -27,6 +28,7 @@ def osis_seis_rsp_spec_import(
         strName (str): 名称
         strType (str): 谱类型，N=无量纲加速度谱，A=加速度谱，V=速度谱，D=位移谱
         dG (float): 输入g值
+        inputtype：类型，0 = 导入
         nNum (int): 点数
         spectrum_data (list): 反应谱数据列表，每个元素为 (周期, 谱值) 元组
 
@@ -49,6 +51,7 @@ def osis_seis_rsp_spec_code(
     strName: str,
     strType: Literal["N", "A", "V", "D"],
     dG: float,
+    inputType: int = 1,
     strCode: str = "JTGT_2231_01_2020",
     strBridgeType: Literal["A", "B", "C", "D"] = "A",
     nIsLongSpan: Literal[0, 1] = 0,
@@ -67,6 +70,7 @@ def osis_seis_rsp_spec_code(
         strName (str): 名称
         strType (str): 谱类型，N=无量纲加速度谱，A=加速度谱，V=速度谱，D=位移谱
         dG (float): 输入g值
+        inputtype：类型，1 = 按规范生成
         strCode (str): 规范名称，如 "JTGT_2231_01_2020"
         strBridgeType (str): 桥梁类别，A/B/C/D
         nIsLongSpan (int): 0=非高速公路和一级公路上的B类大桥特大桥，1=高速公路和一级公路上的B类大桥特大桥
@@ -111,12 +115,12 @@ def osis_seis_rsp_spec_del(strName: str):
 
 
 @REGISTRY.register("SeisRspSpecMod")
-def osis_seis_rsp_spec_mod(nOld: int, nNew: int):
-    """修改地震反应谱编号。
+def osis_seis_rsp_spec_mod(old_name: str, new_name: str):
+    """修改地震反应谱名称。
 
     Args:
-        nOld (int): 旧编号
-        nNew (int): 新编号
+        old_name (int): 旧名称
+        new_name (int): 新名称
 
     Returns:
         tuple (bool, str): 返回一个元组，包含：
@@ -180,12 +184,12 @@ def osis_rspec_anal_del(strName: str):
 
 
 @REGISTRY.register("RSpecAnalMod")
-def osis_rspec_anal_mod(nOld: int, nNew: int):
-    """修改反应谱工况编号。
+def osis_rspec_anal_mod(old_name: str, new_name: str):
+    """修改反应谱工况名称。
 
     Args:
-        nOld (int): 旧编号
-        nNew (int): 新编号
+        old_name (str): 旧名称
+        new_name (str): 新名称
 
     Returns:
         tuple (bool, str): 返回一个元组，包含：

{osis_python-0.4.0 → 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.0 → 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,
@@ -615,7 +644,7 @@ class ElementManager:
         ok, err = osis_element_shell(no, "SHELL", bIsThin, nMat, nThk, node1, node2, node3, node4)
         if not ok:
             raise RuntimeError(f"创建壳单元 {no} 失败: {err}")
-        return self.get(no)  # type: ignore[return-value]
+        return self.get(no)
 
     def delete(self, no: int) -> None:
         """删除单元"""

{osis_python-0.4.0 → 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.0 → 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,
@@ -267,6 +267,13 @@ class LiveCase:
                 - SUSPENSION: 悬索桥
                 - CUSTOM: 自定义，直接输入基频
             mu_params: 冲击系数计算参数列表（根据桥型不同参数不同）
+                * SIMPLE	            = 桥长、弹模、惯性矩、质量
+                * CONTINUOUS	        = 基频计算常数a、基频计算常数b、桥长、弹模、惯性矩、质量
+                * ARCH	                = 拱厚变化系数、拱桥矢跨比、桥长、弹模、惯性矩，质量
+                * CABLE_STAYED	        = 计算常数、主跨跨径
+                * CABLE_STAYED_AUX	    = 计算常数、主跨跨径
+                * SUSPENSION	        = 主跨跨径、弹模、惯性矩、主缆水平拉力、质量
+                * CUSTOM	            = 用户直接输入基频
             lane_names: 车道名称列表
 
         Returns:
@@ -316,6 +323,13 @@ class LiveCase:
                 - SUSPENSION: 悬索桥
                 - CUSTOM: 自定义，直接输入基频
             mu_params: 冲击系数计算参数列表（根据桥型不同参数不同）
+                * SIMPLE	            = 桥长、弹模、惯性矩、质量
+                * CONTINUOUS	        = 基频计算常数a、基频计算常数b、桥长、弹模、惯性矩、质量
+                * ARCH	                = 拱厚变化系数、拱桥矢跨比、桥长、弹模、惯性矩，质量
+                * CABLE_STAYED	        = 计算常数、主跨跨径
+                * CABLE_STAYED_AUX	    = 计算常数、主跨跨径
+                * SUSPENSION	        = 主跨跨径、弹模、惯性矩、主缆水平拉力、质量
+                * CUSTOM	            = 用户直接输入基频
             lane_names: 车道名称列表
 
         Returns:
@@ -535,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:
         """删除活载等级