osis-python 0.3.0__tar.gz → 0.3.1__tar.gz

{osis_python-0.3.0/src/osis_python.egg-info → osis_python-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: osis-python
-Version: 0.3.0
+Version: 0.3.1
 Summary: A Python client library for Osis APDL
 Author-email: "CCCC Highway Consultant Co. Ltd." <support@osisbim.com>
 License-Expression: MIT
@@ -102,7 +102,31 @@ lc.create_gravity()
 engine.solve()
 ```
 
-### 2. Using Managers Directly
+### 2. Engine Convenience Methods
+
+`OSISEngine` provides project-level convenience methods:
+
+```python
+# Project management
+engine.new_project()           # Create new project
+engine.save_project()          # Save current project
+engine.open_project(path)      # Open existing project
+
+# Model information
+summary = engine.model_summary()  # Returns dict with all manager counts
+
+# Import/Export
+engine.export_apdl(path)       # Export to APDL format
+engine.import_apdl(path)       # Import from APDL format
+
+# Result output for calculation book
+engine.output_result_for_calc_book()
+
+# Matrix output
+engine.matrix("matrix_1", [[1, 2],[3, 4]])
+```
+
+### 3. Using Managers Directly
 
 If you don't need the convenience methods of Engine, you can also import individual managers directly:
 
@@ -127,6 +151,9 @@ pyosis adopts a Manager pattern to organize code. Each module corresponds to a M
 | NodeManager | `engine.node` | Nodes |
 | ElementManager | `engine.element` | Elements (beam, truss, spring, cable, shell) |
 | BoundaryManager | `engine.boundary` | Boundaries (general support, master-slave, elastic support, etc.) |
+| GeometryManager | `engine.geometry` | Geometric entities (splines, spatial curves) |
+| PropertyManager | `engine.prop` | Properties (coordinate systems, creep/shrinkage, damping, P-U curves, element thickness assignments) |
+| ThicknessManager | `engine.thickness` | Shell thickness properties |
 | LoadCaseManager | `engine.load` | Load cases |
 | StageManager | `engine.stage` | Construction stages |
 | TendonManager | `engine.tendon` | Tendons (properties + shapes) |
@@ -152,6 +179,15 @@ grp.add([1, 2, 3])
 bg = engine.boundary.group.create("Abutment Boundaries")
 bg.add([1, 2])
 
+# Various boundary types
+engine.boundary.create_general(bX=1, bY=1, bZ=1, bRX=1, bRY=1, bRZ=1)  # General support
+engine.boundary.create_master_slave(nMast=1, nSlav=2, dDir=1)           # Master-slave
+engine.boundary.create_release(nElem=1, iReleaseEnd=2)                  # End release
+engine.boundary.create_elstcspt(nNode=1, dK=[1e9, 1e9, 1e9, 0, 0, 0])  # Elastic support
+engine.boundary.create_general_elstcspt(nNode=1, bX=1, bY=1, bZ=1, dKx=1e9, dKy=1e9, dKz=1e9)  # General elastic
+engine.boundary.create_rigid(nNode1=1, nNode2=2)                        # Rigid link
+engine.boundary.create_section_factor(nElem=1, iEnd=1)                  # Section factor
+
 # Tendons
 prop = engine.tendon.prop.create_in(
     "15-10", mat_no=1, e_code="GBT5224_2014",
@@ -168,6 +204,44 @@ lane = engine.live.lane.create("Lane 1")
 case = engine.live.case.create("Live Load Case 1")
 ```
 
+### Property & Thickness Management
+
+```python
+# Coordinate systems
+engine.prop.coord.create_local("CS1", origin=[0, 0, 0], x_axis=[1, 0, 0], y_axis=[0, 1, 0])
+
+# Creep and shrinkage
+engine.prop.creep_shrink.create("Creep1", eCode="JTG3362_2018", eGrade="C30")
+
+# Damping
+engine.prop.damping.create("Damping1", dDmp=0.05)
+
+# P-U curve (for soil-structure interaction)
+engine.prop.pu_curve.create("PU1", data=[(0, 0), (0.01, 1000), (0.02, 1500)])
+
+# Element thickness assignment
+engine.prop.thickness.assign_element(nElem=1, dThick=0.3)
+
+# Shell thickness properties
+engine.thickness.create_uniform("Thick1", dThick=0.3)
+engine.thickness.create_tapered("Thick2", dThick1=0.2, dThick2=0.4)
+```
+
+### Geometry Queries
+
+The `GeometryManager` supports querying geometric entities:
+
+```python
+# Get all splines
+splines = engine.geometry.all("spline")
+
+# Get a specific spline
+spline = engine.geometry.get("spline", name="curve1")
+
+# Filter by type
+arcs = engine.geometry.filter("spline", spline_type="ARC3D")
+```
+
 ### Data Class Objects
 
 Create and query operations return data class objects (dataclass) instead of raw dictionaries:
@@ -209,7 +283,7 @@ df = engine.result.env("Basic Combination Envelope", "EnvEF")
 
 # Export design check results
 df = engine.result.check(
-    "Concrete", "Ultimate Bending Capacity Check", "Basic Combination"
+    "混凝土", "正截面抗弯验算", "Basic Combination"
 )
 
 # Batch export all check results from Check folder
@@ -284,9 +358,8 @@ engine.solve()
 
 1. **OSIS must be running**: Before executing code, ensure the OSIS software is launched and logged in. pyosis communicates with OSIS via HTTP.
 2. **Exception handling**: All operations throw `RuntimeError` on failure. It is recommended to add exception handling in production code.
-3. **Stateless design**: Managers do not cache data. Frequent calls to `all()` and other query methods incur network overhead. Use cautiously in loops.
+3. **Stateless design**: Managers do not cache data. Every query method (`all()`, `get()`, `filter()`) fetches fresh data from OSIS via HTTP. This ensures consistency but incurs network overhead. Cache results locally when iterating in loops.
 4. **Number uniqueness**: When explicitly specifying `no`, if the number already exists, the behavior depends on the OSIS underlying implementation (usually overwrites or raises an error).
-5. **Command mode**: When executing code in OSIS command mode, you can directly send Python code blocks. When executing in an IDE, ensure OSIS is running.
 
 ## More Resources
 

{osis_python-0.3.0 → osis_python-0.3.1}/README.md

@@ -71,7 +71,31 @@ lc.create_gravity()
 engine.solve()
 ```
 
-### 2. Using Managers Directly
+### 2. Engine Convenience Methods
+
+`OSISEngine` provides project-level convenience methods:
+
+```python
+# Project management
+engine.new_project()           # Create new project
+engine.save_project()          # Save current project
+engine.open_project(path)      # Open existing project
+
+# Model information
+summary = engine.model_summary()  # Returns dict with all manager counts
+
+# Import/Export
+engine.export_apdl(path)       # Export to APDL format
+engine.import_apdl(path)       # Import from APDL format
+
+# Result output for calculation book
+engine.output_result_for_calc_book()
+
+# Matrix output
+engine.matrix("matrix_1", [[1, 2],[3, 4]])
+```
+
+### 3. Using Managers Directly
 
 If you don't need the convenience methods of Engine, you can also import individual managers directly:
 
@@ -96,6 +120,9 @@ pyosis adopts a Manager pattern to organize code. Each module corresponds to a M
 | NodeManager | `engine.node` | Nodes |
 | ElementManager | `engine.element` | Elements (beam, truss, spring, cable, shell) |
 | BoundaryManager | `engine.boundary` | Boundaries (general support, master-slave, elastic support, etc.) |
+| GeometryManager | `engine.geometry` | Geometric entities (splines, spatial curves) |
+| PropertyManager | `engine.prop` | Properties (coordinate systems, creep/shrinkage, damping, P-U curves, element thickness assignments) |
+| ThicknessManager | `engine.thickness` | Shell thickness properties |
 | LoadCaseManager | `engine.load` | Load cases |
 | StageManager | `engine.stage` | Construction stages |
 | TendonManager | `engine.tendon` | Tendons (properties + shapes) |
@@ -121,6 +148,15 @@ grp.add([1, 2, 3])
 bg = engine.boundary.group.create("Abutment Boundaries")
 bg.add([1, 2])
 
+# Various boundary types
+engine.boundary.create_general(bX=1, bY=1, bZ=1, bRX=1, bRY=1, bRZ=1)  # General support
+engine.boundary.create_master_slave(nMast=1, nSlav=2, dDir=1)           # Master-slave
+engine.boundary.create_release(nElem=1, iReleaseEnd=2)                  # End release
+engine.boundary.create_elstcspt(nNode=1, dK=[1e9, 1e9, 1e9, 0, 0, 0])  # Elastic support
+engine.boundary.create_general_elstcspt(nNode=1, bX=1, bY=1, bZ=1, dKx=1e9, dKy=1e9, dKz=1e9)  # General elastic
+engine.boundary.create_rigid(nNode1=1, nNode2=2)                        # Rigid link
+engine.boundary.create_section_factor(nElem=1, iEnd=1)                  # Section factor
+
 # Tendons
 prop = engine.tendon.prop.create_in(
     "15-10", mat_no=1, e_code="GBT5224_2014",
@@ -137,6 +173,44 @@ lane = engine.live.lane.create("Lane 1")
 case = engine.live.case.create("Live Load Case 1")
 ```
 
+### Property & Thickness Management
+
+```python
+# Coordinate systems
+engine.prop.coord.create_local("CS1", origin=[0, 0, 0], x_axis=[1, 0, 0], y_axis=[0, 1, 0])
+
+# Creep and shrinkage
+engine.prop.creep_shrink.create("Creep1", eCode="JTG3362_2018", eGrade="C30")
+
+# Damping
+engine.prop.damping.create("Damping1", dDmp=0.05)
+
+# P-U curve (for soil-structure interaction)
+engine.prop.pu_curve.create("PU1", data=[(0, 0), (0.01, 1000), (0.02, 1500)])
+
+# Element thickness assignment
+engine.prop.thickness.assign_element(nElem=1, dThick=0.3)
+
+# Shell thickness properties
+engine.thickness.create_uniform("Thick1", dThick=0.3)
+engine.thickness.create_tapered("Thick2", dThick1=0.2, dThick2=0.4)
+```
+
+### Geometry Queries
+
+The `GeometryManager` supports querying geometric entities:
+
+```python
+# Get all splines
+splines = engine.geometry.all("spline")
+
+# Get a specific spline
+spline = engine.geometry.get("spline", name="curve1")
+
+# Filter by type
+arcs = engine.geometry.filter("spline", spline_type="ARC3D")
+```
+
 ### Data Class Objects
 
 Create and query operations return data class objects (dataclass) instead of raw dictionaries:
@@ -178,7 +252,7 @@ df = engine.result.env("Basic Combination Envelope", "EnvEF")
 
 # Export design check results
 df = engine.result.check(
-    "Concrete", "Ultimate Bending Capacity Check", "Basic Combination"
+    "混凝土", "正截面抗弯验算", "Basic Combination"
 )
 
 # Batch export all check results from Check folder
@@ -253,9 +327,8 @@ engine.solve()
 
 1. **OSIS must be running**: Before executing code, ensure the OSIS software is launched and logged in. pyosis communicates with OSIS via HTTP.
 2. **Exception handling**: All operations throw `RuntimeError` on failure. It is recommended to add exception handling in production code.
-3. **Stateless design**: Managers do not cache data. Frequent calls to `all()` and other query methods incur network overhead. Use cautiously in loops.
+3. **Stateless design**: Managers do not cache data. Every query method (`all()`, `get()`, `filter()`) fetches fresh data from OSIS via HTTP. This ensures consistency but incurs network overhead. Cache results locally when iterating in loops.
 4. **Number uniqueness**: When explicitly specifying `no`, if the number already exists, the behavior depends on the OSIS underlying implementation (usually overwrites or raises an error).
-5. **Command mode**: When executing code in OSIS command mode, you can directly send Python code blocks. When executing in an IDE, ensure OSIS is running.
 
 ## More Resources
 

{osis_python-0.3.0 → osis_python-0.3.1/src/osis_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: osis-python
-Version: 0.3.0
+Version: 0.3.1
 Summary: A Python client library for Osis APDL
 Author-email: "CCCC Highway Consultant Co. Ltd." <support@osisbim.com>
 License-Expression: MIT
@@ -102,7 +102,31 @@ lc.create_gravity()
 engine.solve()
 ```
 
-### 2. Using Managers Directly
+### 2. Engine Convenience Methods
+
+`OSISEngine` provides project-level convenience methods:
+
+```python
+# Project management
+engine.new_project()           # Create new project
+engine.save_project()          # Save current project
+engine.open_project(path)      # Open existing project
+
+# Model information
+summary = engine.model_summary()  # Returns dict with all manager counts
+
+# Import/Export
+engine.export_apdl(path)       # Export to APDL format
+engine.import_apdl(path)       # Import from APDL format
+
+# Result output for calculation book
+engine.output_result_for_calc_book()
+
+# Matrix output
+engine.matrix("matrix_1", [[1, 2],[3, 4]])
+```
+
+### 3. Using Managers Directly
 
 If you don't need the convenience methods of Engine, you can also import individual managers directly:
 
@@ -127,6 +151,9 @@ pyosis adopts a Manager pattern to organize code. Each module corresponds to a M
 | NodeManager | `engine.node` | Nodes |
 | ElementManager | `engine.element` | Elements (beam, truss, spring, cable, shell) |
 | BoundaryManager | `engine.boundary` | Boundaries (general support, master-slave, elastic support, etc.) |
+| GeometryManager | `engine.geometry` | Geometric entities (splines, spatial curves) |
+| PropertyManager | `engine.prop` | Properties (coordinate systems, creep/shrinkage, damping, P-U curves, element thickness assignments) |
+| ThicknessManager | `engine.thickness` | Shell thickness properties |
 | LoadCaseManager | `engine.load` | Load cases |
 | StageManager | `engine.stage` | Construction stages |
 | TendonManager | `engine.tendon` | Tendons (properties + shapes) |
@@ -152,6 +179,15 @@ grp.add([1, 2, 3])
 bg = engine.boundary.group.create("Abutment Boundaries")
 bg.add([1, 2])
 
+# Various boundary types
+engine.boundary.create_general(bX=1, bY=1, bZ=1, bRX=1, bRY=1, bRZ=1)  # General support
+engine.boundary.create_master_slave(nMast=1, nSlav=2, dDir=1)           # Master-slave
+engine.boundary.create_release(nElem=1, iReleaseEnd=2)                  # End release
+engine.boundary.create_elstcspt(nNode=1, dK=[1e9, 1e9, 1e9, 0, 0, 0])  # Elastic support
+engine.boundary.create_general_elstcspt(nNode=1, bX=1, bY=1, bZ=1, dKx=1e9, dKy=1e9, dKz=1e9)  # General elastic
+engine.boundary.create_rigid(nNode1=1, nNode2=2)                        # Rigid link
+engine.boundary.create_section_factor(nElem=1, iEnd=1)                  # Section factor
+
 # Tendons
 prop = engine.tendon.prop.create_in(
     "15-10", mat_no=1, e_code="GBT5224_2014",
@@ -168,6 +204,44 @@ lane = engine.live.lane.create("Lane 1")
 case = engine.live.case.create("Live Load Case 1")
 ```
 
+### Property & Thickness Management
+
+```python
+# Coordinate systems
+engine.prop.coord.create_local("CS1", origin=[0, 0, 0], x_axis=[1, 0, 0], y_axis=[0, 1, 0])
+
+# Creep and shrinkage
+engine.prop.creep_shrink.create("Creep1", eCode="JTG3362_2018", eGrade="C30")
+
+# Damping
+engine.prop.damping.create("Damping1", dDmp=0.05)
+
+# P-U curve (for soil-structure interaction)
+engine.prop.pu_curve.create("PU1", data=[(0, 0), (0.01, 1000), (0.02, 1500)])
+
+# Element thickness assignment
+engine.prop.thickness.assign_element(nElem=1, dThick=0.3)
+
+# Shell thickness properties
+engine.thickness.create_uniform("Thick1", dThick=0.3)
+engine.thickness.create_tapered("Thick2", dThick1=0.2, dThick2=0.4)
+```
+
+### Geometry Queries
+
+The `GeometryManager` supports querying geometric entities:
+
+```python
+# Get all splines
+splines = engine.geometry.all("spline")
+
+# Get a specific spline
+spline = engine.geometry.get("spline", name="curve1")
+
+# Filter by type
+arcs = engine.geometry.filter("spline", spline_type="ARC3D")
+```
+
 ### Data Class Objects
 
 Create and query operations return data class objects (dataclass) instead of raw dictionaries:
@@ -209,7 +283,7 @@ df = engine.result.env("Basic Combination Envelope", "EnvEF")
 
 # Export design check results
 df = engine.result.check(
-    "Concrete", "Ultimate Bending Capacity Check", "Basic Combination"
+    "混凝土", "正截面抗弯验算", "Basic Combination"
 )
 
 # Batch export all check results from Check folder
@@ -284,9 +358,8 @@ engine.solve()
 
 1. **OSIS must be running**: Before executing code, ensure the OSIS software is launched and logged in. pyosis communicates with OSIS via HTTP.
 2. **Exception handling**: All operations throw `RuntimeError` on failure. It is recommended to add exception handling in production code.
-3. **Stateless design**: Managers do not cache data. Frequent calls to `all()` and other query methods incur network overhead. Use cautiously in loops.
+3. **Stateless design**: Managers do not cache data. Every query method (`all()`, `get()`, `filter()`) fetches fresh data from OSIS via HTTP. This ensures consistency but incurs network overhead. Cache results locally when iterating in loops.
 4. **Number uniqueness**: When explicitly specifying `no`, if the number already exists, the behavior depends on the OSIS underlying implementation (usually overwrites or raises an error).
-5. **Command mode**: When executing code in OSIS command mode, you can directly send Python code blocks. When executing in an IDE, ensure OSIS is running.
 
 ## More Resources
 

{osis_python-0.3.0 → osis_python-0.3.1}/src/osis_python.egg-info/SOURCES.txt

@@ -92,4 +92,8 @@ src/pyosis/stage/manager.py
 src/pyosis/stage/overall.py
 src/pyosis/thickness/__init__.py
 src/pyosis/thickness/interface.py
-src/pyosis/thickness/manager.py
+src/pyosis/thickness/manager.py
+src/pyosis/transfer/__init__.py
+src/pyosis/transfer/command_map.py
+src/pyosis/transfer/generator.py
+src/pyosis/transfer/parser.py

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

{osis_python-0.3.0 → osis_python-0.3.1}/src/pyosis/boundary/manager.py

@@ -29,6 +29,7 @@ from .interface import (
     osis_boundary_master_slave,
     osis_boundary_release,
     osis_boundary_general_elstcspt,
+    osis_boundary_rigid,
     osis_boundary_section_factor,
     osis_boundary_group,
     osis_boundary_del,
@@ -788,6 +789,30 @@ class BoundaryManager:
             raise RuntimeError(f"创建一般弹性支承 {no} 失败: {err}")
         return self.get(no)  # type: ignore[return-value]
 
+    def create_rigid(
+        self,
+        nNodeI: int,
+        no: int | None = None,
+    ) -> Boundary:
+        """创建刚性连接
+
+        Args:
+            nNodeI: 节点1编号（刚性区域的主节点）
+            no: 边界编号，None 时自动分配
+
+        Returns:
+            Boundary 对象
+
+        Notes:
+            用于形成刚性区域的节点号 nodeJ, nodeK, ..., nodeL 由 assign 方法定义
+        """
+        if no is None:
+            no = self._next_no()
+        ok, err = osis_boundary_rigid(no, "RIGID", nNodeI)
+        if not ok:
+            raise RuntimeError(f"创建刚性连接 {no} 失败: {err}")
+        return self.get(no)  # type: ignore[return-value]
+
     def delete(self, no: int) -> None:
         """删除边界"""
         ok, err = osis_boundary_del(no)

{osis_python-0.3.0 → osis_python-0.3.1}/src/pyosis/core/engine.py

@@ -327,6 +327,11 @@ class OSISEngine:
             "boundaries": self._boundary.count(),
             "load_cases": self._load.count(),
             "stages": self._stage.count(),
+            "geometry": self._geometry.count(),
+            "live_loads": self._live.count(),
+            "settlements": self._settlement.count(),
+            "tendon_props": self._tendon.prop.count(),
+            "tendon_shapes": self._tendon.shape.count(),
         }
 
     def __repr__(self) -> str:

{osis_python-0.3.0 → osis_python-0.3.1}/src/pyosis/live/manager.py

@@ -978,6 +978,18 @@ class LiveManager:
         """
         return self._case_manager
 
+    def count(self) -> dict[str, int]:
+        """获取活载各组件数量
+        
+        Returns:
+            活载等级、车道、活载工况数量的字典
+        """
+        return {
+            "grades": self._grade_manager.count(),
+            "lanes": self._lane_manager.count(),
+            "cases": self._case_manager.count(),
+        }
+
     def __repr__(self) -> str:
         return f"LiveManager()"
 

osis_python-0.3.1/src/pyosis/transfer/__init__.py

@@ -0,0 +1,50 @@
+"""pyosis 命令流转换模块
+
+提供 OSIS 命令流与 pyosis Engine API 之间的双向转换能力。
+
+主要组件:
+    - command_map: 命令映射表
+    - parser: 命令流解析器
+    - generator: pyosis 代码生成器
+
+用法:
+    from pyosis.transfer import CommandParser, PyosisGenerator
+    
+    # 解析命令流
+    parser = CommandParser()
+    modules = parser.parse_file("path/to/OSIS.out")
+    
+    # 生成 pyosis 代码
+    generator = PyosisGenerator()
+    code = generator.generate_module("MATERIAL", modules["MATERIAL"])
+"""
+
+from .command_map import (
+    CMD_MAP,
+    DISPATCHER_CONFIG,
+    CommandMapping,
+    lookup_command,
+    list_all_commands,
+)
+
+from .parser import (
+    CommandParser,
+    ParsedCommand,
+)
+
+from .generator import (
+    PyosisGenerator,
+    IndexTracker,
+)
+
+__all__ = [
+    "CMD_MAP",
+    "DISPATCHER_CONFIG",
+    "CommandMapping",
+    "lookup_command",
+    "list_all_commands",
+    "CommandParser",
+    "ParsedCommand",
+    "PyosisGenerator",
+    "IndexTracker",
+]