qtmodel 0.6.8__tar.gz → 0.6.9__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of qtmodel might be problematic. Click here for more details.

qtmodel-0.6.9/PKG-INFO ADDED
@@ -0,0 +1,5005 @@
1
+ Metadata-Version: 2.1
2
+ Name: qtmodel
3
+ Version: 0.6.9
4
+ Summary: python modeling for qt 2025-03-04
5
+ Home-page: https://github.com/Inface0443/pyqt
6
+ Author: dqy-zhj
7
+ Author-email: 1105417715@qq.com
8
+ License: UNKNOWN
9
+ Platform: UNKNOWN
10
+ Classifier: License :: OSI Approved :: MIT License
11
+ Classifier: Programming Language :: Python :: 3
12
+ Classifier: Operating System :: OS Independent
13
+ Description-Content-Type: text/markdown
14
+
15
+ > 最新版本 V0.6.9 - 2025-03-04
16
+ > pip install --upgrade qtmodel -i https://pypi.org/simple
17
+ - 新增部分接口
18
+ # 建模操作
19
+ ## 建模助手
20
+ ### create_cantilever_bridge
21
+ > **说明**
22
+ > 悬浇桥快速建模
23
+ > **参数**
24
+ > - span_len:桥跨分段
25
+ > - span_seg:各桥跨内节段基准长度
26
+ > - bearing_spacing:支座间距
27
+ > - top_width:主梁顶板宽度
28
+ > - bottom_width:主梁顶板宽度
29
+ > - box_num:主梁箱室长度
30
+ > - material:主梁材料类型
31
+ >
32
+ > **示例代码**
33
+ > ```Python
34
+ > from qtmodel import *
35
+ > mdb.create_cantilever_bridge(span_len=[6,70,70,6],span_seg=[2,3.5,3.5,2],bearing_spacing=[5.6,5.6])
36
+ > ```
37
+ > **返回**
38
+ > Returns: 无
39
+
40
+ ## 项目管理
41
+ ### undo_model
42
+ > **说明**
43
+ > 撤销模型上次操作
44
+ > **参数**
45
+ >
46
+ > **示例代码**
47
+ > ```Python
48
+ > from qtmodel import *
49
+ > mdb.undo_model()
50
+ > ```
51
+ > **返回**
52
+ > Returns: 无
53
+
54
+ ### redo_model
55
+ > **说明**
56
+ > 重做上次撤销
57
+ > **参数**
58
+ >
59
+ > **示例代码**
60
+ > ```Python
61
+ > from qtmodel import *
62
+ > mdb.redo_model()
63
+ > ```
64
+ > **返回**
65
+ > Returns: 无
66
+
67
+ ### update_model
68
+ > **说明**
69
+ > 刷新模型信息
70
+ > **参数**
71
+ >
72
+ > **示例代码**
73
+ > ```Python
74
+ > from qtmodel import *
75
+ > mdb.update_model()
76
+ > ```
77
+ > **返回**
78
+ > Returns: 无
79
+
80
+ ### update_app_stage
81
+ > **说明**
82
+ > 切换模型前后处理状态
83
+ > **参数**
84
+ > - num: 1-前处理 2-后处理
85
+ >
86
+ > **示例代码**
87
+ > ```Python
88
+ > from qtmodel import *
89
+ > mdb.update_app_stage(num=1)
90
+ > mdb.update_app_stage(num=2)
91
+ > ```
92
+ > **返回**
93
+ > Returns: 无
94
+
95
+ ### do_solve
96
+ > **说明**
97
+ > 运行分析
98
+ > **参数**
99
+ >
100
+ > **示例代码**
101
+ > ```Python
102
+ > from qtmodel import *
103
+ > mdb.do_solve()
104
+ > ```
105
+ > **返回**
106
+ > Returns: 无
107
+
108
+ ### initial
109
+ > **说明**
110
+ > 初始化模型,新建模型
111
+ > **参数**
112
+ >
113
+ > **示例代码**
114
+ > ```Python
115
+ > from qtmodel import *
116
+ > mdb.initial()
117
+ > ```
118
+ > **返回**
119
+ > Returns: 无
120
+
121
+ ### open_file
122
+ > **说明**
123
+ > 打开bfmd文件
124
+ > **参数**
125
+ > - file_path: 文件全路径
126
+ >
127
+ > **示例代码**
128
+ > ```Python
129
+ > from qtmodel import *
130
+ > mdb.open_file(file_path="a.bfmd")
131
+ > ```
132
+ > **返回**
133
+ > Returns: 无
134
+
135
+ ### close_project
136
+ > **说明**
137
+ > 关闭项目
138
+ > **参数**
139
+ >
140
+ > **示例代码**
141
+ > ```Python
142
+ > from qtmodel import *
143
+ > mdb.close_project()
144
+ > ```
145
+ > **返回**
146
+ > Returns: 无
147
+
148
+ ### save_file
149
+ > **说明**
150
+ > 保存bfmd文件
151
+ > **参数**
152
+ > - file_path: 文件全路径
153
+ >
154
+ > **示例代码**
155
+ > ```Python
156
+ > from qtmodel import *
157
+ > mdb.save_file(file_path="a.bfmd")
158
+ > ```
159
+ > **返回**
160
+ > Returns: 无
161
+
162
+ ### import_command
163
+ > **说明**
164
+ > 导入命令
165
+ > **参数**
166
+ > - command:命令字符
167
+ > - command_type:命令类型,默认桥通命令 1-桥通命令 2-mct命令
168
+ >
169
+ > **示例代码**
170
+ > ```Python
171
+ > from qtmodel import *
172
+ > mdb.import_command(command="*SECTION")
173
+ > mdb.import_command(command="*SECTION",command_type=2)
174
+ > ```
175
+ > **返回**
176
+ > Returns: 无
177
+
178
+ ### import_file
179
+ > **说明**
180
+ > 导入文件
181
+ > **参数**
182
+ > - file_path:导入文件(.mct/.qdat/.dxf/.3dx)
183
+ >
184
+ > **示例代码**
185
+ > ```Python
186
+ > from qtmodel import *
187
+ > mdb.import_file(file_path="a.mct")
188
+ > ```
189
+ > **返回**
190
+ > Returns: 无
191
+
192
+ ### export_file
193
+ > **说明**
194
+ > 导入命令
195
+ > **参数**
196
+ > - file_path:导出文件全路径,支持格式(.mct/.qdat/.obj/.txt/.py)
197
+ > - convert_sec_group:是否将变截面组转换为变截面
198
+ > - type_kind:输出文件类型 1-全部模型文件 2-计算相关文件 (py输出时 2-输出截面特性)
199
+ > - group_name:obj与 APDL导出时指定结构组导出
200
+ >
201
+ > **示例代码**
202
+ > ```Python
203
+ > from qtmodel import *
204
+ > mdb.export_file(file_path="a.mct")
205
+ > ```
206
+ > **返回**
207
+ > Returns: 无
208
+
209
+ ## 分析设置
210
+ ### update_global_setting
211
+ > **说明**
212
+ > 更新整体设置
213
+ > **参数**
214
+ > - solver_type:求解器类型 0-稀疏矩阵求解器 1-变带宽求解器
215
+ > - calculation_type: 计算设置 0-单线程 1-用户自定义 2-自动设置
216
+ > - thread_count: 线程数
217
+ >
218
+ > **示例代码**
219
+ > ```Python
220
+ > from qtmodel import *
221
+ > mdb.update_global_setting(solver_type=0,calculation_type=2,thread_count=12)
222
+ > ```
223
+ > **返回**
224
+ > Returns: 无
225
+
226
+ ### update_construction_stage_setting
227
+ > **说明**
228
+ > 更新施工阶段设置
229
+ > **参数**
230
+ > - do_analysis: 是否进行分析
231
+ > - to_end_stage: 是否计算至最终阶段
232
+ > - other_stage_id: 计算至其他阶段时ID
233
+ > - analysis_type: 分析类型 (0-线性 1-非线性 2-部分非线性)
234
+ > - do_creep_analysis: 是否进行徐变分析
235
+ > - cable_tension_position: 索力张力位置 (0-I端 1-J端 2-平均索力)
236
+ > - consider_completion_stage: 是否考虑成桥内力对运营阶段影响
237
+ > - shrink_creep_type: 收缩徐变类型 (0-仅徐变 1-仅收缩 2-收缩徐变)
238
+ > - creep_load_type: 徐变荷载类型 (1-开始 2-中间 3-结束)
239
+ > - sub_step_info: 子步信息 [是否开启子部划分设置,10天步数,100天步数,1000天步数,5000天步数,10000天步数] None时为UI默认值
240
+ >
241
+ > **示例代码**
242
+ > ```Python
243
+ > from qtmodel import *
244
+ > mdb.update_construction_stage_setting(do_analysis=True, to_end_stage=False, other_stage_id=1,analysis_type=0,
245
+ > do_creep_analysis=True, cable_tension_position=0, consider_completion_stage=True,shrink_creep_type=2)
246
+ > ```
247
+ > **返回**
248
+ > Returns: 无
249
+
250
+ ### update_live_load_setting
251
+ > **说明**
252
+ > 更新移动荷载分析设置
253
+ > **参数**
254
+ > - lateral_spacing: 横向加密间距
255
+ > - vertical_spacing: 纵向加密间距
256
+ > - damper_calc_type: 模拟阻尼器约束方程计算类选项(-1-不考虑 0-全部组 1-部分)
257
+ > - displacement_calc_type: 位移计算选项(-1-不考虑 0-全部组 1-部分)
258
+ > - force_calc_type: 内力计算选项(-1-不考虑 0-全部组 1-部分)
259
+ > - reaction_calc_type: 反力计算选项(-1-不考虑 0-全部组 1-部分)
260
+ > - link_calc_type: 连接计算选项(-1-不考虑 0-全部组 1-部分)
261
+ > - constrain_calc_type: 约束方程计算选项(-1-不考虑 0-全部组 1-部分)
262
+ > - eccentricity: 离心力系数
263
+ > - displacement_track: 是否追踪位移
264
+ > - force_track: 是否追踪内力
265
+ > - reaction_track: 是否追踪反力
266
+ > - link_track: 是否追踪连接
267
+ > - constrain_track: 是否追踪约束方程
268
+ > - damper_groups: 模拟阻尼器约束方程计算类选项为组时边界组名称
269
+ > - displacement_groups: 位移计算类选项为组时结构组名称
270
+ > - force_groups: 内力计算类选项为组时结构组名称
271
+ > - reaction_groups: 反力计算类选项为组时边界组名称
272
+ > - link_groups: 弹性连接计算类选项为组时边界组名称
273
+ > - constrain_groups: 约束方程计算类选项为组时边界组名称
274
+ >
275
+ > **示例代码**
276
+ > ```Python
277
+ > from qtmodel import *
278
+ > mdb.update_live_load_setting(lateral_spacing=0.1, vertical_spacing=1, displacement_calc_type=1)
279
+ > mdb.update_live_load_setting(lateral_spacing=0.1, vertical_spacing=1, displacement_calc_type=2,displacement_track=True,
280
+ > displacement_groups=["结构组1","结构组2"])
281
+ > ```
282
+ > **返回**
283
+ > Returns: 无
284
+
285
+ ### update_non_linear_setting
286
+ > **说明**
287
+ > 更新非线性设置
288
+ > **参数**
289
+ > - non_linear_type: 非线性类型 0-部分非线性 1-非线性
290
+ > - non_linear_method: 非线性方法 0-修正牛顿法 1-牛顿法
291
+ > - max_loading_steps: 最大加载步数
292
+ > - max_iteration_times: 最大迭代次数
293
+ > - accuracy_of_displacement: 位移相对精度
294
+ > - accuracy_of_force: 内力相对精度
295
+ >
296
+ > **示例代码**
297
+ > ```Python
298
+ > from qtmodel import *
299
+ > mdb.update_non_linear_setting(non_linear_type=-1, non_linear_method=1, max_loading_steps=-1, max_iteration_times=30,
300
+ > accuracy_of_displacement=0.0001, accuracy_of_force=0.0001)
301
+ > ```
302
+ > **返回**
303
+ > Returns: 无
304
+
305
+ ### update_operation_stage_setting
306
+ > **说明**
307
+ > 更新运营阶段分析设置
308
+ > **参数**
309
+ > - do_analysis: 是否进行运营阶段分析
310
+ > - final_stage: 最终阶段名
311
+ > - static_load_cases: 静力工况名列表
312
+ > - sink_load_cases: 沉降工况名列表
313
+ > - live_load_cases: 活载工况名列表
314
+ >
315
+ > **示例代码**
316
+ > ```Python
317
+ > from qtmodel import *
318
+ > mdb.update_operation_stage_setting(do_analysis=True, final_stage="上二恒",static_load_cases=None)
319
+ > ```
320
+ > **返回**
321
+ > Returns: 无
322
+
323
+ ### update_self_vibration_setting
324
+ > **说明**
325
+ > 更新自振分析设置
326
+ > **参数**
327
+ > - do_analysis: 是否进行运营阶段分析
328
+ > - method: 计算方法 1-子空间迭代法 2-滤频法 3-多重Ritz法 4-兰索斯法
329
+ > - matrix_type: 矩阵类型 0-集中质量矩阵 1-一致质量矩阵
330
+ > - mode_num: 振型数量
331
+ >
332
+ > **示例代码**
333
+ > ```Python
334
+ > from qtmodel import *
335
+ > mdb.update_self_vibration_setting(do_analysis=True,method=1,matrix_type=0,mode_num=3)
336
+ > ```
337
+ > **返回**
338
+ > Returns: 无
339
+
340
+ ### update_response_spectrum_setting
341
+ > **说明**
342
+ > 更新反应谱设置
343
+ > **参数**
344
+ > - do_analysis:是否进行反应谱分析
345
+ > - kind:组合方式 1-SRSS 2-CQC
346
+ > - by_mode: 是否按照振型输入阻尼比
347
+ > - damping_ratio:常数阻尼比或振型阻尼比列表
348
+ >
349
+ > **示例代码**
350
+ > ```Python
351
+ > from qtmodel import *
352
+ > mdb.update_response_spectrum_setting(do_analysis=True,kind=1,damping_ratio=0.05)
353
+ > ```
354
+ > **返回**
355
+ > Returns: 无
356
+
357
+ ## 结构组操作
358
+ ### add_structure_group
359
+ > **说明**
360
+ > 添加结构组
361
+ > **参数**
362
+ > - name: 结构组名
363
+ > - node_ids: 节点编号列表(可选参数)
364
+ > - element_ids: 单元编号列表(可选参数)
365
+ >
366
+ > **示例代码**
367
+ > ```Python
368
+ > from qtmodel import *
369
+ > mdb.add_structure_group(name="新建结构组1")
370
+ > mdb.add_structure_group(name="新建结构组2",node_ids=[1,2,3,4],element_ids=[1,2])
371
+ > ```
372
+ > **返回**
373
+ > Returns: 无
374
+
375
+ ### update_structure_group_name
376
+ > **说明**
377
+ > 更新结构组名
378
+ > **参数**
379
+ > - name: 结构组名
380
+ > - new_name: 节点编号列表(可选参数)
381
+ >
382
+ > **示例代码**
383
+ > ```Python
384
+ > from qtmodel import *
385
+ > mdb.update_structure_group_name(name="结构组1",new_name="新结构组")
386
+ > ```
387
+ > **返回**
388
+ > Returns: 无
389
+
390
+ ### remove_structure_group
391
+ > **说明**
392
+ > 可根据结构与组名删除结构组,当组名为默认则删除所有结构组
393
+ > **参数**
394
+ > - name:结构组名称
395
+ >
396
+ > **示例代码**
397
+ > ```Python
398
+ > from qtmodel import *
399
+ > mdb.remove_structure_group(name="新建结构组1")
400
+ > mdb.remove_structure_group()
401
+ > ```
402
+ > **返回**
403
+ > Returns: 无
404
+
405
+ ### add_structure_to_group
406
+ > **说明**
407
+ > 为结构组添加节点和/或单元
408
+ > **参数**
409
+ > - name: 结构组名
410
+ > - node_ids: 节点编号列表(可选参数)
411
+ > - element_ids: 单元编号列表(可选参数)
412
+ >
413
+ > **示例代码**
414
+ > ```Python
415
+ > from qtmodel import *
416
+ > mdb.add_structure_to_group(name="现有结构组1",node_ids=[1,2,3,4],element_ids=[1,2])
417
+ > ```
418
+ > **返回**
419
+ > Returns: 无
420
+
421
+ ### remove_structure_from_group
422
+ > **说明**
423
+ > 为结构组删除节点、单元
424
+ > **参数**
425
+ > - name: 结构组名
426
+ > - node_ids: 节点编号列表(可选参数)
427
+ > - element_ids: 单元编号列表(可选参数)
428
+ >
429
+ > **示例代码**
430
+ > ```Python
431
+ > from qtmodel import *
432
+ > mdb.remove_structure_from_group(name="现有结构组1",node_ids=[1,2,3,4],element_ids=[1,2])
433
+ > ```
434
+ > **返回**
435
+ > Returns: 无
436
+
437
+ ## 节点操作
438
+ ### add_node
439
+ > **说明**
440
+ > 根据坐标信息和节点编号添加节点
441
+ > **参数**
442
+ > - node_data: [id,x,y,z] 或 [x,y,z] 指定节点编号时不进行交叉分割、合并、编号等操作
443
+ > - intersected: 是否交叉分割
444
+ > - is_merged: 是否忽略位置重复节点
445
+ > - merge_error: 合并容许误差
446
+ > - numbering_type:编号方式 0-未使用的最小号码 1-最大号码加1 2-用户定义号码
447
+ > - start_id:自定义节点起始编号(用户定义号码时使用)
448
+ >
449
+ > **示例代码**
450
+ > ```Python
451
+ > from qtmodel import *
452
+ > mdb.add_node(node_data=[1,2,3])
453
+ > mdb.add_node(node_data=[1,1,2,3])
454
+ > ```
455
+ > **返回**
456
+ > Returns: 无
457
+
458
+ ### add_nodes
459
+ > **说明**
460
+ > 根据坐标信息和节点编号添加一组节点,可指定节点号,或不指定节点号
461
+ > **参数**
462
+ > - node_data: [[id,x,y,z]...] 或[[x,y,z]...] 指定节点编号时不进行交叉分割、合并、编号等操作
463
+ > - intersected: 是否交叉分割
464
+ > - is_merged: 是否忽略位置重复节点
465
+ > - merge_error: 合并容许误差
466
+ > - numbering_type:编号方式 0-未使用的最小号码 1-最大号码加1 2-用户定义号码
467
+ > - start_id:自定义节点起始编号(用户定义号码时使用)
468
+ >
469
+ > **示例代码**
470
+ > ```Python
471
+ > from qtmodel import *
472
+ > mdb.add_nodes(node_data=[[1,1,2,3],[1,1,2,3]])
473
+ > ```
474
+ > **返回**
475
+ > Returns: 无
476
+
477
+ ### update_node
478
+ > **说明**
479
+ > 根据节点号修改节点坐标
480
+ > **参数**
481
+ > - node_id: 旧节点编号
482
+ > - new_id: 新节点编号,默认为-1时不改变节点编号
483
+ > - x: 更新后x坐标
484
+ > - y: 更新后y坐标
485
+ > - z: 更新后z坐标
486
+ >
487
+ > **示例代码**
488
+ > ```Python
489
+ > from qtmodel import *
490
+ > mdb.update_node(node_id=1,new_id=2,x=2,y=2,z=2)
491
+ > ```
492
+ > **返回**
493
+ > Returns: 无
494
+
495
+ ### update_node_id
496
+ > **说明**
497
+ > 修改节点Id
498
+ > **参数**
499
+ > - node_id: 节点编号
500
+ > - new_id: 新节点编号
501
+ >
502
+ > **示例代码**
503
+ > ```Python
504
+ > from qtmodel import *
505
+ > mdb.update_node_id(node_id=1,new_id=2)
506
+ > ```
507
+ > **返回**
508
+ > Returns: 无
509
+
510
+ ### merge_nodes
511
+ > **说明**
512
+ > 根据坐标信息和节点编号添加节点,默认自动识别编号
513
+ > **参数**
514
+ > - ids: 合并节点集合 默认全部节点
515
+ > - tolerance: 合并容许误差
516
+ >
517
+ > **示例代码**
518
+ > ```Python
519
+ > from qtmodel import *
520
+ > mdb.merge_nodes()
521
+ > ```
522
+ > **返回**
523
+ > Returns: 无
524
+
525
+ ### remove_node
526
+ > **说明**
527
+ > 删除指定节点,不输入参数时默认删除所有节点
528
+ > **参数**
529
+ > - ids:节点编号
530
+ >
531
+ > **示例代码**
532
+ > ```Python
533
+ > from qtmodel import *
534
+ > mdb.remove_node()
535
+ > mdb.remove_node(ids=1)
536
+ > mdb.remove_node(ids=[1,2,3])
537
+ > ```
538
+ > **返回**
539
+ > Returns: 无
540
+
541
+ ### renumber_nodes
542
+ > **说明**
543
+ > 节点编号重排序,默认按1升序重排所有节点
544
+ > **参数**
545
+ > - node_ids:被修改节点号
546
+ > - new_ids:新节点号
547
+ >
548
+ > **示例代码**
549
+ > ```Python
550
+ > from qtmodel import *
551
+ > mdb.renumber_nodes()
552
+ > mdb.renumber_nodes([7,9,22],[1,2,3])
553
+ > ```
554
+ > **返回**
555
+ > Returns: 无
556
+
557
+ ### move_node
558
+ > **说明**
559
+ > 移动节点坐标
560
+ > **参数**
561
+ > - node_id:节点号
562
+ > - offset_x:X轴偏移量
563
+ > - offset_y:Y轴偏移量
564
+ > - offset_z:Z轴偏移量
565
+ >
566
+ > **示例代码**
567
+ > ```Python
568
+ > from qtmodel import *
569
+ > mdb.move_node(node_id=1,offset_x=1.5,offset_y=1.5,offset_z=1.5)
570
+ > ```
571
+ > **返回**
572
+ > Returns: 无
573
+
574
+ ## 单元操作
575
+ ### update_local_orientation
576
+ > **说明**
577
+ > 反转杆系单元局部方向
578
+ > **参数**
579
+ > - ele_id: 杆系单元编号
580
+ >
581
+ > **示例代码**
582
+ > ```Python
583
+ > from qtmodel import *
584
+ > mdb.update_local_orientation(1)
585
+ > ```
586
+ > **返回**
587
+ > Returns: 无
588
+
589
+ ### update_element_id
590
+ > **说明**
591
+ > 更改单元编号
592
+ > **参数**
593
+ > - old_id: 单元编号
594
+ > - new_id: 新单元编号
595
+ >
596
+ > **示例代码**
597
+ > ```Python
598
+ > from qtmodel import *
599
+ > mdb.update_element_id(1,2)
600
+ > ```
601
+ > **返回**
602
+ > Returns: 无
603
+
604
+ ### add_element
605
+ > **说明**
606
+ > 根据单元编号和单元类型添加单元
607
+ > **参数**
608
+ > - index:单元编号
609
+ > - ele_type:单元类型 1-梁 2-杆 3-索 4-板
610
+ > - node_ids:单元对应的节点列表 [i,j] 或 [i,j,k,l]
611
+ > - beta_angle:贝塔角
612
+ > - mat_id:材料编号
613
+ > - sec_id:截面编号
614
+ > - initial_type:索单元初始参数类型 1-初始拉力 2-初始水平力 3-无应力长度
615
+ > - initial_value:索单元初始始参数值
616
+ > - plate_type:板单元类型 0-薄板 1-厚板
617
+ >
618
+ > **示例代码**
619
+ > ```Python
620
+ > from qtmodel import *
621
+ > mdb.add_element(index=1,ele_type=1,node_ids=[1,2],beta_angle=1,mat_id=1,sec_id=1)
622
+ > ```
623
+ > **返回**
624
+ > Returns: 无
625
+
626
+ ### update_element
627
+ > **说明**
628
+ > 根据单元编号和单元类型添加单元
629
+ > **参数**
630
+ > - old_id:原单元编号
631
+ > - new_id:现单元编号,默认不修改原单元Id
632
+ > - ele_type:单元类型 1-梁 2-杆 3-索 4-板
633
+ > - node_ids:单元对应的节点列表 [i,j] 或 [i,j,k,l]
634
+ > - beta_angle:贝塔角
635
+ > - mat_id:材料编号
636
+ > - sec_id:截面编号
637
+ > - initial_type:索单元初始参数类型 1-初始拉力 2-初始水平力 3-无应力长度
638
+ > - initial_value:索单元初始始参数值
639
+ > - plate_type:板单元类型 0-薄板 1-厚板
640
+ >
641
+ > **示例代码**
642
+ > ```Python
643
+ > from qtmodel import *
644
+ > mdb.update_element(old_id=1,ele_type=1,node_ids=[1,2],beta_angle=1,mat_id=1,sec_id=1)
645
+ > ```
646
+ > **返回**
647
+ > Returns: 无
648
+
649
+ ### add_elements
650
+ > **说明**
651
+ > 根据单元编号和单元类型添加单元
652
+ > **参数**
653
+ > - ele_data:单元信息
654
+ > [编号,类型(1-梁 2-杆),materialId,sectionId,betaAngle,nodeI,nodeJ]
655
+ > [编号,类型(3-索),materialId,sectionId,betaAngle,nodeI,nodeJ,张拉类型(1-初拉力 2-初始水平力 3-无应力长度),张拉值]
656
+ > [编号,类型(4-板),materialId,thicknessId,betaAngle,nodeI,nodeJ,nodeK,nodeL]
657
+ >
658
+ > **示例代码**
659
+ > ```Python
660
+ > from qtmodel import *
661
+ > mdb.add_elements(ele_data=[
662
+ > [1,1,1,1,0,1,2],
663
+ > [2,2,1,1,0,1,2],
664
+ > [3,3,1,1,0,1,2,1,100],
665
+ > [4,4,1,1,0,1,2,3,4]])
666
+ > ```
667
+ > **返回**
668
+ > Returns: 无
669
+
670
+ ### update_element_local_orientation
671
+ > **说明**
672
+ > 更新指定单元的单元局部坐标系
673
+ > **参数**
674
+ > - index: 单元编号
675
+ >
676
+ > **示例代码**
677
+ > ```Python
678
+ > from qtmodel import *
679
+ > mdb.update_element_local_orientation(index=1)
680
+ > ```
681
+ > **返回**
682
+ > Returns: 无
683
+
684
+ ### update_element_material
685
+ > **说明**
686
+ > 更新指定单元的材料号
687
+ > **参数**
688
+ > - index: 单元编号
689
+ > - mat_id: 材料编号
690
+ >
691
+ > **示例代码**
692
+ > ```Python
693
+ > from qtmodel import *
694
+ > mdb.update_element_material(index=1,mat_id=2)
695
+ > ```
696
+ > **返回**
697
+ > Returns: 无
698
+
699
+ ### update_element_beta_angle
700
+ > **说明**
701
+ > 更新指定单元的贝塔角
702
+ > **参数**
703
+ > - index: 单元编号
704
+ > - beta_angle: 贝塔角度数
705
+ >
706
+ > **示例代码**
707
+ > ```Python
708
+ > from qtmodel import *
709
+ > mdb.update_element_beta_angle(index=1,beta_angle=90)
710
+ > ```
711
+ > **返回**
712
+ > Returns: 无
713
+
714
+ ### update_element_section
715
+ > **说明**
716
+ > 更新杆系单元截面或板单元板厚
717
+ > **参数**
718
+ > - index: 单元编号
719
+ > - sec_id: 截面号
720
+ >
721
+ > **示例代码**
722
+ > ```Python
723
+ > from qtmodel import *
724
+ > mdb.update_element_section(index=1,sec_id=2)
725
+ > ```
726
+ > **返回**
727
+ > Returns: 无
728
+
729
+ ### update_element_node
730
+ > **说明**
731
+ > 更新单元节点
732
+ > **参数**
733
+ > - index: 单元编号
734
+ > - nodes: 杆系单元时为[node_i,node_j] 板单元[i,j,k,l]
735
+ >
736
+ > **示例代码**
737
+ > ```Python
738
+ > from qtmodel import *
739
+ > mdb.update_element_node(1,[1,2])
740
+ > mdb.update_element_node(2,[1,2,3,4])
741
+ > ```
742
+ > **返回**
743
+ > Returns: 无
744
+
745
+ ### remove_element
746
+ > **说明**
747
+ > 删除指定编号的单元
748
+ > **参数**
749
+ > - index: 单元编号,默认时删除所有单元
750
+ >
751
+ > **示例代码**
752
+ > ```Python
753
+ > from qtmodel import *
754
+ > mdb.remove_element()
755
+ > mdb.remove_element(index=1)
756
+ > ```
757
+ > **返回**
758
+ > Returns: 无
759
+
760
+ ### renumber_elements
761
+ > **说明**
762
+ > 单元编号重排序,默认按1升序重排所有节点
763
+ > **参数**
764
+ > - ele_ids:被修改单元号
765
+ > - new_ids:新单元号
766
+ >
767
+ > **示例代码**
768
+ > ```Python
769
+ > from qtmodel import *
770
+ > mdb.renumber_elements()
771
+ > mdb.renumber_elements([7,9,22],[1,2,3])
772
+ > ```
773
+ > **返回**
774
+ > Returns: 无
775
+
776
+ ## 材料操作
777
+ ### update_material
778
+ > **说明**
779
+ > 添加材料
780
+ > **参数**
781
+ > - name:旧材料名称
782
+ > - new_name:新材料名称,默认不更改名称
783
+ > - new_id:新材料Id,默认不更改Id
784
+ > - mat_type: 材料类型,1-混凝土 2-钢材 3-预应力 4-钢筋 5-自定义 6-组合材料
785
+ > - standard:规范序号,参考UI 默认从1开始
786
+ > - database:数据库名称
787
+ > - construct_factor:构造系数
788
+ > - modified:是否修改默认材料参数,默认不修改 (可选参数)
789
+ > - data_info:材料参数列表[弹性模量,容重,泊松比,热膨胀系数] (可选参数)
790
+ > - creep_id:徐变材料id (可选参数)
791
+ > - f_cuk: 立方体抗压强度标准值 (可选参数)
792
+ > - composite_info: 主材名和辅材名 (仅组合材料需要)
793
+ >
794
+ > **示例代码**
795
+ > ```Python
796
+ > from qtmodel import *
797
+ > mdb.update_material(name="混凝土材料1",mat_type=1,standard=1,database="C50")
798
+ > mdb.update_material(name="自定义材料1",mat_type=5,data_info=[3.5e10,2.5e4,0.2,1.5e-5])
799
+ > ```
800
+ > **返回**
801
+ > Returns: 无
802
+
803
+ ### add_material
804
+ > **说明**
805
+ > 添加材料
806
+ > **参数**
807
+ > - index:材料编号,默认为最大Id+1
808
+ > - name:材料名称
809
+ > - mat_type: 材料类型,1-混凝土 2-钢材 3-预应力 4-钢筋 5-自定义 6-组合材料
810
+ > - standard:规范序号,参考UI 默认从1开始
811
+ > - database:数据库名称
812
+ > - construct_factor:构造系数
813
+ > - modified:是否修改默认材料参数,默认不修改 (可选参数)
814
+ > - data_info:材料参数列表[弹性模量,容重,泊松比,热膨胀系数] (可选参数)
815
+ > - creep_id:徐变材料id (可选参数)
816
+ > - f_cuk: 立方体抗压强度标准值 (可选参数)
817
+ > - composite_info: 主材名和辅材名 (仅组合材料需要)
818
+ >
819
+ > **示例代码**
820
+ > ```Python
821
+ > from qtmodel import *
822
+ > mdb.add_material(index=1,name="混凝土材料1",mat_type=1,standard=1,database="C50")
823
+ > mdb.add_material(index=1,name="自定义材料1",mat_type=5,data_info=[3.5e10,2.5e4,0.2,1.5e-5])
824
+ > ```
825
+ > **返回**
826
+ > Returns: 无
827
+
828
+ ### add_time_parameter
829
+ > **说明**
830
+ > 添加收缩徐变材料
831
+ > **参数**
832
+ > - name: 收缩徐变名
833
+ > - code_index: 收缩徐变规范索引
834
+ > - time_parameter: 对应规范的收缩徐变参数列表,默认不改变规范中信息 (可选参数)
835
+ > - creep_data: 徐变数据 [(函数名,龄期)...]
836
+ > - shrink_data: 收缩函数名
837
+ >
838
+ > **示例代码**
839
+ > ```Python
840
+ > from qtmodel import *
841
+ > mdb.add_time_parameter(name="收缩徐变材料1",code_index=1)
842
+ > ```
843
+ > **返回**
844
+ > Returns: 无
845
+
846
+ ### update_time_parameter
847
+ > **说明**
848
+ > 添加收缩徐变材料
849
+ > **参数**
850
+ > - name: 收缩徐变名
851
+ > - new_name: 新收缩徐变名,默认不改变名称
852
+ > - code_index: 收缩徐变规范索引
853
+ > - time_parameter: 对应规范的收缩徐变参数列表,默认不改变规范中信息 (可选参数)
854
+ > - creep_data: 徐变数据 [(函数名,龄期)...]
855
+ > - shrink_data: 收缩函数名
856
+ >
857
+ > **示例代码**
858
+ > ```Python
859
+ > from qtmodel import *
860
+ > mdb.update_time_parameter(name="收缩徐变材料1",new_name="新收缩徐变材料1",code_index=1)
861
+ > ```
862
+ > **返回**
863
+ > Returns: 无
864
+
865
+ ### add_creep_function
866
+ > **说明**
867
+ > 添加徐变函数
868
+ > **参数**
869
+ > - name:徐变函数名
870
+ > - creep_data:徐变数据[(时间,徐变系数)...]
871
+ > - scale_factor:缩放系数
872
+ >
873
+ > **示例代码**
874
+ > ```Python
875
+ > from qtmodel import *
876
+ > mdb.add_creep_function(name="徐变函数名",creep_data=[(5,0.5),(100,0.75)])
877
+ > ```
878
+ > **返回**
879
+ > Returns: 无
880
+
881
+ ### update_creep_function
882
+ > **说明**
883
+ > 添加徐变函数
884
+ > **参数**
885
+ > - name:徐变函数名
886
+ > - new_name: 新徐变函数名,默认不改变函数名
887
+ > - creep_data:徐变数据,默认不改变函数名 [(时间,徐变系数)...]
888
+ > - scale_factor:缩放系数
889
+ >
890
+ > **示例代码**
891
+ > ```Python
892
+ > from qtmodel import *
893
+ > mdb.add_creep_function(name="徐变函数名",creep_data=[(5,0.5),(100,0.75)])
894
+ > ```
895
+ > **返回**
896
+ > Returns: 无
897
+
898
+ ### add_shrink_function
899
+ > **说明**
900
+ > 添加收缩函数
901
+ > **参数**
902
+ > - name:收缩函数名
903
+ > - shrink_data:收缩数据[(时间,收缩系数)...]
904
+ > - scale_factor:缩放系数
905
+ >
906
+ > **示例代码**
907
+ > ```Python
908
+ > from qtmodel import *
909
+ > mdb.add_shrink_function(name="收缩函数名",shrink_data=[(5,0.5),(100,0.75)])
910
+ > mdb.add_shrink_function(name="收缩函数名",scale_factor=1.2)
911
+ > ```
912
+ > **返回**
913
+ > Returns: 无
914
+
915
+ ### update_shrink_function
916
+ > **说明**
917
+ > 添加收缩函数
918
+ > **参数**
919
+ > - name:收缩函数名
920
+ > - new_name:收缩函数名
921
+ > - shrink_data:收缩数据,默认不改变数据 [(时间,收缩系数)...]
922
+ > - scale_factor:缩放系数
923
+ >
924
+ > **示例代码**
925
+ > ```Python
926
+ > from qtmodel import *
927
+ > mdb.update_shrink_function(name="收缩函数名",new_name="函数名2")
928
+ > mdb.update_shrink_function(name="收缩函数名",shrink_data=[(5,0.5),(100,0.75)])
929
+ > mdb.update_shrink_function(name="收缩函数名",scale_factor=1.2)
930
+ > ```
931
+ > **返回**
932
+ > Returns: 无
933
+
934
+ ### remove_shrink_function
935
+ > **说明**
936
+ > 删除收缩函数
937
+ > **参数**
938
+ > - name:收缩函数名
939
+ >
940
+ > **示例代码**
941
+ > ```Python
942
+ > from qtmodel import *
943
+ > mdb.remove_shrink_function(name="收缩函数名")
944
+ > ```
945
+ > **返回**
946
+ > Returns: 无
947
+
948
+ ### remove_creep_function
949
+ > **说明**
950
+ > 删除徐变函数
951
+ > **参数**
952
+ > - name:徐变函数名
953
+ >
954
+ > **示例代码**
955
+ > ```Python
956
+ > from qtmodel import *
957
+ > mdb.remove_creep_function(name="徐变函数名")
958
+ > ```
959
+ > **返回**
960
+ > Returns: 无
961
+
962
+ ### update_material_time_parameter
963
+ > **说明**
964
+ > 将收缩徐变参数连接到材料
965
+ > **参数**
966
+ > - name: 材料名
967
+ > - time_parameter_name: 收缩徐变名称
968
+ > - f_cuk: 材料标准抗压强度,仅自定义材料是需要输入
969
+ >
970
+ > **示例代码**
971
+ > ```Python
972
+ > from qtmodel import *
973
+ > mdb.update_material_time_parameter(name="C60",time_parameter_name="收缩徐变1",f_cuk=5e7)
974
+ > ```
975
+ > **返回**
976
+ > Returns: 无
977
+
978
+ ### update_material_id
979
+ > **说明**
980
+ > 更新材料编号
981
+ > **参数**
982
+ > - name:材料名称
983
+ > - new_id:新编号
984
+ >
985
+ > **示例代码**
986
+ > ```Python
987
+ > from qtmodel import *
988
+ > mdb.update_material_id(name="材料1",new_id=2)
989
+ > ```
990
+ > **返回**
991
+ > Returns: 无
992
+
993
+ ### remove_material
994
+ > **说明**
995
+ > 删除指定材料
996
+ > **参数**
997
+ > - index:指定材料编号,默认则删除所有材料
998
+ > - name: 指定材料名,材料名为空时按照index删除
999
+ >
1000
+ > **示例代码**
1001
+ > ```Python
1002
+ > from qtmodel import *
1003
+ > mdb.remove_material()
1004
+ > mdb.remove_material(index=1)
1005
+ > ```
1006
+ > **返回**
1007
+ > Returns: 无
1008
+
1009
+ ### update_material_construction_factor
1010
+ > **说明**
1011
+ > 更新材料构造系数
1012
+ > **参数**
1013
+ > - name:指定材料编号,默认则删除所有材料
1014
+ > - factor:指定材料编号,默认则删除所有材料
1015
+ >
1016
+ > **示例代码**
1017
+ > ```Python
1018
+ > from qtmodel import *
1019
+ > mdb.update_material_construction_factor(name="材料1",factor=1.0)
1020
+ > ```
1021
+ > **返回**
1022
+ > Returns: 无
1023
+
1024
+ ### remove_time_parameter
1025
+ > **说明**
1026
+ > 删除指定时间依存材料
1027
+ > **参数**
1028
+ > - name: 指定收缩徐变材料名
1029
+ >
1030
+ > **示例代码**
1031
+ > ```Python
1032
+ > from qtmodel import *
1033
+ > mdb.remove_time_parameter("收缩徐变材料1")
1034
+ > ```
1035
+ > **返回**
1036
+ > Returns: 无
1037
+
1038
+ ## 板厚操作
1039
+ ### add_thickness
1040
+ > **说明**
1041
+ > 添加板厚
1042
+ > **参数**
1043
+ > - index: 板厚id
1044
+ > - name: 板厚名称
1045
+ > - t: 板厚度
1046
+ > - thick_type: 板厚类型 0-普通板 1-加劲肋板
1047
+ > - bias_info: 默认不偏心,偏心时输入列表[type(0-厚度比 1-数值),value]
1048
+ > - rib_pos: 肋板位置 0-下部 1-上部
1049
+ > - dist_v: 纵向截面肋板间距
1050
+ > - dist_l: 横向截面肋板间距
1051
+ > - rib_v: 纵向肋板信息
1052
+ > - rib_l: 横向肋板信息
1053
+ >
1054
+ > **示例代码**
1055
+ > ```Python
1056
+ > from qtmodel import *
1057
+ > mdb.add_thickness(name="厚度1", t=0.2,thick_type=0,bias_info=(0,0.8))
1058
+ > mdb.add_thickness(name="厚度2", t=0.2,thick_type=1,rib_pos=0,dist_v=0.1,rib_v=[1,1,0.02,0.02])
1059
+ > ```
1060
+ > **返回**
1061
+ > Returns: 无
1062
+
1063
+ ### update_thickness_id
1064
+ > **说明**
1065
+ > 更新板厚编号
1066
+ > **参数**
1067
+ > - index: 板厚id
1068
+ > - new_id: 新板厚id
1069
+ >
1070
+ > **示例代码**
1071
+ > ```Python
1072
+ > from qtmodel import *
1073
+ > mdb.update_thickness_id(1,2)
1074
+ > ```
1075
+ > **返回**
1076
+ > Returns: 无
1077
+
1078
+ ### remove_thickness
1079
+ > **说明**
1080
+ > 删除板厚
1081
+ > **参数**
1082
+ > - index:板厚编号,默认时删除所有板厚信息
1083
+ > - name:默认按照编号删除,如果不为空则按照名称删除
1084
+ >
1085
+ > **示例代码**
1086
+ > ```Python
1087
+ > from qtmodel import *
1088
+ > mdb.remove_thickness()
1089
+ > mdb.remove_thickness(index=1)
1090
+ > mdb.remove_thickness(name="板厚1")
1091
+ > ```
1092
+ > **返回**
1093
+ > Returns: 无
1094
+
1095
+ ## 截面操作
1096
+ ### add_section
1097
+ > **说明**
1098
+ > 添加单一截面信息,如果截面存在则自动覆盖
1099
+ > **参数**
1100
+ > - index: 截面编号,默认自动识别
1101
+ > - name:截面名称
1102
+ > - sec_type:参数截面类型名称(详见UI界面)
1103
+ > - sec_info:截面信息 (必要参数)
1104
+ > - symmetry:混凝土截面是否对称 (仅混凝土箱梁截面需要)
1105
+ > - charm_info:混凝土截面倒角信息 (仅混凝土箱梁截面需要)
1106
+ > - sec_right:混凝土截面右半信息 (对称时可忽略,仅混凝土箱梁截面需要)
1107
+ > - charm_right:混凝土截面右半倒角信息 (对称时可忽略,仅混凝土箱梁截面需要)
1108
+ > - box_num: 混凝土箱室数 (仅混凝土箱梁截面需要)
1109
+ > - box_height: 混凝土箱梁梁高 (仅混凝土箱梁截面需要)
1110
+ > - mat_combine: 组合截面材料信息 (仅组合材料需要) [弹性模量比s/c、密度比s/c、钢材泊松比、混凝土泊松比、热膨胀系数比s/c]
1111
+ > - rib_info:肋板信息
1112
+ > - rib_place:肋板位置 list[tuple[布置具体部位,参考点0-下/左,距参考点间距,肋板名,加劲肋位置0-上/左 1-下/右 2-两侧,加劲肋名]]
1113
+ > _布置具体部位(工字钢梁) 1-上左 2-上右 3-腹板 4-下左 5-下右
1114
+ > _布置具体部位(箱型钢梁) 1-上左 2-上中 3-上右 4-左腹板 5-右腹板 6-下左 7-下中 8-下右
1115
+ > - loop_segments:线圈坐标集合 list[dict] dict示例:{"main":[(x1,y1),(x2,y2)...],"sub1":[(x1,y1),(x2,y2)...],"sub2":[(x1,y1),(x2,y2)...]}
1116
+ > - sec_lines:线宽集合[(x1,y1,x2,y3,thick),]
1117
+ > - secondary_loop_segments:辅材线圈坐标集合 list[dict] (同loop_segments)
1118
+ > - sec_property:截面特性(参考UI界面共计26个参数),可选参数,指定截面特性时不进行截面计算
1119
+ > - bias_type:偏心类型 默认中心
1120
+ > - center_type:中心类型 默认质心
1121
+ > - shear_consider:考虑剪切 bool 默认考虑剪切变形
1122
+ > - bias_x:自定义偏心点x坐标 (仅自定义类型偏心需要,相对于center_type偏移)
1123
+ > - bias_y:自定义偏心点y坐标 (仅自定义类型偏心需要,相对于center_type偏移)
1124
+ >
1125
+ > **示例代码**
1126
+ > ```Python
1127
+ > from qtmodel import *
1128
+ > mdb.add_section(name="截面1",sec_type="矩形",sec_info=[2,4],bias_type="中心")
1129
+ > mdb.add_section(name="截面2",sec_type="混凝土箱梁",box_height=2,box_num=3,
1130
+ > sec_info=[0.02,0,12,3,1,2,1,5,6,0.2,0.4,0.1,0.13,0.28,0.3,0.5,0.5,0.5,0.2],
1131
+ > charm_info=["1*0.2,0.1*0.2","0.5*0.15,0.3*0.2","0.4*0.2","0.5*0.2"])
1132
+ > mdb.add_section(name="钢梁截面1",sec_type="工字钢梁",sec_info=[0,0,0.5,0.5,0.5,0.5,0.7,0.02,0.02,0.02])
1133
+ > mdb.add_section(name="钢梁截面2",sec_type="箱型钢梁",sec_info=[0,0.15,0.25,0.5,0.25,0.15,0.4,0.15,0.7,0.02,0.02,0.02,0.02],
1134
+ > rib_info = {"板肋1": [0.1,0.02],"T形肋1":[0.1,0.02,0.02,0.02]},
1135
+ > rib_place = [(1, 0, 0.1, "板肋1", 2, "默认名称1"),
1136
+ > (1, 0, 0.2, "板肋1", 2, "默认名称1")])
1137
+ > ```
1138
+ > **返回**
1139
+ > Returns: 无
1140
+
1141
+ ### add_single_section
1142
+ > **说明**
1143
+ > 以字典形式添加单一截面
1144
+ > **参数**
1145
+ > - index:截面编号
1146
+ > - name:截面名称
1147
+ > - sec_type:截面类型
1148
+ > - sec_data:截面信息字典,键值参考添加add_section方法参数
1149
+ >
1150
+ > **示例代码**
1151
+ > ```Python
1152
+ > from qtmodel import *
1153
+ > mdb.add_single_section(index=1,name="变截面1",sec_type="矩形",
1154
+ > sec_data={"sec_info":[1,2],"bias_type":"中心"})
1155
+ > ```
1156
+ > **返回**
1157
+ > Returns: 无
1158
+
1159
+ ### update_single_section
1160
+ > **说明**
1161
+ > 以字典形式添加单一截面
1162
+ > **参数**
1163
+ > - index:截面编号
1164
+ > - new_id:新截面编号,默认不修改截面编号
1165
+ > - name:截面名称
1166
+ > - sec_type:截面类型
1167
+ > - sec_data:截面信息字典,键值参考添加add_section方法参数
1168
+ >
1169
+ > **示例代码**
1170
+ > ```Python
1171
+ > from qtmodel import *
1172
+ > mdb.update_single_section(index=1,name="变截面1",sec_type="矩形",
1173
+ > sec_data={"sec_info":[1,2],"bias_type":"中心"})
1174
+ > ```
1175
+ > **返回**
1176
+ > Returns: 无
1177
+
1178
+ ### add_tapper_section
1179
+ > **说明**
1180
+ > 添加变截面,字典参数参考单一截面,如果截面存在则自动覆盖
1181
+ > **参数**
1182
+ > - index:截面编号
1183
+ > - name:截面名称
1184
+ > - sec_type:截面类型
1185
+ > - sec_begin:截面始端截面信息字典,键值参考添加add_section方法参数
1186
+ > - sec_end:截面末端截面信息字典,键值参考添加add_section方法参数
1187
+ > - shear_consider:考虑剪切变形
1188
+ > - sec_normalize:变截面线段线圈重新排序
1189
+ >
1190
+ > **示例代码**
1191
+ > ```Python
1192
+ > from qtmodel import *
1193
+ > mdb.add_tapper_section(index=1,name="变截面1",sec_type="矩形",
1194
+ > sec_begin={"sec_info":[1,2],"bias_type":"中心"},
1195
+ > sec_end={"sec_info":[2,2],"bias_type":"中心"})
1196
+ > ```
1197
+ > **返回**
1198
+ > Returns: 无
1199
+
1200
+ ### update_tapper_section
1201
+ > **说明**
1202
+ > 添加变截面,字典参数参考单一截面,如果截面存在则自动覆盖
1203
+ > **参数**
1204
+ > - index:截面编号
1205
+ > - new_id:新截面编号,默认不修改截面编号
1206
+ > - name:截面名称
1207
+ > - sec_type:截面类型
1208
+ > - sec_begin:截面始端编号
1209
+ > - sec_end:截面末端编号
1210
+ > - shear_consider:考虑剪切变形
1211
+ > - sec_normalize:变截面线段线圈重新排序
1212
+ >
1213
+ > **示例代码**
1214
+ > ```Python
1215
+ > from qtmodel import *
1216
+ > mdb.add_tapper_section(index=1,name="变截面1",sec_type="矩形",
1217
+ > sec_begin={"sec_info":[1,2],"bias_type":"中心"},
1218
+ > sec_end={"sec_info":[2,2],"bias_type":"中心"})
1219
+ > ```
1220
+ > **返回**
1221
+ > Returns: 无
1222
+
1223
+ ### add_tapper_section_by_id
1224
+ > **说明**
1225
+ > 添加变截面,需先建立单一截面
1226
+ > **参数**
1227
+ > - index:截面编号
1228
+ > - name:截面名称
1229
+ > - begin_id:截面始端编号
1230
+ > - end_id:截面末端编号
1231
+ > - shear_consider:考虑剪切变形
1232
+ > - sec_normalize: 开启变截面线圈和线宽自适应排序 (避免两端截面绘制顺序导致的渲染和计算失效)
1233
+ >
1234
+ > **示例代码**
1235
+ > ```Python
1236
+ > from qtmodel import *
1237
+ > mdb.add_tapper_section_by_id(name="变截面1",begin_id=1,end_id=2)
1238
+ > ```
1239
+ > **返回**
1240
+ > Returns: 无
1241
+
1242
+ ### remove_section
1243
+ > **说明**
1244
+ > 删除截面信息
1245
+ > **参数**
1246
+ > - index: 截面编号,参数为默认时删除全部截面
1247
+ >
1248
+ > **示例代码**
1249
+ > ```Python
1250
+ > from qtmodel import *
1251
+ > mdb.remove_section()
1252
+ > mdb.remove_section(1)
1253
+ > ```
1254
+ > **返回**
1255
+ > Returns: 无
1256
+
1257
+ ### add_tapper_section_group
1258
+ > **说明**
1259
+ > 添加变截面组
1260
+ > **参数**
1261
+ > - ids:变截面组单元号
1262
+ > - name: 变截面组名
1263
+ > - factor_w: 宽度方向变化阶数 线性(1.0) 非线性(!=1.0)
1264
+ > - factor_h: 高度方向变化阶数 线性(1.0) 非线性(!=1.0)
1265
+ > - ref_w: 宽度方向参考点 0-i 1-j
1266
+ > - ref_h: 高度方向参考点 0-i 1-j
1267
+ > - dis_w: 宽度方向距离
1268
+ > - dis_h: 高度方向距离
1269
+ >
1270
+ > **示例代码**
1271
+ > ```Python
1272
+ > from qtmodel import *
1273
+ > mdb.add_tapper_section_group(ids=[1,2,3,4],name="变截面组1")
1274
+ > ```
1275
+ > **返回**
1276
+ > Returns: 无
1277
+
1278
+ ### update_tapper_section_group
1279
+ > **说明**
1280
+ > 添加变截面组
1281
+ > **参数**
1282
+ > - name:变截面组组名
1283
+ > - new_name: 新变截面组名
1284
+ > - ids:变截面组单元号
1285
+ > - factor_w: 宽度方向变化阶数 线性(1.0) 非线性(!=1.0)
1286
+ > - factor_h: 高度方向变化阶数 线性(1.0) 非线性(!=1.0)
1287
+ > - ref_w: 宽度方向参考点 0-i 1-j
1288
+ > - ref_h: 高度方向参考点 0-i 1-j
1289
+ > - dis_w: 宽度方向距离
1290
+ > - dis_h: 高度方向距离
1291
+ >
1292
+ > **示例代码**
1293
+ > ```Python
1294
+ > from qtmodel import *
1295
+ > mdb.update_tapper_section_group(ids=[1,2,3,4],name="变截面组1")
1296
+ > ```
1297
+ > **返回**
1298
+ > Returns: 无
1299
+
1300
+ ### update_section_bias
1301
+ > **说明**
1302
+ > 更新截面偏心
1303
+ > **参数**
1304
+ > - index:截面编号
1305
+ > - bias_type:偏心类型
1306
+ > - center_type:中心类型
1307
+ > - shear_consider:考虑剪切
1308
+ > - bias_point:自定义偏心点(仅自定义类型偏心需要)
1309
+ > - side_i: 是否为截面I,否则为截面J(仅变截面需要)
1310
+ >
1311
+ > **示例代码**
1312
+ > ```Python
1313
+ > from qtmodel import *
1314
+ > mdb.update_section_bias(index=1,bias_type="中上",center_type="几何中心")
1315
+ > mdb.update_section_bias(index=1,bias_type="自定义",bias_point=[0.1,0.2])
1316
+ > ```
1317
+ > **返回**
1318
+ > Returns: 无
1319
+
1320
+ ### update_section_property
1321
+ > **说明**
1322
+ > 更新截面特性
1323
+ > **参数**
1324
+ > - index:截面号
1325
+ > - sec_property:截面特性值参考UI共计26个数值
1326
+ > - side_i:是否为I端截面(仅变截面需要)
1327
+ >
1328
+ > **示例代码**
1329
+ > ```Python
1330
+ > from qtmodel import *
1331
+ > mdb.update_section_property(index=1,sec_property=[i for i in range(1,27)])
1332
+ > ```
1333
+ > **返回**
1334
+ > Returns: 无
1335
+
1336
+ ### add_tapper_section_from_group
1337
+ > **说明**
1338
+ > 将变截面组转为变截面
1339
+ > **参数**
1340
+ > - name: 变截面组名,默认则转化全部变截面组
1341
+ >
1342
+ > **示例代码**
1343
+ > ```Python
1344
+ > from qtmodel import *
1345
+ > mdb.add_tapper_section_from_group()
1346
+ > mdb.add_tapper_section_from_group("变截面组1")
1347
+ > ```
1348
+ > **返回**
1349
+ > Returns: 无
1350
+
1351
+ ### update_section_id
1352
+ > **说明**
1353
+ > 更新截面编号
1354
+ > **参数**
1355
+ > - index: 原编号
1356
+ > - new_id: 新编号
1357
+ >
1358
+ > **示例代码**
1359
+ > ```Python
1360
+ > from qtmodel import *
1361
+ > mdb.update_section_id(index=1,new_id=2)
1362
+ > ```
1363
+ > **返回**
1364
+ > Returns:无
1365
+
1366
+ ### remove_tapper_section_group
1367
+ > **说明**
1368
+ > 删除变截面组,默认删除所有变截面组
1369
+ > **参数**
1370
+ > - name:变截面组名称
1371
+ >
1372
+ > **示例代码**
1373
+ > ```Python
1374
+ > from qtmodel import *
1375
+ > mdb.remove_tapper_section_group()
1376
+ > mdb.remove_tapper_section_group("变截面组1")
1377
+ > ```
1378
+ > **返回**
1379
+ > Returns:无
1380
+
1381
+ ### add_elements_to_tapper_section_group
1382
+ > **说明**
1383
+ > 删除变截面组,默认删除所有变截面组
1384
+ > **参数**
1385
+ > - name:变截面组名称
1386
+ > - ids:新增单元编号
1387
+ >
1388
+ > **示例代码**
1389
+ > ```Python
1390
+ > from qtmodel import *
1391
+ > mdb.add_elements_to_tapper_section_group("变截面组1",ids=[1,2,3,4,5,6])
1392
+ > ```
1393
+ > **返回**
1394
+ > Returns:无
1395
+
1396
+ ## 边界操作
1397
+ ### add_boundary_group
1398
+ > **说明**
1399
+ > 新建边界组
1400
+ > **参数**
1401
+ > - name:边界组名
1402
+ >
1403
+ > **示例代码**
1404
+ > ```Python
1405
+ > from qtmodel import *
1406
+ > mdb.add_boundary_group(name="边界组1")
1407
+ > ```
1408
+ > **返回**
1409
+ > Returns: 无
1410
+
1411
+ ### update_boundary_group
1412
+ > **说明**
1413
+ > 更改边界组名
1414
+ > **参数**
1415
+ > - name:边界组名
1416
+ > - new_name:新边界组名
1417
+ >
1418
+ > **示例代码**
1419
+ > ```Python
1420
+ > from qtmodel import *
1421
+ > mdb.update_boundary_group("旧边界组","新边界组")
1422
+ > ```
1423
+ > **返回**
1424
+ > Returns: 无
1425
+
1426
+ ### remove_boundary_group
1427
+ > **说明**
1428
+ > 按照名称删除边界组
1429
+ > **参数**
1430
+ > - name: 边界组名称,默认删除所有边界组 (非必须参数)
1431
+ >
1432
+ > **示例代码**
1433
+ > ```Python
1434
+ > from qtmodel import *
1435
+ > mdb.remove_boundary_group()
1436
+ > mdb.remove_boundary_group(name="边界组1")
1437
+ > ```
1438
+ > **返回**
1439
+ > Returns: 无
1440
+
1441
+ ### remove_all_boundary
1442
+ > **说明**
1443
+ > 根据边界组名称、边界的类型和编号删除边界信息,默认时删除所有边界信息
1444
+ > **参数**
1445
+ >
1446
+ > **示例代码**
1447
+ > ```Python
1448
+ > from qtmodel import *
1449
+ > mdb.remove_all_boundary()
1450
+ > ```
1451
+ > **返回**
1452
+ > Returns: 无
1453
+
1454
+ ### remove_boundary
1455
+ > **说明**
1456
+ > 根据节点号删除一般支撑、弹性支承/根据弹性连接I或J端(需指定)节点号删除弹性连接/根据单元号删除梁端约束/根据从节点号和约束方程名删除约束方程/根据从节点号删除主从约束
1457
+ > **参数**
1458
+ > - remove_id:节点号 or 单元号 or 从节点号
1459
+ > - bd_type:边界类型 ["一般支承", "弹性支承","一般弹性支承", "主从约束", "一般/受拉/受压/刚性弹性连接", "约束方程", "梁端约束"]
1460
+ > - group:边界所处边界组名
1461
+ > - extra_name:删除弹性连接或约束方程时额外标识,约束方程名或指定删除弹性连接节点类型 I/J
1462
+ >
1463
+ > **示例代码**
1464
+ > ```Python
1465
+ > from qtmodel import *
1466
+ > mdb.remove_boundary(remove_id=11, bd_type="一般弹性连接",group="边界组1", extra_name="J")
1467
+ > mdb.remove_boundary(remove_id=12, bd_type="约束方程",group="边界组1", extra_name="约束方程名")
1468
+ > ```
1469
+ > **返回**
1470
+ > Returns: 无
1471
+
1472
+ ### add_general_elastic_support_property
1473
+ > **说明**
1474
+ > 添加一般弹性支承特性
1475
+ > **参数**
1476
+ > - name:一般弹性支承特性名称
1477
+ > - data_matrix:一般弹性支承刚度矩阵(数据需按列输入至列表,共计21个参数)
1478
+ >
1479
+ > **示例代码**
1480
+ > ```Python
1481
+ > from qtmodel import *
1482
+ > mdb.add_general_elastic_support_property(name = "特性1", data_matrix=[i for i in range(1,22)])
1483
+ > ```
1484
+ > **返回**
1485
+ > Returns: 无
1486
+
1487
+ ### update_general_elastic_support_property
1488
+ > **说明**
1489
+ > 添加一般弹性支承特性
1490
+ > **参数**
1491
+ > - name:原一般弹性支承特性名称
1492
+ > - new_name:现一般弹性支承特性名称
1493
+ > - data_matrix:一般弹性支承刚度矩阵(数据需按列输入至列表,共计21个参数)
1494
+ >
1495
+ > **示例代码**
1496
+ > ```Python
1497
+ > from qtmodel import *
1498
+ > mdb.update_general_elastic_support_property(name = "特性1",new_name="特性2", data_matrix=[i for i in range(1,22)])
1499
+ > ```
1500
+ > **返回**
1501
+ > Returns: 无
1502
+
1503
+ ### remove_general_elastic_support_property
1504
+ > **说明**
1505
+ > 添加一般弹性支承特性
1506
+ > **参数**
1507
+ > - name:一般弹性支承特性名称
1508
+ >
1509
+ > **示例代码**
1510
+ > ```Python
1511
+ > from qtmodel import *
1512
+ > mdb.remove_general_elastic_support_property(name = "特性1")
1513
+ > ```
1514
+ > **返回**
1515
+ > Returns: 无
1516
+
1517
+ ### add_general_elastic_support
1518
+ > **说明**
1519
+ > 添加一般弹性支承特性
1520
+ > **参数**
1521
+ > - node_id:节点号
1522
+ > - property_name:一般弹性支承特性名
1523
+ > - group_name:一般弹性支承边界组名
1524
+ >
1525
+ > **示例代码**
1526
+ > ```Python
1527
+ > from qtmodel import *
1528
+ > mdb.add_general_elastic_support(node_id = 1, property_name = "特性1",group_name="边界组1")
1529
+ > ```
1530
+ > **返回**
1531
+ > Returns: 无
1532
+
1533
+ ### add_general_support
1534
+ > **说明**
1535
+ > 添加一般支承
1536
+ > **参数**
1537
+ > - node_id:节点编号,支持整数或整数型列表
1538
+ > - boundary_info:边界信息 [X,Y,Z,Rx,Ry,Rz] ture-固定 false-自由
1539
+ > - group_name:边界组名,默认为默认边界组
1540
+ >
1541
+ > **示例代码**
1542
+ > ```Python
1543
+ > from qtmodel import *
1544
+ > mdb.add_general_support(node_id=1, boundary_info=[True,True,True,False,False,False])
1545
+ > ```
1546
+ > **返回**
1547
+ > Returns: 无
1548
+
1549
+ ### add_elastic_support
1550
+ > **说明**
1551
+ > 添加弹性支承
1552
+ > **参数**
1553
+ > - node_id:节点编号,支持数或列表
1554
+ > - support_type:支承类型 1-线性 2-受拉 3-受压
1555
+ > - boundary_info:边界信息 受拉和受压时列表长度为2-[direct(1-X 2-Y 3-Z),stiffness] 线性时列表长度为6-[kx,ky,kz,krx,kry,krz]
1556
+ > - group_name:边界组
1557
+ >
1558
+ > **示例代码**
1559
+ > ```Python
1560
+ > from qtmodel import *
1561
+ > mdb.add_elastic_support(node_id=1,support_type=1,boundary_info=[1e6,0,1e6,0,0,0])
1562
+ > mdb.add_elastic_support(node_id=1,support_type=2,boundary_info=[1,1e6])
1563
+ > mdb.add_elastic_support(node_id=1,support_type=3,boundary_info=[1,1e6])
1564
+ > ```
1565
+ > **返回**
1566
+ > Returns: 无
1567
+
1568
+ ### add_elastic_link
1569
+ > **说明**
1570
+ > 添加弹性连接,建议指定index(弹性连接编号)
1571
+ > **参数**
1572
+ > - index:弹性连接编号,默认自动识别
1573
+ > - link_type:节点类型 1-一般弹性连接 2-刚性连接 3-受拉弹性连接 4-受压弹性连接
1574
+ > - start_id:起始节点号
1575
+ > - end_id:终节点号
1576
+ > - beta_angle:贝塔角
1577
+ > - boundary_info:边界信息
1578
+ > - group_name:边界组名
1579
+ > - dis_ratio:距i端距离比 (仅一般弹性连接需要)
1580
+ > - kx:受拉或受压刚度
1581
+ >
1582
+ > **示例代码**
1583
+ > ```Python
1584
+ > from qtmodel import *
1585
+ > mdb.add_elastic_link(link_type=1,start_id=1,end_id=2,boundary_info=[1e6,1e6,1e6,0,0,0])
1586
+ > mdb.add_elastic_link(link_type=2,start_id=1,end_id=2)
1587
+ > mdb.add_elastic_link(link_type=3,start_id=1,end_id=2,kx=1e6)
1588
+ > ```
1589
+ > **返回**
1590
+ > Returns: 无
1591
+
1592
+ ### add_master_slave_links
1593
+ > **说明**
1594
+ > 添加主从约束
1595
+ > **参数**
1596
+ > - node_ids:主节点号和从节点号,主节点号位于首位
1597
+ > - boundary_info:边界信息 [X,Y,Z,Rx,Ry,Rz] ture-固定 false-自由
1598
+ > - group_name:边界组名
1599
+ >
1600
+ > **示例代码**
1601
+ > ```Python
1602
+ > from qtmodel import *
1603
+ > mdb.add_master_slave_links(node_ids=[(1,2),(1,3),(4,5),(4,6)],boundary_info=[True,True,True,False,False,False])
1604
+ > ```
1605
+ > **返回**
1606
+ > Returns: 无
1607
+
1608
+ ### add_master_slave_link
1609
+ > **说明**
1610
+ > 添加主从约束
1611
+ > **参数**
1612
+ > - master_id:主节点号
1613
+ > - slave_id:从节点号,支持整数或整数型列表
1614
+ > - boundary_info:边界信息 [X,Y,Z,Rx,Ry,Rz] ture-固定 false-自由
1615
+ > - group_name:边界组名
1616
+ >
1617
+ > **示例代码**
1618
+ > ```Python
1619
+ > from qtmodel import *
1620
+ > mdb.add_master_slave_link(master_id=1,slave_id=[2,3],boundary_info=[True,True,True,False,False,False])
1621
+ > ```
1622
+ > **返回**
1623
+ > Returns: 无
1624
+
1625
+ ### add_beam_constraint
1626
+ > **说明**
1627
+ > 添加梁端约束
1628
+ > **参数**
1629
+ > - beam_id:梁号
1630
+ > - info_i:i端约束信息 [X,Y,Z,Rx,Ry,Rz] ture-固定 false-自由
1631
+ > - info_j:j端约束信息 [X,Y,Z,Rx,Ry,Rz] ture-固定 false-自由
1632
+ > - group_name:边界组名
1633
+ >
1634
+ > **示例代码**
1635
+ > ```Python
1636
+ > from qtmodel import *
1637
+ > mdb.add_beam_constraint(beam_id=2,info_i=[True,True,True,False,False,False],info_j=[True,True,True,False,False,False])
1638
+ > ```
1639
+ > **返回**
1640
+ > Returns: 无
1641
+
1642
+ ### add_constraint_equation
1643
+ > **说明**
1644
+ > 添加约束方程
1645
+ > **参数**
1646
+ > - name:约束方程名
1647
+ > - sec_node:从节点号
1648
+ > - sec_dof: 从节点自由度 1-x 2-y 3-z 4-rx 5-ry 6-rz
1649
+ > - master_info:主节点约束信息列表
1650
+ > - group_name:边界组名
1651
+ >
1652
+ > **示例代码**
1653
+ > ```Python
1654
+ > from qtmodel import *
1655
+ > mdb.add_beam_constraint(beam_id=2,info_i=[True,True,True,False,False,False],info_j=[True,True,True,False,False,False])
1656
+ > ```
1657
+ > **返回**
1658
+ > Returns: 无
1659
+
1660
+ ### add_node_axis
1661
+ > **说明**
1662
+ > 添加节点坐标
1663
+ > **参数**
1664
+ > - node_id:节点号
1665
+ > - input_type:输入方式 1-角度 2-三点 3-向量
1666
+ > - coord_info:局部坐标信息 -List<float>(角) -List<List<float>>(三点 or 向量)
1667
+ >
1668
+ > **示例代码**
1669
+ > ```Python
1670
+ > from qtmodel import *
1671
+ > mdb.add_node_axis(input_type=1,node_id=1,coord_info=[45,45,45])
1672
+ > mdb.add_node_axis(input_type=2,node_id=1,coord_info=[[0,0,1],[0,1,0],[1,0,0]])
1673
+ > mdb.add_node_axis(input_type=3,node_id=1,coord_info=[[0,0,1],[0,1,0]])
1674
+ > ```
1675
+ > **返回**
1676
+ > Returns: 无
1677
+
1678
+ ### update_node_axis
1679
+ > **说明**
1680
+ > 添加节点坐标
1681
+ > **参数**
1682
+ > - node_id:节点号
1683
+ > - new_id:新节点号
1684
+ > - input_type:输入方式 1-角度 2-三点 3-向量
1685
+ > - coord_info:局部坐标信息 -List<float>(角) -List<List<float>>(三点 or 向量)
1686
+ >
1687
+ > **示例代码**
1688
+ > ```Python
1689
+ > from qtmodel import *
1690
+ > mdb.update_node_axis(node_id=1,new_id=1,input_type=1,coord_info=[45,45,45])
1691
+ > mdb.update_node_axis(node_id=2,new_id=2,input_type=2,coord_info=[[0,0,1],[0,1,0],[1,0,0]])
1692
+ > mdb.update_node_axis(node_id=3,new_id=3,input_type=3,coord_info=[[0,0,1],[0,1,0]])
1693
+ > ```
1694
+ > **返回**
1695
+ > Returns: 无
1696
+
1697
+ ### remove_node_axis
1698
+ > **说明**
1699
+ > 添加节点坐标
1700
+ > **参数**
1701
+ > - node_id:节点号
1702
+ >
1703
+ > **示例代码**
1704
+ > ```Python
1705
+ > from qtmodel import *
1706
+ > mdb.remove_node_axis(node_id=1)
1707
+ > ```
1708
+ > **返回**
1709
+ > Returns: 无
1710
+
1711
+ ## 移动荷载操作
1712
+ ### add_standard_vehicle
1713
+ > **说明**
1714
+ > 添加标准车辆
1715
+ > **参数**
1716
+ > - name: 车辆荷载名称
1717
+ > - standard_code: 荷载规范
1718
+ > _1-中国铁路桥涵规范(TB10002-2017)
1719
+ > _2-城市桥梁设计规范(CJJ11-2019)
1720
+ > _3-公路工程技术标准(JTJ 001-97)
1721
+ > _4-公路桥涵设计通规(JTG D60-2004
1722
+ > _5-公路桥涵设计通规(JTG D60-2015)
1723
+ > _6-城市轨道交通桥梁设计规范(GB/T51234-2017)
1724
+ > _7-市域铁路设计规范2017(T/CRS C0101-2017)
1725
+ > - load_type: 荷载类型,支持类型参考软件内界面
1726
+ > - load_length: 默认为0即不限制荷载长度 (铁路桥涵规范2017 所需参数)
1727
+ > - factor: 默认为1.0(铁路桥涵规范2017 ZH荷载所需参数)
1728
+ > - n:车厢数: 默认6节车厢 (城市轨道交通桥梁规范2017 所需参数)
1729
+ > - calc_fatigue:计算公路疲劳 (公路桥涵设计通规2015 所需参数)
1730
+ >
1731
+ > **示例代码**
1732
+ > ```Python
1733
+ > from qtmodel import *
1734
+ > mdb.add_standard_vehicle("高速铁路",standard_code=1,load_type="高速铁路")
1735
+ > ```
1736
+ > **返回**
1737
+ > Returns: 无
1738
+
1739
+ ### add_user_vehicle
1740
+ > **说明**
1741
+ > 添加标准车辆
1742
+ > **参数**
1743
+ > - name: 车辆荷载名称
1744
+ > - load_type: 荷载类型,支持类型 -车辆/车道荷载 列车普通活载 城市轻轨活载 旧公路人群荷载 轮重集合
1745
+ > - p: 荷载Pk或Pi列表
1746
+ > - q: 均布荷载Qk或荷载集度dW
1747
+ > - dis:荷载距离Li列表
1748
+ > - load_length: 荷载长度 (列车普通活载 所需参数)
1749
+ > - n:车厢数: 默认6节车厢 (列车普通活载 所需参数)
1750
+ > - empty_load:空载 (列车普通活载、城市轻轨活载 所需参数)
1751
+ > - width:宽度 (旧公路人群荷载 所需参数)
1752
+ > - wheelbase:轮间距 (轮重集合 所需参数)
1753
+ > - min_dis:车轮距影响面最小距离 (轮重集合 所需参数))
1754
+ > - unit_force:荷载单位 默认为"N"
1755
+ > - unit_length:长度单位 默认为"M"
1756
+ >
1757
+ > **示例代码**
1758
+ > ```Python
1759
+ > from qtmodel import *
1760
+ > mdb.add_user_vehicle(name="车道荷载",load_type="车道荷载",p=270000,q=10500)
1761
+ > ```
1762
+ > **返回**
1763
+ > Returns: 无
1764
+
1765
+ ### add_node_tandem
1766
+ > **说明**
1767
+ > 添加节点纵列,默认以最小X对应节点作为纵列起点
1768
+ > **参数**
1769
+ > - name:节点纵列名
1770
+ > - node_ids:节点列表
1771
+ >
1772
+ > **示例代码**
1773
+ > ```Python
1774
+ > from qtmodel import *
1775
+ > mdb.add_node_tandem(name="节点纵列1",node_ids=[i+1 for i in range(12)])
1776
+ > ```
1777
+ > **返回**
1778
+ > Returns: 无
1779
+
1780
+ ### add_influence_plane
1781
+ > **说明**
1782
+ > 添加影响面
1783
+ > **参数**
1784
+ > - name:影响面名称
1785
+ > - tandem_names:节点纵列名称组
1786
+ >
1787
+ > **示例代码**
1788
+ > ```Python
1789
+ > from qtmodel import *
1790
+ > mdb.add_influence_plane(name="影响面1",tandem_names=["节点纵列1","节点纵列2"])
1791
+ > ```
1792
+ > **返回**
1793
+ > Returns: 无
1794
+
1795
+ ### add_lane_line
1796
+ > **说明**
1797
+ > 添加车道线
1798
+ > **参数**
1799
+ > - name:车道线名称
1800
+ > - influence_name:影响面名称
1801
+ > - tandem_name:节点纵列名
1802
+ > - offset:偏移
1803
+ > - lane_width:车道宽度
1804
+ > - optimize:是否允许车辆摆动
1805
+ > - direction:0-向前 1-向后
1806
+ >
1807
+ > **示例代码**
1808
+ > ```Python
1809
+ > from qtmodel import *
1810
+ > mdb.add_lane_line(name="车道1",influence_name="影响面1",tandem_name="节点纵列1",offset=0,lane_width=3.1)
1811
+ > ```
1812
+ > **返回**
1813
+ > Returns: 无
1814
+
1815
+ ### add_live_load_case
1816
+ > **说明**
1817
+ > 添加移动荷载工况
1818
+ > **参数**
1819
+ > - name:活载工况名
1820
+ > - influence_plane:影响线名
1821
+ > - span:跨度
1822
+ > - sub_case:子工况信息 [(车辆名称,系数,["车道1","车道2"])...]
1823
+ > - trailer_code:考虑挂车时挂车车辆名
1824
+ > - special_code:考虑特载时特载车辆名
1825
+ >
1826
+ > **示例代码**
1827
+ > ```Python
1828
+ > from qtmodel import *
1829
+ > mdb.add_live_load_case(name="活载工况1",influence_plane="影响面1",span=100,sub_case=[("车辆名称",1.0,["车道1","车道2"]),])
1830
+ > ```
1831
+ > **返回**
1832
+ > Returns: 无
1833
+
1834
+ ### add_car_relative_factor
1835
+ > **说明**
1836
+ > 添加移动荷载工况汽车折减
1837
+ > **参数**
1838
+ > - name:活载工况名
1839
+ > - code_index: 汽车折减规范编号 1-公规2015 2-公规2004 3-无
1840
+ > - cross_factors:横向折减系数列表,自定义时要求长度为8,否则按照规范选取
1841
+ > - longitude_factor:纵向折减系数,大于0时为自定义,否则为规范自动选取
1842
+ > - impact_factor:冲击系数大于1时为自定义,否则按照规范自动选取
1843
+ > - frequency:桥梁基频
1844
+ >
1845
+ > **示例代码**
1846
+ > ```Python
1847
+ > from qtmodel import *
1848
+ > mdb.add_car_relative_factor(name="活载工况1",code_index=1,cross_factors=[1.2,1,0.78,0.67,0.6,0.55,0.52,0.5])
1849
+ > ```
1850
+ > **返回**
1851
+ > Returns: 无
1852
+
1853
+ ### add_train_relative_factor
1854
+ > **说明**
1855
+ > 添加移动荷载工况汽车折减
1856
+ > **参数**
1857
+ > - name:活载工况名
1858
+ > - code_index: 火车折减规范编号 1-铁规2017_ZK_ZC 2-铁规2017_ZKH_ZH 3-无
1859
+ > - cross_factors:横向折减系数列表,自定义时要求长度为8,否则按照规范选取
1860
+ > - calc_fatigue:是否计算疲劳
1861
+ > - line_count: 疲劳加载线路数
1862
+ > - longitude_factor:纵向折减系数,大于0时为自定义,否则为规范自动选取
1863
+ > - impact_factor:强度冲击系数大于1时为自定义,否则按照规范自动选取
1864
+ > - fatigue_factor:疲劳系数
1865
+ > - bridge_kind:桥梁类型 0-无 1-简支 2-结合 3-涵洞 4-空腹式
1866
+ > - fill_thick:填土厚度 (规ZKH ZH钢筋/素混凝土、石砌桥跨结构以及涵洞所需参数)
1867
+ > - rise:拱高 (规ZKH ZH活载-空腹式拱桥所需参数)
1868
+ > - calc_length:计算跨度(铁规ZKH ZH活载-空腹式拱桥所需参数)或计算长度(铁规ZK ZC活载所需参数)
1869
+ >
1870
+ > **示例代码**
1871
+ > ```Python
1872
+ > from qtmodel import *
1873
+ > mdb.add_train_relative_factor(name="活载工况1",code_index=1,cross_factors=[1.2,1,0.78,0.67,0.6,0.55,0.52,0.5],calc_length=50)
1874
+ > ```
1875
+ > **返回**
1876
+ > Returns: 无
1877
+
1878
+ ### add_metro_relative_factor
1879
+ > **说明**
1880
+ > 添加移动荷载工况汽车折减
1881
+ > **参数**
1882
+ > - name:活载工况名
1883
+ > - cross_factors:横向折减系数列表,自定义时要求长度为8,否则按照规范选取
1884
+ > - longitude_factor:纵向折减系数,大于0时为自定义,否则为规范自动选取
1885
+ > - impact_factor:强度冲击系数大于1时为自定义,否则按照规范自动选取
1886
+ >
1887
+ > **示例代码**
1888
+ > ```Python
1889
+ > from qtmodel import *
1890
+ > mdb.add_metro_relative_factor(name="活载工况1",cross_factors=[1.2,1,0.78,0.67,0.6,0.55,0.52,0.5],
1891
+ > longitude_factor=1,impact_factor=1)
1892
+ > ```
1893
+ > **返回**
1894
+ > Returns: 无
1895
+
1896
+ ### remove_vehicle
1897
+ > **说明**
1898
+ > 删除车辆信息
1899
+ > **参数**
1900
+ > - name:车辆名称
1901
+ >
1902
+ > **示例代码**
1903
+ > ```Python
1904
+ > from qtmodel import *
1905
+ > mdb.remove_vehicle(name="车辆名称")
1906
+ > ```
1907
+ > **返回**
1908
+ > Returns: 无
1909
+
1910
+ ### remove_node_tandem
1911
+ > **说明**
1912
+ > 按照 节点纵列编号/节点纵列名 删除节点纵列
1913
+ > **参数**
1914
+ > - index:节点纵列编号
1915
+ > - name:节点纵列名
1916
+ >
1917
+ > **示例代码**
1918
+ > ```Python
1919
+ > from qtmodel import *
1920
+ > mdb.remove_node_tandem(index=1)
1921
+ > mdb.remove_node_tandem(name="节点纵列1")
1922
+ > ```
1923
+ > **返回**
1924
+ > Returns: 无
1925
+
1926
+ ### remove_influence_plane
1927
+ > **说明**
1928
+ > 按照 影响面编号/影响面名称 删除影响面
1929
+ > **参数**
1930
+ > - index:影响面编号
1931
+ > - name:影响面名称
1932
+ >
1933
+ > **示例代码**
1934
+ > ```Python
1935
+ > from qtmodel import *
1936
+ > mdb.remove_influence_plane(index=1)
1937
+ > mdb.remove_influence_plane(name="影响面1")
1938
+ > ```
1939
+ > **返回**
1940
+ > Returns: 无
1941
+
1942
+ ### remove_lane_line
1943
+ > **说明**
1944
+ > 按照 车道线编号/车道线名称 删除车道线
1945
+ > **参数**
1946
+ > - name:车道线名称
1947
+ > - index:车道线编号
1948
+ >
1949
+ > **示例代码**
1950
+ > ```Python
1951
+ > from qtmodel import *
1952
+ > mdb.remove_lane_line(index=1)
1953
+ > mdb.remove_lane_line(name="车道线1")
1954
+ > ```
1955
+ > **返回**
1956
+ > Returns: 无
1957
+
1958
+ ### remove_live_load_case
1959
+ > **说明**
1960
+ > 删除移动荷载工况
1961
+ > **参数**
1962
+ > - name:移动荷载工况名
1963
+ >
1964
+ > **示例代码**
1965
+ > ```Python
1966
+ > from qtmodel import *
1967
+ > mdb.remove_live_load_case(name="活载工况1")
1968
+ > ```
1969
+ > **返回**
1970
+ > Returns: 无
1971
+
1972
+ ### update_standard_vehicle
1973
+ > **说明**
1974
+ > 添加标准车辆
1975
+ > **参数**
1976
+ > - name: 车辆荷载名称
1977
+ > - new_name: 新车辆荷载名称,默认不修改
1978
+ > - standard_code: 荷载规范
1979
+ > _1-中国铁路桥涵规范(TB10002-2017)
1980
+ > _2-城市桥梁设计规范(CJJ11-2019)
1981
+ > _3-公路工程技术标准(JTJ 001-97)
1982
+ > _4-公路桥涵设计通规(JTG D60-2004
1983
+ > _5-公路桥涵设计通规(JTG D60-2015)
1984
+ > _6-城市轨道交通桥梁设计规范(GB/T51234-2017)
1985
+ > _7-市域铁路设计规范2017(T/CRS C0101-2017)
1986
+ > - load_type: 荷载类型,支持类型参考软件内界面
1987
+ > - load_length: 默认为0即不限制荷载长度 (铁路桥涵规范2017 所需参数)
1988
+ > - factor: 默认为1.0(铁路桥涵规范2017 ZH荷载所需参数)
1989
+ > - n:车厢数: 默认6节车厢 (城市轨道交通桥梁规范2017 所需参数)
1990
+ > - calc_fatigue:计算公路疲劳 (公路桥涵设计通规2015 所需参数)
1991
+ >
1992
+ > **示例代码**
1993
+ > ```Python
1994
+ > from qtmodel import *
1995
+ > mdb.update_standard_vehicle("高速铁路",standard_code=1,load_type="高速铁路")
1996
+ > ```
1997
+ > **返回**
1998
+ > Returns: 无
1999
+
2000
+ ### update_user_vehicle
2001
+ > **说明**
2002
+ > 修改自定义标准车辆
2003
+ > **参数**
2004
+ > - name: 车辆荷载名称
2005
+ > - new_name: 新车辆荷载名称,默认不修改
2006
+ > - load_type: 荷载类型,支持类型 -车辆/车道荷载 列车普通活载 城市轻轨活载 旧公路人群荷载 轮重集合
2007
+ > - p: 荷载Pk或Pi列表
2008
+ > - q: 均布荷载Qk或荷载集度dW
2009
+ > - dis:荷载距离Li列表
2010
+ > - load_length: 荷载长度 (列车普通活载 所需参数)
2011
+ > - n:车厢数: 默认6节车厢 (列车普通活载 所需参数)
2012
+ > - empty_load:空载 (列车普通活载、城市轻轨活载 所需参数)
2013
+ > - width:宽度 (旧公路人群荷载 所需参数)
2014
+ > - wheelbase:轮间距 (轮重集合 所需参数)
2015
+ > - min_dis:车轮距影响面最小距离 (轮重集合 所需参数))
2016
+ > - unit_force:荷载单位 默认为"N"
2017
+ > - unit_length:长度单位 默认为"M"
2018
+ >
2019
+ > **示例代码**
2020
+ > ```Python
2021
+ > from qtmodel import *
2022
+ > mdb.update_user_vehicle(name="车道荷载",load_type="车道荷载",p=270000,q=10500)
2023
+ > ```
2024
+ > **返回**
2025
+ > Returns: 无
2026
+
2027
+ ### update_influence_plane
2028
+ > **说明**
2029
+ > 添加影响面
2030
+ > **参数**
2031
+ > - name:影响面名称
2032
+ > - new_name:更改后影响面名称,若无更改则默认
2033
+ > - tandem_names:节点纵列名称组
2034
+ >
2035
+ > **示例代码**
2036
+ > ```Python
2037
+ > from qtmodel import *
2038
+ > mdb.update_influence_plane(name="影响面1",tandem_names=["节点纵列1","节点纵列2"])
2039
+ > ```
2040
+ > **返回**
2041
+ > Returns: 无
2042
+
2043
+ ### update_lane_line
2044
+ > **说明**
2045
+ > 添加车道线
2046
+ > **参数**
2047
+ > - name:车道线名称
2048
+ > - new_name:更改后车道名,默认为不更改
2049
+ > - influence_name:影响面名称
2050
+ > - tandem_name:节点纵列名
2051
+ > - offset:偏移
2052
+ > - lane_width:车道宽度
2053
+ > - optimize:是否允许车辆摆动
2054
+ > - direction:0-向前 1-向后
2055
+ >
2056
+ > **示例代码**
2057
+ > ```Python
2058
+ > from qtmodel import *
2059
+ > mdb.update_lane_line(name="车道1",influence_name="影响面1",tandem_name="节点纵列1",offset=0,lane_width=3.1)
2060
+ > ```
2061
+ > **返回**
2062
+ > Returns: 无
2063
+
2064
+ ### update_node_tandem
2065
+ > **说明**
2066
+ > 添加节点纵列,默认以最小X对应节点作为纵列起点
2067
+ > **参数**
2068
+ > - name:节点纵列名
2069
+ > - new_name: 新节点纵列名,默认不修改
2070
+ > - node_ids:节点列表
2071
+ >
2072
+ > **示例代码**
2073
+ > ```Python
2074
+ > from qtmodel import *
2075
+ > mdb.update_node_tandem(name="节点纵列1",node_ids=[i+1 for i in range(12)])
2076
+ > ```
2077
+ > **返回**
2078
+ > Returns: 无
2079
+
2080
+ ### update_live_load_case
2081
+ > **说明**
2082
+ > 添加移动荷载工况
2083
+ > **参数**
2084
+ > - name:活载工况名
2085
+ > - new_name:新移动荷载名,默认不修改
2086
+ > - influence_plane:影响线名
2087
+ > - span:跨度
2088
+ > - sub_case:子工况信息 [(车辆名称,系数,["车道1","车道2"])...]
2089
+ > - trailer_code:考虑挂车时挂车车辆名
2090
+ > - special_code:考虑特载时特载车辆名
2091
+ >
2092
+ > **示例代码**
2093
+ > ```Python
2094
+ > from qtmodel import *
2095
+ > mdb.update_live_load_case(name="活载工况1",influence_plane="影响面1",span=100,sub_case=[("车辆名称",1.0,["车道1","车道2"]),])
2096
+ > ```
2097
+ > **返回**
2098
+ > Returns: 无
2099
+
2100
+ ## 动力荷载操作
2101
+ ### add_load_to_mass
2102
+ > **说明**
2103
+ > 添加荷载转为质量
2104
+ > **参数**
2105
+ > - name: 荷载工况名称
2106
+ > - factor: 系数
2107
+ >
2108
+ > **示例代码**
2109
+ > ```Python
2110
+ > from qtmodel import *
2111
+ > mdb.add_load_to_mass(name="荷载工况",factor=1)
2112
+ > ```
2113
+ > **返回**
2114
+ > Returns: 无
2115
+
2116
+ ### add_nodal_mass
2117
+ > **说明**
2118
+ > 添加节点质量
2119
+ > **参数**
2120
+ > - node_id:节点编号,支持单个编号和编号列表
2121
+ > - mass_info:[m,rmX,rmY,rmZ]
2122
+ >
2123
+ > **示例代码**
2124
+ > ```Python
2125
+ > from qtmodel import *
2126
+ > mdb.add_nodal_mass(node_id=1,mass_info=(100,0,0,0))
2127
+ > ```
2128
+ > **返回**
2129
+ > Returns: 无
2130
+
2131
+ ### remove_nodal_mass
2132
+ > **说明**
2133
+ > 删除节点质量
2134
+ > **参数**
2135
+ > - node_id:节点号,默认删除所有节点质量
2136
+ >
2137
+ > **示例代码**
2138
+ > ```Python
2139
+ > from qtmodel import *
2140
+ > mdb.remove_nodal_mass(node_id=1)
2141
+ > ```
2142
+ > **返回**
2143
+ > Returns: 无
2144
+
2145
+ ### remove_load_to_mass
2146
+ > **说明**
2147
+ > 删除荷载转为质量,默认删除所有荷载转质量
2148
+ > **参数**
2149
+ > - name:荷载工况名
2150
+ >
2151
+ > **示例代码**
2152
+ > ```Python
2153
+ > from qtmodel import *
2154
+ > mdb.remove_load_to_mass(name="荷载工况")
2155
+ > ```
2156
+ > **返回**
2157
+ > Returns: 无
2158
+
2159
+ ### add_spectrum_function
2160
+ > **说明**
2161
+ > 添加反应谱函数
2162
+ > **参数**
2163
+ > - name:反应谱函数名
2164
+ > - factor:反应谱调整系数
2165
+ > - kind:反应谱类型 0-无量纲 1-加速度 2-位移
2166
+ > - function_info:反应谱函数信息
2167
+ >
2168
+ > **示例代码**
2169
+ > ```Python
2170
+ > from qtmodel import *
2171
+ > mdb.add_spectrum_function(name="反应谱函数1",factor=1.0,function_info=[(0,0.02),(1,0.03)])
2172
+ > ```
2173
+ > **返回**
2174
+ > Returns: 无
2175
+
2176
+ ### add_spectrum_case
2177
+ > **说明**
2178
+ > 添加反应谱工况
2179
+ > **参数**
2180
+ > - name:荷载工况名
2181
+ > - description:说明
2182
+ > - kind:组合方式 1-求模 2-求和
2183
+ > - info_x: 反应谱X向信息 (X方向函数名,系数)
2184
+ > - info_y: 反应谱Y向信息 (Y方向函数名,系数)
2185
+ > - info_z: 反应谱Z向信息 (Z方向函数名,系数)
2186
+ >
2187
+ > **示例代码**
2188
+ > ```Python
2189
+ > from qtmodel import *
2190
+ > mdb.add_spectrum_case(name="反应谱工况",info_x=("函数1",1.0))
2191
+ > ```
2192
+ > **返回**
2193
+ > Returns: 无
2194
+
2195
+ ### update_load_to_mass
2196
+ > **说明**
2197
+ > 更新荷载转为质量
2198
+ > **参数**
2199
+ > - data_list:荷载工况和系数列表[("工况1",1.2),("工况2",1.3)...]
2200
+ >
2201
+ > **示例代码**
2202
+ > ```Python
2203
+ > from qtmodel import *
2204
+ > mdb.update_load_to_mass(data_list=[("工况1",1.2),("工况2",1.3)])
2205
+ > ```
2206
+ > **返回**
2207
+ > Returns: 无
2208
+
2209
+ ### update_nodal_mass
2210
+ > **说明**
2211
+ > 更新节点质量
2212
+ > **参数**
2213
+ > - node_id:节点编号
2214
+ > - new_node_id:新节点编号,默认不改变节点
2215
+ > - mass_info:[m,rmX,rmY,rmZ]
2216
+ >
2217
+ > **示例代码**
2218
+ > ```Python
2219
+ > from qtmodel import *
2220
+ > mdb.add_nodal_mass(node_id=1,mass_info=(100,0,0,0))
2221
+ > ```
2222
+ > **返回**
2223
+ > Returns: 无
2224
+
2225
+ ## 钢束操作
2226
+ ### add_tendon_group
2227
+ > **说明**
2228
+ > 按照名称添加钢束组,添加时可指定钢束组id
2229
+ > **参数**
2230
+ > - name: 钢束组名称
2231
+ > - index: 钢束组编号(非必须参数),默认自动识别
2232
+ >
2233
+ > **示例代码**
2234
+ > ```Python
2235
+ > from qtmodel import *
2236
+ > mdb.add_tendon_group(name="钢束组1")
2237
+ > ```
2238
+ > **返回**
2239
+ > Returns: 无
2240
+
2241
+ ### remove_tendon_group
2242
+ > **说明**
2243
+ > 按照钢束组名称或钢束组编号删除钢束组,两参数均为默认时删除所有钢束组
2244
+ > **参数**
2245
+ > - name:钢束组名称,默认自动识别 (可选参数)
2246
+ >
2247
+ > **示例代码**
2248
+ > ```Python
2249
+ > from qtmodel import *
2250
+ > mdb.remove_tendon_group(name="钢束组1")
2251
+ > ```
2252
+ > **返回**
2253
+ > Returns: 无
2254
+
2255
+ ### add_tendon_property
2256
+ > **说明**
2257
+ > 添加钢束特性
2258
+ > **参数**
2259
+ > - name:钢束特性名
2260
+ > - tendon_type: 0-PRE 1-POST
2261
+ > - material_name: 钢材材料名
2262
+ > - duct_type: 1-金属波纹管 2-塑料波纹管 3-铁皮管 4-钢管 5-抽芯成型
2263
+ > - steel_type: 1-钢绞线 2-螺纹钢筋
2264
+ > - steel_detail: 钢束详细信息
2265
+ > _钢绞线[钢束面积,孔道直径,摩阻系数,偏差系数]_
2266
+ > _螺纹钢筋[钢筋直径,钢束面积,孔道直径,摩阻系数,偏差系数,张拉方式(1-一次张拉 2-超张拉)]_
2267
+ > - loos_detail: 松弛信息[规范,张拉,松弛] (仅钢绞线需要,默认为[1,1,1])
2268
+ > - _规范:1-公规 2-铁规_
2269
+ > - _张拉方式:1-一次张拉 2-超张拉_
2270
+ > _松弛类型:1-一般松弛 2-低松弛_
2271
+ > - slip_info: 滑移信息[始端距离,末端距离] 默认为[0.006, 0.006]
2272
+ >
2273
+ > **示例代码**
2274
+ > ```Python
2275
+ > from qtmodel import *
2276
+ > mdb.add_tendon_property(name="钢束1",tendon_type=0,material_name="预应力材料",duct_type=1,steel_type=1,
2277
+ > steel_detail=[0.00014,0.10,0.25,0.0015],loos_detail=(1,1,1))
2278
+ > ```
2279
+ > **返回**
2280
+ > Returns: 无
2281
+
2282
+ ### update_tendon_property_material
2283
+ > **说明**
2284
+ > 更新钢束特性材料
2285
+ > **参数**
2286
+ > - name:钢束特性名
2287
+ > - material_name:材料名
2288
+ >
2289
+ > **示例代码**
2290
+ > ```Python
2291
+ > from qtmodel import *
2292
+ > mdb.update_tendon_property_material("特性1",material_name="材料1")
2293
+ > ```
2294
+ > **返回**
2295
+ > Returns:无
2296
+
2297
+ ### update_tendon_property
2298
+ > **说明**
2299
+ > 更新钢束特性
2300
+ > **参数**
2301
+ > - name:钢束特性名
2302
+ > - new_name:新钢束特性名,默认不修改
2303
+ > - tendon_type: 0-PRE 1-POST
2304
+ > - material_name: 钢材材料名
2305
+ > - duct_type: 1-金属波纹管 2-塑料波纹管 3-铁皮管 4-钢管 5-抽芯成型
2306
+ > - steel_type: 1-钢绞线 2-螺纹钢筋
2307
+ > - steel_detail: 钢束详细信息
2308
+ > _钢绞线[钢束面积,孔道直径,摩阻系数,偏差系数]
2309
+ > _螺纹钢筋[钢筋直径,钢束面积,孔道直径,摩阻系数,偏差系数,张拉方式(1-一次张拉 2-超张拉)]
2310
+ > - loos_detail: 松弛信息[规范(1-公规 2-铁规),张拉(1-一次张拉 2-超张拉),松弛(1-一般松弛 2-低松弛)] (仅钢绞线需要,默认为[1,1,1])
2311
+ > - slip_info: 滑移信息[始端距离,末端距离] 默认为[0.006, 0.006]
2312
+ >
2313
+ > **示例代码**
2314
+ > ```Python
2315
+ > from qtmodel import *
2316
+ > mdb.update_tendon_property(name="钢束1",tendon_type=0,material_name="材料1",duct_type=1,steel_type=1,
2317
+ > steel_detail=[0.00014,0.10,0.25,0.0015],loos_detail=(1,1,1))
2318
+ > ```
2319
+ > **返回**
2320
+ > Returns:无
2321
+
2322
+ ### add_tendon_3d
2323
+ > **说明**
2324
+ > 添加三维钢束
2325
+ > **参数**
2326
+ > - name:钢束名称
2327
+ > - property_name:钢束特性名称
2328
+ > - group_name:默认钢束组
2329
+ > - num:根数
2330
+ > - line_type:1-导线点 2-折线点
2331
+ > - position_type: 定位方式 1-直线 2-轨迹线
2332
+ > - control_points: 控制点信息[(x1,y1,z1,r1),(x2,y2,z2,r2)....]
2333
+ > - point_insert: 定位方式 (直线时为插入点坐标[x,y,z] 轨迹线时[插入端(1-I 2-J),插入方向(1-ij 2-ji),插入单元id])
2334
+ > - tendon_direction:直线钢束X方向向量 默认为x轴即[1,0,0] (轨迹线不用赋值)
2335
+ > - rotation_angle:绕钢束旋转角度
2336
+ > - track_group:轨迹线结构组名 (直线时不用赋值)
2337
+ > - projection:直线钢束投影 (默认为true)
2338
+ >
2339
+ > **示例代码**
2340
+ > ```Python
2341
+ > from qtmodel import *
2342
+ > mdb.add_tendon_3d("BB1",property_name="22-15",num=2,position_type=1,
2343
+ > control_points=[(0,0,-1,0),(10,0,-1,0)],point_insert=(0,0,0))
2344
+ > mdb.add_tendon_3d("BB1",property_name="22-15",num=2,position_type=2,
2345
+ > control_points=[(0,0,-1,0),(10,0,-1,0)],point_insert=(1,1,1),track_group="轨迹线结构组1")
2346
+ > ```
2347
+ > **返回**
2348
+ > Returns: 无
2349
+
2350
+ ### add_tendon_2d
2351
+ > **说明**
2352
+ > 添加三维钢束
2353
+ > **参数**
2354
+ > - name:钢束名称
2355
+ > - property_name:钢束特性名称
2356
+ > - group_name:默认钢束组
2357
+ > - num:根数
2358
+ > - line_type:1-导线点 2-折线点
2359
+ > - position_type: 定位方式 1-直线 2-轨迹线
2360
+ > - symmetry: 对称点 0-左端点 1-右端点 2-不对称
2361
+ > - control_points: 控制点信息[(x1,z1,r1),(x2,z2,r2)....] 三维[(x1,y1,z1,r1),(x2,y2,z2,r2)....]
2362
+ > - control_points_lateral: 控制点横弯信息[(x1,y1,r1),(x2,y2,r2)....],无横弯时不必输入
2363
+ > - point_insert: 定位方式 (直线时为插入点坐标[x,y,z] 轨迹线时[插入端(1-I 2-J),插入方向(1-ij 2-ji),插入单元id])
2364
+ > - tendon_direction:直线钢束X方向向量 默认为x轴即[1,0,0] (轨迹线不用赋值)
2365
+ > - rotation_angle:绕钢束旋转角度
2366
+ > - track_group:轨迹线结构组名 (直线时不用赋值)
2367
+ > - projection:直线钢束投影 (默认为true)
2368
+ >
2369
+ > **示例代码**
2370
+ > ```Python
2371
+ > from qtmodel import *
2372
+ > mdb.add_tendon_2d(name="BB1",property_name="22-15",num=2,position_type=1,
2373
+ > control_points=[(0,-1,0),(10,-1,0)],point_insert=(0,0,0))
2374
+ > mdb.add_tendon_2d(name="BB1",property_name="22-15",num=2,position_type=2,
2375
+ > control_points=[(0,-1,0),(10,-1,0)],point_insert=(1,1,1),track_group="轨迹线结构组1")
2376
+ > ```
2377
+ > **返回**
2378
+ > Returns: 无
2379
+
2380
+ ### update_tendon
2381
+ > **说明**
2382
+ > 添加三维钢束
2383
+ > **参数**
2384
+ > - name:钢束名称
2385
+ > - new_name:新钢束名称
2386
+ > - tendon_2d:是否为2维钢束
2387
+ > - property_name:钢束特性名称
2388
+ > - group_name:默认钢束组
2389
+ > - num:根数
2390
+ > - line_type:1-导线点 2-折线点
2391
+ > - position_type: 定位方式 1-直线 2-轨迹线
2392
+ > - symmetry: 对称点 0-左端点 1-右端点 2-不对称
2393
+ > - control_points: 控制点信息二维[(x1,z1,r1),(x2,z2,r2)....]
2394
+ > - control_points_lateral: 控制点横弯信息[(x1,y1,r1),(x2,y2,r2)....],无横弯时不必输入
2395
+ > - point_insert: 定位方式 (直线时为插入点坐标[x,y,z] 轨迹线时[插入端(1-I 2-J),插入方向(1-ij 2-ji),插入单元id])
2396
+ > - tendon_direction:直线钢束X方向向量 默认为x轴即[1,0,0] (轨迹线不用赋值)
2397
+ > - rotation_angle:绕钢束旋转角度
2398
+ > - track_group:轨迹线结构组名 (直线时不用赋值)
2399
+ > - projection:直线钢束投影 (默认为true)
2400
+ >
2401
+ > **示例代码**
2402
+ > ```Python
2403
+ > from qtmodel import *
2404
+ > mdb.update_tendon(name="BB1",property_name="22-15",num=2,position_type=1,
2405
+ > control_points=[(0,-1,0),(10,-1,0)],point_insert=(0,0,0))
2406
+ > mdb.update_tendon(name="BB1",property_name="22-15",num=2,position_type=2,
2407
+ > control_points=[(0,-1,0),(10,-1,0)],point_insert=(1,1,1),track_group="轨迹线结构组1")
2408
+ > ```
2409
+ > **返回**
2410
+ > Returns: 无
2411
+
2412
+ ### update_element_component_type
2413
+ > **说明**
2414
+ > 赋予单元构件类型
2415
+ > **参数**
2416
+ > - ids: 钢束构件所在单元编号集合
2417
+ > - component_type:0-钢结构构件 1-钢筋混凝土构件 2-预应力混凝土构件
2418
+ >
2419
+ > **示例代码**
2420
+ > ```Python
2421
+ > from qtmodel import *
2422
+ > mdb.update_element_component_type(ids=[1,2,3,4],component_type=2)
2423
+ > ```
2424
+ > **返回**
2425
+ > Returns: 无
2426
+
2427
+ ### remove_tendon
2428
+ > **说明**
2429
+ > 按照名称或编号删除钢束,默认时删除所有钢束
2430
+ > **参数**
2431
+ > - name:钢束名称
2432
+ > - index:钢束编号
2433
+ >
2434
+ > **示例代码**
2435
+ > ```Python
2436
+ > from qtmodel import *
2437
+ > mdb.remove_tendon(name="钢束1")
2438
+ > mdb.remove_tendon(index=1)
2439
+ > mdb.remove_tendon()
2440
+ > ```
2441
+ > **返回**
2442
+ > Returns: 无
2443
+
2444
+ ### remove_tendon_property
2445
+ > **说明**
2446
+ > 按照名称或编号删除钢束组,默认时删除所有钢束组
2447
+ > **参数**
2448
+ > - name:钢束组名称
2449
+ > - index:钢束组编号
2450
+ >
2451
+ > **示例代码**
2452
+ > ```Python
2453
+ > from qtmodel import *
2454
+ > mdb.remove_tendon_property(name="钢束特性1")
2455
+ > mdb.remove_tendon_property(index=1)
2456
+ > mdb.remove_tendon_property()
2457
+ > ```
2458
+ > **返回**
2459
+ > Returns: 无
2460
+
2461
+ ### update_tendon_group
2462
+ > **说明**
2463
+ > 更新钢束组名
2464
+ > **参数**
2465
+ > - name:原钢束组名
2466
+ > - new_name:新钢束组名
2467
+ >
2468
+ > **示例代码**
2469
+ > ```Python
2470
+ > from qtmodel import *
2471
+ > mdb.update_tendon_group("钢束组1","钢束组2")
2472
+ > ```
2473
+ > **返回**
2474
+ > Returns: 无
2475
+
2476
+ ### add_pre_stress
2477
+ > **说明**
2478
+ > 添加预应力
2479
+ > **参数**
2480
+ > - case_name:荷载工况名
2481
+ > - tendon_name:钢束名,支持钢束名或钢束名列表
2482
+ > - tension_type:预应力类型 (0-始端 1-末端 2-两端)
2483
+ > - force:预应力
2484
+ > - group_name:边界组
2485
+ >
2486
+ > **示例代码**
2487
+ > ```Python
2488
+ > from qtmodel import *
2489
+ > mdb.add_pre_stress(case_name="荷载工况名",tendon_name="钢束1",force=1390000)
2490
+ > ```
2491
+ > **返回**
2492
+ > Returns: 无
2493
+
2494
+ ### remove_pre_stress
2495
+ > **说明**
2496
+ > 删除预应力
2497
+ > **参数**
2498
+ > - tendon_name:钢束组,默认则删除所有预应力荷载
2499
+ >
2500
+ > **示例代码**
2501
+ > ```Python
2502
+ > from qtmodel import *
2503
+ > mdb.remove_pre_stress(tendon_name="钢束1")
2504
+ > mdb.remove_pre_stress()
2505
+ > ```
2506
+ > **返回**
2507
+ > Returns: 无
2508
+
2509
+ ## 温度与制造偏差荷载
2510
+ ### add_deviation_parameter
2511
+ > **说明**
2512
+ > 添加制造误差
2513
+ > **参数**
2514
+ > - name:名称
2515
+ > - element_type:单元类型 1-梁单元 2-板单元
2516
+ > - parameters:参数列表
2517
+ > _梁杆单元为[轴向,I端X向转角,I端Y向转角,I端Z向转角,J端X向转角,J端Y向转角,J端Z向转角]
2518
+ > _板单元为[X向位移,Y向位移,Z向位移,X向转角,Y向转角]
2519
+ >
2520
+ > **示例代码**
2521
+ > ```Python
2522
+ > from qtmodel import *
2523
+ > mdb.add_deviation_parameter(name="梁端制造误差",element_type=1,parameters=[1,0,0,0,0,0,0])
2524
+ > mdb.add_deviation_parameter(name="板端制造误差",element_type=1,parameters=[1,0,0,0,0])
2525
+ > ```
2526
+ > **返回**
2527
+ > Returns: 无
2528
+
2529
+ ### update_deviation_parameter
2530
+ > **说明**
2531
+ > 添加制造误差
2532
+ > **参数**
2533
+ > - name:名称
2534
+ > - new_name:新名称,默认不修改名称
2535
+ > - element_type:单元类型 1-梁单元 2-板单元
2536
+ > - parameters:参数列表
2537
+ > _梁杆单元为[轴向,I端X向转角,I端Y向转角,I端Z向转角,J端X向转角,J端Y向转角,J端Z向转角]
2538
+ > _板单元为[X向位移,Y向位移,Z向位移,X向转角,Y向转角]
2539
+ >
2540
+ > **示例代码**
2541
+ > ```Python
2542
+ > from qtmodel import *
2543
+ > mdb.update_deviation_parameter(name="梁端制造误差",element_type=1,parameters=[1,0,0,0,0,0,0])
2544
+ > mdb.update_deviation_parameter(name="板端制造误差",element_type=1,parameters=[1,0,0,0,0])
2545
+ > ```
2546
+ > **返回**
2547
+ > Returns: 无
2548
+
2549
+ ### remove_deviation_parameter
2550
+ > **说明**
2551
+ > 删除指定制造偏差参数
2552
+ > **参数**
2553
+ > - name:制造偏差参数名
2554
+ > - para_type:制造偏差类型 1-梁单元 2-板单元
2555
+ >
2556
+ > **示例代码**
2557
+ > ```Python
2558
+ > from qtmodel import *
2559
+ > mdb.remove_deviation_parameter(name="参数1",para_type=1)
2560
+ > ```
2561
+ > **返回**
2562
+ > Returns: 无
2563
+
2564
+ ### add_deviation_load
2565
+ > **说明**
2566
+ > 添加制造误差荷载
2567
+ > **参数**
2568
+ > - element_id:单元编号,支持数或列表
2569
+ > - case_name:荷载工况名
2570
+ > - parameters:参数名列表
2571
+ > _梁杆单元为制造误差参数名称
2572
+ > _板单元为[I端误差名,J端误差名,K端误差名,L端误差名]
2573
+ > - group_name:荷载组名
2574
+ >
2575
+ > **示例代码**
2576
+ > ```Python
2577
+ > from qtmodel import *
2578
+ > mdb.add_deviation_load(element_id=1,case_name="工况1",parameters="梁端误差")
2579
+ > mdb.add_deviation_load(element_id=2,case_name="工况1",parameters=["板端误差1","板端误差2","板端误差3","板端误差4"])
2580
+ > ```
2581
+ > **返回**
2582
+ > Returns: 无
2583
+
2584
+ ### remove_deviation_load
2585
+ > **说明**
2586
+ > 删除指定制造偏差荷载
2587
+ > **参数**
2588
+ > - case_name:荷载工况名
2589
+ > - element_id:单元编号,支持数或列表
2590
+ > - group_name: 荷载组
2591
+ >
2592
+ > **示例代码**
2593
+ > ```Python
2594
+ > from qtmodel import *
2595
+ > mdb.remove_deviation_load(case_name="工况1",element_id=1,group_name="荷载组1")
2596
+ > ```
2597
+ > **返回**
2598
+ > Returns: 无
2599
+
2600
+ ### add_element_temperature
2601
+ > **说明**
2602
+ > 添加单元温度
2603
+ > **参数**
2604
+ > - element_id:单元编号,支持数或列表
2605
+ > - case_name:荷载工况名
2606
+ > - temperature:最终温度
2607
+ > - group_name:荷载组名
2608
+ >
2609
+ > **示例代码**
2610
+ > ```Python
2611
+ > from qtmodel import *
2612
+ > mdb.add_element_temperature(element_id=1,case_name="自重",temperature=1,group_name="默认荷载组")
2613
+ > ```
2614
+ > **返回**
2615
+ > Returns: 无
2616
+
2617
+ ### remove_element_temperature
2618
+ > **说明**
2619
+ > 删除指定单元温度
2620
+ > **参数**
2621
+ > - case_name:荷载工况名
2622
+ > - element_id:单元编号,支持数或列表
2623
+ >
2624
+ > **示例代码**
2625
+ > ```Python
2626
+ > from qtmodel import *
2627
+ > mdb.remove_element_temperature(case_name="荷载工况1",element_id=1)
2628
+ > ```
2629
+ > **返回**
2630
+ > Returns: 无
2631
+
2632
+ ### add_gradient_temperature
2633
+ > **说明**
2634
+ > 添加梯度温度
2635
+ >
2636
+ > **示例代码**
2637
+ > ```Python
2638
+ > from qtmodel import *
2639
+ > mdb.add_gradient_temperature(element_id=1,case_name="荷载工况1",group_name="荷载组名1",temperature=10)
2640
+ > mdb.add_gradient_temperature(element_id=2,case_name="荷载工况2",group_name="荷载组名2",temperature=10,element_type=2)
2641
+ > ```
2642
+ > **返回**
2643
+ > Returns: 无
2644
+
2645
+ ### remove_gradient_temperature
2646
+ > **说明**
2647
+ > 删除梁或板单元梯度温度
2648
+ > **参数**
2649
+ > - case_name:荷载工况名
2650
+ > - element_id:单元编号,支持数或列表
2651
+ >
2652
+ > **示例代码**
2653
+ > ```Python
2654
+ > from qtmodel import *
2655
+ > mdb.remove_gradient_temperature(case_name="工况1",element_id=1)
2656
+ > ```
2657
+ > **返回**
2658
+ > Returns: 无
2659
+
2660
+ ### add_beam_section_temperature
2661
+ > **说明**
2662
+ > 添加梁截面温度
2663
+ > **参数**
2664
+ > - element_id:单元编号,支持整数或整数型列表
2665
+ > - case_name:荷载工况名
2666
+ > - code_index:规范编号 (1-公路规范2015 2-美规2017)
2667
+ > - sec_type:截面类型(1-混凝土 2-组合梁)
2668
+ > - t1:温度1
2669
+ > - t2:温度2
2670
+ > - t3:温度3
2671
+ > - thick:厚度
2672
+ > - group_name:荷载组名
2673
+ >
2674
+ > **示例代码**
2675
+ > ```Python
2676
+ > from qtmodel import *
2677
+ > mdb.add_beam_section_temperature(element_id=1,case_name="工况1",code_index=1,sec_type=1,t1=-4.2,t2=-1)
2678
+ > ```
2679
+ > **返回**
2680
+ > Returns: 无
2681
+
2682
+ ### remove_beam_section_temperature
2683
+ > **说明**
2684
+ > 删除指定梁或板单元梁截面温度
2685
+ > **参数**
2686
+ > - case_name:荷载工况名
2687
+ > - element_id:单元编号,支持数或列表
2688
+ >
2689
+ > **示例代码**
2690
+ > ```Python
2691
+ > from qtmodel import *
2692
+ > mdb.remove_beam_section_temperature(case_name="工况1",element_id=1)
2693
+ > ```
2694
+ > **返回**
2695
+ > Returns: 无
2696
+
2697
+ ### add_index_temperature
2698
+ > **说明**
2699
+ > 添加指数温度
2700
+ > **参数**
2701
+ > - element_id:单元编号,支持数或列表
2702
+ > - case_name:荷载工况名
2703
+ > - temperature:温差
2704
+ > - index:指数
2705
+ > - group_name:荷载组名
2706
+ >
2707
+ > **示例代码**
2708
+ > ```Python
2709
+ > from qtmodel import *
2710
+ > mdb.add_index_temperature(element_id=1,case_name="工况1",temperature=20,index=2)
2711
+ > ```
2712
+ > **返回**
2713
+ > Returns: 无
2714
+
2715
+ ### remove_index_temperature
2716
+ > **说明**
2717
+ > 删除梁单元指数温度
2718
+ > **参数**
2719
+ > - case_name:荷载工况名
2720
+ > - element_id:单元编号,支持数或列表
2721
+ >
2722
+ > **示例代码**
2723
+ > ```Python
2724
+ > from qtmodel import *
2725
+ > mdb.remove_index_temperature(case_name="工况1",element_id=1)
2726
+ > ```
2727
+ > **返回**
2728
+ > Returns: 无
2729
+
2730
+ ### add_top_plate_temperature
2731
+ > **说明**
2732
+ > 添加顶板温度
2733
+ > **参数**
2734
+ > - element_id:单元编号
2735
+ > - case_name:荷载
2736
+ > - temperature:温差,最终温度于初始温度之差
2737
+ > - group_name:荷载组名
2738
+ >
2739
+ > **示例代码**
2740
+ > ```Python
2741
+ > from qtmodel import *
2742
+ > mdb.add_top_plate_temperature(element_id=1,case_name="工况1",temperature=40,group_name="默认荷载组")
2743
+ > ```
2744
+ > **返回**
2745
+ > Returns: 无
2746
+
2747
+ ### remove_top_plate_temperature
2748
+ > **说明**
2749
+ > 删除梁单元顶板温度
2750
+ > **参数**
2751
+ > - case_name:荷载工况名
2752
+ > - element_id:单元编号,支持数或列表
2753
+ >
2754
+ > **示例代码**
2755
+ > ```Python
2756
+ > from qtmodel import *
2757
+ > mdb.remove_top_plate_temperature(case_name="荷载工况1",element_id=1)
2758
+ > ```
2759
+ > **返回**
2760
+ > Returns: 无
2761
+
2762
+ ### add_custom_temperature
2763
+ > **说明**
2764
+ > 添加梁自定义温度
2765
+ > **参数**
2766
+ > - case_name:荷载工况名
2767
+ > - element_id:单元编号,支持数或列表
2768
+ > - group_name:指定荷载组,后续升级开放指定荷载组删除功能
2769
+ > - orientation: 1-局部坐标z 2-局部坐标y
2770
+ > - temperature_data:自定义数据[(参考位置1-顶 2-底,高度,温度)...]
2771
+ >
2772
+ > **示例代码**
2773
+ > ```Python
2774
+ > from qtmodel import *
2775
+ > mdb.add_custom_temperature(case_name="荷载工况1",element_id=1,orientation=1,temperature_data=[(1,1,20),(1,2,10)])
2776
+ > ```
2777
+ > **返回**
2778
+ > Returns: 无
2779
+
2780
+ ### remove_custom_temperature
2781
+ > **说明**
2782
+ > 删除梁单元自定义温度
2783
+ > **参数**
2784
+ > - case_name:荷载工况名
2785
+ > - element_id:单元编号,支持数或列表
2786
+ >
2787
+ > **示例代码**
2788
+ > ```Python
2789
+ > from qtmodel import *
2790
+ > mdb.remove_custom_temperature(case_name="工况1",element_id=1)
2791
+ > ```
2792
+ > **返回**
2793
+ > Returns: 无
2794
+
2795
+ ## 静力荷载操作
2796
+ ### add_nodal_force
2797
+ > **说明**
2798
+ > 添加节点荷载
2799
+ > **参数**
2800
+ > - node_id:节点编号
2801
+ > - case_name:荷载工况名
2802
+ > - load_info:荷载信息列表 [Fx,Fy,Fz,Mx,My,Mz]
2803
+ > - group_name:荷载组名
2804
+ >
2805
+ > **示例代码**
2806
+ > ```Python
2807
+ > from qtmodel import *
2808
+ > mdb.add_nodal_force(case_name="荷载工况1",node_id=1,load_info=[1,1,1,1,1,1],group_name="默认结构组")
2809
+ > ```
2810
+ > **返回**
2811
+ > Returns: 无
2812
+
2813
+ ### remove_nodal_force
2814
+ > **说明**
2815
+ > 删除节点荷载
2816
+ > **参数**
2817
+ > - case_name:荷载工况名
2818
+ > - node_id:节点编号
2819
+ > - group_name:指定荷载组
2820
+ >
2821
+ > **示例代码**
2822
+ > ```Python
2823
+ > from qtmodel import *
2824
+ > mdb.remove_nodal_force(case_name="荷载工况1",node_id=1,group_name="默认荷载组")
2825
+ > ```
2826
+ > **返回**
2827
+ > Returns: 无
2828
+
2829
+ ### add_node_displacement
2830
+ > **说明**
2831
+ > 添加节点位移
2832
+ > **参数**
2833
+ > - node_id:节点编号,支持整型或整数型列表
2834
+ > - case_name:荷载工况名
2835
+ > - load_info:节点位移列表 [Dx,Dy,Dz,Rx,Ry,Rz]
2836
+ > - group_name:荷载组名
2837
+ >
2838
+ > **示例代码**
2839
+ > ```Python
2840
+ > from qtmodel import *
2841
+ > mdb.add_node_displacement(case_name="荷载工况1",node_id=1,load_info=(1,0,0,0,0,0),group_name="默认荷载组")
2842
+ > mdb.add_node_displacement(case_name="荷载工况1",node_id=[1,2,3],load_info=(1,0,0,0,0,0),group_name="默认荷载组")
2843
+ > ```
2844
+ > **返回**
2845
+ > Returns: 无
2846
+
2847
+ ### remove_nodal_displacement
2848
+ > **说明**
2849
+ > 删除节点位移荷载
2850
+ > **参数**
2851
+ > - node_id:节点编号,支持数或列表
2852
+ > - case_name:荷载工况名
2853
+ > - group_name:指定荷载组
2854
+ >
2855
+ > **示例代码**
2856
+ > ```Python
2857
+ > from qtmodel import *
2858
+ > mdb.remove_nodal_displacement(case_name="荷载工况1",node_id=1,group_name="默认荷载组")
2859
+ > ```
2860
+ > **返回**
2861
+ > Returns: 无
2862
+
2863
+ ### add_beam_element_load
2864
+ > **说明**
2865
+ > 添加梁单元荷载
2866
+ > **参数**
2867
+ > - element_id:单元编号,支持数或列表
2868
+ > - case_name:荷载工况名
2869
+ > - load_type:荷载类型 (1-集中力 2-集中弯矩 3-分布力 4-分布弯矩)
2870
+ > - coord_system:坐标系 (1-整体X 2-整体Y 3-整体Z 4-局部X 5-局部Y 6-局部Z)
2871
+ > - is_abs: 荷载位置输入方式,True-绝对值 False-相对值
2872
+ > - list_x:荷载位置信息 ,荷载距离单元I端的距离,可输入绝对距离或相对距离
2873
+ > - list_load:荷载数值信息
2874
+ > - group_name:荷载组名
2875
+ > - load_bias:偏心荷载 (是否偏心,0-中心 1-偏心,偏心坐标系-int,偏心距离)
2876
+ > - projected:荷载是否投影
2877
+ >
2878
+ > **示例代码**
2879
+ > ```Python
2880
+ > from qtmodel import *
2881
+ > mdb.add_beam_element_load(case_name="荷载工况1",element_id=1,load_type=1,list_x=[0.1,0.5,0.8],list_load=[100,100,100])
2882
+ > mdb.add_beam_element_load(case_name="荷载工况1",element_id=1,load_type=3,list_x=[0.4,0.8],list_load=[100,200])
2883
+ > ```
2884
+ > **返回**
2885
+ > Returns: 无
2886
+
2887
+ ### remove_beam_element_load
2888
+ > **说明**
2889
+ > 删除梁单元荷载
2890
+ > **参数**
2891
+ > - element_id:单元号支持数或列表
2892
+ > - case_name:荷载工况名
2893
+ > - load_type:荷载类型 (1-集中力 2-集中弯矩 3-分布力 4-分布弯矩)
2894
+ > - group_name:荷载组名称
2895
+ >
2896
+ > **示例代码**
2897
+ > ```Python
2898
+ > from qtmodel import *
2899
+ > mdb.remove_beam_element_load(case_name="工况1",element_id=1,load_type=1,group_name="默认荷载组")
2900
+ > ```
2901
+ > **返回**
2902
+ > Returns: 无
2903
+
2904
+ ### add_initial_tension_load
2905
+ > **说明**
2906
+ > 添加初始拉力
2907
+ > **参数**
2908
+ > - element_id:单元编号支持数或列表
2909
+ > - case_name:荷载工况名
2910
+ > - tension:初始拉力
2911
+ > - tension_type:张拉类型 0-增量 1-全量
2912
+ > - group_name:荷载组名
2913
+ >
2914
+ > **示例代码**
2915
+ > ```Python
2916
+ > from qtmodel import *
2917
+ > mdb.add_initial_tension_load(element_id=1,case_name="工况1",tension=100,tension_type=1)
2918
+ > ```
2919
+ > **返回**
2920
+ > Returns: 无
2921
+
2922
+ ### remove_initial_tension_load
2923
+ > **说明**
2924
+ > 删除初始拉力
2925
+ > **参数**
2926
+ > - element_id:单元编号支持数或列表
2927
+ > - case_name:荷载工况名
2928
+ > - group_name:荷载组名
2929
+ >
2930
+ > **示例代码**
2931
+ > ```Python
2932
+ > from qtmodel import *
2933
+ > mdb.remove_initial_tension_load(case_name="工况1",element_id=1, group_name="默认荷载组")
2934
+ > ```
2935
+ > **返回**
2936
+ > Returns: 无
2937
+
2938
+ ### add_cable_length_load
2939
+ > **说明**
2940
+ > 添加索长张拉
2941
+ > **参数**
2942
+ > - element_id:单元编号支持数或列表
2943
+ > - case_name:荷载工况名
2944
+ > - length:长度
2945
+ > - tension_type:张拉类型 0-增量 1-全量
2946
+ > - group_name:荷载组名
2947
+ >
2948
+ > **示例代码**
2949
+ > ```Python
2950
+ > from qtmodel import *
2951
+ > mdb.add_cable_length_load(element_id=1,case_name="工况1",length=1,tension_type=1)
2952
+ > ```
2953
+ > **返回**
2954
+ > Returns: 无
2955
+
2956
+ ### remove_cable_length_load
2957
+ > **说明**
2958
+ > 删除索长张拉
2959
+ > **参数**
2960
+ > - element_id:单元号支持数或列表
2961
+ > - case_name:荷载工况名
2962
+ > - group_name:荷载组名
2963
+ >
2964
+ > **示例代码**
2965
+ > ```Python
2966
+ > from qtmodel import *
2967
+ > mdb.remove_cable_length_load(case_name="工况1",element_id=1, group_name= "默认荷载组")
2968
+ > ```
2969
+ > **返回**
2970
+ > Returns: 无
2971
+
2972
+ ### add_plate_element_load
2973
+ > **说明**
2974
+ > 添加版单元荷载
2975
+ > **参数**
2976
+ > - element_id:单元编号支持数或列表
2977
+ > - case_name:荷载工况名
2978
+ > - load_type:荷载类型 (1-集中力 2-集中弯矩 3-分布力 4-分布弯矩)
2979
+ > - load_place:荷载位置 (0-面IJKL 1-边IJ 2-边JK 3-边KL 4-边LI ) (仅分布荷载需要)
2980
+ > - coord_system:坐标系 (1-整体X 2-整体Y 3-整体Z 4-局部X 5-局部Y 6-局部Z)
2981
+ > - group_name:荷载组名
2982
+ > - list_load:荷载列表
2983
+ > - list_xy:荷载位置信息 [IJ方向绝对距离x,IL方向绝对距离y] (仅集中荷载需要)
2984
+ >
2985
+ > **示例代码**
2986
+ > ```Python
2987
+ > from qtmodel import *
2988
+ > mdb.add_plate_element_load(element_id=1,case_name="工况1",load_type=1,group_name="默认荷载组",list_load=[1000],list_xy=(0.2,0.5))
2989
+ > ```
2990
+ > **返回**
2991
+ > Returns: 无
2992
+
2993
+ ### remove_plate_element_load
2994
+ > **说明**
2995
+ > 删除指定荷载工况下指定单元的板单元荷载
2996
+ > **参数**
2997
+ > - element_id:单元编号,支持数或列表
2998
+ > - case_name:荷载工况名
2999
+ > - load_type: 板单元类型 1集中力 2-集中弯矩 3-分布线力 4-分布线弯矩 5-分布面力 6-分布面弯矩
3000
+ > - group_name:荷载组名
3001
+ >
3002
+ > **示例代码**
3003
+ > ```Python
3004
+ > from qtmodel import *
3005
+ > mdb.remove_plate_element_load(case_name="工况1",element_id=1,load_type=1,group_name="默认荷载组")
3006
+ > ```
3007
+ > **返回**
3008
+ > Returns: 无
3009
+
3010
+ ### add_plane_load_type
3011
+ > **说明**
3012
+ > 添加分配面荷载类型
3013
+ > **参数**
3014
+ > - name:荷载类型名称
3015
+ > - load_type:荷载类型 1-集中荷载 2-线荷载 3-面荷载
3016
+ > - point_list:点列表,集中力时为列表内元素为 [x,y,force] 线荷载与面荷载时为 [x,y]
3017
+ > - load:荷载值,仅线荷载与面荷载需要
3018
+ > - copy_x:复制到x轴距离,与UI一致,支持3@2形式字符串,逗号分隔
3019
+ > - copy_y:复制到y轴距离,与UI一致,支持3@2形式字符串,逗号分隔
3020
+ > - describe:描述
3021
+ >
3022
+ > **示例代码**
3023
+ > ```Python
3024
+ > from qtmodel import *
3025
+ > mdb.add_plane_load_type(name="荷载类型1",load_type=1,point_list=[[1,0,10],[1,1,10],[1,2,10]])
3026
+ > mdb.add_plane_load_type(name="荷载类型2",load_type=2,point_list=[[1,0],[1,1]],load=10)
3027
+ > ```
3028
+ > **返回**
3029
+ > Returns: 无
3030
+
3031
+ ### add_plane_load
3032
+ > **说明**
3033
+ > 添加分配面荷载类型
3034
+ > **参数**
3035
+ > - index:荷载编号,默认自动识别
3036
+ > - case_name:工况名
3037
+ > - type_name:荷载类型名称
3038
+ > - point1:第一点(原点)
3039
+ > - point2:第一点(在x轴上)
3040
+ > - point3:第一点(在y轴上)
3041
+ > - plate_ids:指定板单元。默认时为全部板单元
3042
+ > - coord_system:描述
3043
+ > - group_name:描述
3044
+ >
3045
+ > **示例代码**
3046
+ > ```Python
3047
+ > from qtmodel import *
3048
+ > mdb.add_plane_load(index=1,case_name="工况1",type_name="荷载类型1",point1=(0,0,0),
3049
+ > point2=(1,0,0),point3=(0,1,0),group_name="默认荷载组")
3050
+ > ```
3051
+ > **返回**
3052
+ > Returns: 无
3053
+
3054
+ ### update_plane_load_type
3055
+ > **说明**
3056
+ > 更新板单元类型
3057
+ > **参数**
3058
+ > - name:荷载类型名称
3059
+ > - new_name:新名称,默认不修改名称
3060
+ > - load_type:荷载类型 1-集中荷载 2-线荷载 3-面荷载
3061
+ > - point_list:点列表,集中力时为列表内元素为 [x,y,force] 线荷载与面荷载时为 [x,y]
3062
+ > - load:荷载值,仅线荷载与面荷载需要
3063
+ > - copy_x:复制到x轴距离,与UI一致,支持3@2形式字符串,逗号分隔
3064
+ > - copy_y:复制到y轴距离,与UI一致,支持3@2形式字符串,逗号分隔
3065
+ > - describe:描述
3066
+ >
3067
+ > **示例代码**
3068
+ > ```Python
3069
+ > from qtmodel import *
3070
+ > mdb.update_plane_load_type(name="荷载类型1",load_type=1,point_list=[[1,0,10],[1,1,10],[1,2,10]])
3071
+ > mdb.update_plane_load_type(name="荷载类型2",load_type=2,point_list=[[1,0],[1,1]],load=10)
3072
+ > ```
3073
+ > **返回**
3074
+ > Returns: 无
3075
+
3076
+ ### remove_plane_load
3077
+ > **说明**
3078
+ > 根据荷载编号删除分配面荷载
3079
+ > **参数**
3080
+ > - index: 指定荷载编号,默认则删除所有分配面荷载
3081
+ >
3082
+ > **示例代码**
3083
+ > ```Python
3084
+ > from qtmodel import *
3085
+ > mdb.remove_plane_load()
3086
+ > mdb.remove_plane_load(index=1)
3087
+ > ```
3088
+ > **返回**
3089
+ > Returns: 无
3090
+
3091
+ ### remove_plane_load_type
3092
+ > **说明**
3093
+ > 删除分配面荷载类型
3094
+ > **参数**
3095
+ > - name: 指定荷载类型,默认则删除所有分配面荷载
3096
+ >
3097
+ > **示例代码**
3098
+ > ```Python
3099
+ > from qtmodel import *
3100
+ > mdb.remove_plane_load_type("类型1")
3101
+ > ```
3102
+ > **返回**
3103
+ > Returns: 无
3104
+
3105
+ ## 荷载工况操作
3106
+ ### add_sink_group
3107
+ > **说明**
3108
+ > 添加沉降组
3109
+ > **参数**
3110
+ > - name: 沉降组名
3111
+ > - sink: 沉降值
3112
+ > - node_ids: 节点编号,支持数或列表
3113
+ >
3114
+ > **示例代码**
3115
+ > ```Python
3116
+ > from qtmodel import *
3117
+ > mdb.add_sink_group(name="沉降1",sink=0.1,node_ids=[1,2,3])
3118
+ > ```
3119
+ > **返回**
3120
+ > Returns: 无
3121
+
3122
+ ### update_sink_group
3123
+ > **说明**
3124
+ > 添加沉降组
3125
+ > **参数**
3126
+ > - name: 沉降组名
3127
+ > - new_name: 新沉降组名,默认不修改
3128
+ > - sink: 沉降值
3129
+ > - node_ids: 节点编号,支持数或列表
3130
+ >
3131
+ > **示例代码**
3132
+ > ```Python
3133
+ > from qtmodel import *
3134
+ > mdb.update_sink_group(name="沉降1",sink=0.1,node_ids=[1,2,3])
3135
+ > ```
3136
+ > **返回**
3137
+ > Returns: 无
3138
+
3139
+ ### remove_sink_group
3140
+ > **说明**
3141
+ > 按照名称删除沉降组
3142
+ > **参数**
3143
+ > - name:沉降组名,默认删除所有沉降组
3144
+ >
3145
+ > **示例代码**
3146
+ > ```Python
3147
+ > from qtmodel import *
3148
+ > mdb.remove_sink_group()
3149
+ > mdb.remove_sink_group(name="沉降1")
3150
+ > ```
3151
+ > **返回**
3152
+ > Returns: 无
3153
+
3154
+ ### add_sink_case
3155
+ > **说明**
3156
+ > 添加沉降工况
3157
+ > **参数**
3158
+ > - name:荷载工况名
3159
+ > - sink_groups:沉降组名,支持字符串或列表
3160
+ >
3161
+ > **示例代码**
3162
+ > ```Python
3163
+ > from qtmodel import *
3164
+ > mdb.add_sink_case(name="沉降工况1",sink_groups=["沉降1","沉降2"])
3165
+ > ```
3166
+ > **返回**
3167
+ > Returns: 无
3168
+
3169
+ ### update_sink_case
3170
+ > **说明**
3171
+ > 添加沉降工况
3172
+ > **参数**
3173
+ > - name:荷载工况名
3174
+ > - new_name: 新沉降组名,默认不修改
3175
+ > - sink_groups:沉降组名,支持字符串或列表
3176
+ >
3177
+ > **示例代码**
3178
+ > ```Python
3179
+ > from qtmodel import *
3180
+ > mdb.update_sink_case(name="沉降工况1",sink_groups=["沉降1","沉降2"])
3181
+ > ```
3182
+ > **返回**
3183
+ > Returns: 无
3184
+
3185
+ ### remove_sink_case
3186
+ > **说明**
3187
+ > 按照名称删除沉降工况,不输入名称时默认删除所有沉降工况
3188
+ > **参数**
3189
+ > - name:沉降工况名
3190
+ >
3191
+ > **示例代码**
3192
+ > ```Python
3193
+ > from qtmodel import *
3194
+ > mdb.remove_sink_case()
3195
+ > mdb.remove_sink_case(name="沉降1")
3196
+ > ```
3197
+ > **返回**
3198
+ > Returns: 无
3199
+
3200
+ ### add_concurrent_reaction
3201
+ > **说明**
3202
+ > 添加并发反力组
3203
+ > **参数**
3204
+ > - names: 结构组名称集合
3205
+ >
3206
+ > **示例代码**
3207
+ > ```Python
3208
+ > from qtmodel import *
3209
+ > mdb.add_concurrent_reaction(names=["默认结构组"])
3210
+ > ```
3211
+ > **返回**
3212
+ > Returns: 无
3213
+
3214
+ ### remove_concurrent_reaction
3215
+ > **说明**
3216
+ > 删除所有并发反力组
3217
+ > **参数**
3218
+ >
3219
+ > **示例代码**
3220
+ > ```Python
3221
+ > from qtmodel import *
3222
+ > mdb.remove_concurrent_reaction()
3223
+ > ```
3224
+ > **返回**
3225
+ > Returns: 无
3226
+
3227
+ ### add_concurrent_force
3228
+ > **说明**
3229
+ > 创建并发内力组
3230
+ > **参数**
3231
+ > - names: 结构组名称集合
3232
+ >
3233
+ > **示例代码**
3234
+ > ```Python
3235
+ > from qtmodel import *
3236
+ > mdb.add_concurrent_force(names=["默认结构组"])
3237
+ > ```
3238
+ > **返回**
3239
+ > Returns: 无
3240
+
3241
+ ### remove_concurrent_force
3242
+ > **说明**
3243
+ > 删除所有并发内力组
3244
+ > **参数**
3245
+ >
3246
+ > **示例代码**
3247
+ > ```Python
3248
+ > from qtmodel import *
3249
+ > mdb.remove_concurrent_force()
3250
+ > ```
3251
+ > **返回**
3252
+ > Returns: 无
3253
+
3254
+ ### add_load_case
3255
+ > **说明**
3256
+ > 添加荷载工况
3257
+ > **参数**
3258
+ > - name:工况名
3259
+ > - case_type:荷载工况类型
3260
+ > _"施工阶段荷载", "恒载", "活载", "制动力", "风荷载","体系温度荷载","梯度温度荷载",
3261
+ > _"长轨伸缩挠曲力荷载", "脱轨荷载", "船舶撞击荷载","汽车撞击荷载","长轨断轨力荷载", "用户定义荷载"
3262
+ >
3263
+ > **示例代码**
3264
+ > ```Python
3265
+ > from qtmodel import *
3266
+ > mdb.add_load_case(name="工况1",case_type="施工阶段荷载")
3267
+ > ```
3268
+ > **返回**
3269
+ > Returns: 无
3270
+
3271
+ ### remove_load_case
3272
+ > **说明**
3273
+ > 删除荷载工况,参数均为默认时删除全部荷载工况
3274
+ > **参数**
3275
+ > - index:荷载编号
3276
+ > - name:荷载名
3277
+ >
3278
+ > **示例代码**
3279
+ > ```Python
3280
+ > from qtmodel import *
3281
+ > mdb.remove_load_case(index=1)
3282
+ > mdb.remove_load_case(name="工况1")
3283
+ > mdb.remove_load_case()
3284
+ > ```
3285
+ > **返回**
3286
+ > Returns: 无
3287
+
3288
+ ### update_load_case
3289
+ > **说明**
3290
+ > 添加荷载工况
3291
+ > **参数**
3292
+ > - name:工况名
3293
+ > - new_name:新工况名
3294
+ > - case_type:荷载工况类型
3295
+ > _"施工阶段荷载", "恒载", "活载", "制动力", "风荷载","体系温度荷载","梯度温度荷载",
3296
+ > _"长轨伸缩挠曲力荷载", "脱轨荷载", "船舶撞击荷载","汽车撞击荷载","长轨断轨力荷载", "用户定义荷载"
3297
+ >
3298
+ > **示例代码**
3299
+ > ```Python
3300
+ > from qtmodel import *
3301
+ > mdb.add_load_case(name="工况1",case_type="施工阶段荷载")
3302
+ > ```
3303
+ > **返回**
3304
+ > Returns: 无
3305
+
3306
+ ### add_load_group
3307
+ > **说明**
3308
+ > 根据荷载组名称添加荷载组
3309
+ > **参数**
3310
+ > - name: 荷载组名称
3311
+ >
3312
+ > **示例代码**
3313
+ > ```Python
3314
+ > from qtmodel import *
3315
+ > mdb.add_load_group(name="荷载组1")
3316
+ > ```
3317
+ > **返回**
3318
+ > Returns: 无
3319
+
3320
+ ### remove_load_group
3321
+ > **说明**
3322
+ > 根据荷载组名称删除荷载组,参数为默认时删除所有荷载组
3323
+ > **参数**
3324
+ > - name: 荷载组名称
3325
+ >
3326
+ > **示例代码**
3327
+ > ```Python
3328
+ > from qtmodel import *
3329
+ > mdb.remove_load_group(name="荷载组1")
3330
+ > ```
3331
+ > **返回**
3332
+ > Returns: 无
3333
+
3334
+ ### update_load_group
3335
+ > **说明**
3336
+ > 根据荷载组名称添加荷载组
3337
+ > **参数**
3338
+ > - name: 荷载组名称
3339
+ > - new_name: 荷载组名称
3340
+ >
3341
+ > **示例代码**
3342
+ > ```Python
3343
+ > from qtmodel import *
3344
+ > mdb.update_load_group(name="荷载组1",new_name="荷载组2")
3345
+ > ```
3346
+ > **返回**
3347
+ > Returns: 无
3348
+
3349
+ ## 施工阶段操作
3350
+ ### add_construction_stage
3351
+ > **说明**
3352
+ > 添加施工阶段信息
3353
+ > **参数**
3354
+ > - name:施工阶段信息
3355
+ > - duration:时长
3356
+ > - active_structures:激活结构组信息 [(结构组名,龄期,安装方法,计自重施工阶段id),...]
3357
+ > _计自重施工阶段id 0-不计自重,1-本阶段 n-第n阶段
3358
+ > _安装方法 1-变形法 2-无应力法 3-接线法 4-切线法
3359
+ > - delete_structures:钝化结构组信息 [结构组1,结构组2,...]
3360
+ > - active_boundaries:激活边界组信息 [(边界组1,位置),...]
3361
+ > _位置 0-变形前 1-变形后
3362
+ > - delete_boundaries:钝化边界组信息 [边界组1,边界组2,...]
3363
+ > - active_loads:激活荷载组信息 [(荷载组1,时间),...]
3364
+ > _时间 0-开始 1-结束
3365
+ > - delete_loads:钝化荷载组信息 [(荷载组1,时间),...]
3366
+ > _时间 0-开始 1-结束
3367
+ > - temp_loads:临时荷载信息 [荷载组1,荷载组2,..]
3368
+ > - index:施工阶段插入位置,从0开始,默认添加到最后
3369
+ >
3370
+ > **示例代码**
3371
+ > ```Python
3372
+ > from qtmodel import *
3373
+ > mdb.add_construction_stage(name="施工阶段1",duration=5,active_structures=[("结构组1",5,1,1),("结构组2",5,1,1)],
3374
+ > active_boundaries=[("默认边界组",1)],active_loads=[("默认荷载组1",0)])
3375
+ > ```
3376
+ > **返回**
3377
+ > Returns: 无
3378
+
3379
+ ### update_construction_stage
3380
+ > **说明**
3381
+ > 添加施工阶段信息
3382
+ > **参数**
3383
+ > - name:施工阶段信息
3384
+ > - new_name:新施工阶段名
3385
+ > - duration:时长
3386
+ > - active_structures:激活结构组信息 [(结构组名,龄期,安装方法,计自重施工阶段id),...]
3387
+ > _计自重施工阶段id 0-不计自重,1-本阶段 n-第n阶段
3388
+ > _安装方法1-变形法 2-接线法 3-无应力法
3389
+ > - delete_structures:钝化结构组信息 [结构组1,结构组2,...]
3390
+ > - active_boundaries:激活边界组信息 [(边界组1,位置),...]
3391
+ > _位置 0-变形前 1-变形后
3392
+ > - delete_boundaries:钝化边界组信息 [边界组1,结构组2,...]
3393
+ > - active_loads:激活荷载组信息 [(荷载组1,时间),...]
3394
+ > _时间 0-开始 1-结束
3395
+ > - delete_loads:钝化荷载组信息 [(荷载组1,时间),...]
3396
+ > _时间 0-开始 1-结束
3397
+ > - temp_loads:临时荷载信息 [荷载组1,荷载组2,..]
3398
+ >
3399
+ > **示例代码**
3400
+ > ```Python
3401
+ > from qtmodel import *
3402
+ > mdb.update_construction_stage(name="施工阶段1",duration=5,active_structures=[("结构组1",5,1,1),("结构组2",5,1,1)],
3403
+ > active_boundaries=[("默认边界组",1)],active_loads=[("默认荷载组1",0)])
3404
+ > ```
3405
+ > **返回**
3406
+ > Returns: 无
3407
+
3408
+ ### update_construction_stage_id
3409
+ > **说明**
3410
+ > 更新部分施工阶段到致电给编号位置,从1计算,例如从{1,2,3}中将 1,2移动到3
3411
+ > **参数**
3412
+ > - stage_id:修改施工阶段编号
3413
+ > - target_id:目标施工阶段编号
3414
+ >
3415
+ > **示例代码**
3416
+ > ```Python
3417
+ > from qtmodel import *
3418
+ > mdb.update_construction_stage_id([1,2],3)
3419
+ > ```
3420
+ > **返回**
3421
+ > Returns:无
3422
+
3423
+ ### update_weight_stage
3424
+ > **说明**
3425
+ > 更新施工阶段自重
3426
+ > **参数**
3427
+ > - name:施工阶段信息
3428
+ > - structure_group_name:结构组名
3429
+ > - weight_stage_id: 计自重阶段号 (0-不计自重,1-本阶段 n-第n阶段)
3430
+ >
3431
+ > **示例代码**
3432
+ > ```Python
3433
+ > from qtmodel import *
3434
+ > mdb.update_weight_stage(name="施工阶段1",structure_group_name="默认结构组",weight_stage_id=1)
3435
+ > ```
3436
+ > **返回**
3437
+ > Returns: 无
3438
+
3439
+ ### update_all_stage_setting_type
3440
+ > **说明**
3441
+ > 更新施工阶段安装方式
3442
+ > **参数**
3443
+ > - setting_type:安装方式 (1-接线法 2-无应力法 3-变形法 4-切线法)
3444
+ >
3445
+ > **示例代码**
3446
+ > ```Python
3447
+ > from qtmodel import *
3448
+ > mdb.update_all_stage_setting_type(setting_type=1)
3449
+ > ```
3450
+ > **返回**
3451
+ > Returns: 无
3452
+
3453
+ ### remove_construction_stage
3454
+ > **说明**
3455
+ > 按照施工阶段名删除施工阶段,默认删除所有施工阶段
3456
+ > **参数**
3457
+ > - name:所删除施工阶段名称
3458
+ >
3459
+ > **示例代码**
3460
+ > ```Python
3461
+ > from qtmodel import *
3462
+ > mdb.remove_construction_stage(name="施工阶段1")
3463
+ > ```
3464
+ > **返回**
3465
+ > Returns: 无
3466
+
3467
+ ### add_section_connection_stage
3468
+ > **说明**
3469
+ > 添加施工阶段联合截面
3470
+ > **参数**
3471
+ > - name:名称
3472
+ > - sec_id:截面号
3473
+ > - ele_id:单元号,支持整型和整型列表
3474
+ > - stage_name:结合阶段名
3475
+ > - age:材龄
3476
+ > - weight_type:辅材计自重方式 0-由主材承担 1-由整体承担 2-不计辅材自重
3477
+ >
3478
+ > **示例代码**
3479
+ > ```Python
3480
+ > from qtmodel import *
3481
+ > mdb.add_section_connection_stage(name="联合阶段",sec_id=1,ele_id=[2,3,4,5],stage_name="施工阶段1")
3482
+ > ```
3483
+ > **返回**
3484
+ > Returns:无
3485
+
3486
+ ### update_section_connection_stage
3487
+ > **说明**
3488
+ > 更新施工阶段联合截面
3489
+ > **参数**
3490
+ > - name:名称
3491
+ > - new_name:新名称
3492
+ > - sec_id:截面号
3493
+ > - ele_id:单元号,支持整型和整型列表
3494
+ > - stage_name:结合阶段名
3495
+ > - age:材龄
3496
+ > - weight_type:辅材计自重方式 0-由主材承担 1-由整体承担 2-不计辅材自重
3497
+ >
3498
+ > **示例代码**
3499
+ > ```Python
3500
+ > from qtmodel import *
3501
+ > mdb.update_section_connection_stage(name="联合阶段",sec_id=1,ele_id=[2,3,4,5],stage_name="施工阶段1")
3502
+ > ```
3503
+ > **返回**
3504
+ > Returns:无
3505
+
3506
+ ### remove_section_connection_stage
3507
+ > **说明**
3508
+ > 删除施工阶段联合截面
3509
+ > **参数**
3510
+ > - name:名称
3511
+ >
3512
+ > **示例代码**
3513
+ > ```Python
3514
+ > from qtmodel import *
3515
+ > mdb.remove_section_connection_stage(name="联合阶段")
3516
+ > ```
3517
+ > **返回**
3518
+ > Returns:无
3519
+
3520
+ ### add_element_to_connection_stage
3521
+ > **说明**
3522
+ > 添加单元到施工阶段联合截面
3523
+ > **参数**
3524
+ > - ele_id:单元号
3525
+ > - name:联合阶段名
3526
+ >
3527
+ > **示例代码**
3528
+ > ```Python
3529
+ > from qtmodel import *
3530
+ > mdb.add_element_to_connection_stage([1,2,3,4],"联合阶段")
3531
+ > ```
3532
+ > **返回**
3533
+ > Returns:无
3534
+
3535
+ ## 荷载组合操作
3536
+ ### add_load_combine
3537
+ > **说明**
3538
+ > 添加荷载组合
3539
+ > **参数**
3540
+ > - name:荷载组合名
3541
+ > - combine_type:荷载组合类型 1-叠加 2-判别 3-包络 4-SRss 5-AbsSum
3542
+ > - describe:描述
3543
+ > - combine_info:荷载组合信息 [(荷载工况类型,工况名,系数)...] 工况类型如下
3544
+ > _"ST"-静力荷载工况 "CS"-施工阶段荷载工况 "CB"-荷载组合
3545
+ > _"MV"-移动荷载工况 "SM"-沉降荷载工况_ "RS"-反应谱工况
3546
+ >
3547
+ > **示例代码**
3548
+ > ```Python
3549
+ > from qtmodel import *
3550
+ > mdb.add_load_combine(name="荷载组合1",combine_type=1,describe="无",combine_info=[("CS","合计值",1),("CS","恒载",1)])
3551
+ > ```
3552
+ > **返回**
3553
+ > Returns: 无
3554
+
3555
+ ### update_load_combine
3556
+ > **说明**
3557
+ > 更新荷载组合
3558
+ > **参数**
3559
+ > - name:荷载组合名
3560
+ > - new_name:新荷载组合名,默认不修改
3561
+ > - combine_type:荷载组合类型 (1-叠加 2-判别 3-包络)
3562
+ > - describe:描述
3563
+ > - combine_info:荷载组合信息 [(荷载工况类型,工况名,系数)...] 工况类型如下
3564
+ > _"ST"-静力荷载工况 "CS"-施工阶段荷载工况 "CB"-荷载组合
3565
+ > _"MV"-移动荷载工况 "SM"-沉降荷载工况
3566
+ >
3567
+ > **示例代码**
3568
+ > ```Python
3569
+ > from qtmodel import *
3570
+ > mdb.update_load_combine(name="荷载组合1",combine_type=1,describe="无",combine_info=[("CS","合计值",1),("CS","恒载",1)])
3571
+ > ```
3572
+ > **返回**
3573
+ > Returns: 无
3574
+
3575
+ ### remove_load_combine
3576
+ > **说明**
3577
+ > 删除荷载组合
3578
+ > **参数**
3579
+ > - name:指定删除荷载组合名,默认时则删除所有荷载组合
3580
+ >
3581
+ > **示例代码**
3582
+ > ```Python
3583
+ > from qtmodel import *
3584
+ > mdb.remove_load_combine(name="荷载组合1")
3585
+ > ```
3586
+ > **返回**
3587
+ > Returns: 无
3588
+
3589
+ # 视图与结果提取
3590
+ ## 视图控制
3591
+ ### display_node_id
3592
+ > **说明**
3593
+ > 设置节点号显示
3594
+ > **参数**
3595
+ > - show_id:是否打开节点号显示
3596
+ >
3597
+ > **示例代码**
3598
+ > ```Python
3599
+ > from qtmodel import *
3600
+ > odb.display_node_id()
3601
+ > odb.display_node_id(False)
3602
+ > ```
3603
+ > **返回**
3604
+ > Returns: 无
3605
+
3606
+ ### display_element_id
3607
+ > **说明**
3608
+ > 设置单元号显示
3609
+ > **参数**
3610
+ > - show_id:是否打开单元号显示
3611
+ >
3612
+ > **示例代码**
3613
+ > ```Python
3614
+ > from qtmodel import *
3615
+ > odb.display_element_id()
3616
+ > odb.display_element_id(False)
3617
+ > ```
3618
+ > **返回**
3619
+ > Returns: 无
3620
+
3621
+ ### set_view_camera
3622
+ > **说明**
3623
+ > 更改三维显示相机设置
3624
+ > **参数**
3625
+ > - camera_point: 相机坐标点
3626
+ > - focus_point: 相机焦点
3627
+ > - camera_rotate:相机绕XYZ旋转角度
3628
+ > - scale: 缩放系数
3629
+ >
3630
+ > **示例代码**
3631
+ > ```Python
3632
+ > from qtmodel import *
3633
+ > odb.set_view_camera(camera_point=(-100,-100,100),focus_point=(0,0,0))
3634
+ > ```
3635
+ > **返回**
3636
+ > Returns: 无
3637
+
3638
+ ### set_view_direction
3639
+ > **说明**
3640
+ > 更改三维显示默认视图
3641
+ > **参数**
3642
+ > - direction: 1-空间视图1 2-前视图 3-三维视图2 4-左视图 5-顶视图 6-右视图 7-空间视图3 8-后视图 9-空间视图4 10-底视图
3643
+ > - horizontal_degree:水平向旋转角度
3644
+ > - vertical_degree:竖向旋转角度
3645
+ > - scale:缩放系数
3646
+ >
3647
+ > **示例代码**
3648
+ > ```Python
3649
+ > from qtmodel import *
3650
+ > odb.set_view_direction(direction=1,scale=1.2)
3651
+ > ```
3652
+ > **返回**
3653
+ > Returns: 无
3654
+
3655
+ ### activate_structure
3656
+ > **说明**
3657
+ > 激活指定阶段和单元,默认激活所有
3658
+ > **参数**
3659
+ > - node_ids: 节点集合
3660
+ > - element_ids: 单元集合
3661
+ >
3662
+ > **示例代码**
3663
+ > ```Python
3664
+ > from qtmodel import *
3665
+ > odb.activate_structure(node_ids=[1,2,3],element_ids=[1,2,3])
3666
+ > ```
3667
+ > **返回**
3668
+ > Returns: 无
3669
+
3670
+ ### set_unit
3671
+ > **说明**
3672
+ > 修改视图显示时单位制,不影响建模
3673
+ > **参数**
3674
+ > - unit_force: 支持 N KN TONF KIPS LBF
3675
+ > - unit_length: 支持 M MM CM IN FT
3676
+ >
3677
+ > **示例代码**
3678
+ > ```Python
3679
+ > from qtmodel import *
3680
+ > odb.set_unit(unit_force="N",unit_length="M")
3681
+ > ```
3682
+ > **返回**
3683
+ > Returns: 无
3684
+
3685
+ ### remove_display
3686
+ > **说明**
3687
+ > 删除当前所有显示,包括边界荷载钢束等全部显示
3688
+ > **参数**
3689
+ >
3690
+ > **示例代码**
3691
+ > ```Python
3692
+ > from qtmodel import *
3693
+ > odb.remove_display()
3694
+ > ```
3695
+ > **返回**
3696
+ > Returns: 无
3697
+
3698
+ ### save_png
3699
+ > **说明**
3700
+ > 保存当前模型窗口图形信息
3701
+ > **参数**
3702
+ > - file_path: 文件全路径
3703
+ >
3704
+ > **示例代码**
3705
+ > ```Python
3706
+ > from qtmodel import *
3707
+ > odb.save_png(file_path=r"D:\\QT\\aa.png")
3708
+ > ```
3709
+ > **返回**
3710
+ > Returns: 无
3711
+
3712
+ ### set_render
3713
+ > **说明**
3714
+ > 消隐设置开关
3715
+ > **参数**
3716
+ > - flag: 默认设置打开消隐
3717
+ >
3718
+ > **示例代码**
3719
+ > ```Python
3720
+ > from qtmodel import *
3721
+ > odb.set_render(flag=True)
3722
+ > ```
3723
+ > **返回**
3724
+ > Returns: 无
3725
+
3726
+ ### change_construct_stage
3727
+ > **说明**
3728
+ > 消隐设置开关
3729
+ > **参数**
3730
+ > - stage: 施工阶段名称或施工阶段号 0-基本
3731
+ >
3732
+ > **示例代码**
3733
+ > ```Python
3734
+ > from qtmodel import *
3735
+ > odb.change_construct_stage(0)
3736
+ > odb.change_construct_stage(stage=1)
3737
+ > ```
3738
+ > **返回**
3739
+ > Returns: 无
3740
+
3741
+ ## 静力结果查看
3742
+ ### get_element_stress
3743
+ > **说明**
3744
+ > 获取单元应力,支持单个单元和单元列表
3745
+ > **参数**
3746
+ > - element_id: 单元编号,支持整数或整数型列表
3747
+ > - stage_id: 施工阶段号 -1-运营阶段 0-施工阶段包络 n-施工阶段号
3748
+ > - result_kind: 施工阶段数据的类型 1-合计 2-收缩徐变效应 3-预应力效应 4-恒载
3749
+ > - increment_type: 1-全量 2-增量
3750
+ > - case_name: 运营阶段所需荷载工况名
3751
+ >
3752
+ > **示例代码**
3753
+ > ```Python
3754
+ > from qtmodel import *
3755
+ > odb.get_element_stress(element_id=1,stage_id=1)
3756
+ > odb.get_element_stress(element_id=[1,2,3],stage_id=1)
3757
+ > odb.get_element_stress(element_id=1,stage_id=-1,case_name="工况名")
3758
+ > ```
3759
+ > **返回**
3760
+ > Returns: json字符串,包含信息为list[dict] or dict
3761
+
3762
+ ### get_element_force
3763
+ > **说明**
3764
+ > 获取单元内力,支持单个单元和单元列表
3765
+ > **参数**
3766
+ > - element_id: 单元编号
3767
+ > - stage_id: 施工阶段号 -1-运营阶段 0-施工阶段包络 n-施工阶段号
3768
+ > - result_kind: 施工阶段数据的类型 1-合计 2-收缩徐变效应 3-预应力效应 4-恒载
3769
+ > - increment_type: 1-全量 2-增量
3770
+ > - case_name: 运营阶段所需荷载工况名
3771
+ >
3772
+ > **示例代码**
3773
+ > ```Python
3774
+ > from qtmodel import *
3775
+ > odb.get_element_force(element_id=1,stage_id=1)
3776
+ > odb.get_element_force(element_id=[1,2,3],stage_id=1)
3777
+ > odb.get_element_force(element_id=1,stage_id=-1,case_name="工况名")
3778
+ > ```
3779
+ > **返回**
3780
+ > Returns: json字符串,包含信息为list[dict] or dict
3781
+
3782
+ ### get_reaction
3783
+ > **说明**
3784
+ > 获取节点反力
3785
+ > **参数**
3786
+ > - node_id: 节点编号,支持整数或整数型列表
3787
+ > - stage_id: 施工阶段号 -1-运营阶段 0-施工阶段包络 n-施工阶段号
3788
+ > - result_kind: 施工阶段数据的类型 1-合计 2-收缩徐变效应 3-预应力效应 4-恒载
3789
+ > - increment_type: 1-全量 2-增量
3790
+ > - case_name: 运营阶段所需荷载工况名
3791
+ >
3792
+ > **示例代码**
3793
+ > ```Python
3794
+ > from qtmodel import *
3795
+ > odb.get_reaction(node_id=1,stage_id=1)
3796
+ > odb.get_reaction(node_id=[1,2,3],stage_id=1)
3797
+ > odb.get_reaction(node_id=1,stage_id=-1,case_name="工况名")
3798
+ > ```
3799
+ > **返回**
3800
+ > Returns: json字符串,包含信息为list[dict] or dict
3801
+
3802
+ ### get_node_displacement
3803
+ > **说明**
3804
+ > 获取节点,支持单个节点和节点列表
3805
+ > **参数**
3806
+ > - node_id: 节点号
3807
+ > - stage_id: 施工阶段号 -1-运营阶段 0-施工阶段包络 n-施工阶段号
3808
+ > - result_kind: 施工阶段数据的类型 1-合计 2-收缩徐变效应 3-预应力效应 4-恒载
3809
+ > - increment_type: 1-全量 2-增量
3810
+ > - case_name: 运营阶段所需荷载工况名
3811
+ >
3812
+ > **示例代码**
3813
+ > ```Python
3814
+ > from qtmodel import *
3815
+ > odb.get_node_displacement(node_id=1,stage_id=1)
3816
+ > odb.get_node_displacement(node_id=[1,2,3],stage_id=1)
3817
+ > odb.get_node_displacement(node_id=1,stage_id=-1,case_name="工况名")
3818
+ > ```
3819
+ > **返回**
3820
+ > Returns: json字符串,包含信息为list[dict] or dict
3821
+
3822
+ ### get_self_concurrent_reaction
3823
+ > **说明**
3824
+ > 获取自并发反力
3825
+ > **参数**
3826
+ > - node_id:节点号
3827
+ > - case_name:工况号
3828
+ >
3829
+ > **示例代码**
3830
+ > ```Python
3831
+ > from qtmodel import *
3832
+ > odb.get_self_concurrent_reaction(node_id=1,case_name="工况1_Fx最大")
3833
+ > ```
3834
+ > **返回**
3835
+ > Returns: json字符串,包含信息为dict
3836
+
3837
+ ### get_all_concurrent_reaction
3838
+ > **说明**
3839
+ > 获取完全并发反力
3840
+ > **参数**
3841
+ > - node_id:节点号
3842
+ > - case_name:工况号
3843
+ >
3844
+ > **示例代码**
3845
+ > ```Python
3846
+ > from qtmodel import *
3847
+ > odb.get_all_concurrent_reaction(node_id=1,case_name="工况1_Fx最大")
3848
+ > ```
3849
+ > **返回**
3850
+ > Returns: json字符串,包含信息为dict
3851
+
3852
+ ### get_beam_concurrent_force
3853
+ > **说明**
3854
+ > 获取梁单元并发内力
3855
+ > **参数**
3856
+ > - ele_id:单元号
3857
+ > - case_name:工况号
3858
+ >
3859
+ > **示例代码**
3860
+ > ```Python
3861
+ > from qtmodel import *
3862
+ > odb.get_beam_concurrent_force(ele_id=1,case_name="工况1_Fx最大")
3863
+ > ```
3864
+ > **返回**
3865
+ > Returns: json字符串,包含信息为dict
3866
+
3867
+ ### get_composite_beam_concurrent_force
3868
+ > **说明**
3869
+ > 获取组合梁单元并发内力
3870
+ > **参数**
3871
+ > - ele_id:单元号
3872
+ > - case_name:工况号
3873
+ >
3874
+ > **示例代码**
3875
+ > ```Python
3876
+ > from qtmodel import *
3877
+ > odb.get_composite_beam_concurrent_force(ele_id=1,case_name="工况1_Fx最大")
3878
+ > ```
3879
+ > **返回**
3880
+ > Returns: json字符串,包含信息为dict
3881
+
3882
+ ## 动力结果查看
3883
+ ### get_vibration_node_displacement
3884
+ > **说明**
3885
+ > 获取指定节点指定模态的振型向量
3886
+ > **参数**
3887
+ > - node_id: 节点号
3888
+ > - mode: 模态号
3889
+ >
3890
+ > **示例代码**
3891
+ > ```Python
3892
+ > from qtmodel import *
3893
+ > odb.get_vibration_node_displacement(node_id=1,mode=1)
3894
+ > ```
3895
+ > **返回**
3896
+ > Returns: json字符串,包含信息为list[dict] or dict
3897
+
3898
+ ### get_period_and_frequency
3899
+ > **说明**
3900
+ > 获取周期和频率
3901
+ > **参数**
3902
+ > - mode:模态号
3903
+ >
3904
+ > **示例代码**
3905
+ > ```Python
3906
+ > from qtmodel import *
3907
+ > odb.get_period_and_frequency(mode=1)
3908
+ > ```
3909
+ > **返回**
3910
+ > Returns: json字符串,包含信息为dict
3911
+
3912
+ ### get_participation_mass
3913
+ > **说明**
3914
+ > 获取振型参与质量百分比
3915
+ > **参数**
3916
+ > - mode:模态号
3917
+ >
3918
+ > **示例代码**
3919
+ > ```Python
3920
+ > from qtmodel import *
3921
+ > odb.get_participation_mass(mode=1)
3922
+ > ```
3923
+ > **返回**
3924
+ > Returns: json字符串,包含信息为dict
3925
+
3926
+ ### get_participation_factor
3927
+ > **说明**
3928
+ > 获取振型参与质量系数
3929
+ > **参数**
3930
+ > - mode:模态号
3931
+ >
3932
+ > **示例代码**
3933
+ > ```Python
3934
+ > from qtmodel import *
3935
+ > odb.get_participation_factor(mode=1)
3936
+ > ```
3937
+ > **返回**
3938
+ > Returns: json字符串,包含信息为dict
3939
+
3940
+ ## 绘制模型结果
3941
+ ### plot_reaction_result
3942
+ > **说明**
3943
+ > 保存结果图片到指定文件甲
3944
+ > **参数**
3945
+ > - file_path: 保存路径名
3946
+ > - stage_id: -1-运营阶段 0-施工阶段包络 n-施工阶段号
3947
+ > - load_case_name: 详细荷载工况名,参考桥通结果输出,例如: CQ:成桥(合计)
3948
+ > - show_increment: 是否显示增量结果
3949
+ > - envelope_type: 施工阶段包络类型 1-最大 2-最小
3950
+ > - component: 分量编号 0-Fx 1-Fy 2-Fz 3-Fxyz 4-Mx 5-My 6-Mz 7-Mxyz
3951
+ > - show_number: 数值选项卡开启
3952
+ > - show_legend: 图例选项卡开启
3953
+ > - text_rotation: 数值选项卡内文字旋转角度
3954
+ > - max_min_kind: 数值选项卡内最大最小值显示 -1-不显示最大最小值 0-显示最大值和最小值 1-最大绝对值 2-最大值 3-最小值
3955
+ > - digital_count: 小数点位数
3956
+ > - show_exponential: 指数显示开启
3957
+ > - arrow_scale:箭头大小
3958
+ >
3959
+ > **示例代码**
3960
+ > ```Python
3961
+ > from qtmodel import *
3962
+ > odb.plot_reaction_result(file_path=r"D:\\图片\\反力图.png",component=0,load_case_name="CQ:成桥(合计)",stage_id=-1)
3963
+ > ```
3964
+ > **返回**
3965
+ > Returns: 无
3966
+
3967
+ ### plot_displacement_result
3968
+ > **说明**
3969
+ > 保存结果图片到指定文件甲
3970
+ > **参数**
3971
+ > - file_path: 保存路径名
3972
+ > - stage_id: -1-运营阶段 0-施工阶段包络 n-施工阶段号
3973
+ > - load_case_name: 详细荷载工况名,参考桥通结果输出,例如: CQ:成桥(合计)
3974
+ > - show_increment: 是否显示增量结果
3975
+ > - envelope_type: 施工阶段包络类型 1-最大 2-最小
3976
+ > - component: 分量编号 0-Dx 1-Dy 2-Dz 3-Rx 4-Ry 5-Rz 6-Dxy 7-Dyz 8-Dxz 9-Dxyz
3977
+ > - show_deformed: 变形选项卡开启
3978
+ > - deformed_scale:变形比例
3979
+ > - deformed_actual:是否显示实际变形
3980
+ > - show_number: 数值选项卡开启
3981
+ > - text_rotation: 数值选项卡内文字旋转角度
3982
+ > - max_min_kind: 数值选项卡内最大最小值显示 -1-不显示最大最小值 0-显示最大值和最小值 1-最大绝对值 2-最大值 3-最小值
3983
+ > - show_legend: 图例选项卡开启
3984
+ > - digital_count: 小数点位数
3985
+ > - show_exponential: 指数显示开启
3986
+ > - show_pre_deformed: 显示变形前
3987
+ >
3988
+ > **示例代码**
3989
+ > ```Python
3990
+ > from qtmodel import *
3991
+ > odb.plot_displacement_result(file_path=r"D:\\图片\\变形图.png",component=0,load_case_name="CQ:成桥(合计)",stage_id=-1)
3992
+ > ```
3993
+ > **返回**
3994
+ > Returns: 无
3995
+
3996
+ ### plot_beam_element_force
3997
+ > **说明**
3998
+ > 绘制梁单元结果图并保存到指定文件
3999
+ > **参数**
4000
+ > - file_path: 保存路径名
4001
+ > - stage_id: -1-运营阶段 0-施工阶段包络 n-施工阶段号
4002
+ > - load_case_name: 详细荷载工况名,参考桥通结果输出,例如: CQ:成桥(合计)
4003
+ > - show_increment: 是否显示增量结果
4004
+ > - envelope_type: 施工阶段包络类型 1-最大 2-最小
4005
+ > - component: 分量编号 0-Dx 1-Dy 2-Dz 3-Rx 4-Ry 5-Rz 6-Dxy 7-Dyz 8-Dxz 9-Dxyz
4006
+ > - show_line_chart: 折线图选项卡开启
4007
+ > - line_scale:折线图比例
4008
+ > - flip_plot:反向绘制
4009
+ > - show_deformed: 变形选项卡开启
4010
+ > - deformed_scale:变形比例
4011
+ > - deformed_actual:是否显示实际变形
4012
+ > - show_number: 数值选项卡开启
4013
+ > - text_rotation: 数值选项卡内文字旋转角度
4014
+ > - digital_count: 小数点位数
4015
+ > - show_exponential: 指数显示开启
4016
+ > - max_min_kind: 数值选项卡内最大最小值显示 -1-不显示最大最小值 0-显示最大值和最小值 1-最大绝对值 2-最大值 3-最小值
4017
+ > - show_legend: 图例选项卡开启
4018
+ > - show_pre_deformed: 显示变形前
4019
+ > - position: 位置编号 0-始端 1-末端 2-绝对最大 4-全部
4020
+ >
4021
+ > **示例代码**
4022
+ > ```Python
4023
+ > from qtmodel import *
4024
+ > odb.plot_beam_element_force(file_path=r"D:\\图片\\梁内力.png",component=0,load_case_name="CQ:成桥(合计)",stage_id=-1)
4025
+ > ```
4026
+ > **返回**
4027
+ > Returns: 无
4028
+
4029
+ ### plot_truss_element_force
4030
+ > **说明**
4031
+ > 绘制杆单元结果图并保存到指定文件
4032
+ > **参数**
4033
+ > - file_path: 保存路径名
4034
+ > - stage_id: -1-运营阶段 0-施工阶段包络 n-施工阶段号
4035
+ > - load_case_name: 详细荷载工况名,参考桥通结果输出,例如: CQ:成桥(合计)
4036
+ > - show_increment: 是否显示增量结果
4037
+ > - envelope_type: 施工阶段包络类型 1-最大 2-最小
4038
+ > - component: 分量编号 0-N 1-Fx 2-Fy 3-Fz
4039
+ > - show_line_chart: 折线图选项卡开启
4040
+ > - line_scale:折线图比例
4041
+ > - flip_plot:反向绘制
4042
+ > - show_deformed: 变形选项卡开启
4043
+ > - deformed_scale:变形比例
4044
+ > - deformed_actual:是否显示实际变形
4045
+ > - show_number: 数值选项卡开启
4046
+ > - text_rotation: 数值选项卡内文字旋转角度
4047
+ > - digital_count: 小数点位数
4048
+ > - show_exponential: 指数显示开启
4049
+ > - max_min_kind: 数值选项卡内最大最小值显示 -1-不显示最大最小值 0-显示最大值和最小值 1-最大绝对值 2-最大值 3-最小值
4050
+ > - show_legend: 图例选项卡开启
4051
+ > - show_pre_deformed: 显示变形前
4052
+ > - position: 位置编号 0-始端 1-末端 2-绝对最大 4-全部
4053
+ >
4054
+ > **示例代码**
4055
+ > ```Python
4056
+ > from qtmodel import *
4057
+ > odb.plot_truss_element_force(file_path=r"D:\\图片\\杆内力.png",load_case_name="CQ:成桥(合计)",stage_id=-1)
4058
+ > ```
4059
+ > **返回**
4060
+ > Returns: 无
4061
+
4062
+ ### plot_plate_element_force
4063
+ > **说明**
4064
+ > 绘制板单元结果图并保存到指定文件
4065
+ > **参数**
4066
+ > - file_path: 保存路径名
4067
+ > - component: 分量编号 0-Fxx 1-Fyy 2-Fxy 3-Mxx 4-Myy 5-Mxy
4068
+ > - force_kind: 力类型
4069
+ > - load_case_name: 详细荷载工况名
4070
+ > - stage_id: 阶段编号
4071
+ > - envelope_type: 包络类型
4072
+ > - show_number: 是否显示数值
4073
+ > - show_deformed: 是否显示变形形状
4074
+ > - show_pre_deformed: 是否显示未变形形状
4075
+ > - deformed_actual: 是否显示实际变形
4076
+ > - deformed_scale: 变形比例
4077
+ > - show_legend: 是否显示图例
4078
+ > - text_rotation_angle: 数值选项卡内文字旋转角度
4079
+ > - digital_count: 小数点位数
4080
+ > - show_exponential: 是否以指数形式显示
4081
+ > - max_min_kind: 最大最小值显示类型
4082
+ > - show_increment: 是否显示增量结果
4083
+ >
4084
+ > **示例代码**
4085
+ > ```Python
4086
+ > from qtmodel import *
4087
+ > odb.plot_plate_element_force(file_path=r"D:\\图片\\板内力.png",component=0,load_case_name="CQ:成桥(合计)",stage_id=-1)
4088
+ > ```
4089
+ > **返回**
4090
+ > Returns: 无
4091
+
4092
+ ### plot_composite_beam_force
4093
+ > **说明**
4094
+ > 绘制组合梁单元结果图并保存到指定文件
4095
+ > **参数**
4096
+ > - file_path: 保存路径名
4097
+ > - stage_id: -1-运营阶段 0-施工阶段包络 n-施工阶段号
4098
+ > - load_case_name: 详细荷载工况名,参考桥通结果输出,例如: CQ:成桥(合计)
4099
+ > - show_increment: 是否显示增量结果
4100
+ > - envelope_type: 施工阶段包络类型 1-最大 2-最小
4101
+ > - mat_type: 材料类型 0-主材 1-辅材 2-主材+辅材
4102
+ > - component: 分量编号 0-Fx 1-Fy 2-Fz 3-Mx 4-My 5-Mz
4103
+ > - show_line_chart: 折线图选项卡开启
4104
+ > - line_scale:折线图比例
4105
+ > - flip_plot:反向绘制
4106
+ > - show_deformed: 变形选项卡开启
4107
+ > - deformed_scale:变形比例
4108
+ > - deformed_actual:是否显示实际变形
4109
+ > - show_number: 数值选项卡开启
4110
+ > - text_rotation: 数值选项卡内文字旋转角度
4111
+ > - digital_count: 小数点位数
4112
+ > - show_exponential: 指数显示开启
4113
+ > - max_min_kind: 数值选项卡内最大最小值显示 -1-不显示最大最小值 0-显示最大值和最小值 1-最大绝对值 2-最大值 3-最小值
4114
+ > - show_legend: 图例选项卡开启
4115
+ > - show_pre_deformed: 显示变形前
4116
+ > - position: 位置编号 0-始端 1-末端 2-绝对最大 4-全部
4117
+ >
4118
+ > **示例代码**
4119
+ > ```Python
4120
+ > from qtmodel import *
4121
+ > odb.plot_composite_beam_force(file_path=r"D:\\图片\\组合梁内力.png",mat_type=0,component=0,load_case_name="CQ:成桥(合计)",stage_id=-1)
4122
+ > ```
4123
+ > **返回**
4124
+ > Returns: 无
4125
+
4126
+ ### plot_beam_element_stress
4127
+ > **说明**
4128
+ > 绘制梁单元应力结果图并保存到指定文件
4129
+ > **参数**
4130
+ > - file_path: 保存路径名
4131
+ > - stage_id: -1-运营阶段 0-施工阶段包络 n-施工阶段号
4132
+ > - load_case_name: 详细荷载工况名,参考桥通结果输出,例如: CQ:成桥(合计)
4133
+ > - show_increment: 是否显示增量结果
4134
+ > - envelope_type: 施工阶段包络类型 1-最大 2-最小
4135
+ > - component: 分量编号 0-轴力分量 1-Mz分量 2-My分量 3-组合包络 4-左上 5-右上 6-右下 7-左下
4136
+ > - show_line_chart: 折线图选项卡开启
4137
+ > - line_scale:折线图比例
4138
+ > - flip_plot:反向绘制
4139
+ > - show_deformed: 变形选项卡开启
4140
+ > - deformed_scale:变形比例
4141
+ > - deformed_actual:是否显示实际变形
4142
+ > - show_number: 数值选项卡开启
4143
+ > - text_rotation: 数值选项卡内文字旋转角度
4144
+ > - digital_count: 小数点位数
4145
+ > - show_exponential: 指数显示开启
4146
+ > - max_min_kind: 数值选项卡内最大最小值显示 -1-不显示最大最小值 0-显示最大值和最小值 1-最大绝对值 2-最大值 3-最小值
4147
+ > - show_legend: 图例选项卡开启
4148
+ > - show_pre_deformed: 显示变形前
4149
+ > - position: 位置编号 0-始端 1-末端 2-绝对最大 4-全部
4150
+ >
4151
+ > **示例代码**
4152
+ > ```Python
4153
+ > from qtmodel import *
4154
+ > odb.plot_beam_element_stress(file_path=r"D:\\图片\\梁应力.png",show_line_chart=False,component=0,load_case_name="CQ:成桥(合计)",stage_id=-1)
4155
+ > ```
4156
+ > **返回**
4157
+ > Returns: 无
4158
+
4159
+ ### plot_truss_element_stress
4160
+ > **说明**
4161
+ > 绘制杆单元结果图并保存到指定文件
4162
+ > **参数**
4163
+ > - file_path: 保存路径名
4164
+ > - stage_id: -1-运营阶段 0-施工阶段包络 n-施工阶段号
4165
+ > - load_case_name: 详细荷载工况名,参考桥通结果输出,例如: CQ:成桥(合计)
4166
+ > - show_increment: 是否显示增量结果
4167
+ > - envelope_type: 施工阶段包络类型 1-最大 2-最小
4168
+ > - show_line_chart: 折线图选项卡开启
4169
+ > - line_scale:折线图比例
4170
+ > - flip_plot:反向绘制
4171
+ > - show_deformed: 变形选项卡开启
4172
+ > - deformed_scale:变形比例
4173
+ > - deformed_actual:是否显示实际变形
4174
+ > - show_number: 数值选项卡开启
4175
+ > - text_rotation: 数值选项卡内文字旋转角度
4176
+ > - digital_count: 小数点位数
4177
+ > - show_exponential: 指数显示开启
4178
+ > - max_min_kind: 数值选项卡内最大最小值显示 -1-不显示最大最小值 0-显示最大值和最小值 1-最大绝对值 2-最大值 3-最小值
4179
+ > - show_legend: 图例选项卡开启
4180
+ > - show_pre_deformed: 显示变形前
4181
+ > - position: 位置编号 0-始端 1-末端 2-绝对最大 4-全部
4182
+ >
4183
+ > **示例代码**
4184
+ > ```Python
4185
+ > from qtmodel import *
4186
+ > odb.plot_truss_element_stress(file_path=r"D:\\图片\\杆应力.png",load_case_name="CQ:成桥(合计)",stage_id=-1)
4187
+ > ```
4188
+ > **返回**
4189
+ > Returns: 无
4190
+
4191
+ ### plot_composite_beam_stress
4192
+ > **说明**
4193
+ > 绘制组合梁单元结果图并保存到指定文件
4194
+ > **参数**
4195
+ > - file_path: 保存路径名
4196
+ > - stage_id: -1-运营阶段 0-施工阶段包络 n-施工阶段号
4197
+ > - load_case_name: 详细荷载工况名,参考桥通结果输出,例如: CQ:成桥(合计)
4198
+ > - show_increment: 是否显示增量结果
4199
+ > - envelope_type: 施工阶段包络类型 1-最大 2-最小
4200
+ > - mat_type: 材料类型 0-主材 1-辅材
4201
+ > - component: 分量编号 0-轴力分量 1-Mz分量 2-My分量 3-包络 4-左上 5-右上 6-左下 7-右下
4202
+ > - show_line_chart: 折线图选项卡开启
4203
+ > - line_scale:折线图比例
4204
+ > - flip_plot:反向绘制
4205
+ > - show_deformed: 变形选项卡开启
4206
+ > - deformed_scale:变形比例
4207
+ > - deformed_actual:是否显示实际变形
4208
+ > - show_number: 数值选项卡开启
4209
+ > - text_rotation: 数值选项卡内文字旋转角度
4210
+ > - digital_count: 小数点位数
4211
+ > - show_exponential: 指数显示开启
4212
+ > - max_min_kind: 数值选项卡内最大最小值显示 -1-不显示最大最小值 0-显示最大值和最小值 1-最大绝对值 2-最大值 3-最小值
4213
+ > - show_legend: 图例选项卡开启
4214
+ > - show_pre_deformed: 显示变形前
4215
+ > - position: 位置编号 0-始端 1-末端 2-绝对最大 4-全部
4216
+ >
4217
+ > **示例代码**
4218
+ > ```Python
4219
+ > from qtmodel import *
4220
+ > odb.plot_composite_beam_stress(file_path=r"D:\\图片\\组合梁应力.png",component=0,load_case_name="CQ:成桥(合计)",stage_id=-1)
4221
+ > ```
4222
+ > **返回**
4223
+ > Returns: 无
4224
+
4225
+ ### plot_plate_element_stress
4226
+ > **说明**
4227
+ > 绘制板单元结果图并保存到指定文件
4228
+ > **参数**
4229
+ > - file_path: 保存路径名
4230
+ > - component: 分量编号 0-Fxx 1-Fyy 2-Fxy 3-Mxx 4-Myy 5-Mxy
4231
+ > - stress_kind: 力类型 0-单元 1-节点平均
4232
+ > - load_case_name: 详细荷载工况名
4233
+ > - stage_id: 阶段编号
4234
+ > - envelope_type: 包络类型
4235
+ > - show_number: 是否显示数值
4236
+ > - show_deformed: 是否显示变形形状
4237
+ > - show_pre_deformed: 是否显示未变形形状
4238
+ > - deformed_actual: 是否显示实际变形
4239
+ > - deformed_scale: 变形比例
4240
+ > - show_legend: 是否显示图例
4241
+ > - text_rotation_angle: 数值选项卡内文字旋转角度
4242
+ > - digital_count: 小数点位数
4243
+ > - show_exponential: 是否以指数形式显示
4244
+ > - max_min_kind: 最大最小值显示类型
4245
+ > - show_increment: 是否显示增量结果
4246
+ > - position: 位置 0-板顶 1-板底 2-绝对值最大
4247
+ >
4248
+ > **示例代码**
4249
+ > ```Python
4250
+ > from qtmodel import *
4251
+ > odb.plot_plate_element_stress(file_path=r"D:\\图片\\板应力.png",component=0,load_case_name="CQ:成桥(合计)",stage_id=-1)
4252
+ > ```
4253
+ > **返回**
4254
+ > Returns: 无
4255
+
4256
+ ### plot_vibration_mode
4257
+ > **说明**
4258
+ > 绘制板单元结果图并保存到指定文件
4259
+ > **参数**
4260
+ > - file_path: 保存路径名
4261
+ > - mode: 模态号
4262
+ > - show_number: 是否显示数值
4263
+ > - show_pre_deformed: 是否显示未变形形状
4264
+ > - show_legend: 是否显示图例
4265
+ > - text_rotation_angle: 数值选项卡内文字旋转角度
4266
+ > - digital_count: 小数点位数
4267
+ > - show_exponential: 是否以指数形式显示
4268
+ > - max_min_kind: 最大最小值显示类型
4269
+ >
4270
+ > **示例代码**
4271
+ > ```Python
4272
+ > from qtmodel import *
4273
+ > odb.plot_vibration_mode(file_path=r"D:\\图片\\自振模态.png",mode=1)
4274
+ > ```
4275
+ > **返回**
4276
+ > Returns: 无
4277
+
4278
+ ## 获取模型信息
4279
+ ### get_element_by_point
4280
+ > **说明**
4281
+ > 获取某一点指定范围内单元集合,单元中心点为节点平均值
4282
+ > **参数**
4283
+ > - x: 坐标x
4284
+ > - y: 坐标y
4285
+ > - z: 坐标z
4286
+ > - tolerance:容许范围,默认为1
4287
+ >
4288
+ > **示例代码**
4289
+ > ```Python
4290
+ > from qtmodel import *
4291
+ > odb.get_element_by_point(0.5,0.5,0.5,tolerance=1)
4292
+ > ```
4293
+ > **返回**
4294
+ > Returns: json字符串,包含信息为list[int]
4295
+
4296
+ ### get_element_by_material
4297
+ > **说明**
4298
+ > 获取某一材料相应的单元
4299
+ > **参数**
4300
+ > - name:材料名称
4301
+ >
4302
+ > **示例代码**
4303
+ > ```Python
4304
+ > from qtmodel import *
4305
+ > odb.get_element_by_material("材料1")
4306
+ > ```
4307
+ > **返回**
4308
+ > Returns: json字符串,包含信息为list[int]
4309
+
4310
+ ### get_overlap_nodes
4311
+ > **说明**
4312
+ > 获取重合节点
4313
+ > **参数**
4314
+ > - round_num: 判断精度,默认小数点后四位
4315
+ >
4316
+ > **示例代码**
4317
+ > ```Python
4318
+ > from qtmodel import *
4319
+ > odb.get_overlap_nodes()
4320
+ > ```
4321
+ > **返回**
4322
+ > Returns: json字符串,包含信息为list[list[int]]
4323
+
4324
+ ### get_overlap_elements
4325
+ > **说明**
4326
+ > 获取重合节点
4327
+ > **参数**
4328
+ >
4329
+ > **示例代码**
4330
+ > ```Python
4331
+ > from qtmodel import *
4332
+ > odb.get_overlap_elements()
4333
+ > ```
4334
+ > **返回**
4335
+ > Returns: json字符串,包含信息为list[list[int]]
4336
+
4337
+ ### get_structure_group_names
4338
+ > **说明**
4339
+ > 获取结构组名称
4340
+ > **参数**
4341
+ >
4342
+ > **示例代码**
4343
+ > ```Python
4344
+ > from qtmodel import *
4345
+ > odb.get_structure_group_names()
4346
+ > ```
4347
+ > **返回**
4348
+ > Returns: json字符串,包含信息为list[str]
4349
+
4350
+ ### get_thickness_data
4351
+ > **说明**
4352
+ > 获取所有板厚信息
4353
+ > **参数**
4354
+ >
4355
+ > **示例代码**
4356
+ > ```Python
4357
+ > from qtmodel import *
4358
+ > odb.get_thickness_data(1)
4359
+ > ```
4360
+ > **返回**
4361
+ > Returns:
4362
+
4363
+ ### get_all_thickness_data
4364
+ > **说明**
4365
+ > 获取所有板厚信息
4366
+ > **参数**
4367
+ >
4368
+ > **示例代码**
4369
+ > ```Python
4370
+ > from qtmodel import *
4371
+ > odb.get_all_thickness_data()
4372
+ > ```
4373
+ > **返回**
4374
+ > Returns: json字符串,包含信息为list[dict]
4375
+
4376
+ ### get_all_section_shape
4377
+ > **说明**
4378
+ > 获取所有截面形状信息
4379
+ > **参数**
4380
+ >
4381
+ > **示例代码**
4382
+ > ```Python
4383
+ > from qtmodel import *
4384
+ > odb.get_all_section_shape()
4385
+ > ```
4386
+ > **返回**
4387
+ > Returns: json字符串,包含信息为list[dict]
4388
+
4389
+ ### get_section_shape
4390
+ > **说明**
4391
+ > 获取截面形状信息
4392
+ > **参数**
4393
+ > - sec_id: 目标截面编号
4394
+ >
4395
+ > **示例代码**
4396
+ > ```Python
4397
+ > from qtmodel import *
4398
+ > odb.get_section_shape(1)
4399
+ > ```
4400
+ > **返回**
4401
+ > Returns:
4402
+
4403
+ ### get_all_section_data
4404
+ > **说明**
4405
+ > 获取所有截面详细信息,截面特性详见UI自定义特性截面
4406
+ > **参数**
4407
+ >
4408
+ > **示例代码**
4409
+ > ```Python
4410
+ > from qtmodel import *
4411
+ > odb.get_all_section_data()
4412
+ > ```
4413
+ > **返回**
4414
+ > Returns: json字符串,包含信息为list[dict]
4415
+
4416
+ ### get_section_data
4417
+ > **说明**
4418
+ > 获取截面详细信息,截面特性详见UI自定义特性截面
4419
+ > **参数**
4420
+ > - sec_id: 目标截面编号
4421
+ >
4422
+ > **示例代码**
4423
+ > ```Python
4424
+ > from qtmodel import *
4425
+ > odb.get_section_data(1)
4426
+ > ```
4427
+ > **返回**
4428
+ > Returns: json字符串,包含信息为dict
4429
+
4430
+ ### get_section_property
4431
+ > **说明**
4432
+ > 获取指定截面特性
4433
+ > **参数**
4434
+ > - index:截面号
4435
+ >
4436
+ > **示例代码**
4437
+ > ```Python
4438
+ > from qtmodel import *
4439
+ > odb.get_section_property(1)
4440
+ > ```
4441
+ > **返回**
4442
+ > Returns: dict
4443
+
4444
+ ### get_section_ids
4445
+ > **说明**
4446
+ > 获取模型所有截面号
4447
+ > **参数**
4448
+ >
4449
+ > **示例代码**
4450
+ > ```Python
4451
+ > from qtmodel import *
4452
+ > odb.get_section_ids()
4453
+ > ```
4454
+ > **返回**
4455
+ > Returns: list[int]
4456
+
4457
+ ### get_node_id
4458
+ > **说明**
4459
+ > 获取节点编号,结果为-1时则表示未找到该坐标节点
4460
+ > **参数**
4461
+ > - x: 目标点X轴坐标
4462
+ > - y: 目标点Y轴坐标
4463
+ > - z: 目标点Z轴坐标
4464
+ > - tolerance: 距离容许误差
4465
+ >
4466
+ > **示例代码**
4467
+ > ```Python
4468
+ > from qtmodel import *
4469
+ > odb.get_node_id(x=1,y=1,z=1)
4470
+ > ```
4471
+ > **返回**
4472
+ > Returns: int
4473
+
4474
+ ### get_group_elements
4475
+ > **说明**
4476
+ > 获取结构组单元编号
4477
+ > **参数**
4478
+ > - group_name: 结构组名
4479
+ >
4480
+ > **示例代码**
4481
+ > ```Python
4482
+ > from qtmodel import *
4483
+ > odb.get_group_elements(group_name="默认结构组")
4484
+ > ```
4485
+ > **返回**
4486
+ > Returns: list[int]
4487
+
4488
+ ### get_group_nodes
4489
+ > **说明**
4490
+ > 获取结构组节点编号
4491
+ > **参数**
4492
+ > - group_name: 结构组名
4493
+ >
4494
+ > **示例代码**
4495
+ > ```Python
4496
+ > from qtmodel import *
4497
+ > odb.get_group_nodes(group_name="默认结构组")
4498
+ > ```
4499
+ > **返回**
4500
+ > Returns: list[int]
4501
+
4502
+ ### get_node_data
4503
+ > **说明**
4504
+ > 获取节点信息 默认获取所有节点信息
4505
+ > **参数**
4506
+ >
4507
+ > **示例代码**
4508
+ > ```Python
4509
+ > from qtmodel import *
4510
+ > odb.get_node_data() # 获取所有节点信息
4511
+ > odb.get_node_data(ids=1) # 获取单个节点信息
4512
+ > odb.get_node_data(ids=[1,2]) # 获取多个节点信息
4513
+ > ```
4514
+ > **返回**
4515
+ > Returns: json字符串,包含信息为list[dict] or dict
4516
+
4517
+ ### get_element_data
4518
+ > **说明**
4519
+ > 获取单元信息
4520
+ > **参数**
4521
+ > - ids:单元号,支持整数或整数型列表,默认为None时获取所有单元信息
4522
+ >
4523
+ > **示例代码**
4524
+ > ```Python
4525
+ > from qtmodel import *
4526
+ > odb.get_element_data() # 获取所有单元结果
4527
+ > odb.get_element_data(ids=1) # 获取指定编号单元信息
4528
+ > ```
4529
+ > **返回**
4530
+ > Returns: json字符串,包含信息为list[dict] or dict
4531
+
4532
+ ### get_element_type
4533
+ > **说明**
4534
+ > 获取单元类型
4535
+ > **参数**
4536
+ > - ele_id: 单元号
4537
+ >
4538
+ > **示例代码**
4539
+ > ```Python
4540
+ > from qtmodel import *
4541
+ > odb.get_element_type(ele_id=1) # 获取1号单元类型
4542
+ > ```
4543
+ > **返回**
4544
+ > Returns: str
4545
+
4546
+ ### get_beam_element
4547
+ > **说明**
4548
+ > 获取梁单元信息
4549
+ > **参数**
4550
+ > - ids: 梁单元号,默认时获取所有梁单元
4551
+ >
4552
+ > **示例代码**
4553
+ > ```Python
4554
+ > from qtmodel import *
4555
+ > odb.get_beam_element() # 获取所有单元信息
4556
+ > ```
4557
+ > **返回**
4558
+ > Returns: list[str] 其中str为json格式
4559
+
4560
+ ### get_plate_element
4561
+ > **说明**
4562
+ > 获取板单元信息
4563
+ > **参数**
4564
+ > - ids: 板单元号,默认时获取所有板单元
4565
+ >
4566
+ > **示例代码**
4567
+ > ```Python
4568
+ > from qtmodel import *
4569
+ > odb.get_plate_element() # 获取所有单元信息
4570
+ > ```
4571
+ > **返回**
4572
+ > Returns: list[str] 其中str为json格式
4573
+
4574
+ ### get_cable_element
4575
+ > **说明**
4576
+ > 获取索单元信息
4577
+ > **参数**
4578
+ > - ids: 索单元号,默认时获取所有索单元
4579
+ >
4580
+ > **示例代码**
4581
+ > ```Python
4582
+ > from qtmodel import *
4583
+ > odb.get_cable_element() # 获取所有单元信息
4584
+ > ```
4585
+ > **返回**
4586
+ > Returns: list[str] 其中str为json格式
4587
+
4588
+ ### get_link_element
4589
+ > **说明**
4590
+ > 获取杆单元信息
4591
+ > **参数**
4592
+ > - ids: 杆单元号,默认时输出全部杆单元
4593
+ >
4594
+ > **示例代码**
4595
+ > ```Python
4596
+ > from qtmodel import *
4597
+ > odb.get_link_element() # 获取所有单元信息
4598
+ > ```
4599
+ > **返回**
4600
+ > Returns: list[str] 其中str为json格式
4601
+
4602
+ ### get_material_data
4603
+ > **说明**
4604
+ > 获取材料信息
4605
+ > **参数**
4606
+ >
4607
+ > **示例代码**
4608
+ > ```Python
4609
+ > from qtmodel import *
4610
+ > odb.get_material_data() # 获取所有材料信息
4611
+ > ```
4612
+ > **返回**
4613
+ > Returns: json字符串,包含信息为list[dict]
4614
+
4615
+ ### get_concrete_material
4616
+ > **说明**
4617
+ > 获取混凝土材料信息
4618
+ > **参数**
4619
+ > - ids: 材料号,默认时输出全部材料
4620
+ >
4621
+ > **示例代码**
4622
+ > ```Python
4623
+ > from qtmodel import *
4624
+ > odb.get_concrete_material() # 获取所有材料信息
4625
+ > ```
4626
+ > **返回**
4627
+ > Returns: list[str] 其中str为json格式
4628
+
4629
+ ### get_steel_plate_material
4630
+ > **说明**
4631
+ > 获取钢材材料信息
4632
+ > **参数**
4633
+ > - ids: 材料号,默认时输出全部材料
4634
+ >
4635
+ > **示例代码**
4636
+ > ```Python
4637
+ > from qtmodel import *
4638
+ > odb.get_steel_plate_material() # 获取所有钢材材料信息
4639
+ > ```
4640
+ > **返回**
4641
+ > Returns: list[str] 其中str为json格式
4642
+
4643
+ ### get_pre_stress_bar_material
4644
+ > **说明**
4645
+ > 获取钢材材料信息
4646
+ > **参数**
4647
+ > - ids: 材料号,默认时输出全部材料
4648
+ >
4649
+ > **示例代码**
4650
+ > ```Python
4651
+ > from qtmodel import *
4652
+ > odb.get_pre_stress_bar_material() # 获取所有预应力材料信息
4653
+ > ```
4654
+ > **返回**
4655
+ > Returns: list[str] 其中str为json格式
4656
+
4657
+ ### get_steel_bar_material
4658
+ > **说明**
4659
+ > 获取钢筋材料信息
4660
+ > **参数**
4661
+ > - ids: 材料号,默认时输出全部材料
4662
+ >
4663
+ > **示例代码**
4664
+ > ```Python
4665
+ > from qtmodel import *
4666
+ > odb.get_steel_bar_material() # 获取所有钢筋材料信息
4667
+ > ```
4668
+ > **返回**
4669
+ > Returns: list[str] 其中str为json格式
4670
+
4671
+ ### get_user_###ine_material
4672
+ > **说明**
4673
+ > 获取自定义材料信息
4674
+ > **参数**
4675
+ > - ids: 材料号,默认时输出全部材料
4676
+ >
4677
+ > **示例代码**
4678
+ > ```Python
4679
+ > from qtmodel import *
4680
+ > odb.get_user_define_material() # 获取所有自定义材料信息
4681
+ > ```
4682
+ > **返回**
4683
+ > Returns: list[str] 其中str为json格式
4684
+
4685
+ ## 获取模型边界信息
4686
+ ### get_boundary_group_names
4687
+ > **说明**
4688
+ > 获取自边界组名称
4689
+ > **参数**
4690
+ >
4691
+ > **示例代码**
4692
+ > ```Python
4693
+ > from qtmodel import *
4694
+ > odb.get_boundary_group_names()
4695
+ > ```
4696
+ > **返回**
4697
+ > Returns: json字符串,包含信息为list[str]
4698
+
4699
+ ### get_general_support_data
4700
+ > **说明**
4701
+ > 获取一般支承信息
4702
+ > **参数**
4703
+ > - group_name:默认输出所有边界组信息
4704
+ >
4705
+ > **示例代码**
4706
+ > ```Python
4707
+ > from qtmodel import *
4708
+ > odb.get_general_support_data()
4709
+ > ```
4710
+ > **返回**
4711
+ > Returns: json字符串,包含信息为list[dict]
4712
+
4713
+ ### get_elastic_link_data
4714
+ > **说明**
4715
+ > 获取弹性连接信息
4716
+ > **参数**
4717
+ > - group_name:默认输出所有边界组信息
4718
+ >
4719
+ > **示例代码**
4720
+ > ```Python
4721
+ > from qtmodel import *
4722
+ > odb.get_elastic_link_data()
4723
+ > ```
4724
+ > **返回**
4725
+ > Returns: json字符串,包含信息为list[dict]
4726
+
4727
+ ### get_elastic_support_data
4728
+ > **说明**
4729
+ > 获取弹性支承信息
4730
+ > **参数**
4731
+ > - group_name:默认输出所有边界组信息
4732
+ >
4733
+ > **示例代码**
4734
+ > ```Python
4735
+ > from qtmodel import *
4736
+ > odb.get_elastic_support_data()
4737
+ > ```
4738
+ > **返回**
4739
+ > Returns: json字符串,包含信息为list[dict]
4740
+
4741
+ ### get_master_slave_link_data
4742
+ > **说明**
4743
+ > 获取主从连接信息
4744
+ > **参数**
4745
+ > - group_name:默认输出所有边界组信息
4746
+ >
4747
+ > **示例代码**
4748
+ > ```Python
4749
+ > from qtmodel import *
4750
+ > odb.get_master_slave_link_data()
4751
+ > ```
4752
+ > **返回**
4753
+ > Returns: json字符串,包含信息为list[dict]
4754
+
4755
+ ### get_node_local_axis_data
4756
+ > **说明**
4757
+ > 获取节点坐标信息
4758
+ > **参数**
4759
+ >
4760
+ > **示例代码**
4761
+ > ```Python
4762
+ > from qtmodel import *
4763
+ > odb.get_node_local_axis_data()
4764
+ > ```
4765
+ > **返回**
4766
+ > Returns: json字符串,包含信息为list[dict]
4767
+
4768
+ ### get_beam_constraint_data
4769
+ > **说明**
4770
+ > 获取节点坐标信息
4771
+ > **参数**
4772
+ > - group_name:默认输出所有边界组信息
4773
+ >
4774
+ > **示例代码**
4775
+ > ```Python
4776
+ > from qtmodel import *
4777
+ > odb.get_beam_constraint_data()
4778
+ > ```
4779
+ > **返回**
4780
+ > Returns: json字符串,包含信息为list[dict]
4781
+
4782
+ ### get_constraint_equation_data
4783
+ > **说明**
4784
+ > 获取约束方程信息
4785
+ > **参数**
4786
+ > - group_name:默认输出所有边界组信息
4787
+ >
4788
+ > **示例代码**
4789
+ > ```Python
4790
+ > from qtmodel import *
4791
+ > odb.get_constraint_equation_data()
4792
+ > ```
4793
+ > **返回**
4794
+ > Returns: json字符串,包含信息为list[dict]
4795
+
4796
+ ## 获取施工阶段信息
4797
+ ### get_stage_name
4798
+ > **说明**
4799
+ > 获取所有施工阶段名称
4800
+ > **参数**
4801
+ >
4802
+ > **示例代码**
4803
+ > ```Python
4804
+ > from qtmodel import *
4805
+ > odb.get_stage_name()
4806
+ > ```
4807
+ > **返回**
4808
+ > Returns: json字符串,包含信息为list[int]
4809
+
4810
+ ### get_elements_of_stage
4811
+ > **说明**
4812
+ > 获取指定施工阶段单元编号信息
4813
+ > **参数**
4814
+ > - stage_id: 施工阶段编号
4815
+ >
4816
+ > **示例代码**
4817
+ > ```Python
4818
+ > from qtmodel import *
4819
+ > odb.get_elements_of_stage(stage_id=1)
4820
+ > ```
4821
+ > **返回**
4822
+ > Returns: json字符串,包含信息为list[int]
4823
+
4824
+ ### get_nodes_of_stage
4825
+ > **说明**
4826
+ > 获取指定施工阶段节点编号信息
4827
+ > **参数**
4828
+ > - stage_id: 施工阶段编号
4829
+ >
4830
+ > **示例代码**
4831
+ > ```Python
4832
+ > from qtmodel import *
4833
+ > odb.get_nodes_of_stage(stage_id=1)
4834
+ > ```
4835
+ > **返回**
4836
+ > Returns: json字符串,包含信息为list[int]
4837
+
4838
+ ### get_groups_of_stage
4839
+ > **说明**
4840
+ > 获取施工阶段结构组、边界组、荷载组名集合
4841
+ > **参数**
4842
+ > - stage_id: 施工阶段编号
4843
+ >
4844
+ > **示例代码**
4845
+ > ```Python
4846
+ > from qtmodel import *
4847
+ > odb.get_groups_of_stage(stage_id=1)
4848
+ > ```
4849
+ > **返回**
4850
+ > Returns: json字符串,包含信息为dict
4851
+
4852
+ ## 荷载信息
4853
+ ### get_load_case_names
4854
+ > **说明**
4855
+ > 获取荷载工况名
4856
+ > **参数**
4857
+ >
4858
+ > **示例代码**
4859
+ > ```Python
4860
+ > from qtmodel import *
4861
+ > odb.get_load_case_names()
4862
+ > ```
4863
+ > **返回**
4864
+ > Returns: json字符串,包含信息为list[str]
4865
+
4866
+ ### get_pre_stress_load
4867
+ > **说明**
4868
+ > 获取预应力荷载
4869
+ > **参数**
4870
+ > - case_name: 荷载工况名
4871
+ >
4872
+ > **示例代码**
4873
+ > ```Python
4874
+ > from qtmodel import *
4875
+ > odb.get_pre_stress_load(case_name="荷载工况1")
4876
+ > ```
4877
+ > **返回**
4878
+ > Returns: json字符串,包含信息为list[dict]
4879
+
4880
+ ### get_node_mass_data
4881
+ > **说明**
4882
+ > 获取节点质量
4883
+ > **参数**
4884
+ >
4885
+ > **示例代码**
4886
+ > ```Python
4887
+ > from qtmodel import *
4888
+ > odb.get_node_mass_data()
4889
+ > ```
4890
+ > **返回**
4891
+ > Returns: json字符串,包含信息为list[dict]
4892
+
4893
+ ### get_nodal_force_load
4894
+ > **说明**
4895
+ > 获取节点力荷载
4896
+ > **参数**
4897
+ > - case_name: 荷载工况名
4898
+ >
4899
+ > **示例代码**
4900
+ > ```Python
4901
+ > from qtmodel import *
4902
+ > odb.get_nodal_force_load(case_name="荷载工况1")
4903
+ > ```
4904
+ > **返回**
4905
+ > Returns: json字符串,包含信息为list[dict]
4906
+
4907
+ ### get_nodal_displacement_load
4908
+ > **说明**
4909
+ > 获取节点位移荷载
4910
+ > **参数**
4911
+ > - case_name: 荷载工况名
4912
+ >
4913
+ > **示例代码**
4914
+ > ```Python
4915
+ > from qtmodel import *
4916
+ > odb.get_nodal_displacement_load(case_name="荷载工况1")
4917
+ > ```
4918
+ > **返回**
4919
+ > Returns: json字符串,包含信息为list[dict]
4920
+
4921
+ ### get_beam_element_load
4922
+ > **说明**
4923
+ > 获取梁单元荷载
4924
+ > **参数**
4925
+ > - case_name: 荷载工况名
4926
+ >
4927
+ > **示例代码**
4928
+ > ```Python
4929
+ > from qtmodel import *
4930
+ > odb.get_beam_element_load(case_name="荷载工况1")
4931
+ > ```
4932
+ > **返回**
4933
+ > Returns: json字符串,包含信息为list[dict]
4934
+
4935
+ ### get_plate_element_load
4936
+ > **说明**
4937
+ > 获取梁单元荷载
4938
+ > **参数**
4939
+ > - case_name: 荷载工况名
4940
+ >
4941
+ > **示例代码**
4942
+ > ```Python
4943
+ > from qtmodel import *
4944
+ > odb.get_beam_element_load(case_name="荷载工况1")
4945
+ > ```
4946
+ > **返回**
4947
+ > Returns: json字符串,包含信息为list[dict]
4948
+
4949
+ ### get_initial_tension_load
4950
+ > **说明**
4951
+ > 获取初拉力荷载数据
4952
+ > **参数**
4953
+ > - case_name: 荷载工况名
4954
+ >
4955
+ > **示例代码**
4956
+ > ```Python
4957
+ > from qtmodel import *
4958
+ > odb.get_initial_tension_load(case_name="荷载工况1")
4959
+ > ```
4960
+ > **返回**
4961
+ > Returns: json字符串,包含信息为list[dict]
4962
+
4963
+ ### get_cable_length_load
4964
+ > **说明**
4965
+ > 获取指定荷载工况的初拉力荷载数据
4966
+ > **参数**
4967
+ > - case_name: 荷载工况名
4968
+ >
4969
+ > **示例代码**
4970
+ > ```Python
4971
+ > from qtmodel import *
4972
+ > odb.get_cable_length_load(case_name="荷载工况1")
4973
+ > ```
4974
+ > **返回**
4975
+ > Returns: json字符串,包含信息为list[dict]
4976
+
4977
+ ### get_deviation_parameter
4978
+ > **说明**
4979
+ > 获取制造偏差参数
4980
+ > **参数**
4981
+ >
4982
+ > **示例代码**
4983
+ > ```Python
4984
+ > from qtmodel import *
4985
+ > odb.get_deviation_parameter()
4986
+ > ```
4987
+ > **返回**
4988
+ > Returns: json字符串,包含信息为list[dict]
4989
+
4990
+ ### get_deviation_load
4991
+ > **说明**
4992
+ > 获取指定荷载工况的制造偏差荷载
4993
+ > **参数**
4994
+ > - case_name:荷载工况名
4995
+ >
4996
+ > **示例代码**
4997
+ > ```Python
4998
+ > from qtmodel import *
4999
+ > odb.get_deviation_load(case_name="荷载工况1")
5000
+ > ```
5001
+ > **返回**
5002
+ > Returns: json字符串,包含信息为list[dict]
5003
+
5004
+
5005
+