STAAD Pro, un software di analisi strutturale e di progettazione ampiamente adottato da Bentley Systems, offre ampie capacità per la modellazione, l'analisi e il design. Tuttavia, molti ingegneri svolgono ancora attività ripetitive manualmente, caricando membri, eseguendo più combinazioni di carico, o generando riassunti dei risultati.

Il ruolo dell'automazione nell'analisi strutturale

L’analisi strutturale comporta spesso processi iterativi: la regolazione delle dimensioni dei membri, la modifica delle condizioni di supporto o la rivalutazione dei casi di carico. La ripetizione manuale non solo consuma ore ma introduce anche inconsistenza. Gli script automatizzati assicurano che ogni iterazione segue la stessa procedura, dalla modifica del modello all’estrazione dei risultati. Inoltre, l’automazione consente agli ingegneri di eseguire studi parametrici, valorizzando dimensioni o carichi in modo sistematico, senza riflusso manuale.

Comprendere gli script VBA nel contesto di STAAD Pro

VLTL è un linguaggio di programmazione basato su eventi costruito in applicazioni Microsoft Office come Excel, Word e Access. Mentre STAAD Pro non supporta in modo nativo l'esecuzione VBA all'interno del proprio ambiente, espone un'interfaccia di automazione COM (Component Object Model) . Questa interfaccia consente ai programmi esterni, come una macro VBA Excel, di interagire con STAAD Pro programmaticamente.

Vantaggi di Automating STAAD Pro con VBA

  • Risparmio di tempo:[] Le attività che richiedono ore manualmente, come l'esecuzione di 50 combinazioni di carico e le reazioni di esportazione, possono essere completate in pochi secondi.
  • Consistenza e precisione:[] Gli errori umani da errori di battitura o passi mancati vengono eliminati. Lo stesso script può essere riutilizzato in più progetti, garantendo procedure standardizzate.
  • Customization:[] Gli script possono essere adattati a specifiche esigenze di progetto—modelli di carico personalizzati, controlli di codice di progettazione unici o formati di risultato proprietari.
  • Integrazione senza problemi con Excel:[ Excel funge sia dal centro di controllo che dal repository dati. I risultati possono essere scritti direttamente in fogli di calcolo per ulteriori analisi, grafici o reportage.
  • Reduced Software Licensing Lock-in:[] Automatizzato tramite Excel, i team possono condividere gli script senza richiedere a tutti gli utenti di avere avanzate capacità di programmazione STAAD Pro.

Prerequisiti per l'utilizzo di VBA con STAAD Pro

Prima di scrivere script di automazione, assicurarsi che i seguenti siano in atto:

  • Installazione di STAAD Pro:[ L'interfaccia di automazione richiede una licenza valida di STAAD Pro (tipicamente STAAD.Pro Connect Edition o versioni precedenti).
  • Microsoft Excel (2010 o versioni successive):[ VBA è supportato in tutte le edizioni; tuttavia, per lo sviluppo professionale, Excel 365 è raccomandato.
  • Abilita scheda Sviluppatore:[ In Excel, abilitare la scheda Sviluppatore per accedere all'editor VBA e alle impostazioni macro.
  • Aggiungi riferimento alla libreria di tipo di STAAD Pro:[ Nell'editor VBA (Tools > Referenze), assicurarsi che la libreria di oggetti di STAAD Pro (ad esempio, “STAAD.Pro.Application” o “STAAD.Pro v2.0 Type Library”) sia controllata.
  • Impostazioni di sicurezza:[] Regolare la sicurezza macro per abilitare “L’accesso al modello oggetto del progetto VBA” e consentire opzionalmente macro firmate digitalmente da editori fidati.

Se la libreria tipo STAAD Pro non è elencata, visita la cartella di installazione (tipicamente o simile) e seleziona il file [ o (ad esempio, ).

Guida passo-passo: Creazione di un Macro VBA per controllare STAAD Pro

Impostazione dell'ambiente VBA in Excel

Apri Excel, premi Alt+F11[]] per lanciare l'Editor Visual Basic. Inserisci un nuovo modulo (Insert > Module). Questo è il luogo in cui scrivi le tue procedure di automazione.

Stabilire una connessione a STAAD Pro

Per interagire con STAAD Pro, è necessario creare un'istanza dell'oggetto dell'applicazione. L'approccio più semplice utilizza il legame precoce (se il riferimento è impostato):

Dim staadApp As STAADPro.Application
Set staadApp = New STAADPro.Application

Se si preferisce la legatura tardiva (non è richiesto alcun riferimento), utilizzare:

Dim staadApp As Object
Set staadApp = CreateObject("STAAD.Pro.Application")

Il primo binding offre prestazioni migliori e il supporto IntelliSense, ma il legame tardivo evita le dipendenze specifiche della versione.

Apertura di un Modello e esecuzione di un'analisi

Una volta disponibile l'oggetto dell'applicazione, è possibile aprire un file STAAD esistente, eseguire analisi e salvare i risultati.

Sub RunStaadAnalysis()
 Dim staadApp As STAADPro.Application
 Dim staadModel As STAADPro.Model
 Dim analysisResult As Boolean

 ' Create STAAD Pro application object
 Set staadApp = New STAADPro.Application
 ' Make STAAD Pro visible (optional)
 staadApp.Visible = True

 ' Open an existing model file
 staadApp.OpenFile "C:\Projects\Bridge.std"
 Set staadModel = staadApp.ActiveModel

 ' Run all analysis cases
 analysisResult = staadModel.Analyze()
 If analysisResult Then
 MsgBox "Analysis completed successfully."
 Else
 MsgBox "Analysis failed. Check STAAD Pro output for errors."
 End If

 ' Save changes
 staadModel.Save
 ' Close the model (optional)
 staadApp.Close
 ' Release objects
 Set staadModel = Nothing
 Set staadApp = Nothing
End Sub

Nota:[] Il metodo ] gestisce tutti i casi di carico definiti.Per analisi parziale o combinazioni di carico specifiche, potrebbero essere richieste chiamate API aggiuntive.

Recuperare ed esportare i risultati in Excel

Uno degli usi più potenti di VBA sta estraendo i risultati direttamente in un foglio di lavoro. Il seguente script legge spostamenti articolari per tutti i nodi e li scrive al foglio attivo:

Sub ExportDisplacementsToExcel()
 Dim staadApp As STAADPro.Application
 Dim staadModel As STAADPro.Model
 Dim resultSet As STAADPro.ResultSet
 Dim nodeID As Long
 Dim displ As STAADPro.Displacement
 Dim ws As Worksheet
 Dim rowIdx As Long

 Set staadApp = New STAADPro.Application
 staadApp.Visible = False
 staadApp.OpenFile "C:\Projects\Bridge.std"
 Set staadModel = staadApp.ActiveModel

 ' Run analysis if not already done
 staadModel.Analyze

 ' Get results for a specific load case (e.g., load case 1)
 Set resultSet = staadModel.GetResultSet(1)

 ' Set up Excel worksheet
 Set ws = ThisWorkbook.Sheets(1)
 ws.Cells.Clear
 ws.Cells(1, 1).Value = "Node ID"
 ws.Cells(1, 2).Value = "X Displacement (mm)"
 ws.Cells(1, 3).Value = "Y Displacement (mm)"
 ws.Cells(1, 4).Value = "Z Displacement (mm)"
 rowIdx = 2

 ' Loop through all nodes in the model
 For Each nodeID In staadModel.Nodes.Keys
 Set displ = resultSet.GetNodeDisplacement(nodeID)
 ws.Cells(rowIdx, 1).Value = nodeID
 ws.Cells(rowIdx, 2).Value = displ.X
 ws.Cells(rowIdx, 3).Value = displ.Y
 ws.Cells(rowIdx, 4).Value = displ.Z
 rowIdx = rowIdx + 1
 Next nodeID

 ' Clean up
 staadApp.Close
 Set resultSet = Nothing
 Set staadModel = Nothing
 Set staadApp = Nothing
 MsgBox "Displacements exported to sheet: " & ws.Name
End Sub

Questo esempio dimostra la potenza di combinare il motore di analisi di STAAD Pro con la presentazione dei dati di Excel.

Gestione degli errori e debug

Gli script di automazione devono gestire con grazia i guasti. Usare strutture per catturare problemi come file mancanti, errori di analisi, o errori API:

Sub SafeAnalysis()
 On Error GoTo ErrHandler
 Dim staadApp As Object
 Set staadApp = CreateObject("STAAD.Pro.Application")
 staadApp.OpenFile "C:\Projects\Structure.std"
 If Not staadApp.ActiveModel.Analyze() Then
 MsgBox "Analysis returned false. Check STAAD Pro log."
 End If
 staadApp.ActiveModel.Save
 staadApp.Close
 Set staadApp = Nothing
 Exit Sub
ErrHandler:
 MsgBox "Error " & Err.Number & ": " & Err.Description
 If Not staadApp Is Nothing Then staadApp.Quit
 Set staadApp = Nothing
End Sub

Assicurarsi sempre che STAAD Pro sia correttamente chiuso anche se si verifica un errore, per evitare processi persistenti.

Tecniche di automazione avanzate

Elaborazione batch Modelli multipli

Gli ingegneri spesso devono analizzare un insieme di modelli simili, ad esempio, configurazioni diverse di truss o condizioni del suolo. Utilizzando un loop, uno script VBA può aprire ogni file, eseguire analisi, estrarre i risultati chiave e aggregarli in una cartella di lavoro riassuntiva:

Sub BatchAnalyze()
 Dim filePath As String
 Dim modelFiles As Variant
 Dim i As Integer
 Dim staadApp As STAADPro.Application
 Dim resultSummary As Worksheet

 Set resultSummary = ThisWorkbook.Sheets("Summary")
 resultSummary.Cells.Clear
 resultSummary.Cells(1, 1).Value = "Model Name"
 resultSummary.Cells(1, 2).Value = "Max Displacement (mm)"

 ' List of .std files (could also read from a folder)
 modelFiles = Array("C:\Models\Case1.std", "C:\Models\Case2.std", "C:\Models\Case3.std")

 Set staadApp = New STAADPro.Application
 staadApp.Visible = False

 For i = LBound(modelFiles) To UBound(modelFiles)
 staadApp.OpenFile modelFiles(i)
 If staadApp.ActiveModel.Analyze() Then
 ' Extract maximum displacement (example)
 Dim maxDisp As Double: maxDisp = 0
 Dim nodeKeys As Variant: nodeKeys = staadApp.ActiveModel.Nodes.Keys
 Dim nd As Long
 Dim rs As Object
 Set rs = staadApp.ActiveModel.GetResultSet(1)
 For Each nd In nodeKeys
 Dim d As Object: Set d = rs.GetNodeDisplacement(nd)
 Dim mag As Double: mag = Sqr(d.X ^ 2 + d.Y ^ 2 + d.Z ^ 2)
 If mag > maxDisp Then maxDisp = mag
 Next
 resultSummary.Cells(i + 2, 1).Value = modelFiles(i)
 resultSummary.Cells(i + 2, 2).Value = maxDisp
 End If
 staadApp.ActiveModel.Close False ' don't save changes
 Next i

 staadApp.Quit
 Set staadApp = Nothing
 MsgBox "Batch processing complete."
End Sub

Generazione e modifica del modello parametrico

VBA può anche creare interi modelli da zero utilizzando dati di coordinate e membri memorizzati in Excel. Ad esempio, un foglio di calcolo della geometria del ponte può guidare la creazione di nodi, travi e supporti. Questo approccio è particolarmente utile per le strutture ripetitive come torri di trasmissione o ponti di truss. I metodi API , ], e consentono l'assemblaggio completo del modello.

Generazione di report automatizzata

STAAD Pro può esportare report in formato HTML, PDF o Word. Utilizzando VBA, è possibile controllare il motore di report per generare output standardizzato per più casi di carico o codici di progettazione. Combinato con le capacità di grafico di Excel, è possibile creare dashboard che si aggiornano automaticamente dopo ogni esecuzione di analisi.

Applicazioni reali e studi di casi

L'automazione tramite VBA è stata applicata con successo in molte aziende di consulenza, ad esempio, una società di ingegneria strutturale ha utilizzato una macro VBA per automatizzare la verifica di progettazione di oltre 500 strutture in acciaio per un progetto di stadio. Lo script è stato iterated attraverso diverse combinazioni di carichi eolici, controlli di unità dei membri estratti e contrassegnato qualsiasi membro sovrastato direttamente in un foglio di audit Excel.

Un altro caso riguardava un'agenzia governativa responsabile delle ispezioni di ponti. Gli ingegneri hanno usato VBA per generare report di analisi per centinaia di ponti esistenti leggendo i dati sul campo da Excel, aggiornando i modelli STAAD e producendo rapporti PDF con tabelle e grafici incorporati.

Migliori Pratiche per l'automazione VBA in ingegneria strutturale

  • Inizio Semplice:[] Inizia con piccole attività come l'apertura di un file e l'analisi in esecuzione.
  • Utili nomi variabili significati:[] In script di ingegneria, la chiarezza è cruciale.
  • Incorporate Logging:[]] Scrivere messaggi di progresso in un file di registro o finestra immediata ([]) per monitorare l'esecuzione, soprattutto per operazioni batch.
  • Sempre testare su backup:[] Non eseguire script non testati sui modelli di produzione.
  • Differenze di versione di Handle:[[]] Le modifiche dell'API di STAAD Pro tra le versioni.
  • Documenti il tuo Codice:[] Aggiungi commenti che spiegano lo scopo di ogni blocco. Questo è essenziale per il trasferimento di conoscenze e le modifiche future.
  • Combina con funzioni Excel:[] Dopo aver estraito i risultati, sfrutta le funzioni integrate di Excel (ad esempio, VLOOKUP, tabelle pivot) per ulteriori analisi invece di scrivere loop VBA complessi.
  • Usa la gestione degli errori Ovunque:[ Si verificheranno situazioni inaspettate—file bloccati, fallimenti di analisi, problemi di rete.
  • Continua a leggere STAAD Pro Visibile durante lo sviluppo:[] Imposta mentre si debugga per vedere cosa sta facendo lo script.

Conclusioni

Automatizzazione delle attività di analisi strutturale in STAAD Pro con gli script VBA è un modo potente per aumentare la produttività, garantire la coerenza e sbloccare nuove possibilità nel design parametrico e nella gestione dei dati. Mentre la curva di apprendimento iniziale comporta la presa dell’interfaccia di automazione COM e della sintassi VBA, il payoff è immenso: ore di lavoro manuale ridotte a minuti, meno errori e la capacità di esplorare più alternative di progettazione.

Risorse aggiuntive

Nota:[]] Verifica sempre che l'utilizzo dell'automazione sia conforme ai termini di licenza software della tua organizzazione e alle politiche IT. Bentley non supporta ufficialmente gli script VBA di terze parti, quindi procedere con cautela e test approfonditi.