qtmodel 2.3.0__tar.gz → 2.3.3__tar.gz

{qtmodel-2.3.0 → qtmodel-2.3.3}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: qtmodel
-Version: 2.3.0
+Version: 2.3.3
 Summary: qtmodel package
 Author: Your Name
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 
-> 最新qtmodel版本 2.3.0 - 2026-05-19 
+> 最新qtmodel版本 2.3.3 - 2026-06-02 
 > pip install --upgrade qtmodel -i https://pypi.org/simple
 - 增加运行分析等待时间参数
 # 建模操作 
@@ -161,6 +161,26 @@ mdb.add_elements(ele_data=[
 [4,4,1,1,0,1,2,3,4,0]])
 #Returns: 无
 ```  
+### add_beam_between
+根据起始节点和终止节点平均添加或按间距添加梁单元。
+> 参数:  
+> start_id: 新建单元起始编号  
+> end_id: 新建单元终止编号  
+> node_start: 起始节点号  
+> node_end: 终止节点号  
+> beta_angle: beta角，默认0  
+> mat_id: 材料号，默认1  
+> sec_id: 截面号，默认1  
+> gap: 间距列表；数量等于 end_id - start_id + 1 时按间距创建，否则C#侧按等分创建  
+> using_exist_node: 是否优先使用已有重合节点，默认True  
+```Python
+# 示例代码
+from qtmodel import *
+mdb.add_beam_between(start_id=1001,end_id=1010,
+node_start=1,node_end=20,beta_angle=0,mat_id=1,
+sec_id=1,gap=[2.0] * 10,using_exist_node=True)
+#Returns: 无
+```  
 ### revert_local_orientation
 反转杆系单元局部方向
 > 参数:  
@@ -201,6 +221,20 @@ from qtmodel import *
 mdb.update_element(old_id=1,ele_type=1,node_ids=[1,2],beta_angle=1,mat_id=1,sec_id=1)
 #Returns: 无
 ```  
+### update_frame_type
+修改杆系单元类型
+> 参数:  
+> element_ids: 需要修改的单元编号列表  
+> element_type: 单元类型 1-梁 2-杆 3-索  
+> initial_type: 索单元初始参数类型 1-初始拉力 2-初始水平力 3-无应力长度  
+> initial_value: 索单元初始参数值  
+```Python
+# 示例代码
+from qtmodel import *
+mdb.update_frame_type(element_ids=[1, 2, 3], element_type=1)
+mdb.update_frame_type(element_ids=[101, 102], element_type=3, initial_type=1, initial_value=100)
+#Returns:
+```  
 ### update_element_material
 更新指定单元的材料号
 > 参数:  
@@ -223,6 +257,17 @@ from qtmodel import *
 mdb.update_element_beta(ids=1,beta=90)
 #Returns: 无
 ```  
+### update_element_section
+更新杆系单元截面或板单元板厚
+> 参数:  
+> ids: 单元编号,支持整形、列表、XtoYbyZ形式字符串  
+> sec_id: 截面号或板厚号  
+```Python
+# 示例代码
+from qtmodel import *
+mdb.update_element_section(ids=1,sec_id=2)
+#Returns: 无
+```  
 ### update_frame_section
 更新杆系单元截面
 > 参数:  
@@ -728,6 +773,48 @@ mdb.update_view_stage(stage_name="一次成桥")
 #Returns: 无
 ```  
 ##  截面
+### add_parameter_section
+添加参数化截面
+> 参数:  
+> index: 截面编号,默认自动识别  
+> name:截面名称  
+> sec_type:参数截面类型名称  
+> sec_info:只填写截面参数  
+> sec_property:截面特性(参考UI界面共计29个参数)，可选参数，指定截面特性时不进行截面计算  
+> bias_type:偏心类型 默认中心  
+> center_type:中心类型 默认质心  
+> shear_consider:考虑剪切 bool 默认考虑剪切变形  
+> bias_x:自定义偏心点x坐标 (仅自定义类型偏心需要,相对于center_type偏移)  
+> bias_y:自定义偏心点y坐标 (仅自定义类型偏心需要,相对于center_type偏移)  
+```Python
+# 示例代码
+from qtmodel import *
+mdb.add_parameter_section(
+index=271,
+name="新建矩形截面271",
+sec_type="矩形",
+sec_info={"W": 2, "H": 2}
+)
+mdb.add_parameter_section(
+index=271, name="新建混凝土箱梁271", sec_type="混凝土箱梁",
+sec_info=dict(B=24, N=3, H=2, symmetry=True, H1=0.2, H2=0.4,
+H2a=0.1, H2b=0.13, B1=3, B1a=1, B1b=2, B2=1, i1=0.02,
+i2=0, B0=12, B3=5, B4=6, T1=0.28, T2=0.3, T3=0.5, T4=0.5,
+R1=0.5, R2=0.2, C1="1*0.2,0.1*0.2", C2="0.5*0.15,0.3*0.2",
+C3="0.4*0.2", C4="0.5*0.2")
+)
+mdb.add_parameter_section(
+index=271,
+name="新建带肋钢梁271",
+sec_type="带肋钢梁",
+sec_info={
+"tb": 0.016,"H": 2.5,"Nh": 4,"Nv": 4,"hrt": 0.25,
+"hrw": 0.2,"trt": 0.016,"trw": 0.016,"dh": 0.3,
+"dv": 0.5,"tt": 0.016,"tw": 0.02,"W": 2
+}
+)
+#Returns: 无
+```  
 ### add_section
 添加单一截面信息,如果截面号存在则自动覆盖添加
 > 参数:  
@@ -1413,6 +1500,54 @@ from qtmodel import *
 mdb.update_element_component_type(ids=[1,2,3,4],component_type=2)
 #Returns: 无
 ```  
+### update_tendon
+更新钢束信息，支持二维钢束和三维钢束
+> 参数:  
+> name: 原钢束名称  
+> new_name: 新钢束名称，为空时不修改名称  
+> tendon_2d: 是否为二维钢束，True-二维钢束，False-三维钢束  
+> property_name: 钢束特性名称  
+> group_name: 钢束组名称  
+> num: 根数  
+> line_type: 线型，1-导线点，2-折线点  
+> symmetry: 二维钢束对称点，0-左端点，1-右端点，2-不对称  
+> control_points:  
+> 二维钢束控制点: [(x1,z1,r1),(x2,z2,r2),...]  
+> 三维钢束控制点: [(x1,y1,z1,r1),(x2,y2,z2,r2),...]  
+> control_points_lateral: 二维钢束横弯控制点 [(x1,y1,r1),(x2,y2,r2),...]，无横弯时不必输入  
+> position_type: 定位方式，1-直线，2-轨迹线  
+> point_insert:  
+> 直线时为插入点坐标 [x,y,z]  
+> 轨迹线时为 [插入端(1-I 2-J), 插入方向(1-ij 2-ji), 插入单元id]  
+> tendon_direction: 直线钢束X方向向量，默认为x轴即 [1,0,0]，轨迹线不用赋值  
+> rotation_angle: 绕钢束旋转角度  
+> rotate_bias: 绕钢束旋转偏心 X、Y  
+> track_group: 轨迹线结构组名，直线时不用赋值  
+> projection: 直线钢束是否投影  
+```Python
+# 示例代码
+from qtmodel import *
+mdb.update_tendon(
+name="BB1",
+new_name="BB2",
+tendon_2d=True,
+property_name="22-15",
+num=2,
+position_type=1,
+control_points=[(0, -1, 0), (10, -1, 0)],
+point_insert=(0, 0, 0)
+)
+mdb.update_tendon(
+name="BB1",
+tendon_2d=False,
+property_name="22-15",
+num=2,
+position_type=1,
+control_points=[(0, 0, -1, 0), (10, 0, -1, 0)],
+point_insert=(0, 0, 0)
+)
+#Returns:
+```  
 ### update_tendon_group
 更新钢束组名
 > 参数:  
@@ -2965,7 +3100,7 @@ mdb.update_bulking_setting(do_analysis=True,mode_count=3,variable_cases=["工况
 # 示例代码
 from qtmodel import *
 odb.get_material_data() # 获取所有材料信息
-#Returns: 包含信息为list[dict]
+#Returns: list[dict]
 ```  
 ### get_thickness_data
 获取所有板厚信息
@@ -3020,7 +3155,7 @@ from qtmodel import *
 odb.get_node_data()     # 获取所有节点信息
 odb.get_node_data(ids=1)    # 获取单个节点信息
 odb.get_node_data(ids=[1,2])    # 获取多个节点信息
-#Returns:  包含信息为list[dict] or dict
+#Returns:  list[Node]
 ```  
 ##  获取单元信息
 ### get_elements_by_point
@@ -3067,12 +3202,41 @@ odb.get_overlap_elements()
 ```  
 ### get_structure_group_names
 获取结构组名称
+```Python
+# 示例代码
+from qtmodel import *
+names = odb.get_structure_group_names()
+#Returns:
+```  
+### get_structure_group
+获取结构组具体信息
 > 参数:  
+> group_name:结构组名称  
 ```Python
 # 示例代码
 from qtmodel import *
-odb.get_structure_group_names()
-#Returns: 包含信息为list[str]
+names = odb.get_structure_group()
+#Returns:
+```  
+### get_structure_group_element_ids
+获取结构组单元号
+> 参数:  
+> group_name:结构组名称  
+```Python
+# 示例代码
+from qtmodel import *
+names = odb.get_structure_group_element_ids("结构组1")
+#Returns:
+```  
+### get_structure_group_node_ids
+获取结构组节点号
+> 参数:  
+> group_name:结构组名称  
+```Python
+# 示例代码
+from qtmodel import *
+names = odb.get_structure_group_node_ids("结构组1")
+#Returns:
 ```  
 ### get_element_data
 获取单元信息
@@ -3081,8 +3245,17 @@ odb.get_structure_group_names()
 ```Python
 # 示例代码
 from qtmodel import *
-odb.get_element_data() # 获取所有单元结果
-odb.get_element_data(ids=1) # 获取指定编号单元信息
+odb.get_element_data() # 获取所有单元信息
+odb.get_element_data(ids=[1,2,3,4]) # 获取指定编号单元信息
+#Returns:  包含信息为list[Element]
+```  
+### get_all_element_ids
+获取所有单元节点号
+> 参数:  
+```Python
+# 示例代码
+from qtmodel import *
+odb.get_all_element_ids() # 获取所有单元信息
 #Returns:  包含信息为list[dict] or dict
 ```  
 ### get_element_type
@@ -3113,7 +3286,7 @@ odb.get_group_elements(group_name="默认结构组")
 # 示例代码
 from qtmodel import *
 odb.get_element_weight(ids=1)
-#Returns: dict<int,double>类型的json格式字符串
+#Returns: dict<int,float>
 ```  
 ##  跨度信息
 ### get_span_data
@@ -3165,7 +3338,7 @@ odb.get_section_shape(1)
 # 示例代码
 from qtmodel import *
 odb.get_section_data(1)
-#Returns: 包含信息为dict
+#Returns: dict
 ```  
 ### get_section_property
 获取指定截面特性
@@ -3470,7 +3643,7 @@ odb.get_reaction(ids=1,stage_id=1)
 odb.get_reaction(ids=[1,2,3],stage_id=1)
 odb.get_reaction(ids="1to3",stage_id=1)
 odb.get_reaction(ids=1,stage_id=-1,case_name="工况名")
-#Returns: 返回json字符串， 内部为list[dict]
+#Returns: 内部为list[dict]
 ```  
 ### get_deformation
 获取节点变形结果,支持单个节点和节点列表
@@ -3490,7 +3663,7 @@ odb.get_deformation(ids=1,stage_id=1)
 odb.get_deformation(ids=[1,2,3],stage_id=1)
 odb.get_deformation(ids="1to3",stage_id=1)
 odb.get_deformation(ids=1,stage_id=-1,case_name="工况名")
-#Returns: 返回json字符串， 内部为list[dict]
+#Returns: list[dict]
 ```  
 ### get_element_stress
 获取单元应力,支持单个单元和单元列表
@@ -3507,7 +3680,7 @@ from qtmodel import *
 odb.get_element_stress(ids=1,stage_id=1)
 odb.get_element_stress(ids=[1,2,3],stage_id=1)
 odb.get_element_stress(ids=1,stage_id=-1,case_name="工况名")
-#Returns: 返回json字符串， 内部为list[dict]
+#Returns: 内部为list[dict]
 ```  
 ### get_element_force
 获取单元内力,支持单个单元和单元列表
@@ -3526,7 +3699,7 @@ from qtmodel import *
 odb.get_element_force(ids=1,stage_id=1)
 odb.get_element_force(ids=[1,2,3],stage_id=1)
 odb.get_element_force(ids=1,stage_id=-1,case_name="工况名")
-#Returns: 返回json字符串， 内部为list[dict]
+#Returns: list[dict]
 ```  
 ### get_self_concurrent_reaction
 获取自并发反力
@@ -3537,7 +3710,7 @@ odb.get_element_force(ids=1,stage_id=-1,case_name="工况名")
 # 示例代码
 from qtmodel import *
 odb.get_self_concurrent_reaction(node_id=1,case_name="工况1_Fx最大")
-#Returns: 返回json字符串， 内部为list[dict]
+#Returns: list[dict]
 ```  
 ### get_all_concurrent_reaction
 获取完全并发反力
@@ -3548,7 +3721,7 @@ odb.get_self_concurrent_reaction(node_id=1,case_name="工况1_Fx最大")
 # 示例代码
 from qtmodel import *
 odb.get_all_concurrent_reaction(node_id=1,case_name="工况1_Fx最大")
-#Returns: 返回json字符串， 包含信息为list[dict]
+#Returns: list[dict]
 ```  
 ### get_concurrent_force
 获取单元并发内力
@@ -3560,7 +3733,7 @@ odb.get_all_concurrent_reaction(node_id=1,case_name="工况1_Fx最大")
 from qtmodel import *
 odb.get_concurrent_force(ids=1,case_name="工况1_Fx最大")
 odb.get_concurrent_force(ids="1to19",case_name="工况1_Fx最大")
-#Returns: 返回json字符串， 包含信息为list[dict]
+#Returns: list[dict]
 ```  
 ### get_elastic_link_force
 获取弹性连接内力
@@ -3575,7 +3748,7 @@ odb.get_concurrent_force(ids="1to19",case_name="工况1_Fx最大")
 # 示例代码
 from qtmodel import *
 odb.get_elastic_link_force(ids=[1,2,3], result_kind=1, stage_id=1)
-#Returns: 返回json字符串， 内部为list[dict]
+#Returns: list[dict]
 ```  
 ### get_constrain_equation_force
 查询约束方程内力
@@ -3590,7 +3763,7 @@ odb.get_elastic_link_force(ids=[1,2,3], result_kind=1, stage_id=1)
 # 示例代码
 from qtmodel import *
 odb.get_constrain_equation_force(ids=[1,2,3], result_kind=1, stage_id=1)
-#Returns: 返回json字符串， 内部为list[dict]
+#Returns: list[dict]
 ```  
 ### get_cable_element_length
 查询无应力索长
@@ -3602,7 +3775,7 @@ odb.get_constrain_equation_force(ids=[1,2,3], result_kind=1, stage_id=1)
 # 示例代码
 from qtmodel import *
 odb.get_cable_element_length(ids=[1,2,3], stage_id=1)
-#Returns: 返回json字符串， 内部为list[dict]
+#Returns: list[dict]
 ```  
 ### get_period_and_vibration_results
 获取自振分析角频率和振型参与质量等结果
@@ -3611,7 +3784,7 @@ odb.get_cable_element_length(ids=[1,2,3], stage_id=1)
 # 示例代码
 from qtmodel import *
 odb.get_period_and_vibration_results()
-#Returns: 返回json字符串，list[dict]包含各模态周期和频率的列表
+#Returns: list[dict]
 ```  
 ### get_vibration_modal_results
 获取自振分析振型向量
@@ -3621,7 +3794,7 @@ odb.get_period_and_vibration_results()
 # 示例代码
 from qtmodel import *
 odb.get_vibration_modal_results(mode=1)
-#Returns: 返回json字符串，list[dict]包含该模态下节点位移向量列表
+#Returns: list[dict]
 ```  
 ### get_buckling_eigenvalue
 获取屈曲分析特征值结果
@@ -3630,7 +3803,7 @@ odb.get_vibration_modal_results(mode=1)
 # 示例代码
 from qtmodel import *
 odb.get_buckling_eigenvalue()
-#Returns: 返回json字符串， list[dict]包含各模态下特征值
+#Returns: list[dict]
 ```  
 ### get_buckling_modal_results
 获取屈曲模态向量
@@ -3640,7 +3813,7 @@ odb.get_buckling_eigenvalue()
 # 示例代码
 from qtmodel import *
 odb.get_buckling_modal_results(mode=1)
-#Returns: 返回json字符串，list[dict]包含该模态下屈曲模态向量列表
+#Returns: list[dict]
 ```  
 ### get_tendon_loss_results
 获取预应力钢束损失
@@ -3651,7 +3824,7 @@ odb.get_buckling_modal_results(mode=1)
 # 示例代码
 from qtmodel import *
 odb.get_tendon_loss_results(name="T1", stage_id=2)
-#Returns:
+#Returns: list[dict]
 ```  
 ### get_tendon_position_result
 获取预应力钢束坐标
@@ -3661,7 +3834,7 @@ odb.get_tendon_loss_results(name="T1", stage_id=2)
 # 示例代码
 from qtmodel import *
 odb.get_tendon_position_result(name="T1")
-#Returns:
+#Returns: list[dict]
 ```  
 ### get_tendon_length_result
 获取预应力伸长量
@@ -3670,7 +3843,7 @@ odb.get_tendon_position_result(name="T1")
 # 示例代码
 from qtmodel import *
 odb.get_tendon_length_result()
-#Returns:
+#Returns: list[dict]
 ```  
 ##  绘制模型结果
 ### plot_reaction_result
@@ -4688,17 +4861,6 @@ from qtmodel import *
 cdb.update_steel_box_stress_support_info(name="应力验算1", support_data=[[...]])
 #Returns:
 ```  
-### calculate_steel_box_stress_support_infos
-计算局部支承承压验算结果。
-> 参数:  
-> name: 应力验算工况名称。  
-> user_define: 是否使用用户自定义输入；0 使用程序默认或模型数据，1 使用用户输入。  
-```Python
-# 示例代码
-from qtmodel import *
-cdb.calculate_steel_box_stress_support_infos(name="应力验算1")
-#Returns:
-```  
 ### calc_steel_box_stress_support_infos
 计算局部支承承压验算结果。
 > 参数: