qtmodel 0.6.2__tar.gz → 0.6.4__tar.gz

{qtmodel-0.6.2 → qtmodel-0.6.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: qtmodel
-Version: 0.6.2
-Summary: python modeling for qt 2025-01-13 
+Version: 0.6.4
+Summary: python modeling for qt 2025-01-21 
 Home-page: https://github.com/Inface0443/pyqt
 Author: dqy-zhj
 Author-email: 1105417715@qq.com
@@ -12,9 +12,10 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
 Description-Content-Type: text/markdown
 
-# 最新版本 V0.6.2 - 2025-01-13 
+> 最新版本 V0.6.4 - 2025-01-21 
 > pip install --upgrade qtmodel -i https://pypi.org/simple
-- 修改部分接口 
+- 新增部分接口 
+# 建模操作 
 ##  项目管理
 ### undo_model
 撤销模型上次操作
@@ -2700,6 +2701,7 @@ from qtmodel import *
 mdb.remove_load_combine(name="荷载组合1")
 ```  
 Returns: 无
+# 视图与结果提取 
 ##  视图控制
 ### display_node_id
 设置节点号显示
@@ -2876,6 +2878,28 @@ odb.get_node_displacement(node_id=[1,2,3],stage_id=1)
 odb.get_node_displacement(node_id=1,stage_id=-1,case_name="工况名")
 ```  
 Returns: json字符串,包含信息为list[dict] or dict
+### get_vibration_node_displacement
+获取指定节点指定模态的振型向量
+> 参数:  
+> node_id: 节点号  
+> mode: 模态号  
+```Python
+# 示例代码
+from qtmodel import *
+odb.get_vibration_node_displacement(node_id=1,mode=1)
+```  
+Returns: json字符串,包含信息为list[dict] or dict
+##  动力结果查看
+### get_period_and_frequency
+获取周期和频率
+> 参数:  
+> mode:模态号  
+```Python
+# 示例代码
+from qtmodel import *
+odb.get_period_and_frequency(mode=1)
+```  
+Returns: json字符串,包含信息为dict
 ##  绘制模型结果
 ### plot_reaction_result
 保存结果图片到指定文件甲
@@ -2999,7 +3023,7 @@ Returns: 无
 > show_legend: 是否显示图例  
 > text_rotation_angle: 数值选项卡内文字旋转角度  
 > digital_count: 小数点位数  
-> show_as_exponential: 是否以指数形式显示  
+> show_exponential: 是否以指数形式显示  
 > max_min_kind: 最大最小值显示类型  
 > show_increment: 是否显示增量结果  
 ```Python
@@ -3142,7 +3166,7 @@ Returns: 无
 > show_legend: 是否显示图例  
 > text_rotation_angle: 数值选项卡内文字旋转角度  
 > digital_count: 小数点位数  
-> show_as_exponential: 是否以指数形式显示  
+> show_exponential: 是否以指数形式显示  
 > max_min_kind: 最大最小值显示类型  
 > show_increment: 是否显示增量结果  
 > position: 位置 0-板顶 1-板底 2-绝对值最大  
@@ -3152,6 +3176,24 @@ from qtmodel import *
 odb.plot_plate_element_stress(file_path=r"D:\\图片\\板应力.png",component=0,load_case_name="CQ:成桥(合计)",stage_id=-1)
 ```  
 Returns: 无
+### plot_vibration_mode
+绘制板单元结果图并保存到指定文件
+> 参数:  
+> file_path: 保存路径名  
+> mode: 模态号  
+> show_number: 是否显示数值  
+> show_pre_deformed: 是否显示未变形形状  
+> show_legend: 是否显示图例  
+> text_rotation_angle: 数值选项卡内文字旋转角度  
+> digital_count: 小数点位数  
+> show_exponential: 是否以指数形式显示  
+> max_min_kind: 最大最小值显示类型  
+```Python
+# 示例代码
+from qtmodel import *
+odb.plot_vibration_mode(file_path=r"D:\\图片\\自振模态.png",mode=1)
+```  
+Returns: 无
 ##  获取模型信息
 ### get_element_by_point
 获取某一点指定范围内单元集合,单元中心点为节点平均值
@@ -3194,7 +3236,7 @@ Returns: json字符串,包含信息为list[list[int]]
 from qtmodel import *
 odb.get_overlap_elements()
 ```  
-Returns: json字符串,包含信息为list[list[int]]
+Returns:  json字符串,包含信息为list[list[int]]
 ### get_structure_group_names
 获取结构组名称
 > 参数:  
@@ -3212,7 +3254,7 @@ Returns: json字符串,包含信息为list[str]
 from qtmodel import *
 odb.get_thickness_data(1)
 ```  
-Returns: json字符串,包含信息为dict
+Returns:
 ### get_all_thickness_data
 获取所有板厚信息
 > 参数:  
@@ -3240,7 +3282,7 @@ Returns: json字符串,包含信息为list[dict]
 from qtmodel import *
 odb.get_section_shape(1)
 ```  
-Returns: json字符串,包含信息为dict
+Returns:
 ### get_all_section_data
 获取所有截面详细信息,截面特性详见UI自定义特性截面
 > 参数:  

{qtmodel-0.6.2 → qtmodel-0.6.4}/README.md

@@ -1,6 +1,7 @@
-# 最新版本 V0.6.2 - 2025-01-13 
+> 最新版本 V0.6.4 - 2025-01-21 
 > pip install --upgrade qtmodel -i https://pypi.org/simple
-- 修改部分接口 
+- 新增部分接口 
+# 建模操作 
 ##  项目管理
 ### undo_model
 撤销模型上次操作
@@ -2686,6 +2687,7 @@ from qtmodel import *
 mdb.remove_load_combine(name="荷载组合1")
 ```  
 Returns: 无
+# 视图与结果提取 
 ##  视图控制
 ### display_node_id
 设置节点号显示
@@ -2862,6 +2864,28 @@ odb.get_node_displacement(node_id=[1,2,3],stage_id=1)
 odb.get_node_displacement(node_id=1,stage_id=-1,case_name="工况名")
 ```  
 Returns: json字符串,包含信息为list[dict] or dict
+### get_vibration_node_displacement
+获取指定节点指定模态的振型向量
+> 参数:  
+> node_id: 节点号  
+> mode: 模态号  
+```Python
+# 示例代码
+from qtmodel import *
+odb.get_vibration_node_displacement(node_id=1,mode=1)
+```  
+Returns: json字符串,包含信息为list[dict] or dict
+##  动力结果查看
+### get_period_and_frequency
+获取周期和频率
+> 参数:  
+> mode:模态号  
+```Python
+# 示例代码
+from qtmodel import *
+odb.get_period_and_frequency(mode=1)
+```  
+Returns: json字符串,包含信息为dict
 ##  绘制模型结果
 ### plot_reaction_result
 保存结果图片到指定文件甲
@@ -2985,7 +3009,7 @@ Returns: 无
 > show_legend: 是否显示图例  
 > text_rotation_angle: 数值选项卡内文字旋转角度  
 > digital_count: 小数点位数  
-> show_as_exponential: 是否以指数形式显示  
+> show_exponential: 是否以指数形式显示  
 > max_min_kind: 最大最小值显示类型  
 > show_increment: 是否显示增量结果  
 ```Python
@@ -3128,7 +3152,7 @@ Returns: 无
 > show_legend: 是否显示图例  
 > text_rotation_angle: 数值选项卡内文字旋转角度  
 > digital_count: 小数点位数  
-> show_as_exponential: 是否以指数形式显示  
+> show_exponential: 是否以指数形式显示  
 > max_min_kind: 最大最小值显示类型  
 > show_increment: 是否显示增量结果  
 > position: 位置 0-板顶 1-板底 2-绝对值最大  
@@ -3138,6 +3162,24 @@ from qtmodel import *
 odb.plot_plate_element_stress(file_path=r"D:\\图片\\板应力.png",component=0,load_case_name="CQ:成桥(合计)",stage_id=-1)
 ```  
 Returns: 无
+### plot_vibration_mode
+绘制板单元结果图并保存到指定文件
+> 参数:  
+> file_path: 保存路径名  
+> mode: 模态号  
+> show_number: 是否显示数值  
+> show_pre_deformed: 是否显示未变形形状  
+> show_legend: 是否显示图例  
+> text_rotation_angle: 数值选项卡内文字旋转角度  
+> digital_count: 小数点位数  
+> show_exponential: 是否以指数形式显示  
+> max_min_kind: 最大最小值显示类型  
+```Python
+# 示例代码
+from qtmodel import *
+odb.plot_vibration_mode(file_path=r"D:\\图片\\自振模态.png",mode=1)
+```  
+Returns: 无
 ##  获取模型信息
 ### get_element_by_point
 获取某一点指定范围内单元集合,单元中心点为节点平均值
@@ -3180,7 +3222,7 @@ Returns: json字符串,包含信息为list[list[int]]
 from qtmodel import *
 odb.get_overlap_elements()
 ```  
-Returns: json字符串,包含信息为list[list[int]]
+Returns:  json字符串,包含信息为list[list[int]]
 ### get_structure_group_names
 获取结构组名称
 > 参数:  
@@ -3198,7 +3240,7 @@ Returns: json字符串,包含信息为list[str]
 from qtmodel import *
 odb.get_thickness_data(1)
 ```  
-Returns: json字符串,包含信息为dict
+Returns:
 ### get_all_thickness_data
 获取所有板厚信息
 > 参数:  
@@ -3226,7 +3268,7 @@ Returns: json字符串,包含信息为list[dict]
 from qtmodel import *
 odb.get_section_shape(1)
 ```  
-Returns: json字符串,包含信息为dict
+Returns:
 ### get_all_section_data
 获取所有截面详细信息,截面特性详见UI自定义特性截面
 > 参数:  

{qtmodel-0.6.2 → qtmodel-0.6.4}/qtmodel/qt_mdb.py

@@ -214,7 +214,7 @@ class Mdb:
             raise Exception(ex)
 
     @staticmethod
-    def update_construction_stage_setting(do_analysis: bool, to_end_stage: bool, other_stage_id: int = 1, analysis_type: int = 0,
+    def update_construction_stage_setting(do_analysis: bool = True, to_end_stage: bool = True, other_stage_id: int = 1, analysis_type: int = 0,
                                           do_creep_analysis: bool = True, cable_tension_position: int = 0, consider_completion_stage: bool = True,
                                           shrink_creep_type: int = 2, creep_load_type: int = 1,
                                           sub_step_info: tuple[bool, float, float, float, float, float] = None):

{qtmodel-0.6.2 → qtmodel-0.6.4}/qtmodel/qt_odb.py

@@ -343,6 +343,46 @@ class Odb:
         except Exception as ex:
             raise Exception(ex)
 
+    @staticmethod
+    def get_vibration_node_displacement(node_id: (Union[int, List[int]]) = None, mode: int = 1):
+        """
+        获取指定节点指定模态的振型向量
+        Args:
+            node_id: 节点号
+            mode: 模态号
+        Example:
+            odb.get_vibration_node_displacement(node_id=1,mode=1)
+        Returns: json字符串,包含信息为list[dict] or dict
+        """
+        try:
+            bf_list = qt_model.GetVibrationNodeDisplacement(nodeIds=node_id, mode=mode)
+            list_res = []
+            for item in bf_list:
+                displacements = [item.Displacement.Dx, item.Displacement.Dy, item.Displacement.Dz,
+                                 item.Displacement.Rx, item.Displacement.Ry, item.Displacement.Rz]
+                list_res.append(str(NodeDisplacement(item.NodeId, displacements)))
+            return json.dumps(list_res) if len(list_res) > 1 else list_res[0]
+        except Exception as ex:
+            raise Exception(ex)
+
+    # endregion
+
+    # region 动力结果查看
+    @staticmethod
+    def get_period_and_frequency(mode: int = 1):
+        """
+        获取周期和频率
+        Args:
+            mode:模态号
+        Example:
+            odb.get_period_and_frequency(mode=1)
+        Returns: json字符串,包含信息为dict
+        """
+        try:
+            qt_model.GetPeriodAndFrequency(mode=mode)
+        except Exception as ex:
+            raise Exception(ex)
+
     # endregion
 
     # region 绘制模型结果
@@ -518,7 +558,7 @@ class Odb:
                                  envelope_type: int = 1, force_kind: int = 0, component: int = 0,
                                  show_number: bool = False, text_rotation_angle: int = 0, max_min_kind: int = 0,
                                  show_deformed: bool = True, deformed_scale: float = 1.0, deformed_actual: bool = False,
-                                 show_legend: bool = True, digital_count: int = 3, show_as_exponential: bool = True,
+                                 show_legend: bool = True, digital_count: int = 3, show_exponential: bool = True,
                                  show_pre_deformed: bool = False, ):
         """
         绘制板单元结果图并保存到指定文件
@@ -537,7 +577,7 @@ class Odb:
             show_legend: 是否显示图例
             text_rotation_angle: 数值选项卡内文字旋转角度
             digital_count: 小数点位数
-            show_as_exponential: 是否以指数形式显示
+            show_exponential: 是否以指数形式显示
             max_min_kind: 最大最小值显示类型
             show_increment: 是否显示增量结果
         Example:
@@ -550,7 +590,7 @@ class Odb:
                 envelopeType=envelope_type, forceKind=force_kind, component=component,
                 showAsDeformedShape=show_deformed, deformedScale=deformed_scale, deformedActual=deformed_actual,
                 showNumber=show_number, textRotationAngle=text_rotation_angle, maxMinValueKind=max_min_kind,
-                showLegend=show_legend, digitalCount=digital_count, showAsExponential=show_as_exponential,
+                showLegend=show_legend, digitalCount=digital_count, showAsExponential=show_exponential,
                 showUndeformedShape=show_pre_deformed)
         except Exception as ex:
             raise Exception(ex)
@@ -747,7 +787,7 @@ class Odb:
                                   envelope_type: int = 1, stress_kind: int = 0, component: int = 0,
                                   show_number: bool = False, text_rotation_angle: int = 0, max_min_kind: int = 0,
                                   show_deformed: bool = True, deformed_scale: float = 1.0, deformed_actual: bool = False,
-                                  show_legend: bool = True, digital_count: int = 3, show_as_exponential: bool = True,
+                                  show_legend: bool = True, digital_count: int = 3, show_exponential: bool = True,
                                   show_pre_deformed: bool = False, position: int = 0):
         """
         绘制板单元结果图并保存到指定文件
@@ -766,7 +806,7 @@ class Odb:
             show_legend: 是否显示图例
             text_rotation_angle: 数值选项卡内文字旋转角度
             digital_count: 小数点位数
-            show_as_exponential: 是否以指数形式显示
+            show_exponential: 是否以指数形式显示
             max_min_kind: 最大最小值显示类型
             show_increment: 是否显示增量结果
             position: 位置 0-板顶 1-板底 2-绝对值最大
@@ -780,11 +820,40 @@ class Odb:
                 envelopeType=envelope_type, stressKind=stress_kind, component=component,
                 showAsDeformedShape=show_deformed, deformedScale=deformed_scale, deformedActual=deformed_actual,
                 showNumber=show_number, textRotationAngle=text_rotation_angle, maxMinValueKind=max_min_kind,
-                showLegend=show_legend, digitalCount=digital_count, showAsExponential=show_as_exponential,
+                showLegend=show_legend, digitalCount=digital_count, showAsExponential=show_exponential,
                 showUndeformedShape=show_pre_deformed, position=position)
         except Exception as ex:
             raise Exception(ex)
 
+    @staticmethod
+    def plot_vibration_mode(file_path: str = "", mode: int = 1, show_number: bool = True, text_rotation_angle: float = 0, max_min_kind: int = 0,
+                            show_legend: bool = True, digital_count: int = 3, show_exponential: bool = True,
+                            show_pre_deformed: bool = False):
+        """
+        绘制板单元结果图并保存到指定文件
+        Args:
+           file_path: 保存路径名
+           mode: 模态号
+           show_number: 是否显示数值
+           show_pre_deformed: 是否显示未变形形状
+           show_legend: 是否显示图例
+           text_rotation_angle: 数值选项卡内文字旋转角度
+           digital_count: 小数点位数
+           show_exponential: 是否以指数形式显示
+           max_min_kind: 最大最小值显示类型
+        Example:
+           odb.plot_vibration_mode(file_path=r"D:\\图片\\自振模态.png",mode=1)
+        Returns: 无
+        """
+        try:
+            qt_model.PlotVibrationMode(
+                filePath=file_path, mode=mode,
+                showNumber=show_number, textRotationAngle=text_rotation_angle, maxMinValueKind=max_min_kind,
+                showLegend=show_legend, digitalCount=digital_count, showAsExponential=show_exponential,
+                showUndeformedShape=show_pre_deformed)
+        except Exception as ex:
+            raise Exception(ex)
+
     # endregion
 
     # region 获取模型信息
@@ -851,7 +920,7 @@ class Odb:
         Args:无
         Example:
             odb.get_overlap_elements()
-        Returns: json字符串,包含信息为list[list[int]]
+        Returns:  json字符串,包含信息为list[list[int]]
         """
         try:
             result = []
@@ -884,7 +953,8 @@ class Odb:
         Args:
         Example:
             odb.get_thickness_data(1)
-        Returns: json字符串,包含信息为dict
+        Returns:
+            json字符串,包含信息为dict
         """
         try:
             return qt_model.GetThicknessData(thick_id)
@@ -935,7 +1005,8 @@ class Odb:
             sec_id: 目标截面编号
         Example:
             odb.get_section_shape(1)
-        Returns: json字符串,包含信息为dict
+        Returns:
+            json字符串,包含信息为dict
         """
         try:
             return qt_model.GetSectionShape(sec_id)

{qtmodel-0.6.2 → qtmodel-0.6.4}/qtmodel.egg-info/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: qtmodel
-Version: 0.6.2
-Summary: python modeling for qt 2025-01-13 
+Version: 0.6.4
+Summary: python modeling for qt 2025-01-21 
 Home-page: https://github.com/Inface0443/pyqt
 Author: dqy-zhj
 Author-email: 1105417715@qq.com
@@ -12,9 +12,10 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
 Description-Content-Type: text/markdown
 
-# 最新版本 V0.6.2 - 2025-01-13 
+> 最新版本 V0.6.4 - 2025-01-21 
 > pip install --upgrade qtmodel -i https://pypi.org/simple
-- 修改部分接口 
+- 新增部分接口 
+# 建模操作 
 ##  项目管理
 ### undo_model
 撤销模型上次操作
@@ -2700,6 +2701,7 @@ from qtmodel import *
 mdb.remove_load_combine(name="荷载组合1")
 ```  
 Returns: 无
+# 视图与结果提取 
 ##  视图控制
 ### display_node_id
 设置节点号显示
@@ -2876,6 +2878,28 @@ odb.get_node_displacement(node_id=[1,2,3],stage_id=1)
 odb.get_node_displacement(node_id=1,stage_id=-1,case_name="工况名")
 ```  
 Returns: json字符串,包含信息为list[dict] or dict
+### get_vibration_node_displacement
+获取指定节点指定模态的振型向量
+> 参数:  
+> node_id: 节点号  
+> mode: 模态号  
+```Python
+# 示例代码
+from qtmodel import *
+odb.get_vibration_node_displacement(node_id=1,mode=1)
+```  
+Returns: json字符串,包含信息为list[dict] or dict
+##  动力结果查看
+### get_period_and_frequency
+获取周期和频率
+> 参数:  
+> mode:模态号  
+```Python
+# 示例代码
+from qtmodel import *
+odb.get_period_and_frequency(mode=1)
+```  
+Returns: json字符串,包含信息为dict
 ##  绘制模型结果
 ### plot_reaction_result
 保存结果图片到指定文件甲
@@ -2999,7 +3023,7 @@ Returns: 无
 > show_legend: 是否显示图例  
 > text_rotation_angle: 数值选项卡内文字旋转角度  
 > digital_count: 小数点位数  
-> show_as_exponential: 是否以指数形式显示  
+> show_exponential: 是否以指数形式显示  
 > max_min_kind: 最大最小值显示类型  
 > show_increment: 是否显示增量结果  
 ```Python
@@ -3142,7 +3166,7 @@ Returns: 无
 > show_legend: 是否显示图例  
 > text_rotation_angle: 数值选项卡内文字旋转角度  
 > digital_count: 小数点位数  
-> show_as_exponential: 是否以指数形式显示  
+> show_exponential: 是否以指数形式显示  
 > max_min_kind: 最大最小值显示类型  
 > show_increment: 是否显示增量结果  
 > position: 位置 0-板顶 1-板底 2-绝对值最大  
@@ -3152,6 +3176,24 @@ from qtmodel import *
 odb.plot_plate_element_stress(file_path=r"D:\\图片\\板应力.png",component=0,load_case_name="CQ:成桥(合计)",stage_id=-1)
 ```  
 Returns: 无
+### plot_vibration_mode
+绘制板单元结果图并保存到指定文件
+> 参数:  
+> file_path: 保存路径名  
+> mode: 模态号  
+> show_number: 是否显示数值  
+> show_pre_deformed: 是否显示未变形形状  
+> show_legend: 是否显示图例  
+> text_rotation_angle: 数值选项卡内文字旋转角度  
+> digital_count: 小数点位数  
+> show_exponential: 是否以指数形式显示  
+> max_min_kind: 最大最小值显示类型  
+```Python
+# 示例代码
+from qtmodel import *
+odb.plot_vibration_mode(file_path=r"D:\\图片\\自振模态.png",mode=1)
+```  
+Returns: 无
 ##  获取模型信息
 ### get_element_by_point
 获取某一点指定范围内单元集合,单元中心点为节点平均值
@@ -3194,7 +3236,7 @@ Returns: json字符串,包含信息为list[list[int]]
 from qtmodel import *
 odb.get_overlap_elements()
 ```  
-Returns: json字符串,包含信息为list[list[int]]
+Returns:  json字符串,包含信息为list[list[int]]
 ### get_structure_group_names
 获取结构组名称
 > 参数:  
@@ -3212,7 +3254,7 @@ Returns: json字符串,包含信息为list[str]
 from qtmodel import *
 odb.get_thickness_data(1)
 ```  
-Returns: json字符串,包含信息为dict
+Returns:
 ### get_all_thickness_data
 获取所有板厚信息
 > 参数:  
@@ -3240,7 +3282,7 @@ Returns: json字符串,包含信息为list[dict]
 from qtmodel import *
 odb.get_section_shape(1)
 ```  
-Returns: json字符串,包含信息为dict
+Returns:
 ### get_all_section_data
 获取所有截面详细信息,截面特性详见UI自定义特性截面
 > 参数:  

{qtmodel-0.6.2 → qtmodel-0.6.4}/setup.py

@@ -9,7 +9,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="qtmodel",
-    version=f"V0.6.2",
+    version=f"V0.6.4",
     author="dqy-zhj",
     author_email="1105417715@qq.com",
     description=f"python modeling for qt {datetime.now().date()} ",