osis-python 0.7.0__py3-none-any.whl → 0.7.3__py3-none-any.whl

{osis_python-0.7.0.dist-info → osis_python-0.7.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: osis-python
-Version: 0.7.0
+Version: 0.7.3
 Summary: A Python client library for Osis APDL
 Author-email: "CCCC Highway Consultant Co. Ltd." <support@osisbim.com>
 License-Expression: MIT
@@ -53,10 +53,12 @@ pip install osis-python -i https://pypi.org/simple
 
 ## Requirements
 
-- OSIS >= 5.0 (includes the required Python runtime environment)
+- OSIS >= 5.1 (short-form command names like `N`/`Ele`/`Sec` are accepted by both the converter and runtime)
 - Python >= 3.8
 - **Solver-only mode** additionally requires the solver distribution that ships `PySolver.dll` (e.g. `D:\OSIS_Solver\Rbin64`).
 
+> OSIS 5.1 HTTP server bug workaround: the `/OSIS_Run` command-stream splitter does not strip `//` line comments, so a comment line and the command that follows it are merged into one bad command. The pyosis `.out` converter already strips comments before sending; if you ever build a raw `.out` payload yourself, pre-process the file or use `osis_run()` through the generated `main.py`.
+
 ## Quick Start
 
 ### 1. Using OSISEngine (Recommended)
@@ -398,7 +400,7 @@ lc.create_nforce(4, fx=200000, fy=0, fz=0)
 engine.solve()
 ```
 
-## End-to-End Demo
+## End-to-End Demo (Solver-Only Mode)
 
 See [`tests/pyosis_demo.py`](tests/pyosis_demo.py) for a runnable end-to-end example that:
 
@@ -408,3 +410,109 @@ See [`tests/pyosis_demo.py`](tests/pyosis_demo.py) for a runnable end-to-end exa
 - Exports LCND / LCEF / EnvND / EnvEF results to CSV
 
 The demo reuses the prep modules from `tests/output/output_py/25m简支小箱梁中梁-solveronly/`, so it serves both as a smoke test and a copy-paste template.
+
+## Batch Execution
+
+For non-interactive workflows (large models, customer scripts that took tens of minutes per command), wrap your script in `with batch():` to merge **all** OSIS commands into a **single** `OSIS_Run` HTTP request when the block exits:
+
+```python
+from pyosis import batch
+
+with batch():
+    engine.clear()
+    engine.clc()
+    engine.control.set_gravity_acceleration(9.8066)
+    engine.material.create_conc(no=1, name="C50", ...)
+    for i in range(1000):
+        engine.node.create(no=i + 1, x=i * 0.1, y=0.0, z=0.0)
+    for i in range(999):
+        engine.element.create_beam3d(no=i + 1, node1=i + 1, node2=i + 2, ...)
+```
+
+Server-side `OSIS_Run` calls `SplitOsisCommands` once and then a single `Execution(&v)`, so the network round-trip cost is paid exactly once instead of once per command. Intermediate reads (`get`, `all`) auto-flush the buffer first, so cached objects stay correct.
+
+Notes:
+
+- Nested `with batch():` is supported — the inner exit does not flush; only the outermost exit does.
+- If the block raises, the buffered commands added since `__enter__` are discarded.
+- `flush()` can be called inside the block to force an early flush.
+- `next_no()` (auto-numbering) raises inside `batch()` because it would need to query the server mid-batch; pass `no=...` explicitly, or run auto-numbering outside the batch.
+
+Benchmark on the `25m简支小箱梁中梁` project (`.out` of ~3000 commands): before `batch()` ~3000 round-trips; with `batch()` 3 round-trips (clear + clc + one final flush), **~1000x compression**.
+
+## .out → pyosis Converter
+
+pyosis ships a converter that turns an OSIS command stream (`.out`) into a clean, runnable pyosis project. This is the easiest way to migrate a legacy APDL/SML script.
+
+```bash
+python src/pyosis/transfer/out_to_python.py path/to/model.out path/to/output_project
+```
+
+Generated layout:
+
+```
+output_project/
+└── prep/
+    ├── main.py          # Entry point (batch mode, runs all 10 modules)
+    ├── _1_control.py    # Global control parameters
+    ├── _2_property.py   # Geometry / coordinate / damping / creep properties
+    ├── _3_material.py   # Materials
+    ├── _4_section.py    # Sections (incl. mesh)
+    ├── _5_node.py       # Nodes
+    ├── _6_element.py    # Elements
+    ├── _7_boundary.py   # Boundaries
+    ├── _8_loadcase.py   # Load cases
+    ├── _9_analysis.py   # Analysis settings (settlement / live / dynamic / stability)
+    └── _10_stage.py     # Construction stages
+```
+
+The generated `main.py` wraps the entire modelling flow in `with batch():`, so the whole project is sent to OSIS in one HTTP request — matching the OSIS server's native batching path.
+
+Run it:
+
+```bash
+cd output_project
+python prep/main.py            # build the model
+python prep/main.py --solve    # build + solve
+```
+
+Notes on the converter:
+
+- Both long-form command names (`Node`, `Element`, `Section`, `Material`, `LoadCase`, `Boundary`, `Stage`) and OSIS 5.1 short-form aliases (`N`, `Ele`, `Sec`/`SecOff`/`SecMesh`, `Mat`, `LC`, `Bd`, `Stg`) are recognized and normalized.
+- `SectionMesh` is emitted with the new `Index, PartID, MeshMethod, MeshSize` layout (Section 7.3.6.2) — `PartID = 1` for concrete sections, `2` for templated composite sections.
+- `Spline3D` is dispatched to `engine.geometry.create_general` / `create_natural` / `create_arc2d` / `create_arc3d` based on the type field.
+- Commands that are not yet modeled are passed through verbatim via `engine.run(...)` so the model still runs; rewrite them into pyosis calls manually if needed.
+
+## Chained Method Calls
+
+The dataclass returned by `get()` supports method chaining without server round-trips:
+
+```python
+with batch():
+    lc = engine.load.create("Self-weight", load_case_type="D")
+    lc.create_gravity()
+    lc.create_nforce(node=1, fx=0, fy=-1000, fz=0)
+    # ↑ all three commands are queued; the OSIS_Run request only fires at exit
+```
+
+Accessing identity attributes (`lc.no`, `lc.name`) does not touch the server. Accessing data fields (`lc.type`, `lc.elements`) materializes the object (one-time flush + query), then caches it.
+
+> OSIS 5.1 HTTP server bug workaround: the `/OSIS_Run` command-stream splitter does not strip `//` line comments, so a comment line and the command that follows it are merged into one bad command. The pyosis `.out` converter already strips comments before sending; if you ever build a raw `.out` payload yourself, pre-process the file or use `osis_run()` through the generated `main.py`.
+
+## End-to-End Demo (GUI Mode)
+
+The single-file demo [`tests/demo_gui.py`](tests/demo_gui.py) is a merged version of the project generated from `tests/output/xiaoxiangliang.out`. Run it against an open OSIS 5.1+ GUI:
+
+```bash
+python tests/demo_gui.py            # build the model
+python tests/demo_gui.py --solve    # build + solve
+```
+
+The file contains the engine setup, all 10 `build_*` functions (control / property / material / section / node / element / boundary / loadcase / analysis / stage), and a `build_model()` driver that wraps everything in `with batch():` — so ~250 commands hit OSIS in a single `OSIS_Run` request.
+
+To regenerate both the single-file demo and the multi-module project:
+
+```bash
+python tests/_merge_demo_gui.py                                    # -> tests/demo_gui.py
+python src/pyosis/transfer/out_to_python.py tests/output/xiaoxiangliang.out tests/output/output_py/xiaoxiangliang
+```

{osis_python-0.7.0.dist-info → osis_python-0.7.3.dist-info}/RECORD

@@ -1,19 +1,18 @@
-osis_python-0.7.0.dist-info/licenses/LICENSE,sha256=T4mkSYliXdU9mYe-NfHkqg6GPhzoYaIQO_a630UzpS4,1088
-pyosis/__init__.py,sha256=lK6txR1Z728cE5_0PVNruWOq3pizIvynG8kaQKmJuCA,563
+osis_python-0.7.3.dist-info/licenses/LICENSE,sha256=T4mkSYliXdU9mYe-NfHkqg6GPhzoYaIQO_a630UzpS4,1088
+pyosis/__init__.py,sha256=7K4HxCsTeOYnvULoBFZAhwrJVziAGBpjEBmxY6cqdSQ,440
 pyosis/boundary/__init__.py,sha256=W5LfF-jugWa-YI8pnfELZaz0pXLa-D8TiGnBn12HGGQ,102
 pyosis/boundary/interface.py,sha256=obqQUVFuQK9I7S8IaBZ2VBYfyXgNVBS0PQa9LzRlaAc,8990
-pyosis/boundary/manager.py,sha256=6D3wxItLBV3HhFfcANgLmosJygD_rDOmGyrayF8q4eI,39563
+pyosis/boundary/manager.py,sha256=AAGdkp0sLV85enT9TQT9iqvWzjJyLzjiw0rC-tajSrI,39576
 pyosis/control/__init__.py,sha256=98UAXB9Wkf93pGUKIjoGBBrSCblVeAwc_MXeaAB-UIA,119
-pyosis/control/control.py,sha256=AUNFhkWhmfvOjNG8_RZuN2Pu80q5ANDpBLeXZTFhsQ0,2279
+pyosis/control/control.py,sha256=4bX92TDJnf1D5A3YY7ZZrU7iUeAxKCjQe9z_F_SEHBs,2816
 pyosis/control/io.py,sha256=buaut3-W8kwJIe3PgjtgOU0JCSgDfOEd2cS3mxYsfuc,591
-pyosis/control/manager.py,sha256=Cn8uOXZIcXmF51q0DTvw-GVOFmDfJ9rmeAq19-4i82E,9843
+pyosis/control/manager.py,sha256=NhxM-geF-STaUATMZgMac8A93hQ7OkN2cFMI7WRPm1Q,10800
 pyosis/control/nonlinear.py,sha256=26W_2GhD_0cn3YQxJjgbPR1oEopJWyuFWGlgx0q023I,1604
 pyosis/core/__init__.py,sha256=mte3tkLHfFIJq6HWpE54aM_D7ARvYBVGkM0Qv4H0uGE,629
 pyosis/core/all_func.py,sha256=VhvAeMJMCQJ1redjqdkm7meTw1PJNDoRdmXXh2LzkVo,521
 pyosis/core/apdl_sync.py,sha256=rW5Ot6FLpmUzpfMlrbemstnfhxD_0qtPrWgDfj9_4XY,5312
 pyosis/core/basic_manager.py,sha256=z3Qh5LpHg4AOyTrGffC09mPnW-yUT-UuhKnFe4GLUOM,7204
 pyosis/core/batch.py,sha256=jPA9U3ahGRZdY8y1wCSZyVpBPmGOtQtvM3vfDgqM2sM,6851
-pyosis/core/build.py,sha256=xt8-BLrKB-KMxmQd92rNCaHSsi5EHbcqPpDOVm2DSFc,81573
 pyosis/core/client.py,sha256=6i0q-yPosip5IzSESvpCxuF-v8iojRuFXyPulMKO8Ac,3285
 pyosis/core/command.py,sha256=bZ5nS1wvwhjwIsogWQh5-1dAcbsJoyB8MR85WUprZ0s,8863
 pyosis/core/engine.py,sha256=UnpE_CUQjNk62aFWRQ62lNA9hqaoBcefOmKnua7IE9A,15829
@@ -31,25 +30,25 @@ pyosis/dynamic/modal.py,sha256=__as3Nl7Ks2ntgcZwAA9UhvsvTfBl-1zSUOTsnPVf-Y,640
 pyosis/dynamic/seismic.py,sha256=8DIh7xkUgl0UwweDq4WoYSNzMxpLnpDaM4W_7u3rg_A,6380
 pyosis/element/__init__.py,sha256=fZgmxJiNhCe3Ki8vNEdZOhyinxwvlF6Jcu-DgD-c6YM,92
 pyosis/element/interface.py,sha256=xLd2ljq0qW5uvqV0Lo2e6Ly7NShh_p2I5vQNdcA8P4Q,9872
-pyosis/element/manager.py,sha256=xsUhhinu0T_bU7w0r8BV0yFgnkTnuZC8vyBwFdq3vBY,36602
+pyosis/element/manager.py,sha256=YzJEmcs5sx8R-nfucneujouQtwm3o6vUo0CUEw-xing,36615
 pyosis/general/__init__.py,sha256=dyvge-GgUpT3BeDwm_Lss1xqNlxAQdt63WJ7QcuZ_O4,24
 pyosis/general/interface.py,sha256=YRXQ-iXYVhiUBiUd7fpA0NOtL5VSueOHcobj625aQeU,5382
 pyosis/geometry/__init__.py,sha256=mlAXlxaohcEcm8-6anyDo1fevh_IzYz2OXBn0_DIrCY,99
 pyosis/geometry/interface.py,sha256=OHpsFEgjQok8FXpsOXXbCxfe9PPF6ac2rU6fii91jkY,4444
-pyosis/geometry/manager.py,sha256=dnPjyW_ukLeh17XbK0v9So5rlvODJk4tNHRWKb1hi3o,13757
+pyosis/geometry/manager.py,sha256=8sR4GJ6UXSEPM2_4eM6AFlWTj8RGuwmwm0OIT1hPFiQ,13698
 pyosis/live/__init__.py,sha256=jl0pMkfAGRnukwuCbc6fOJoWo-ufMnFm4lyBV-xQQxc,112
 pyosis/live/analysis.py,sha256=sI0jE65KS2EylpmBbySNcGsUHvvk9-6SZ0-37ZXsmbk,5486
 pyosis/live/grade.py,sha256=GjFxV_FImMK_ahfB0DNePGwdifUbiFK8r-cSXlnrVP8,3774
 pyosis/live/lane.py,sha256=i1-mnKQuo_XLimtcX2ZV4PBC_A0FBneWxJU198X1MMc,5487
-pyosis/live/manager.py,sha256=iVJSZ_Ro2RzyVUMtGnw6KWHQrSCtGLoZA1cJRgvQwuw,49272
+pyosis/live/manager.py,sha256=q0w9RVfuwLUqPYo4CS8kc9NchyF7mCiczcrWEzD31NQ,49319
 pyosis/load/__init__.py,sha256=AdCBsdf4QPVzbKwbj2C24Fnl9sPmlB9h542LjLFcqHM,135
 pyosis/load/loadcase.py,sha256=5DOty5OBtxHPguw_gYUqL3FFbXRkCjA2IVpCdAzJSJU,2457
-pyosis/load/manager.py,sha256=5rc7oK1ZczpgyZPQy6nr-dcLWhOUBSYmKWRo_wV86QQ,81322
+pyosis/load/manager.py,sha256=NVXXxW44eHhAElWSTi9IWjQbvOh9rblcQANzcTf31vg,81453
 pyosis/load/static.py,sha256=vvwx5WmXUL-M3GvlH9GA-oaTZQmvLaawR76dFNVrwgc,22773
 pyosis/load/tendon.py,sha256=2AJxvYJU8PEJ-rH-vbLUjd0CwmhIeSFEx9asuWpT_0s,11528
 pyosis/material/__init__.py,sha256=W0oDx9SY_zngAcrMCO_0sF773-OxCfL1B-w2IeWlZ_g,79
 pyosis/material/interface.py,sha256=SiHWjLPUDR1f3EMObGlYQUlKgpfoh1VuGJgVAQfariA,5729
-pyosis/material/manager.py,sha256=b6pIwi70eOY93IJBhqXZKZdpQEA2DC1SOCCQgVT-Vow,15974
+pyosis/material/manager.py,sha256=4zPVD03QOZ7sSPk4VpZgf1Ug5TTVpqsAIZb4Phj4Ftg,16061
 pyosis/node/__init__.py,sha256=6BKMR_HhFuvf-wr_U1H4njEj95pqgiHh6ApFl2JWMQ0,71
 pyosis/node/interface.py,sha256=T0lL1pHD069Qw3PTxufUF6cJl9fAKiclAL_ISgboaz8,1208
 pyosis/node/manager.py,sha256=fXkmeILs_LUvyv45wKBwzDFB2ssNO4In-bP71Dbrlow,8877
@@ -66,7 +65,7 @@ pyosis/property/component_thickness.py,sha256=fH9jpt2V6w2lSL2jDb1cuk5wylfhvnznxZ
 pyosis/property/coordinate.py,sha256=xFfuzXCzBWqYsDxHifpYCYgC_to9kC4LKD2yTX2CtvM,2668
 pyosis/property/creep_shrink.py,sha256=VsBYrMb8LjCWAx8AG7XeiYlww1HaK43gmayG7fcSL10,1469
 pyosis/property/damping.py,sha256=pasnvd1zua1skO-3lcLydFYT3phIZKqC-28DZn5jsGA,3225
-pyosis/property/manager.py,sha256=71Belg0cLZvkCg3wwq7xywqPx2K4dvOiJRCaxy6o6iw,31135
+pyosis/property/manager.py,sha256=BQRI0dTzPiaMjsUnzgjolponJpas7FLMhM9qDE1ULvw,31135
 pyosis/property/pu_curve.py,sha256=E3oUfe7ERYKX6q9v1U-HnNP1LRbWobNYB8dUC26s8aQ,1534
 pyosis/quick_building/__init__.py,sha256=QiWapgiZk6pkAdiznKI0bVIc16UcFOIALQuLhupLkqw,48
 pyosis/quick_building/interface.py,sha256=xdQrORabxmnlhi537pspFokQBaXSmnZMIxA_kxSo_cE,13951
@@ -79,9 +78,9 @@ pyosis/result/result.py,sha256=wUyRaHSwyijLpodWIHPFQVEOn6LP8MfYp7xLhC-RiIo,1194
 pyosis/section/__init__.py,sha256=VjNbQWgWHtLO6la39oXgbQMnQPR0-b1DPIM52Cj--jg,179
 pyosis/section/common.py,sha256=yI61YQH8btfkoBGnXF7wp3kFhZVW06XABIJZnvkDk3E,26616
 pyosis/section/composite.py,sha256=CWNcPagXbL4D8uUouRk8ux7Xv41bE2dXM8JfWX77pBI,9353
-pyosis/section/manager.py,sha256=QuL4g2v08C0z9kMmo3DUBzysP9bbcTnn20ff5ttE2Mk,92805
+pyosis/section/manager.py,sha256=SUOGDM9IWLNmaEzRkM3Y9tJIaiqpIDVl0fivEFxj2tU,94252
 pyosis/section/numeric.py,sha256=lDO1KvSTmzBE56wkfDw5xxDhWi-kM0szXPx6CIymIyQ,1479
-pyosis/section/param.py,sha256=BC86XGqxbEHrjVMfwFuILmMExEdzpPwpCJ5XrLaVOOo,4713
+pyosis/section/param.py,sha256=YHtRqCUHETgBp99HClqUH4LoAICfzL3gNQxfgsQ-Ebk,4823
 pyosis/section/rebar.py,sha256=9ibcOoMd7HYfzSaO6dMpZFwp1ugmwayOmDqIoWUijNc,8337
 pyosis/section/rib.py,sha256=p3QfuBz9FiNmc7ePH4zzP3EkP52k8JtzxwCPK6Zjq14,8387
 pyosis/section/steel.py,sha256=UZ5OmealrvFwwfFSD1Hf67AzuOVAH5OXE4nyv3XNHN0,14960
@@ -99,13 +98,13 @@ pyosis/thickness/__init__.py,sha256=YGYmUPc9TvAlw4eFuEjxaG7HjvwLQJelU_Mx2M6RhW0,
 pyosis/thickness/interface.py,sha256=o9fwAnPtincBvNB7KZ-Cw67V4mSvoMYgcuLqD_FMLs0,1311
 pyosis/thickness/manager.py,sha256=JfKNKQnAaqEVnFyr3UwCj9cl4qhHYT_9Pp7HVBYNx6M,5048
 pyosis/transfer/__init__.py,sha256=OZVxVnjhDGe4fHC6pjtOaKPzAKuoDp3-XkNFzDWepsE,623
-pyosis/transfer/generator.py,sha256=T3YLf4TrqAF4FFIa84opclmNDCw5WpvbNIsKC2rvKcU,3541
+pyosis/transfer/generator.py,sha256=hDM2je_3t18_S9mimYi1yB7XD2YKVm98cERLLnx_RFQ,3750
 pyosis/transfer/matrix.py,sha256=sHw9X34-PUeY1EdoNklgK0LUHwbBPnhkhk0R9ME0XG0,3378
-pyosis/transfer/out_to_python.py,sha256=WMzu1GaVvzvO1oq9ihyyp9dn2xY4s6ualW5M7CO98Cg,14464
+pyosis/transfer/out_to_python.py,sha256=oaD5xX2lvMTriQe4LIW43xKYw1kh__W45vQzsLDZ1S0,15223
 pyosis/transfer/parser.py,sha256=R_aBlYJTe53hD1sX5PBv86bhj88NQwANFRN4pGYudQ8,6774
-pyosis/transfer/routes.py,sha256=GAgrx71utq1tToxQKtfYeBwBvy7bktvFWEvWq3FPYIk,8267
+pyosis/transfer/routes.py,sha256=EvJ88cgtulYShvgoDfaDkkxVn3fhYgL0CffmJEtk2sY,9649
 pyosis/transfer/split.py,sha256=hpBe9D9WbjbKsovx4hM3X5RjTrruWNkuFmZt2ed0fME,1284
-osis_python-0.7.0.dist-info/METADATA,sha256=VeDqzmZAhV5L5nz7etlwhRQfmfbPrrbSS18aY7Iaepk,14189
-osis_python-0.7.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-osis_python-0.7.0.dist-info/top_level.txt,sha256=6VDNySkQKwipRXcN8ayKVci4vAXi4oPyWLqFhNVcIfM,7
-osis_python-0.7.0.dist-info/RECORD,,
+osis_python-0.7.3.dist-info/METADATA,sha256=9SLOrNx2y-LzxcUmqi5pOZbKBWMVFAUzL5K2D6IZh9A,20117
+osis_python-0.7.3.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+osis_python-0.7.3.dist-info/top_level.txt,sha256=6VDNySkQKwipRXcN8ayKVci4vAXi4oPyWLqFhNVcIfM,7
+osis_python-0.7.3.dist-info/RECORD,,

pyosis/__init__.py

@@ -7,8 +7,7 @@ A library for extending OSIS functionality.
 A library that allows users to use CAE with great flexibility.
 """
 
-__version__ = "0.7.0"
-__author__ = "CCCC Highway Consultant Co. Ltd." # 中交公路规划设计院 - 工程技术研究中心 - lzh - wjh - myf
+__version__ = "0.7.3"
 
 from .core.engine import OSISEngine
 from .core.batch import batch, flush, batch_state, BatchError

pyosis/boundary/manager.py

@@ -536,7 +536,7 @@ class BoundaryGroupManager(BasicManager):
         Returns:
             BoundaryGroup: 创建（或刷新后的）边界组对象
         '''
-        ok, err = osis_boundary_group(name, op, *param)
+        ok, err = osis_boundary_group(name, str(op).lower(), *param)
         if not ok:
             raise RuntimeError(f"创建边界组 {name} 失败: {err}")
         return self.get(name)

pyosis/control/control.py

@@ -103,6 +103,32 @@ def osis_mod_loc_coor(bFlag: int=1):
     '''
     pass
 
+@REGISTRY.register("CalcRebarGravity")
+def osis_calc_rebar_gravity(bFlag: int=1):
+    '''
+    是否考虑钢筋钢束自重
+
+    Args:
+        bFlag (bool): 1=考虑，0=不考虑
+
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    '''
+    pass
+
+@REGISTRY.register("IncRebar")
+def osis_inc_rebar(bFlag: int=1):
+    '''
+    是否考虑钢筋对截面几何特性的影响
+
+    Args:
+        bFlag (bool): 1=考虑，0=不考虑
+
+    Returns:
+        tuple (bool, str): 是否成功，失败原因
+    '''
+    pass
+
 @REGISTRY.register("IncTendon")
 def osis_inc_tendon(bFlag: int=1):
     '''

pyosis/control/manager.py

@@ -27,6 +27,8 @@ from .control import (
     osis_calc_shear,
     osis_calc_rlx,
     osis_mod_loc_coor,
+    osis_calc_rebar_gravity,
+    osis_inc_rebar,
     osis_inc_tendon,
 )
 from .io import osis_apdl
@@ -230,6 +232,38 @@ class ControlManager:
         if not ok:
             raise RuntimeError(f"设置局部坐标轴修正失败: {err}")
 
+    def set_calc_rebar_gravity(self, enabled: Literal[0,1] = 1) -> None:
+        '''设置是否考虑钢筋钢束自重
+
+        Args:
+            enabled (int): 1=考虑，0=不考虑
+
+        Returns:
+            None
+
+        Raises:
+            RuntimeError: 设置失败时抛出异常
+        '''
+        ok, err = osis_calc_rebar_gravity(enabled)
+        if not ok:
+            raise RuntimeError(f"设置钢筋钢束自重考虑失败: {err}")
+
+    def set_inc_rebar(self, enabled: Literal[0,1] = 1) -> None:
+        '''设置是否考虑钢筋对截面几何特性的影响
+
+        Args:
+            enabled (int): 1=考虑，0=不考虑
+
+        Returns:
+            None
+
+        Raises:
+            RuntimeError: 设置失败时抛出异常
+        '''
+        ok, err = osis_inc_rebar(enabled)
+        if not ok:
+            raise RuntimeError(f"设置钢筋截面特性影响失败: {err}")
+
     def set_inc_tendon(self, enabled: Literal[0,1] = 1) -> None:
         '''设置是否考虑钢束自重及钢束对截面几何特性的影响
 

pyosis/element/manager.py

@@ -316,7 +316,7 @@ class ElementGroupManager(BasicManager):
         Returns:
             ElementGroup: 创建的单元组对象
         """
-        ok, err = osis_element_group(name, op, *param)
+        ok, err = osis_element_group(name, str(op).lower(), *param)
         if not ok:
             raise RuntimeError(f"创建单元组 {name} 失败: {err}")
         return self.get(name)

pyosis/geometry/manager.py

@@ -221,7 +221,7 @@ class GeometryManager(BasicManager):
         self,
         name: str,
         owner: Literal["LIVE", "TENDON"],
-        *coordinates: float,
+        coordinates: list[float],
     ) -> Spline:
         """创建或修改三维样条曲线（自然边界/NATURAL）。
 
@@ -240,9 +240,7 @@ class GeometryManager(BasicManager):
 
         Examples:
             >>> geometry_manager.create_natural("Lane1", "LIVE",
-            ...     0.0, 0.0, 0.0,
-            ...     10.0, 0.0, 0.0,
-            ...     20.0, 0.0, 0.0,
+            ...     [0.0, 0.0, 0.0, 10.0, 0.0, 0.0, 20.0, 0.0, 0.0],
             ... )
         """
         ok, err = osis_spline3d_natural(name, "NATURAL", owner, *coordinates)
@@ -254,7 +252,7 @@ class GeometryManager(BasicManager):
         self,
         name: str,
         owner: str,
-        *coordinates: float,
+        coordinates: list[float],
     ) -> Spline:
         """创建或修改三维样条曲线（2D圆弧/ARC2D）。
 
@@ -273,8 +271,7 @@ class GeometryManager(BasicManager):
 
         Examples:
             >>> geometry_manager.create_arc2d("Arc1", "TENDON",
-            ...     0.0, 0.0, 10.0,
-            ...     10.0, 0.0, 10.0,
+            ...     [0.0, 0.0, 10.0, 10.0, 0.0, 10.0],
             ... )
         """
         ok, err = osis_spline3d_arc2d(name, "ARC2D", owner, *coordinates)
@@ -286,7 +283,7 @@ class GeometryManager(BasicManager):
         self,
         name: str,
         owner: str,
-        *coordinates: float,
+        coordinates: list[float],
     ) -> Spline:
         """创建或修改三维样条曲线（3D圆弧/ARC3D）。
 
@@ -305,8 +302,7 @@ class GeometryManager(BasicManager):
 
         Examples:
             >>> geometry_manager.create_arc3d("Arc3d1", "TENDON",
-            ...     0.0, 0.0, 0.0, 20.0,
-            ...     10.0, 0.0, 5.0, 20.0,
+            ...     [0.0, 0.0, 0.0, 20.0, 10.0, 0.0, 5.0, 20.0],
             ... )
         """
         ok, err = osis_spline3d_arc3d(name, "ARC3D", owner, *coordinates)

pyosis/live/manager.py

@@ -265,6 +265,7 @@ class LiveCase:
         Returns:
             更新后的 LiveCase 对象
         """
+        op = str(op).lower()
         if op in ("a", "m"):
             _MU_PARAM_COUNT = {
                 "SIMPLE": 4,
@@ -278,7 +279,7 @@ class LiveCase:
             grade_name, scalar, mu_flag = args[0], float(args[1]), int(args[2])
             rest = args[4:]
             if mu_flag == 1:
-                bridge_type = args[3] or "SIMPLE"
+                bridge_type = (args[3] or "SIMPLE").strip().upper()
                 mu_count = _MU_PARAM_COUNT.get(bridge_type, 1)
                 mu_params: list[float] = [float(x) for x in rest[:mu_count]]
                 lane_names: list[str] = list(rest[mu_count:])

pyosis/load/manager.py

@@ -295,6 +295,8 @@ class LoadCase:
             elem, e_coord, n_range, *rest = args
             forces = [list(rest[i: i + 6]) for i in range(0, len(rest), 6)]
             return self.create_concentrated_force(elem,e_coord,is_moment=(type_key == "PTM"),forces=forces)
+        if type_key not in _creator:
+            raise ValueError(f"未知荷载类型: {type!r}，支持: {', '.join(_creator)}")
         return _creator[type_key](*args, **kwargs)
 
     def create_gravity(

pyosis/material/manager.py

@@ -158,9 +158,10 @@ class MaterialManager(BasicManager):
             "REBAR": self.create_rebar,
             "CUSTOM": self.create_custom,
         }
-        if type not in _creator:
-            raise ValueError(f"未知材料类型: {type}")
-        return _creator[type](no, name, *args, **kwargs)
+        type_key = str(type).strip().upper()
+        if type_key not in _creator:
+            raise ValueError(f"未知材料类型: {type!r}，支持: {', '.join(_creator)}")
+        return _creator[type_key](no, name, *args, **kwargs)
 
     def create_conc(
         self,

pyosis/property/manager.py

@@ -518,9 +518,9 @@ class DampingManager(BasicManager):
             raise ValueError(
                 f"未知阻尼类型: {type!r}，支持: {', '.join(sorted(_supported_types))}"
             )
-        if type_key == "modal":
+        if type_key == "MODAL":
             return self.create_modal(name, *args, **kwargs)
-        # type_key == "ryl"
+        # type_key == "RYL"
         method = args[0] if args else kwargs.get("method")
         _supported_methods = {0: "根据公式计算因子", 1: "自定义因子"}
         if method not in _supported_methods:

pyosis/section/manager.py

@@ -274,19 +274,21 @@ class Section:
             self,
             mesh_method: Literal[0, 1] = 0,
             mesh_size: float = 0.0,
+            part_id: int = 1,
     ) -> None:
-        '''设置截面网格。
+        '''设置截面网格（适用于混凝土截面、模板组合截面与自定义组合截面）。
 
         Args:
             mesh_method (int): 网格划分方式
                 * 0 = 自动划分
                 * 1 = 手动划分
             mesh_size (float): 网格划分尺寸，在 mesh_method=1 时起作用
+            part_id (int): 分部编号，混凝土截面输入 1，模板组合截面输入 2
 
         Raises:
             RuntimeError: 设置失败时抛出
         '''
-        ok, err = osis_section_mesh(self.no, mesh_method, mesh_size)
+        ok, err = osis_section_mesh(self.no, part_id, mesh_method, mesh_size)
         if not ok:
             raise RuntimeError(f"设置截面 {self.no} 网格失败: {err}")
 
@@ -382,15 +384,18 @@ class Section:
         """添加或修改组合截面 Part（按类型分发）
 
         Args:
-            type: Part 类型
+            type: Part 类型（大小写不敏感）
                 * POLYGON = 多边形
                 * LINE    = 折线
             args: 剩余参数透传给对应子方法
         """
-        if type == "POLYGON":
+        key = str(type).upper()
+        if key == "POLYGON":
             self.add_composite_part_polygon(*args)
-        elif type == "LINE":
+        elif key == "LINE":
             self.add_composite_part_line(*args)
+        else:
+            raise ValueError(f"未知 Part 类型: {type!r}，支持 POLYGON/LINE")
 
     # ── 组合截面材料 ──────────────────────────
 
@@ -680,21 +685,26 @@ class Section:
 
         Args:
             rebar_no: 钢筋编号
-            type: 钢筋输入方式
+            type: 钢筋输入方式（大小写不敏感，兼容命令流全大写写法 LINEA 等）
                 * Point  = 点输入
                 * LineA  = 直线-垂直方式 A
                 * LineB  = 直线-垂直方式 B
                 * Circle = 圆周输入
             args: 剩余参数透传给对应子方法
         """
-        if type == "Point":
+        key = str(type).upper()
+        if key == "POINT":
             self.add_rebar_point(rebar_no, *args)
-        elif type == "LineA":
+        elif key == "LINEA":
             self.add_rebar_line_a(rebar_no, *args)
-        elif type == "LineB":
+        elif key == "LINEB":
             self.add_rebar_line_b(rebar_no, *args)
-        elif type == "Circle":
+        elif key == "CIRCLE":
             self.add_rebar_circle(rebar_no, *args)
+        else:
+            raise ValueError(
+                f"未知纵向钢筋类型: {type!r}，支持 Point/LineA/LineB/Circle"
+            )
 
     def add_rebar_s(
         self,
@@ -704,21 +714,26 @@ class Section:
         """添加或修改抗剪钢筋（按类型分发）
 
         Args:
-            type: 钢筋类型
+            type: 钢筋类型（大小写不敏感，兼容 SHEARSTIRRUP 等命令流写法）
                 * BentUpRebar      = 弯起钢筋
                 * ShearStirrup     = 抗剪箍筋
                 * WebVerticalRebar = 腹板竖筋
                 * TorsionalStirrup = 扭转箍筋
             args: 剩余参数透传给对应子方法
         """
-        if type == "BentUpRebar":
+        key = str(type).upper()
+        if key == "BENTUPREBAR":
             self.add_rebar_s_bent_up(*args)
-        elif type == "ShearStirrup":
+        elif key == "SHEARSTIRRUP":
             self.add_rebar_s_shear_stirrup(*args)
-        elif type == "WebVerticalRebar":
+        elif key == "WEBVERTICALREBAR":
             self.add_rebar_s_web_vertical(*args)
-        elif type == "TorsionalStirrup":
+        elif key == "TORSIONALSTIRRUP":
             self.add_rebar_s_torsional_stirrup(*args)
+        else:
+            raise ValueError(
+                f"未知抗剪钢筋类型: {type!r}，支持 BentUpRebar/ShearStirrup/WebVerticalRebar/TorsionalStirrup"
+            )
 
     def add_rib(
         self,
@@ -728,7 +743,7 @@ class Section:
         """添加或修改加劲肋（按类型分发）
 
         Args:
-            type: 加劲肋类型
+            type: 加劲肋类型（大小写不敏感）
                 * Flat = 扁平加劲肋
                 * T    = T 形加劲肋
                 * U    = U 形加劲肋
@@ -736,14 +751,19 @@ class Section:
                 * LR   = 右 L 形加劲肋
             args: 剩余参数透传给对应子方法
         """
-        if type == "Flat":
+        key = str(type).upper()
+        if key == "FLAT":
             self.add_rib_flat(*args)
-        elif type == "T":
+        elif key == "T":
             self.add_rib_t(*args)
-        elif type == "U":
+        elif key == "U":
             self.add_rib_u(*args)
-        elif type in ("LL", "LR"):
-            self.add_rib_l(args[0], type, *args[1:])
+        elif key in ("LL", "LR"):
+            self.add_rib_l(args[0], key, *args[1:])
+        else:
+            raise ValueError(
+                f"未知加劲肋类型: {type!r}，支持 Flat/T/U/LL/LR"
+            )
 
     def add_rib_flat(
         self,
@@ -907,15 +927,22 @@ class Section:
         '''删除箍筋
 
         Args:
-            rebar_type (str): 钢筋类型
+            rebar_type (str): 钢筋类型（大小写不敏感）
                 * BentUpRebar = 弯起钢筋
                 * ShearStirrup = 抗剪箍筋
                 * WebVerticalRebar = 腹板竖筋
                 * TorsionalStirrup = 扭转箍筋
 
         Raises:
+            ValueError: 未知的钢筋类型
             RuntimeError: 删除失败时抛出
         '''
+        if str(rebar_type).strip().upper() not in (
+            "BENTUPREBAR", "SHEARSTIRRUP", "WEBVERTICALREBAR", "TORSIONALSTIRRUP",
+        ):
+            raise ValueError(
+                f"未知抗剪钢筋类型: {rebar_type!r}，支持 BentUpRebar/ShearStirrup/WebVerticalRebar/TorsionalStirrup"
+            )
         ok, err = osis_rebar_s_del(self.no, rebar_type)
         if not ok:
             raise RuntimeError(f"删除截面 {self.no} 箍筋 {rebar_type} 失败: {err}")

pyosis/section/param.py

@@ -48,12 +48,13 @@ def osis_section_offset(nSec: int=1, offsetTypeY: Literal["Left", "Middle", "Rig
     pass
 
 @REGISTRY.register('SectionMesh')
-def osis_section_mesh(nSec: int=1, nMeshMethod: Literal[0, 1]=0, dMeshSize: float=0.0):
+def osis_section_mesh(nSec: int=1, nPartID: int=1, nMeshMethod: Literal[0, 1]=0, dMeshSize: float=0.0):
     """设置截面网格。
 
     Args:
         nSec (int): 截面编号。
-        nMeshMethod (int): Y定义截面网格划分，可选值：
+        nPartID (int): 分部编号，混凝土截面需输入 1，模板组合截面输入 2。
+        nMeshMethod (int): 定义截面网格划分方法，可选值：
             * 0 = 自动划分
             * 1 = 手动划分
         dMeshSize (float): 网格划分尺寸，在 nMeshMethod=1 时该项起作用
@@ -62,7 +63,7 @@ def osis_section_mesh(nSec: int=1, nMeshMethod: Literal[0, 1]=0, dMeshSize: floa
         tuple (bool, str): 返回一个元组，包含：
             - bool: 操作是否成功
             - str: 失败原因（如果操作失败）
-        
+
     """
     pass