osis-python 0.6.2__tar.gz → 0.6.4__tar.gz

{osis_python-0.6.2/src/osis_python.egg-info → osis_python-0.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: osis-python
-Version: 0.6.2
+Version: 0.6.4
 Summary: A Python client library for Osis APDL
 Author-email: "CCCC Highway Consultant Co. Ltd." <support@osisbim.com>
 License-Expression: MIT
@@ -88,7 +88,7 @@ n2 = engine.node.create(no=2, x=15, y=0, z=0)
 
 # Create elements
 elem = engine.element.create_beam3d(
-    no=1, node1=n1.no, node2=n2.no, nMat=mat.no, nSec1=sec.no, nSec2=sec.no
+    no=1, node1=n1.no, node2=n2.no, mat=mat.no, sec1=sec.no, sec2=sec.no
 )
 
 # Create boundaries
@@ -136,7 +136,7 @@ from pyosis.material import material_manager
 from pyosis.node import node_manager
 
 mat = material_manager.create_conc(no=1, name="C30", code="JTG3362_2018", grade="C30")
-node = node_manager.create(0, 0, 0)
+node = node_manager.create(no=None, x=0, y=0, z=0)
 ```
 
 ### 4. Using OSISSolver — Start the Solver Directly (Solver-Only Mode)
@@ -208,8 +208,8 @@ engine.boundary.group.create("AbutmentBoundaries", "a", "1to2")
 
 # Various boundary types
 engine.boundary.create_general(no=1, x=1, y=1, z=1, rx=1, ry=1, rz=1, rw=1)           # General support
-engine.boundary.create_master_slave(no=1, node=1, dx=1, dy=1, dz=1, rx=0, ry=1, rz=1, coincident=2)  # Master-slave
-engine.boundary.create_rigid(no=1, nNodeI=1)                                               # Rigid link
+engine.boundary.create_master_slave(no=1, node=1, dx=1, dy=1, dz=1, rx=0, ry=1, rz=1, coincident=1)  # Master-slave
+engine.boundary.create_rigid(no=1, node_i=1)                                               # Rigid link
 engine.boundary.create_elstcspt(no=1, coor="", x=0, dx=1e9, y=0, dy=1e9, z=0, dz=1e9)     # Elastic support
 
 # Tendons
@@ -260,12 +260,12 @@ engine.prop.creep_shrink.create(no=1, name="Creep1", avg_humidity=70.0,
 # Damping (Rayleigh 自定义系数)
 engine.prop.damping.create_rayleigh_custom(name="Damping1", alpha=0.05, beta=0.005)
 
-# P-U curve (no, name, curve_type, num, values)
-#   curve_type: 1=水平位移推力 2=竖向位移推力 3=竖向力位移
-engine.prop.pu_curve.create(no=1, name="PU1", curve_type=1, num=3, values=[0, 0.01, 1000, 0.02, 1500])
+# P-U curve (no, name, curve_type, num, *values)
+#   curve_type: 0 = force, 1 = moment
+engine.prop.pu_curve.create(1, "PU1", 1, 3, 0, 0.01, 1000, 0.02, 1500)
 
 # Element thickness assignment (thickness, op, *elems)
-engine.prop.assign_component_thickness(thickness=0.3, op="a", elems=[1])
+engine.prop.assign_component_thickness(0.3, "a", 1)
 
 # Shell thickness (no, in_plane, out_plane)
 engine.thickness.create(no=1, in_plane=0.3, out_plane=0.3)
@@ -277,13 +277,13 @@ The `GeometryManager` supports querying geometric entities:
 
 ```python
 # Get all splines
-splines = engine.geometry.all("spline")
+splines = engine.geometry.all()
 
 # Get a specific spline
-spline = engine.geometry.get("spline", name="curve1")
+spline = engine.geometry.get("curve1")
 
-# Filter by type
-arcs = engine.geometry.filter("spline", spline_type="ARC3D")
+# Filter by type (General / Natural / Arc3D / Arc2D)
+arcs = [s for s in engine.geometry.all() if s.spline_type.name == "Arc3D"]
 ```
 
 ### Data Class Objects
@@ -299,7 +299,7 @@ print(elem.mat)         # Material ID
 # Objects support operations (operations下沉 to object)
 lc = engine.load.get("Self-weight")
 lc.create_gravity()
-lc.create_nforce(1, dFx=1000)
+lc.create_nforce(1, fx=1000)
 ```
 
 ### Explicit Numbering
@@ -363,23 +363,23 @@ engine.control.set_inc_tendon(True)
 engine.control.set_nonlinear(geom=False, link=False)
 
 # Sections
-engine.section.create_circle("CircleSection1", d=0.219, tw=0.012, no=1)
-engine.section.create_circle("CircleSection2", d=0.180, tw=0.008, no=2)
+engine.section.create_circle(no=1, name="CircleSection1", d=0.219, tw=0.012)
+engine.section.create_circle(no=2, name="CircleSection2", d=0.180, tw=0.008)
 
 # Materials
 engine.material.create_steel(
-    "Steel1", code="JTGD64_2015", grade="Q345", dmp=0.05, no=1
+    no=1, name="Steel1", code="JTGD64_2015", grade="Q345", dmp=0.05
 )
 
 # Nodes
-engine.node.create(0, 5, 0, no=1)
-engine.node.create(15, 5, 0, no=2)
-engine.node.create(7.5, 0, 0, no=3)
-engine.node.create(20, 0, 0, no=4)
+engine.node.create(no=1, x=0, y=5, z=0)
+engine.node.create(no=2, x=15, y=5, z=0)
+engine.node.create(no=3, x=7.5, y=0, z=0)
+engine.node.create(no=4, x=20, y=0, z=0)
 
 # Elements
-engine.element.create_beam3d(1, 3, nMat=1, nSec1=1, nSec2=1, no=1)
-engine.element.create_beam3d(2, 3, nMat=1, nSec1=2, nSec2=2, no=2)
+engine.element.create_beam3d(no=1, node1=1, node2=3, mat=1, sec1=1, sec2=1)
+engine.element.create_beam3d(no=2, node1=2, node2=3, mat=1, sec1=2, sec2=2)
 
 # Boundaries
 engine.boundary.create_general(no=1)
@@ -391,8 +391,8 @@ lc = engine.load.create(
     load_case_type="USER",
     prompt="Two forces applied at nodes 3 and 4"
 )
-lc.create_nforce(3, dFx=0, dFy=-1000000, dFz=0)
-lc.create_nforce(4, dFx=200000, dFy=0, dFz=0)
+lc.create_nforce(3, fx=0, fy=-1000000, fz=0)
+lc.create_nforce(4, fx=200000, fy=0, fz=0)
 
 # Solve
 engine.solve()

{osis_python-0.6.2 → osis_python-0.6.4}/README.md

@@ -57,7 +57,7 @@ n2 = engine.node.create(no=2, x=15, y=0, z=0)
 
 # Create elements
 elem = engine.element.create_beam3d(
-    no=1, node1=n1.no, node2=n2.no, nMat=mat.no, nSec1=sec.no, nSec2=sec.no
+    no=1, node1=n1.no, node2=n2.no, mat=mat.no, sec1=sec.no, sec2=sec.no
 )
 
 # Create boundaries
@@ -105,7 +105,7 @@ from pyosis.material import material_manager
 from pyosis.node import node_manager
 
 mat = material_manager.create_conc(no=1, name="C30", code="JTG3362_2018", grade="C30")
-node = node_manager.create(0, 0, 0)
+node = node_manager.create(no=None, x=0, y=0, z=0)
 ```
 
 ### 4. Using OSISSolver — Start the Solver Directly (Solver-Only Mode)
@@ -177,8 +177,8 @@ engine.boundary.group.create("AbutmentBoundaries", "a", "1to2")
 
 # Various boundary types
 engine.boundary.create_general(no=1, x=1, y=1, z=1, rx=1, ry=1, rz=1, rw=1)           # General support
-engine.boundary.create_master_slave(no=1, node=1, dx=1, dy=1, dz=1, rx=0, ry=1, rz=1, coincident=2)  # Master-slave
-engine.boundary.create_rigid(no=1, nNodeI=1)                                               # Rigid link
+engine.boundary.create_master_slave(no=1, node=1, dx=1, dy=1, dz=1, rx=0, ry=1, rz=1, coincident=1)  # Master-slave
+engine.boundary.create_rigid(no=1, node_i=1)                                               # Rigid link
 engine.boundary.create_elstcspt(no=1, coor="", x=0, dx=1e9, y=0, dy=1e9, z=0, dz=1e9)     # Elastic support
 
 # Tendons
@@ -229,12 +229,12 @@ engine.prop.creep_shrink.create(no=1, name="Creep1", avg_humidity=70.0,
 # Damping (Rayleigh 自定义系数)
 engine.prop.damping.create_rayleigh_custom(name="Damping1", alpha=0.05, beta=0.005)
 
-# P-U curve (no, name, curve_type, num, values)
-#   curve_type: 1=水平位移推力 2=竖向位移推力 3=竖向力位移
-engine.prop.pu_curve.create(no=1, name="PU1", curve_type=1, num=3, values=[0, 0.01, 1000, 0.02, 1500])
+# P-U curve (no, name, curve_type, num, *values)
+#   curve_type: 0 = force, 1 = moment
+engine.prop.pu_curve.create(1, "PU1", 1, 3, 0, 0.01, 1000, 0.02, 1500)
 
 # Element thickness assignment (thickness, op, *elems)
-engine.prop.assign_component_thickness(thickness=0.3, op="a", elems=[1])
+engine.prop.assign_component_thickness(0.3, "a", 1)
 
 # Shell thickness (no, in_plane, out_plane)
 engine.thickness.create(no=1, in_plane=0.3, out_plane=0.3)
@@ -246,13 +246,13 @@ The `GeometryManager` supports querying geometric entities:
 
 ```python
 # Get all splines
-splines = engine.geometry.all("spline")
+splines = engine.geometry.all()
 
 # Get a specific spline
-spline = engine.geometry.get("spline", name="curve1")
+spline = engine.geometry.get("curve1")
 
-# Filter by type
-arcs = engine.geometry.filter("spline", spline_type="ARC3D")
+# Filter by type (General / Natural / Arc3D / Arc2D)
+arcs = [s for s in engine.geometry.all() if s.spline_type.name == "Arc3D"]
 ```
 
 ### Data Class Objects
@@ -268,7 +268,7 @@ print(elem.mat)         # Material ID
 # Objects support operations (operations下沉 to object)
 lc = engine.load.get("Self-weight")
 lc.create_gravity()
-lc.create_nforce(1, dFx=1000)
+lc.create_nforce(1, fx=1000)
 ```
 
 ### Explicit Numbering
@@ -332,23 +332,23 @@ engine.control.set_inc_tendon(True)
 engine.control.set_nonlinear(geom=False, link=False)
 
 # Sections
-engine.section.create_circle("CircleSection1", d=0.219, tw=0.012, no=1)
-engine.section.create_circle("CircleSection2", d=0.180, tw=0.008, no=2)
+engine.section.create_circle(no=1, name="CircleSection1", d=0.219, tw=0.012)
+engine.section.create_circle(no=2, name="CircleSection2", d=0.180, tw=0.008)
 
 # Materials
 engine.material.create_steel(
-    "Steel1", code="JTGD64_2015", grade="Q345", dmp=0.05, no=1
+    no=1, name="Steel1", code="JTGD64_2015", grade="Q345", dmp=0.05
 )
 
 # Nodes
-engine.node.create(0, 5, 0, no=1)
-engine.node.create(15, 5, 0, no=2)
-engine.node.create(7.5, 0, 0, no=3)
-engine.node.create(20, 0, 0, no=4)
+engine.node.create(no=1, x=0, y=5, z=0)
+engine.node.create(no=2, x=15, y=5, z=0)
+engine.node.create(no=3, x=7.5, y=0, z=0)
+engine.node.create(no=4, x=20, y=0, z=0)
 
 # Elements
-engine.element.create_beam3d(1, 3, nMat=1, nSec1=1, nSec2=1, no=1)
-engine.element.create_beam3d(2, 3, nMat=1, nSec1=2, nSec2=2, no=2)
+engine.element.create_beam3d(no=1, node1=1, node2=3, mat=1, sec1=1, sec2=1)
+engine.element.create_beam3d(no=2, node1=2, node2=3, mat=1, sec1=2, sec2=2)
 
 # Boundaries
 engine.boundary.create_general(no=1)
@@ -360,8 +360,8 @@ lc = engine.load.create(
     load_case_type="USER",
     prompt="Two forces applied at nodes 3 and 4"
 )
-lc.create_nforce(3, dFx=0, dFy=-1000000, dFz=0)
-lc.create_nforce(4, dFx=200000, dFy=0, dFz=0)
+lc.create_nforce(3, fx=0, fy=-1000000, fz=0)
+lc.create_nforce(4, fx=200000, fy=0, fz=0)
 
 # Solve
 engine.solve()

{osis_python-0.6.2 → osis_python-0.6.4/src/osis_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: osis-python
-Version: 0.6.2
+Version: 0.6.4
 Summary: A Python client library for Osis APDL
 Author-email: "CCCC Highway Consultant Co. Ltd." <support@osisbim.com>
 License-Expression: MIT
@@ -88,7 +88,7 @@ n2 = engine.node.create(no=2, x=15, y=0, z=0)
 
 # Create elements
 elem = engine.element.create_beam3d(
-    no=1, node1=n1.no, node2=n2.no, nMat=mat.no, nSec1=sec.no, nSec2=sec.no
+    no=1, node1=n1.no, node2=n2.no, mat=mat.no, sec1=sec.no, sec2=sec.no
 )
 
 # Create boundaries
@@ -136,7 +136,7 @@ from pyosis.material import material_manager
 from pyosis.node import node_manager
 
 mat = material_manager.create_conc(no=1, name="C30", code="JTG3362_2018", grade="C30")
-node = node_manager.create(0, 0, 0)
+node = node_manager.create(no=None, x=0, y=0, z=0)
 ```
 
 ### 4. Using OSISSolver — Start the Solver Directly (Solver-Only Mode)
@@ -208,8 +208,8 @@ engine.boundary.group.create("AbutmentBoundaries", "a", "1to2")
 
 # Various boundary types
 engine.boundary.create_general(no=1, x=1, y=1, z=1, rx=1, ry=1, rz=1, rw=1)           # General support
-engine.boundary.create_master_slave(no=1, node=1, dx=1, dy=1, dz=1, rx=0, ry=1, rz=1, coincident=2)  # Master-slave
-engine.boundary.create_rigid(no=1, nNodeI=1)                                               # Rigid link
+engine.boundary.create_master_slave(no=1, node=1, dx=1, dy=1, dz=1, rx=0, ry=1, rz=1, coincident=1)  # Master-slave
+engine.boundary.create_rigid(no=1, node_i=1)                                               # Rigid link
 engine.boundary.create_elstcspt(no=1, coor="", x=0, dx=1e9, y=0, dy=1e9, z=0, dz=1e9)     # Elastic support
 
 # Tendons
@@ -260,12 +260,12 @@ engine.prop.creep_shrink.create(no=1, name="Creep1", avg_humidity=70.0,
 # Damping (Rayleigh 自定义系数)
 engine.prop.damping.create_rayleigh_custom(name="Damping1", alpha=0.05, beta=0.005)
 
-# P-U curve (no, name, curve_type, num, values)
-#   curve_type: 1=水平位移推力 2=竖向位移推力 3=竖向力位移
-engine.prop.pu_curve.create(no=1, name="PU1", curve_type=1, num=3, values=[0, 0.01, 1000, 0.02, 1500])
+# P-U curve (no, name, curve_type, num, *values)
+#   curve_type: 0 = force, 1 = moment
+engine.prop.pu_curve.create(1, "PU1", 1, 3, 0, 0.01, 1000, 0.02, 1500)
 
 # Element thickness assignment (thickness, op, *elems)
-engine.prop.assign_component_thickness(thickness=0.3, op="a", elems=[1])
+engine.prop.assign_component_thickness(0.3, "a", 1)
 
 # Shell thickness (no, in_plane, out_plane)
 engine.thickness.create(no=1, in_plane=0.3, out_plane=0.3)
@@ -277,13 +277,13 @@ The `GeometryManager` supports querying geometric entities:
 
 ```python
 # Get all splines
-splines = engine.geometry.all("spline")
+splines = engine.geometry.all()
 
 # Get a specific spline
-spline = engine.geometry.get("spline", name="curve1")
+spline = engine.geometry.get("curve1")
 
-# Filter by type
-arcs = engine.geometry.filter("spline", spline_type="ARC3D")
+# Filter by type (General / Natural / Arc3D / Arc2D)
+arcs = [s for s in engine.geometry.all() if s.spline_type.name == "Arc3D"]
 ```
 
 ### Data Class Objects
@@ -299,7 +299,7 @@ print(elem.mat)         # Material ID
 # Objects support operations (operations下沉 to object)
 lc = engine.load.get("Self-weight")
 lc.create_gravity()
-lc.create_nforce(1, dFx=1000)
+lc.create_nforce(1, fx=1000)
 ```
 
 ### Explicit Numbering
@@ -363,23 +363,23 @@ engine.control.set_inc_tendon(True)
 engine.control.set_nonlinear(geom=False, link=False)
 
 # Sections
-engine.section.create_circle("CircleSection1", d=0.219, tw=0.012, no=1)
-engine.section.create_circle("CircleSection2", d=0.180, tw=0.008, no=2)
+engine.section.create_circle(no=1, name="CircleSection1", d=0.219, tw=0.012)
+engine.section.create_circle(no=2, name="CircleSection2", d=0.180, tw=0.008)
 
 # Materials
 engine.material.create_steel(
-    "Steel1", code="JTGD64_2015", grade="Q345", dmp=0.05, no=1
+    no=1, name="Steel1", code="JTGD64_2015", grade="Q345", dmp=0.05
 )
 
 # Nodes
-engine.node.create(0, 5, 0, no=1)
-engine.node.create(15, 5, 0, no=2)
-engine.node.create(7.5, 0, 0, no=3)
-engine.node.create(20, 0, 0, no=4)
+engine.node.create(no=1, x=0, y=5, z=0)
+engine.node.create(no=2, x=15, y=5, z=0)
+engine.node.create(no=3, x=7.5, y=0, z=0)
+engine.node.create(no=4, x=20, y=0, z=0)
 
 # Elements
-engine.element.create_beam3d(1, 3, nMat=1, nSec1=1, nSec2=1, no=1)
-engine.element.create_beam3d(2, 3, nMat=1, nSec1=2, nSec2=2, no=2)
+engine.element.create_beam3d(no=1, node1=1, node2=3, mat=1, sec1=1, sec2=1)
+engine.element.create_beam3d(no=2, node1=2, node2=3, mat=1, sec1=2, sec2=2)
 
 # Boundaries
 engine.boundary.create_general(no=1)
@@ -391,8 +391,8 @@ lc = engine.load.create(
     load_case_type="USER",
     prompt="Two forces applied at nodes 3 and 4"
 )
-lc.create_nforce(3, dFx=0, dFy=-1000000, dFz=0)
-lc.create_nforce(4, dFx=200000, dFy=0, dFz=0)
+lc.create_nforce(3, fx=0, fy=-1000000, fz=0)
+lc.create_nforce(4, fx=200000, fy=0, fz=0)
 
 # Solve
 engine.solve()

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

{osis_python-0.6.2 → osis_python-0.6.4}/src/pyosis/boundary/manager.py

@@ -688,9 +688,9 @@ class BoundaryManager:
             RuntimeError: 创建失败
 
         Examples:
-            >>> boundary_manager.create(None, "GENERAL", bX=1, bY=1, bZ=1)
-            >>> boundary_manager.create(1, "MSTSLV", nNode=10)
-            >>> boundary_manager.create(2, "RIGID", nNodeI=5)
+            >>> boundary_manager.create(None, "GENERAL", x=1, y=1, z=1)
+            >>> boundary_manager.create(1, "MSTSLV", node=10)
+            >>> boundary_manager.create(2, "RIGID", node_i=5)
         """
         _creator = {
             "GENERAL": self.create_general,
@@ -973,26 +973,26 @@ class BoundaryManager:
     def create_rigid(
         self,
         no: int | None,
-        nNodeI: int,
+        node_i: int,
     ) -> Boundary:
         '''创建刚性连接
 
-        将主节点 nNodeI 与通过 assign 分配的从节点绑定为刚性区域，
+        将主节点 node_i 与通过 assign 分配的从节点绑定为刚性区域，
         刚性区域内所有节点的 6 个自由度保持完全一致。
 
         Args:
             no: 边界编号，None 时自动分配
-            nNodeI: 节点1编号（刚性区域的主节点）
+            node_i: 节点1编号（刚性区域的主节点）
 
         Returns:
             Boundary 对象
 
         Notes:
-            用于形成刚性区域的从节点号 nodeJ, nodeK, ..., nodeL 由 assign 方法定义。
+            用于形成刚性区域的从节点号 node_j, node_k, ..., node_l 由 assign 方法定义。
         '''
         if no is None:
             no = self._next_no()
-        ok, err = osis_boundary_rigid(no, "RIGID", nNodeI)
+        ok, err = osis_boundary_rigid(no, "RIGID", node_i)
         if not ok:
             raise RuntimeError(f"创建刚性连接 {no} 失败: {err}")
         return self.get(no)  # type: ignore[return-value]

{osis_python-0.6.2 → osis_python-0.6.4}/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.2 → osis_python-0.6.4}/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.2 → osis_python-0.6.4}/src/pyosis/element/manager.py

@@ -553,7 +553,7 @@ class ElementManager:
 
     用法:
         >>> from pyosis.element import element_manager
-        >>> elem = element_manager.create_beam3d(1, 2, nMat=1, nSec1=1, nSec2=1)
+        >>> elem = element_manager.create_beam3d(1, 2, mat=1, sec1=1, sec2=1)
         >>> elem.no
         >>> elem.element_type
         >>> all_elems = element_manager.all()
@@ -616,7 +616,7 @@ class ElementManager:
             RuntimeError: 创建失败
 
         Examples:
-            >>> element_manager.create(None, "BEAM3D", 1, 2, nMat=1, nSec1=1, nSec2=1)
+            >>> element_manager.create(None, "BEAM3D", 1, 2, mat=1, sec1=1, sec2=1)
             >>> element_manager.create(10, "TRUSS", 1, 2, 1, 1, 1)
         """
         _creator = {
@@ -638,15 +638,15 @@ class ElementManager:
         no: int | None,
         node1: int,
         node2: int,
-        nMat: int,
-        nSec1: int,
-        nSec2: int,
-        nYTrans: Literal[1, 2, 3, 4] = 1,
-        nZTrans: Literal[1, 2, 3, 4] = 1,
-        dStrain: float = 0.0,
-        bFlag: bool = 0,
-        dTheta: float = 0,
-        bWarping: bool = 0,
+        mat: int,
+        sec1: int,
+        sec2: int,
+        y_trans: Literal[1, 2, 3, 4] = 1,
+        z_trans: Literal[1, 2, 3, 4] = 1,
+        strain: float = 0.0,
+        flag: bool = 0,
+        theta: float = 0,
+        warping: bool = 0,
     ) -> Element:
         '''创建梁柱单元
 
@@ -657,19 +657,19 @@ class ElementManager:
             no: 单元编号，None 时自动分配
             node1: 节点1编号
             node2: 节点2编号
-            nMat: 材料编号
-            nSec1: I 端截面1编号
-            nSec2: J 端截面2编号
-            nYTrans: y 轴截面变化次方，可选值：1, 2, 3, 4
-            nZTrans: z 轴截面变化次方，可选值：1, 2, 3, 4
-            dStrain: 应变值，默认为 0.0
-            bFlag: 轴向转角定义方式：
+            mat: 材料编号
+            sec1: I 端截面1编号
+            sec2: J 端截面2编号
+            y_trans: y 轴截面变化次方，可选值：1, 2, 3, 4
+            z_trans: z 轴截面变化次方，可选值：1, 2, 3, 4
+            strain: 应变值，默认为 0.0
+            flag: 轴向转角定义方式：
                 * 0: 使用 beta 角定义
                 * 1: 使用关键点定义
-            dTheta: 轴向转角参数：
-                * bFlag=0 时: 轴向转角（beta 角）
-                * bFlag=1 时: 关键点
-            bWarping: 翘曲效应标志：
+            theta: 轴向转角参数：
+                * flag=0 时: 轴向转角（beta 角）
+                * flag=1 时: 关键点
+            warping: 翘曲效应标志：
                 * 1: 考虑翘曲
                 * 0: 不考虑翘曲
 
@@ -677,13 +677,13 @@ class ElementManager:
             Element 对象
 
         Examples:
-            >>> element_manager.create_beam3d(None, 1, 2, nMat=1, nSec1=1, nSec2=1)
+            >>> element_manager.create_beam3d(None, 1, 2, mat=1, sec1=1, sec2=1)
         '''
         if no is None:
             no = self._next_no()
         ok, err = osis_element_beam3d(
-            no, "BEAM3D", node1, node2, nMat, nSec1, nSec2,
-            nYTrans, nZTrans, dStrain, bFlag, dTheta, bWarping
+            no, "BEAM3D", node1, node2, mat, sec1, sec2,
+            y_trans, z_trans, strain, flag, theta, warping
         )
         if not ok:
             raise RuntimeError(f"创建梁单元 {no} 失败: {err}")
@@ -694,10 +694,10 @@ class ElementManager:
         no: int | None,
         node1: int,
         node2: int,
-        nMat: int,
-        nSec1: int,
-        nSec2: int,
-        dStrain: float = 0.0,
+        mat: int,
+        sec1: int,
+        sec2: int,
+        strain: float = 0.0,
     ) -> Element:
         '''创建桁架单元
 
@@ -707,20 +707,20 @@ class ElementManager:
             no: 单元编号，None 时自动分配
             node1: 节点1编号
             node2: 节点2编号
-            nMat: 材料编号
-            nSec1: I 端截面1编号
-            nSec2: J 端截面2编号
-            dStrain: 应变值，默认为 0.0
+            mat: 材料编号
+            sec1: I 端截面1编号
+            sec2: J 端截面2编号
+            strain: 应变值，默认为 0.0
 
         Returns:
             Element 对象
 
         Examples:
-            >>> element_manager.create_truss(None, 1, 2, nMat=1, nSec1=1, nSec2=1)
+            >>> element_manager.create_truss(None, 1, 2, mat=1, sec1=1, sec2=1)
         '''
         if no is None:
             no = self._next_no()
-        ok, err = osis_element_truss(no, "TRUSS", node1, node2, nMat, nSec1, nSec2, dStrain)
+        ok, err = osis_element_truss(no, "TRUSS", node1, node2, mat, sec1, sec2, strain)
         if not ok:
             raise RuntimeError(f"创建桁架单元 {no} 失败: {err}")
         return self.get(no)  # type: ignore[return-value]
@@ -730,7 +730,7 @@ class ElementManager:
         no: int | None,
         node1: int,
         node2: int,
-        bLinear: int = 1,
+        is_linear: int = 1,
         dx: float = 10,
         dy: float = 10,
         dz: float = 10,
@@ -747,39 +747,39 @@ class ElementManager:
             no: 单元编号，None 时自动分配
             node1: 节点1编号
             node2: 节点2编号
-            bLinear: 弹簧类型标志：
+            is_linear: 弹簧类型标志：
                 * 1: 线性弹簧
                 * 0: 非线性弹簧
             dx: x 方向自由度参数：
-                * 线性弹簧 (bLinear=1): 局部坐标系下 dx 方向的刚度值
-                * 非线性弹簧 (bLinear=0): 局部坐标系下 dx 方向的力-位移曲线编号（PUCurve 定义）
+                * 线性弹簧 (is_linear=1): 局部坐标系下 dx 方向的刚度值
+                * 非线性弹簧 (is_linear=0): 局部坐标系下 dx 方向的力-位移曲线编号（PUCurve 定义）
             dy: y 方向自由度参数：
-                * 线性弹簧 (bLinear=1): 局部坐标系下 dy 方向的刚度值
-                * 非线性弹簧 (bLinear=0): 局部坐标系下 dy 方向的力-位移曲线编号（PUCurve 定义）
+                * 线性弹簧 (is_linear=1): 局部坐标系下 dy 方向的刚度值
+                * 非线性弹簧 (is_linear=0): 局部坐标系下 dy 方向的力-位移曲线编号（PUCurve 定义）
             dz: z 方向自由度参数：
-                * 线性弹簧 (bLinear=1): 局部坐标系下 dz 方向的刚度值
-                * 非线性弹簧 (bLinear=0): 局部坐标系下 dz 方向的力-位移曲线编号（PUCurve 定义）
+                * 线性弹簧 (is_linear=1): 局部坐标系下 dz 方向的刚度值
+                * 非线性弹簧 (is_linear=0): 局部坐标系下 dz 方向的力-位移曲线编号（PUCurve 定义）
             rx: 绕 x 轴旋转自由度参数：
-                * 线性弹簧 (bLinear=1): 局部坐标系下 rx 方向的刚度值
-                * 非线性弹簧 (bLinear=0): 局部坐标系下 rx 方向的力-位移曲线编号（PUCurve 定义）
+                * 线性弹簧 (is_linear=1): 局部坐标系下 rx 方向的刚度值
+                * 非线性弹簧 (is_linear=0): 局部坐标系下 rx 方向的力-位移曲线编号（PUCurve 定义）
             ry: 绕 y 轴旋转自由度参数：
-                * 线性弹簧 (bLinear=1): 局部坐标系下 ry 方向的刚度值
-                * 非线性弹簧 (bLinear=0): 局部坐标系下 ry 方向的力-位移曲线编号（PUCurve 定义）
+                * 线性弹簧 (is_linear=1): 局部坐标系下 ry 方向的刚度值
+                * 非线性弹簧 (is_linear=0): 局部坐标系下 ry 方向的力-位移曲线编号（PUCurve 定义）
             rz: 绕 z 轴旋转自由度参数：
-                * 线性弹簧 (bLinear=1): 局部坐标系下 rz 方向的刚度值
-                * 非线性弹簧 (bLinear=0): 局部坐标系下 rz 方向的力-位移曲线编号（PUCurve 定义）
+                * 线性弹簧 (is_linear=1): 局部坐标系下 rz 方向的刚度值
+                * 非线性弹簧 (is_linear=0): 局部坐标系下 rz 方向的力-位移曲线编号（PUCurve 定义）
             beta: 轴向转角（beta 角），默认为 0.0
 
         Returns:
             Element 对象
 
         Examples:
-            >>> element_manager.create_spring(None, 1, 2, bLinear=1)
+            >>> element_manager.create_spring(None, 1, 2, is_linear=1)
         '''
         if no is None:
             no = self._next_no()
         ok, err = osis_element_spring(
-            no, "SPRING", node1, node2, bLinear, dx, dy, dz, rx, ry, rz, beta
+            no, "SPRING", node1, node2, is_linear, dx, dy, dz, rx, ry, rz, beta
         )
         if not ok:
             raise RuntimeError(f"创建弹簧单元 {no} 失败: {err}")

{osis_python-0.6.2 → osis_python-0.6.4}/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.2 → osis_python-0.6.4}/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: 分配失败时抛出
         '''