将 Google 表格与 SkyCiv API 集成

运行你的结构分析不是很好吗, 设计, 并在 Google 表格中进行优化? 拥有一个使用少量参数作为输入来创建和分析完整结构模型的简单工具，岂不是可以节省大量时间？?

在本文中，我们介绍了 SkyCiv API 使用 Google 表格, 使用 Google Apps 脚本. Apps 脚本是一个 基于云的 JavaScript 平台，可让您与 Google 产品集成并自动执行任务, 这样您就可以轻松创建自己的应用程序来自动执行重复性任务，结合 Google 产品的所有功能和任何其他能够通过 HTTP 请求进行通信的服务. SkyCiv就是这种情况, 我们的 API 接收一个包含模型信息的对象和 SkyCiv 应该在模型上运行的函数. 所有计算完成后, API 响应分析结果, 设计, 并根据要求返回的内容进行优化.

此解决方案源于必须手动创建公司通常设计的结构模型以及必须手动将结果从分析/设计/优化软件获取到电子表格以进一步处理这些结果的问题. 举个例子, 我们将解释如何创建一个能够在 SkyCiv S3D 中创建挡土墙模型的电子表格, 运行分析, 并将结果返回到电子表格.

该模型由一块板组成，该板代表由两根桩支撑的基脚梁顶部的墙杆. 这是一个非常简单的结构，但每次从头开始建模可能是一项非常乏味的任务. 这是获取与 SkyCiv API 通信的电子表格以及自动化建模和分析过程的分步指南.

注意: 本示例中使用的电子表格以及与其相关的所有代码, 可以访问 这里, 请记住，您需要先通过转到文件在云端硬盘中制作副本>复印一份

输入

第一步是确定可以完整描述结构系统的参数集. 在描述的挡土墙的情况下, 我们需要几何描述词干, 立足点, 和桩, 此外, 我们需要支撑土壤的特性以及将施加到墙上的载荷. 那说, 描述模型的参数组织在第一张表的一些表格中.

代码

所有代码都写在 Apps Script 用户界面中. 为了进入代码编辑器, 你可以进入菜单栏 扩展 > 应用脚本

用户互动

为了让用户与我们将要编写的功能进行交互，我们可以向 UI 添加一个菜单项, 可以使用以下代码轻松完成:

从电子表格中获取数据

在代码中, 我们需要所有与几何参数相关的数据, 负载, 并支持电子表格中的条件, 为了这个目的, 我们创建一个 Apps Script 对象 (与 JavaScript 非常相似) 使用以下代码段中显示的结构:

创建模型

最重要的函数是创建将发送到 SkyCiv API 的模型对象, 它遵循一些规则，可以在我们的 API 文档. 我们需要编写很多 for 循环和条件语句才能成功创建该模型对象 (节点, 成员, 部分, 负载, 等等...). 所有代码都可以找到 这里.

创建 API 对象

在上一步中创建的模型需要插入一个 API 对象，其中包含 API 的所有指令，以便它知道要做什么, API 对象的一般结构也可以在我们的 API 文档. 对于这个例子, 我们将开始一个会话, 设置模型, 将盘子网格化, 解决, 并保存模型. 所有代码都可以找到 这里. API 对象还包含身份验证数据, 其中包括您在 SkyCiv 中注册的电子邮件和您的密钥, 如果您正在运行示例电子表格, 确保你在 授权表.

向 SkyCiv API 发出请求

正如先前所说, 此 API 对象将使用 POST HTTP 请求发送到 SkyCiv API, 该请求是使用以下代码执行的:

“响应”对象将包含 API 响应请求的内容, 该响应可以根据您的特定需求在电子表格或代码中进一步处理. 它包括反应, 位移, 压力, 内力, 等等...

结果

第一次运行脚本, 你需要授权, 一旦模型被创建和分析, 结果以您在代码中指定的方式返回到电子表格. 整个电子表格看起来像这样:

该脚本将获取保存模型的 URL, 当您访问该 URL 时，您将能够验证, 修改和求解模型, 全部在 SkyCiv S3D 用户界面中:

这种集成的最大好处是您可以显着减少对这些典型结构进行建模所花费的时间. 通过简单地调整输入参数，您可以获得一个随时可以解决的模型并进一步自动化结果分析, 设计探索, 设计检查, 并通过结合最好的 SkyCiv API 进行优化, Google 表格和 Apps 脚本.

快乐编码!