Integrazione di Fogli Google con l'API SkyCiv

Non sarebbe bello eseguire la tua analisi strutturale?, design, e ottimizzazione direttamente in Fogli Google? Non risparmierebbe molto tempo disporre di uno strumento semplice che utilizza una manciata di parametri come input per creare e analizzare un modello strutturale completo?

In questo articolo vi presentiamo l'integrazione del API SkyCiv con Fogli Google, usando Script di Google Apps. Apps Script è un piattaforma JavaScript basata su cloud che ti consente di integrarti e automatizzare le attività tra i prodotti Google, così puoi creare facilmente le tue app per automatizzare le attività ripetitive combinando tutte le funzionalità dei prodotti Google e di qualsiasi altro servizio in grado di comunicare tramite richieste HTTP. Questo è il caso di SkyCiv, la nostra API riceve un oggetto contenente le informazioni sul modello e le funzioni che SkyCiv dovrebbe eseguire sul modello. Dopo aver eseguito tutti i calcoli, l'API risponde con i risultati dell'analisi, design, e ottimizzazione a seconda di cosa gli è stato chiesto di restituire.

Questa soluzione nasce dal problema di dover creare manualmente il modello delle strutture che la tua azienda progetta in genere e di dover ottenere manualmente i risultati dal software di analisi/progettazione/ottimizzazione su un foglio di calcolo per elaborare ulteriormente tali risultati. Come esempio, spiegheremo come creare un foglio di calcolo in grado di creare un muro di sostegno su un modello di pali in SkyCiv S3D, analisi in corso, e riportare i risultati nel foglio di calcolo.

Il modello è costituito da una piastra che rappresenta il fusto del muro sopra una trave di fondazione sostenuta da due pali. È una struttura piuttosto semplice, ma modellarla da zero ogni volta può essere un compito molto noioso. Ecco la guida passo passo per ottenere un foglio di calcolo che comunica con l'API SkyCiv e automatizzare i processi di modellazione e analisi.

Nota: Il foglio di calcolo utilizzato in questo esempio insieme a tutto il codice ad esso correlato, è possibile accedere Qui, tieni presente che devi prima fare una copia nel tuo Drive andando su File>Fare una copia

L'ingresso

Il primo passo è identificare l'insieme di parametri che possono descrivere completamente il sistema strutturale. Nel caso del muro di sostegno descritto, dobbiamo descrivere geometricamente lo stelo, il fondamento, e le pile, inoltre, abbiamo bisogno delle proprietà del terreno di supporto e dei carichi che verranno applicati al muro. Detto ciò, i parametri che descrivono il modello sono organizzati in alcune tabelle nel primo Foglio.

Il codice

Tutto il codice è scritto direttamente nell'interfaccia utente di Apps Script. Per accedere all'editor di codice, puoi andare nella barra dei menu a estensioni > Script delle app

Interazione con l'utente

Affinché l'utente possa interagire con le funzioni che stiamo per scrivere, possiamo aggiungere una voce di menu all'interfaccia utente, che può essere fatto facilmente usando il seguente codice:

Ottenere dati dal foglio di calcolo

Nel codice, avremo bisogno di tutti i dati relativi ai parametri geometrici, carichi, e condizioni di supporto dal foglio di calcolo, per quello scopo, creiamo un oggetto Apps Script (molto simile a JavaScript) utilizzando la struttura mostrata nel frammento seguente:

Creare il modello

La funzione più importante è quella che crea l'oggetto modello che verrà inviato all'API SkyCiv, segue alcune regole che possono essere trovate nel nostro Documentazione API. Abbiamo bisogno di scrivere molti cicli for e istruzioni condizionali per creare con successo quell'oggetto modello (nodi, aste, sezioni, carichi, eccetera...). Tutto il codice può essere trovato Qui.

Creazione dell'oggetto API

Il modello creato nel passaggio precedente deve essere collegato a un oggetto API che contiene tutte le istruzioni per l'API in modo che sappia cosa fare, la struttura generale dell'oggetto API si trova anche nel nostro Documentazione API. Per questo esempio, inizieremo una sessione, imposta il modello, ingranare le piastre, risolvere, e salva il modello. Tutto il codice può essere trovato Qui. L'oggetto API contiene anche i dati di autenticazione, che consiste nella tua email registrata in SkyCiv e nella tua chiave, nel caso in cui stai eseguendo il foglio di calcolo di esempio, assicurati di compilare le informazioni nel Foglio di autenticazione.

Fare la richiesta all'API SkyCiv

Come menzionato prima, questo oggetto API verrà inviato all'API SkyCiv utilizzando una richiesta HTTP POST, tale richiesta viene eseguita utilizzando il seguente codice:

L'oggetto "risposta" conterrà ciò che l'API ha risposto alla richiesta, quella risposta può essere ulteriormente elaborata nel foglio di calcolo o nel codice in base alle tue esigenze specifiche. Include reazioni, spostamenti, sottolinea, forze interne, eccetera...

I risultati

La prima volta che esegui lo script, devi autorizzarlo, e una volta creato e analizzato il modello, i risultati tornano al foglio di calcolo nel modo specificato nel codice. L'intero foglio di calcolo ha questo aspetto:

Lo script otterrà un URL in cui è stato salvato il modello, quando vai a quell'URL sarai in grado di verificare, modificare e risolvere il modello, tutto nell'interfaccia utente SkyCiv S3D:

The best thing about this integration is that you can significantly reduce the time spent modeling these typical structures. By simply adjusting the input parameters you can get a ready-to-solve model and further automate results analysis, esplorazione del design, controlli di progettazione, and optimization by combining the best of the SkyCiv API, Script di Fogli Google e app.

Codifica felice!