qtmodel 1.1.4__tar.gz → 1.1.6__tar.gz

{qtmodel-1.1.4 → qtmodel-1.1.6}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: qtmodel
-Version: 1.1.4
-Summary: python modeling for qt 2025-09-27 
+Version: 1.1.6
+Summary: python modeling for qt 2025-09-28 
 Home-page: https://github.com/Inface0443/pyqt
 Author: dqy-zhj
 Author-email: 1105417715@qq.com
@@ -17,7 +17,7 @@ Dynamic: description-content-type
 Dynamic: home-page
 Dynamic: summary
 
-> 最新版本 V1.1.4 - 2025-09-27 
+> 最新版本 V1.1.6 - 2025-09-28 
 > pip install --upgrade qtmodel -i https://pypi.org/simple
 - 新增更新结构组接口 
 # 建模操作 
@@ -681,10 +681,10 @@ mdb.add_tapper_section_by_id(name="变截面1",begin_id=1,end_id=2)
 #Returns: 无
 ```  
 ### update_single_section
-以字典形式添加单一截面
+todo 以字典形式添加单一截面
 > 参数:  
 > index:截面编号  
-> new_id:新截面编号，默认不修改截面编号  
+> new_id:新截面编号，默认为-1时不修改截面编号  
 > name:截面名称  
 > sec_type:截面类型  
 > sec_data:截面信息字典，键值参考添加add_section方法参数  
@@ -696,7 +696,7 @@ sec_data={"sec_info":[1,2],"bias_type":"中心"})
 #Returns: 无
 ```  
 ### update_tapper_section
-添加变截面,字典参数参考单一截面,如果截面存在则自动覆盖
+todo 添加变截面,字典参数参考单一截面,如果截面存在则自动覆盖
 > 参数:  
 > index:截面编号  
 > new_id:新截面编号，默认不修改截面编号  
@@ -715,7 +715,7 @@ sec_end={"sec_info":[2,2],"bias_type":"中心"})
 #Returns: 无
 ```  
 ### update_section_bias
-更新截面偏心
+todo 更新截面偏心
 > 参数:  
 > index:截面编号  
 > bias_type:偏心类型  
@@ -731,7 +731,7 @@ mdb.update_section_bias(index=1,bias_type="自定义",bias_point=[0.1,0.2])
 #Returns: 无
 ```  
 ### update_section_property
-更新截面特性
+todo 更新截面特性
 > 参数:  
 > index:截面号  
 > sec_property:截面特性值参考UI共计26个数值  
@@ -743,7 +743,7 @@ mdb.update_section_property(index=1,sec_property=[i for i in range(1,27)])
 #Returns: 无
 ```  
 ### update_section_id
-更新截面编号
+todo 更新截面编号
 > 参数:  
 > index: 原编号  
 > new_id: 新编号  
@@ -753,30 +753,10 @@ from qtmodel import *
 mdb.update_section_id(index=1,new_id=2)
 #Returns:无
 ```  
-### remove_tapper_section_group
-删除变截面组，默认删除所有变截面组
-> 参数:  
-> name:变截面组名称  
-```Python
-# 示例代码
-from qtmodel import *
-mdb.remove_tapper_section_group()
-mdb.remove_tapper_section_group("变截面组1")
-#Returns:无
-```  
-### remove_all_section
-删除全部截面信息
-> 参数:  
-```Python
-# 示例代码
-from qtmodel import *
-mdb.remove_all_section()
-#Returns: 无
-```  
 ### remove_section
-删除截面信息
+删除截面信息,默认则删除所有截面
 > 参数:  
-> index: 截面编号  
+> ids: 截面编号  
 ```Python
 # 示例代码
 from qtmodel import *
@@ -842,6 +822,10 @@ mdb.add_tapper_section_from_group("变截面组1")
 > ref_h: 高度方向参考点 0-i 1-j  
 > dis_w: 宽度方向距离  
 > dis_h: 高度方向距离  
+> parameter_info:参数化变截面组信息,键为参数名(参考UI)值为如下三种类型  
+> 1(非线性),指数,参考点(I/J),距离  
+> 2(自定义),变化长1,终点值1,变化长2,终点值2...  
+> 3(圆弧),半径,参考点(I/J)  
 ```Python
 # 示例代码
 from qtmodel import *
@@ -849,6 +833,17 @@ mdb.update_tapper_section_group(name="变截面组1",ids=[1,2,3,4])
 mdb.update_tapper_section_group(name="变截面组2",ids="1t0100")
 #Returns: 无
 ```  
+### remove_tapper_section_group
+删除变截面组，默认删除所有变截面组
+> 参数:  
+> name:变截面组名称  
+```Python
+# 示例代码
+from qtmodel import *
+mdb.remove_tapper_section_group()
+mdb.remove_tapper_section_group("变截面组1")
+#Returns:无
+```  
 ##  边界操作
 ### add_effective_width
 添加有效宽度系数
@@ -903,13 +898,14 @@ mdb.add_general_elastic_support(node_id=1, property_name = "特性1",group_name=
 添加一般支承
 > 参数:  
 > node_id:节点编号,支持整数或整数型列表且支持XtoYbyN形式字符串  
-> boundary_info:边界信息  [X,Y,Z,Rx,Ry,Rz]  ture-固定 false-自由  
+> boundary_info:边界信息  [X,Y,Z,Rx,Ry,Rz]  ture-固定 false-自由,也可传数值列表(0-自由 1-固定)  
 > group_name:边界组名,默认为默认边界组  
 ```Python
 # 示例代码
 from qtmodel import *
 mdb.add_general_support(node_id=1, boundary_info=[True,True,True,False,False,False])
 mdb.add_general_support(node_id="1to100", boundary_info=[True,True,True,False,False,False])
+mdb.add_general_support(node_id="1to100", boundary_info=[1,1,1,0,0,0])
 #Returns: 无
 ```  
 ### add_elastic_support
@@ -3417,7 +3413,7 @@ odb.get_section_ids()
 ```  
 ##  结果表格
 ### get_reaction
-获取节点反力
+获取制作反力
 > 参数:  
 > ids: 节点编号,支持整数或整数型列表支持XtoYbyN形式字符串  
 > envelop_type: 施工阶段包络类型 1-最大 2-最小  
@@ -3433,7 +3429,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: 包含信息为list[dict] or dict
+#Returns: 返回json字符串， 内部为list[dict]
 ```  
 ### get_deformation
 获取节点变形结果,支持单个节点和节点列表
@@ -3445,6 +3441,7 @@ odb.get_reaction(ids=1,stage_id=-1,case_name="工况名")
 > increment_type: 1-全量    2-增量  
 > case_name: 运营阶段所需荷载工况名  
 > is_time_history: 是否为时程分析  
+> is_local: 是否为输出局部坐标系  
 ```Python
 # 示例代码
 from qtmodel import *
@@ -3452,7 +3449,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: 多结果获取时返回list[dict] 单一结果获取时返回dict
+#Returns: 返回json字符串， 内部为list[dict]
 ```  
 ### get_element_stress
 获取单元应力,支持单个单元和单元列表
@@ -3469,7 +3466,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: 包含信息为list[dict] or dict
+#Returns: 返回json字符串， 内部为list[dict]
 ```  
 ### get_element_force
 获取单元内力,支持单个单元和单元列表
@@ -3488,7 +3485,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: 包含信息为list[dict] or dict
+#Returns: 返回json字符串， 内部为list[dict]
 ```  
 ### get_self_concurrent_reaction
 获取自并发反力
@@ -3499,7 +3496,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: 返回该节点并发反力值dict
+#Returns: 返回json字符串， 内部为list[dict]
 ```  
 ### get_all_concurrent_reaction
 获取完全并发反力
@@ -3510,7 +3507,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: 包含信息为list[dict]
+#Returns: 返回json字符串， 包含信息为list[dict]
 ```  
 ### get_concurrent_force
 获取单元并发内力
@@ -3522,7 +3519,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: 包含信息为list[dict]
+#Returns: 返回json字符串， 包含信息为list[dict]
 ```  
 ### get_elastic_link_force
 获取弹性连接内力
@@ -3537,7 +3534,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: 返回弹性连接内力列表list[dict] 或 dict(单一结果)
+#Returns: 返回json字符串， 内部为list[dict]
 ```  
 ### get_constrain_equation_force
 查询约束方程内力
@@ -3552,7 +3549,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: 返回约束方程内力列表list[dict] 或 dict(单一结果)
+#Returns: 返回json字符串， 内部为list[dict]
 ```  
 ### get_cable_element_length
 查询无应力索长
@@ -3564,7 +3561,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: 返回无应力索长列表list[dict] 或 dict(单一结果)
+#Returns: 返回json字符串， 内部为list[dict]
 ```  
 ### get_period_and_vibration_results
 获取自振分析角频率和振型参与质量等结果
@@ -3573,7 +3570,7 @@ odb.get_cable_element_length(ids=[1,2,3], stage_id=1)
 # 示例代码
 from qtmodel import *
 odb.get_period_and_vibration_results()
-#Returns:list[dict]包含各模态周期和频率的列表
+#Returns: 返回json字符串，list[dict]包含各模态周期和频率的列表
 ```  
 ### get_vibration_modal_results
 获取自振分析振型向量
@@ -3583,7 +3580,7 @@ odb.get_period_and_vibration_results()
 # 示例代码
 from qtmodel import *
 odb.get_vibration_modal_results(mode=1)
-#Returns:list[dict]包含该模态下节点位移向量列表
+#Returns: 返回json字符串，list[dict]包含该模态下节点位移向量列表
 ```  
 ### get_buckling_eigenvalue
 获取屈曲分析特征值
@@ -3592,7 +3589,7 @@ odb.get_vibration_modal_results(mode=1)
 # 示例代码
 from qtmodel import *
 odb.get_buckling_eigenvalue()
-#Returns: list[dict]包含各模态下特征值
+#Returns: 返回json字符串， list[dict]包含各模态下特征值
 ```  
 ### get_buckling_modal_results
 获取屈曲模态向量
@@ -3602,7 +3599,7 @@ odb.get_buckling_eigenvalue()
 # 示例代码
 from qtmodel import *
 odb.get_buckling_modal_results(mode=1)
-#Returns:list[dict]包含该模态下屈曲模态向量列表
+#Returns: 返回json字符串，list[dict]包含该模态下屈曲模态向量列表
 ```  
 ##  绘制模型结果
 ### plot_reaction_result
@@ -3628,7 +3625,7 @@ odb.get_buckling_modal_results(mode=1)
 # 示例代码
 from qtmodel import *
 odb.plot_reaction_result(file_path=r"D:\\图片\\反力图.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
-#Returns: 无
+#Returns: Base64字符串
 ```  
 ### plot_displacement_result
 保存结果图片到指定文件甲
@@ -3657,7 +3654,7 @@ odb.plot_reaction_result(file_path=r"D:\\图片\\反力图.png",component=1,case
 # 示例代码
 from qtmodel import *
 odb.plot_displacement_result(file_path=r"D:\\图片\\变形图.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
-#Returns: 无
+#Returns: Base64字符串
 ```  
 ### plot_beam_element_force
 绘制梁单元结果图并保存到指定文件
@@ -3689,7 +3686,7 @@ odb.plot_displacement_result(file_path=r"D:\\图片\\变形图.png",component=1,
 # 示例代码
 from qtmodel import *
 odb.plot_beam_element_force(file_path=r"D:\\图片\\梁内力.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
-#Returns: 无
+#Returns: Base64字符串
 ```  
 ### plot_truss_element_force
 绘制杆单元结果图并保存到指定文件
@@ -3721,7 +3718,7 @@ odb.plot_beam_element_force(file_path=r"D:\\图片\\梁内力.png",component=1,c
 # 示例代码
 from qtmodel import *
 odb.plot_truss_element_force(file_path=r"D:\\图片\\杆内力.png",case_name="CQ:成桥(合计)",stage_id=-1)
-#Returns: 无
+#Returns: Base64字符串
 ```  
 ### plot_plate_element_force
 绘制板单元结果图并保存到指定文件
@@ -3750,7 +3747,7 @@ odb.plot_truss_element_force(file_path=r"D:\\图片\\杆内力.png",case_name="C
 # 示例代码
 from qtmodel import *
 odb.plot_plate_element_force(file_path=r"D:\\图片\\板内力.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
-#Returns: 无
+#Returns: Base64字符串
 ```  
 ### plot_composite_beam_force
 绘制组合梁单元结果图并保存到指定文件
@@ -3780,7 +3777,7 @@ odb.plot_plate_element_force(file_path=r"D:\\图片\\板内力.png",component=1,
 # 示例代码
 from qtmodel import *
 odb.plot_composite_beam_force(file_path=r"D:\\图片\\组合梁内力.png",mat_type=0,component=1,case_name="CQ:成桥(合计)",stage_id=-1)
-#Returns: 无
+#Returns: Base64字符串
 ```  
 ### plot_beam_element_stress
 绘制梁单元应力结果图并保存到指定文件
@@ -3809,7 +3806,7 @@ odb.plot_composite_beam_force(file_path=r"D:\\图片\\组合梁内力.png",mat_t
 # 示例代码
 from qtmodel import *
 odb.plot_beam_element_stress(file_path=r"D:\\图片\\梁应力.png",show_line_chart=False,component=1,case_name="CQ:成桥(合计)",stage_id=-1)
-#Returns: 无
+#Returns: Base64字符串
 ```  
 ### plot_truss_element_stress
 绘制杆单元结果图并保存到指定文件
@@ -3837,7 +3834,7 @@ odb.plot_beam_element_stress(file_path=r"D:\\图片\\梁应力.png",show_line_ch
 # 示例代码
 from qtmodel import *
 odb.plot_truss_element_stress(file_path=r"D:\\图片\\杆应力.png",case_name="CQ:成桥(合计)",stage_id=-1)
-#Returns: 无
+#Returns: Base64字符串
 ```  
 ### plot_composite_beam_stress
 绘制组合梁单元结果图并保存到指定文件
@@ -3867,7 +3864,7 @@ odb.plot_truss_element_stress(file_path=r"D:\\图片\\杆应力.png",case_name="
 # 示例代码
 from qtmodel import *
 odb.plot_composite_beam_stress(file_path=r"D:\\图片\\组合梁应力.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
-#Returns: 无
+#Returns: Base64字符串
 ```  
 ### plot_plate_element_stress
 绘制板单元结果图并保存到指定文件
@@ -3894,7 +3891,7 @@ odb.plot_composite_beam_stress(file_path=r"D:\\图片\\组合梁应力.png",comp
 # 示例代码
 from qtmodel import *
 odb.plot_plate_element_stress(file_path=r"D:\\图片\\板应力.png",component=1,case_name="CQ:成桥(合计)",stage_id=-1)
-#Returns: 无
+#Returns: Base64字符串
 ```  
 ### plot_modal_result
 绘制模态结果，可选择自振模态和屈曲模态结果
@@ -3914,7 +3911,7 @@ odb.plot_plate_element_stress(file_path=r"D:\\图片\\板应力.png",component=1
 from qtmodel import *
 odb.plot_modal_result(file_path=r"D:\\图片\\自振模态.png",mode=1)
 odb.plot_modal_result(file_path=r"D:\\图片\\屈曲模态.png",mode=1,mode_kind=2)
-#Returns: 无
+#Returns: Base64字符串
 ```  
 ### get_current_png
 获取当前窗口Base64格式(图形)字符串
@@ -3925,3 +3922,114 @@ from qtmodel import *
 odb.get_current_png()
 #Returns: Base64格式(图形)字符串
 ```  
+##  视图控制
+### display_node_id
+设置节点号显示
+> 参数:  
+> show_id:是否打开节点号显示  
+```Python
+# 示例代码
+from qtmodel import *
+odb.display_node_id()
+odb.display_node_id(False)
+#Returns: 无
+```  
+### display_element_id
+设置单元号显示
+> 参数:  
+> show_id:是否打开单元号显示  
+```Python
+# 示例代码
+from qtmodel import *
+odb.display_element_id()
+odb.display_element_id(False)
+#Returns: 无
+```  
+### set_view_camera
+更改三维显示相机设置
+> 参数:  
+> camera_point: 相机坐标点  
+> focus_point: 相机焦点  
+> camera_rotate:相机绕XYZ旋转角度  
+> scale: 缩放系数  
+```Python
+# 示例代码
+from qtmodel import *
+odb.set_view_camera(camera_point=(-100,-100,100),focus_point=(0,0,0))
+#Returns: 无
+```  
+### set_view_direction
+更改三维显示默认视图
+> 参数:  
+> direction: 1-空间视图1 2-前视图 3-三维视图2 4-左视图  5-顶视图 6-右视图 7-空间视图3 8-后视图 9-空间视图4 10-底视图  
+> horizontal_degree:水平向旋转角度  
+> vertical_degree:竖向旋转角度  
+> scale:缩放系数  
+```Python
+# 示例代码
+from qtmodel import *
+odb.set_view_direction(direction=1,scale=1.2)
+#Returns: 无
+```  
+### activate_structure
+激活指定阶段和单元,默认激活所有
+> 参数:  
+> node_ids: 节点集合支持XtoYbyN形式字符串  
+> element_ids: 单元集合支持XtoYbyN形式字符串  
+```Python
+# 示例代码
+from qtmodel import *
+odb.activate_structure(node_ids=[1,2,3],element_ids=[1,2,3])
+#Returns: 无
+```  
+### set_unit
+修改视图显示时单位制,不影响建模
+> 参数:  
+> unit_force: 支持 N KN TONF KIPS LBF  
+> unit_length: 支持 M MM CM IN FT  
+```Python
+# 示例代码
+from qtmodel import *
+odb.set_unit(unit_force="N",unit_length="M")
+#Returns: 无
+```  
+### remove_display
+删除当前所有显示,包括边界荷载钢束等全部显示
+> 参数:  
+```Python
+# 示例代码
+from qtmodel import *
+odb.remove_display()
+#Returns: 无
+```  
+### save_png
+保存当前模型窗口图形信息
+> 参数:  
+> file_path: 文件全路径  
+```Python
+# 示例代码
+from qtmodel import *
+odb.save_png(file_path=r"D:\\QT\\aa.png")
+#Returns: 无
+```  
+### set_render
+消隐设置开关
+> 参数:  
+> flag: 默认设置打开消隐  
+```Python
+# 示例代码
+from qtmodel import *
+odb.set_render(flag=True)
+#Returns: 无
+```  
+### change_construct_stage
+消隐设置开关
+> 参数:  
+> stage: 施工阶段名称或施工阶段号  0-基本  
+```Python
+# 示例代码
+from qtmodel import *
+odb.change_construct_stage(0)
+odb.change_construct_stage(stage=1)
+#Returns: 无
+```