Integração de planilhas do Google com a API SkyCiv

Não seria bom executar sua análise estrutural, design, e otimização diretamente no Planilhas Google? Não seria uma grande economia de tempo ter uma ferramenta simples que usa um punhado de parâmetros como entrada para criar e analisar um modelo estrutural completo?

Neste artigo, apresentamos a integração do API SkyCiv com o Google Sheets, usando Script do Google Apps. Apps Script é um plataforma JavaScript baseada em nuvem que permite a integração e a automação de tarefas nos produtos do Google, para que você possa criar facilmente seus próprios aplicativos para automatizar tarefas repetitivas, combinando todos os recursos dos produtos do Google e qualquer outro serviço capaz de se comunicar por meio de solicitações HTTP. É o caso do SkyCiv, nossa API recebe um objeto contendo as informações do modelo e as funções que o SkyCiv deve executar no modelo. Depois que todos os cálculos forem realizados, a API responde com os resultados da análise, design, e otimização dependendo do que foi pedido para retornar.

Esta solução surge do problema de ter que criar manualmente o modelo das estruturas que sua empresa normalmente projeta e ter que obter manualmente os resultados do software de análise / design / otimização em uma planilha para processar posteriormente esses resultados. Como um exemplo, vamos explicar como criar uma planilha capaz de criar um modelo de muro de contenção sobre estacas no SkyCiv S3D, análise em execução, e obter os resultados de volta para a planilha.

O modelo consiste em uma placa que representa a haste da parede no topo de uma viga de base que é suportada por duas estacas. É uma estrutura bastante simples, mas modelá-la do zero sempre pode ser uma tarefa muito entediante. Aqui está o guia passo a passo para obter uma planilha se comunicando com a API SkyCiv e automatizando os processos de modelagem e análise.

Observação: A planilha usada neste exemplo junto com todo o código relacionado a ela, Pode ser acessado aqui, lembre-se de que você precisa primeiro fazer uma cópia em seu Drive acessando Arquivo>Faça uma cópia

A entrada

A primeira etapa é identificar o conjunto de parâmetros que podem descrever totalmente o sistema estrutural. No caso do muro de arrimo descrito, precisamos descrever geometricamente a haste, o pé, e as pilhas, Além disso, precisamos das propriedades do solo de suporte, bem como das cargas que serão aplicadas à parede. Dito isto, os parâmetros que descrevem o modelo são organizados em algumas tabelas na primeira folha.

O código

Todo o código é escrito diretamente na interface do usuário do Apps Script. Para chegar ao editor de código, você pode ir na barra de menu para Extensões > Apps Script

Interação com o usuário

Para o usuário interagir com as funções que vamos escrever, podemos adicionar um item de menu à IU, isso pode ser feito facilmente usando o seguinte código:

Obtendo dados da planilha

No código, precisaremos ter todos os dados relacionados aos parâmetros geométricos, cargas, e condições de suporte da planilha, para aquele propósito, criamos um objeto Apps Script (muito semelhante a um JavaScript) usando a estrutura mostrada no seguinte trecho:

Criando o modelo

A função mais importante é aquela que cria o objeto modelo que será enviado para a API SkyCiv, segue algumas regras que podem ser encontradas em nosso Documentação API. Precisamos escrever muitos laços for e instruções condicionais para criar esse objeto de modelo com sucesso (nós, membros, seções, cargas, etc ...). Todo o código pode ser encontrado aqui.

Criação do objeto API

O modelo criado na etapa anterior precisa ser conectado a um objeto API que contém todas as instruções para a API para que ele saiba o que fazer, a estrutura geral do objeto API também pode ser encontrada em nosso Documentação API. Para este exemplo, vamos começar uma sessão, definir o modelo, engrene as placas, resolver, e salve o modelo. Todo o código pode ser encontrado aqui. O objeto API também contém os dados de autenticação, que consiste em seu e-mail cadastrado no SkyCiv e sua chave, caso você esteja executando a planilha de exemplo, certifique-se de preencher essa informação no Folha de Autenticação.

Fazendo a solicitação para a API SkyCiv

Como mencionado anteriormente, este objeto API será enviado para a API SkyCiv usando uma solicitação POST HTTP, essa solicitação é realizada usando o seguinte código:

O objeto "resposta" conterá o que a API respondeu à solicitação, essa resposta pode ser processada posteriormente na planilha ou no código de acordo com suas necessidades específicas. Inclui reações, deslocamentos, esforços, forças internas, etc ...

Os resultados

A primeira vez que você está executando o script, você precisa autorizá-lo, e uma vez que o modelo é criado e analisado, os resultados voltam para a planilha da maneira que você especificou no código. Toda a planilha se parece com isto:

O script obterá um URL onde o modelo foi salvo, quando você acessar esse URL, poderá verificar, modificar e resolver o modelo, tudo na interface de usuário SkyCiv S3D:

A melhor coisa sobre esta integração é que você pode reduzir significativamente o tempo gasto na modelagem dessas estruturas típicas. Simplesmente ajustando os parâmetros de entrada você pode obter um modelo pronto para resolver e automatizar ainda mais a análise de resultados, exploração de design, verificações de design, e otimização combinando o melhor da API SkyCiv, Planilhas Google e Apps Script.

Boa codificação!