Integración de Google Sheets con la API SkyCiv

¿No sería bueno ejecutar su análisis estructural, diseño, y optimización directamente en Hojas de cálculo de Google? ¿No ahorraría mucho tiempo tener una herramienta simple que utiliza un puñado de parámetros como entrada para crear y analizar un modelo estructural completo??

En este artículo presentamos la integración de la SkyCiv API con Hojas de cálculo de Google, usando Secuencia de comandos de Google Apps. Apps Script es una Plataforma JavaScript basada en la nube que le permite integrarse y automatizar tareas en todos los productos de Google., para que pueda crear fácilmente sus propias aplicaciones para automatizar tareas repetitivas combinando todas las capacidades de los productos de Google y cualquier otro servicio capaz de comunicarse a través de solicitudes HTTP. Este es el caso de SkyCiv, nuestra API recibe un objeto que contiene la información del modelo y las funciones que se supone que SkyCiv debe ejecutarse en el modelo. Después de realizar todos los cálculos, la API responde con los resultados del análisis, diseño, y optimización en función de lo que se solicitó para devolver.

Esta solución surge del problema de tener que crear manualmente el modelo de las estructuras que su empresa suele diseñar y tener que obtener manualmente los resultados del software de análisis / diseño / optimización en una hoja de cálculo para procesar aún más esos resultados.. Como ejemplo, vamos a explicar cómo crear una hoja de cálculo capaz de crear un modelo de muro de contención sobre pilotes en SkyCiv S3D, análisis de ejecución, y devolver los resultados a la hoja de cálculo.

El modelo consta de una placa que representa el vástago del muro sobre una viga de zapata que se apoya en dos pilotes. Es una estructura bastante simple, pero modelarla desde cero cada vez puede ser una tarea muy tediosa.. Aquí está la guía paso a paso para obtener una hoja de cálculo que se comunique con la API de SkyCiv y automatice los procesos de modelado y análisis..

Nota: La hoja de cálculo utilizada en este ejemplo junto con todo el código relacionado con ella, puede ser accesible aquí, tenga en cuenta que primero debe hacer una copia en su Drive yendo a Archivo>Hacer una copia

La entrada

El primer paso es identificar el conjunto de parámetros que pueden describir completamente el sistema estructural.. En el caso del muro de contención descrito, Necesitamos describir geométricamente la raíz., el pie, y las pilas, Adicionalmente, Necesitamos las propiedades del suelo de soporte, así como las cargas que se aplicarán a la pared.. Eso dicho, Los parámetros que describen el modelo están organizados en algunas tablas en la primera Hoja..

El código

Todo el código está escrito directamente en la interfaz de usuario de Apps Script.. Para llegar al editor de código, puedes ir en la barra de menú a Extensiones > Apps Script

La interacción del usuario

Para que el usuario interactúe con las funciones que vamos a escribir podemos agregar un Item de menú a la UI, que se puede hacer fácilmente usando el siguiente código:

Obtener datos de la hoja de cálculo

En el código, necesitaremos tener todos los datos relacionados con los parámetros geométricos, cargas, y condiciones de soporte de la hoja de cálculo, para ese propósito, creamos un objeto de Apps Script (muy similar a uno de JavaScript) utilizando la estructura que se muestra en el siguiente fragmento:

Creando el modelo

La función más importante es la que crea el objeto modelo que se enviará a la API de SkyCiv., sigue algunas reglas que se pueden encontrar en nuestro Documentación de la API. Necesitamos escribir muchos bucles for y declaraciones condicionales para crear con éxito ese objeto modelo (nodos, miembros, secciones, cargas, etc ...). Todo el código se puede encontrar aquí.

Creando el Objeto API

El modelo creado en el paso anterior debe estar conectado a un objeto API que contiene todas las instrucciones para la API para que sepa qué hacer., la estructura general del objeto API también se puede encontrar en nuestro Documentación de la API. Para este ejemplo, comenzaremos una sesión, establecer el modelo, malla las placas, resolver, y guarda el modelo. Todo el código se puede encontrar aquí. El objeto API también contiene los datos de autenticación, que consta de su correo electrónico registrado en SkyCiv y su clave, en caso de que esté ejecutando la hoja de cálculo de ejemplo, asegúrese de completar esa información en el Hoja de autenticación.

Realizar la solicitud a la API de SkyCiv

Como se mencionó anteriormente, este objeto API se enviará a la API SkyCiv mediante una solicitud HTTP POST, esa solicitud se realiza utilizando el siguiente código:

El objeto "respuesta" contendrá lo que la API respondió a la solicitud, esa respuesta se puede procesar más en la hoja de cálculo o en el código de acuerdo con sus necesidades específicas. Incluye reacciones, desplazamientos, tensiones, fuerzas internas, etc ...

Los resultados

La primera vez que ejecuta el script, necesitas autorizarlo, y una vez creado y analizado el modelo, los resultados vuelven a la hoja de cálculo de la forma que especificó en el código. Toda la hoja de cálculo se ve así:

El script obtendrá una URL donde se guardó el modelo., cuando vaya a esa URL podrá verificar, modificar y resolver el modelo, todo en la interfaz de usuario de SkyCiv S3D:

Lo mejor de esta integración es que puede reducir significativamente el tiempo dedicado a modelar estas estructuras típicas.. Lo mejor de esta integración es que puede reducir significativamente el tiempo dedicado a modelar estas estructuras típicas., exploración de diseño, controles de diseño, Lo mejor de esta integración es que puede reducir significativamente el tiempo dedicado a modelar estas estructuras típicas., Google Sheets y Apps Script.

Codificación feliz!