Idea Statica
  • 钢结构
  • 混凝土
  • BIM与工作流程
  • 支持与学习
  • 定价
  • 公司
  • 钢结构概述
  • 节点设计
  • 构件设计
  • 参数化设计
  • 钢结构案例研究
  • 混凝土概述
  • 墙体与 D 区
  • 锚固设计
  • 混凝土案例研究
  • BIM 概述
  • 兼容与协作软件
  • Checkbot
  • Viewer
  • API
  • 技术支持中心
  • E-learning & 认证
  • 博客
  • 下载与许可
  • 方案
  • 免费社区工具
  • 企业客户
  • 学生与教育工作者
  • 您能节省多少?
  • 关于我们
  • 联系我们
  • 研究与开发
  • 授权经销商
  • 走进我们的客户
  • 钢结构
    钢结构概述节点设计构件设计参数化设计钢结构案例研究
  • 混凝土
    混凝土概述墙体与 D 区锚固设计混凝土案例研究
  • BIM与工作流程
    BIM 概述兼容与协作软件CheckbotViewerAPI
  • 支持与学习
    技术支持中心E-learning & 认证博客下载与许可
  • 定价
    方案免费社区工具企业客户学生与教育工作者您能节省多少?
  • 公司
    关于我们联系我们研究与开发授权经销商走进我们的客户
14天试用
14天试用

订阅我们的新闻通讯

公司

  • 关于我们
  • 合作伙伴关系
  • 职业机会
  • 面向结构工程师的专利技术

资源

  • 客户项目
  • Case studies(案例研究)
  • IDEA StatiCa 节点库
  • 验证手册

法律

  • IDEA StatiCa 最终用户许可协议
  • 全球隐私政策
  • 服务条款 – IDEA StatiCa Viewer
  • 许可授权

帮助

  • 联系我们
  • 报价申请
  • 经销商
  • 下载
FacebookInstagramLinkedInYouTube

© IDEA StatiCa 2009-2026

受到全球工程师、制造商和顾问的信赖与使用。

技术支持中心教程如何开始使用 API - 导入模板并运行计算 03
如何开始使用 API - 导入模板并运行计算 03
SteelConnection designTutorialsConnectionIDEA Open Model (API)

如何开始使用 API - 导入模板并运行计算 03

本文也提供以下语言版本
ENCZDEESFRITPTNLHUROKRPLTHTRVIZH
AI从英语翻译

在本教程中,您将学习如何导入模板、修改默认设置并获取计算结果及费用。

第一步

我们建议先阅读教程 如何开始使用 API - 基础知识 01,该教程将介绍 API 的基本概念及环境配置方法。

Connection 文件 

本示例基于教程 如何开始使用 API - 批量导入荷载组合 02 中创建的文件。 

请将文件 tutorial 02 with loads.ideaCon 和 tutorial 02.contemp 下载到您的电脑。

Python 客户端

同样,在 CMD 中于正确的 IDEA StatiCa 文件夹内运行"IdeaStatiCa.ConnectionRestApi.exe",并打开您选择的 IDE 工具。

  • 创建一个新文件并 导入所需的包,这些包将启用计算功能并与本地主机 URL 建立连接。 

源代码:

## 导入 API 包
import ideastatica_connection_api
from ideastatica_connection_api.models.base_template_conversion import BaseTemplateConversion
from ideastatica_connection_api.models.con_mprl_element import ConMprlElement
from ideastatica_connection_api.models.con_operation_common_properties import ConOperationCommonProperties

#导入可视化包
import pandas as pd

## 与 baseUrl 建立连接
import ideastatica_connection_api.connection_api_service_attacher as connection_api_service_attacher

  • 通过变量"baseUrl"配置日志记录,该变量将调用您的本地主机。第二步,配置您的 IDEA StatiCa Connection 文件的绝对路径。

## 配置日志记录
baseUrl = "http://localhost:5000"

## Python 脚本和 Connection 模块所在文件夹的绝对路径
project_file_path = r"C:\Users\AlexanderSzotkowski\Documents\IDEA\API\Tutorial 03\tutorial 02 with loads.ideaCon"
print("Opening project ",project_file_path)

  • 将客户端与已运行的服务配对。使用 try/except 块——当 try 块引发错误时,将执行 except 块。第一阶段需要打开项目并找到项目 ID,该 ID 对每个 IDEA StatiCa 项目是唯一的。然后需要获取文件中存储的所有节点,因为我们只想将模板应用于第一个节点。下一步,可以读取默认映射模板文件,并向 MPRL 数据库添加新的螺栓组件 (M20 8.8)。

# 创建连接到已运行服务的客户端
with connection_api_service_attacher.ConnectionApiServiceAttacher(baseUrl).create_api_client() as api_client:
    try:
        # 打开项目
        uploadRes = api_client.project.open_project_from_filepath(project_file_path)
        activeProjectId = api_client.project.active_project_id      
        # 获取项目中所有节点的列表
        connections_in_project = api_client.connection.get_connections(activeProjectId)

        # 项目中的第一个节点
        connection1 = connections_in_project[0]      

        # ConTemplateMappingGetParam | 用于获取默认映射的模板数据(可选)
      templateParam =  ideastatica_connection_api.ConTemplateMappingGetParam() 

        #template_file_name
        template_file_name = r"C:\Users\AlexanderSzotkowski\Documents\IDEA\API\Tutorial 03\tutorial 02.contemp"        

        with open(template_file_name, 'r', encoding='utf-16') as file:
            templateParam.template = file.read()

        # 获取所选模板和节点的默认映射  
        default_mapping = api_client.template.get_default_template_mapping(api_client.project.active_project_id, connection1.id, templateParam)
        print("Default mapping: ",default_mapping)        

        #向 MPRL 数据库添加新的螺栓组件
       mprlElement = ConMprlElement()
        print(mprlElement)
        mprlElement.mprl_name = "M20 8.8"
        api_client.material.add_bolt_assembly(activeProjectId, mprlElement)
        print("New bolt assembly added", mprlElement.mprl_name)
        boltsInProject = api_client.material.get_bolt_assemblies(activeProjectId) 

  • 如果要将新的螺栓组件直接分配给板与板操作,需要运行命令 BaseTemplateConversion() 并将其添加到映射模板中。

       # 向映射模板添加新的螺栓组件       
      boltConversion = BaseTemplateConversion()
       boltConversion.original_value = 'M16 8.8'
       boltConversion.original_template_id = '1'
       boltConversion.new_value =  'M20 8.8'
       boltConversion.description = 'Bolt Assembly'
       boltConversion.new_template_id = '2'     

       default_mapping.conversions.append(boltConversion)
      print("New mapping: ", default_mapping)       

       # 将修改后的模板应用于节点
       applyTemplateData =  ideastatica_connection_api.ConTemplateApplyParam() # ConTemplateApplyParam |       要应用的模板(可选)
        applyTemplateData.connection_template = templateParam.template
        applyTemplateData.mapping = default_mapping
        applyTemplateResult = api_client.template.apply_template(api_client.project.active_project_id, connection1.id, applyTemplateData)

        # 将新的螺栓组件设置到 ideaCon 文件中的操作
       commonProperties = ConOperationCommonProperties()
        commonProperties.bolt_assembly_id = 2

        api_client.operation.update_common_operation_properties(api_client.project.active_project_id, connection1.id, commonProperties)

  • 我们还可以获取节点的费用

       # 获取应用模板后节点的费用
        costs = api_client.connection.get_production_cost(api_client.project.active_project_id, connection1.id)
        print("Costs: ",costs.total_estimated_cost)

  • 最后一步,我们可以运行计算、查看结果、以新名称保存文件并查看计算结果

        # 对节点运行应力-应变分析
        con1_cbfem_results1 = api_client.calculation.calculate(api_client.project.active_project_id, [connection1.id])
        results = api_client.calculation.get_results(api_client.project.active_project_id, [connection1.id])
        CheckResSummary = pd.DataFrame(results[0].check_res_summary)
        print("Results summary: \n",CheckResSummary[1])

        #创建新的 ideaCon 文件并应用模板
        updated_file_name = r'C:\Users\AlexanderSzotkowski\Documents\IDEA\API\Tutorial 03\tutorial 03 with template.ideaCon'
        api_client.project.download_project(api_client.project.active_project_id, updated_file_name )
        print("New project with template ",updated_file_name)

    except Exception as e:
        print("Operation failed : %s\n" % e)

计算结果正常。在后续教程中,我们将重点介绍如何优化部分组件。

下载附件

  • tutorial 02.contemp (CONTEMP, 34 KB)

  • tutorial 03 - apply_a_template.py (PY, 5 KB)

  • tutorial 03 with template.ideaCon (IDEACON, 14 KB)

  • tutorial 02 with loads.ideaCon (IDEACON, 9.5 KB)

相关文章

API/开发者文档网站
  • 钢铁
  • 混凝土
  • IDEA Open Model (API)
  • v25.1
  • v23.1
  • +5
  • 钢铁
  • 混凝土
  • IDEA Open Model (API)
  • v25.1
  • v23.1

Knowledge base

API/开发者文档网站

阅读更多
如何开始使用 API - 基础知识 01
  • 钢铁
  • Connection
  • IDEA Open Model (API)
  • +3
  • 钢铁
  • Connection
  • IDEA Open Model (API)

Tutorials

如何开始使用 API - 基础知识 01

阅读更多
如何开始使用 API - 批量导入组合 02
  • 钢铁
  • Connection
  • IDEA Open Model (API)
  • Load effects
  • Equilibrium
  • +5
  • 钢铁
  • Connection
  • IDEA Open Model (API)
  • Load effects
  • Equilibrium

Tutorials

如何开始使用 API - 批量导入组合 02

阅读更多
IDEA StatiCa Connection 中的参数化设计 - 基础知识 (01)
  • 钢铁
  • Connection
  • Connection Library
  • Parametric design
  • IDEA Open Model (API)
  • +5
  • 钢铁
  • Connection
  • Connection Library
  • Parametric design
  • IDEA Open Model (API)

Tutorials

IDEA StatiCa Connection 中的参数化设计 - 基础知识 (01)

阅读更多