viiaPackage documentation

The viiaPackage is used by the structural engineer for seismic assessment of building structures. The viiaPackage is setup to create models in different ways and to prepare and execute the seismic analysis. For the assessment partially a report is automatically generated based on the data in the model. The final deliverable is the responsibility of the structural engineer and the viiaPackage is only a tool for him or her in the process.

Currently the viiaPackage supports the following analysis types: NLTH. The Non-Linear Time History analysis (NLTH) can be performed in DIANA 10.9 software. Following the current project settings of VIIA. Other methods like the Modal Response Spectrum analyses (MRS), the Non-Linear Push-Over analysis (NLPO) and Reference Approach (NLTH-REF) are still available in the viiaPackage, but because they are not in the current workflow, they are not maintained.

This version of the viiaPackage is based on the following Basis of Design:

NLTH

VIIA_QE_R376 Basis of Design Retrofit Advice NLTH 10.0, d.d. 28 June 2023

You can provide feedback (bug reports, suggestions or feature requests) here:

Provide Feedback

Starters manuals The starters introduction presentations for new colleagues can be found here and here.

Note

The viiaPackage requires Python version 3.10 or 3.11.

For use by VIIA

Copyright VIIA

Table of contents

NLTH Protocol

• 1. Seismic analysis in VIIA
  • 1.1. Introduction
  • 1.2. Non-Linear analysis methods and knowledge development
  • 1.3. DIANA process
  • 1.4. ABAQUS
  • 1.5. Python process
  • 1.6. Python
  • 1.7. Other tools used in VIIA
• 2. Phase 1 - Starting phase
  • 2.1. Object start
  • 2.2. Step 1: Reading and inspection
  • 2.3. Step 2: Kick-offs
  • 2.4. Step 3: Issuelog (Building Datalist and BKCL)
  • 2.5. Step 4: Draft model and check of NSCE
  • 2.6. Step 5: Structural schematisation and NLPO suitability check
  • 2.7. Step 6: Editing geometry
  • 2.8. Step 7: Apply Non-Seismic Loads
  • 2.9. Step R1: Reporting structural setup of the building
• 3. Phase 2 - Fixed base model phase
  • 3.1. Step 8: Apply the boundary conditions and base motions for fixed base to the model
  • 3.2. Step C1: Mesh check
  • 3.3. Step A1: Linear static analysis
  • 3.4. Step A2: Rob-test (Optional)
  • 3.5. Step A3: Eigenfrequency analysis
  • 3.6. Step A4: Linear fixed base LTH analysis (Optional)
• 4. Phase 3 - Flexbase model phase
  • 4.1. Step 9: Foundation and SSI
  • 4.2. Step 11: Detailing
  • 4.3. Step 12: Non-linearity
  • 4.4. Step M1: Model pictures
  • 4.5. Step A7: Flexbase eigenfrequency analysis
  • 4.6. Step A10: Nonlinear static analysis
  • 4.7. Step C2: Model check
  • 4.8. Step A12: Nonlinear flexbase NLTH analysis (7x)
• 5. Phase 4 - Reporting
  • 5.1. Step A9: NLKA
  • 5.2. Step R2: Engineering report
  • 5.3. Step C3: Review (peer/lead)
• 6. Phase 5 - Strengthening phase
  • 6.1. Step 13: Measure meeting
  • 6.2. Step 14: Modelling of strengthening measures
  • 6.3. Step 15: Cost engineer
  • 6.4. Step M2: Model pictures
  • 6.5. Step C4: Model check
  • 6.6. Step A15: Non-linear flexbase NLTH analysis 7 signals
  • 6.7. Step R2: Generate engineering report (TVA)
  • 6.8. Step C5: Review (peer/HC)
  • 6.9. Step 16: Closure

---

The following how-to guides are aiming at specific topics when using the viiaPackage:

How to guides

• How to install the viiaPackage
• How to set-up DIANA
• How to translations Dutch-English
• How to standardise the unknown information from inspection
• How to read 3D scan
• How to use the interactive modelling tool
• How to create shallow foundations
• How to create piles
• How to create connections
• How to DCF settings
• How to modify default analysis
• How to use the VIIA servers
• How to use the resultscript for NLTH
• How to assess results
• How to check for compliance NLTH
• How to strengthen
• How to add strengthening measures in the model
• How to perform NSCE and NLKA checks
• How to create pictures and movies
• How to create output for geo
• How to create the engineering report
• How to do peer review
• How to use template script for server
• How to approach reruns
• How to create surface reinforcement

---

Reference Approach

• 1. Introduction
• 2. Workflow Overview
• 3. Phase 1: Reading and inspection
• 4. Phase 2: Expected building behaviour
• 5. Phase 3: Kick-off with lead engineer (Technical Kick-off)
• 6. Phase 4: Validation
• 7. Phase 5: Retrofitting
• 8. Phase 6: Reporting
• 9. Guideline and Examples
• 10. References
• 11. FAQ
• 12. How to set-up the Reference Approach Tool
• 13. Scoring systems in the REF tool

---

The following pages contain the workshops for the viiaPackage:

Workshops

• Workshops
  • Workshop viiaPackage Basics
  • Workshop Connections in the viiaPackage
  • Workshop Advanced usage of viiaPackage

---

The following pages are currently not updated (because there are currently no objects in SLAMA):

SLaMA Protocol

• 1. Introduction SLaMA-Approach
• 2. Phase 1 - Starting phase
• 3. Phase 2 - Calculation phase
• 4. Phase 3 - Strengthening phase
• 5. Phase 4 - Reporting phase
• 6. Phase 5 - Peer Review

---

The following pages are currently not updated (because there are currently not in the current workflow):

Protocol additions - Other methods

• Seismic analysis with NLTH in ABAQUS in VIIA
• Seismic analysis with NLPO in VIIA
• Seismic analysis with SBS in VIIA

---

The following pages are currently not updated (because there are currently no objects in NLPO):

How to guides - Other methods

• How to modify analysis in abaqus
• How to MRS analysis
• How to perform the NLPO suitability check
• How to NLPO analysis
• How to select the critical pushover curves
• How to use the NLPO result template
• How to determine the performance point & verification of NPR 9998:2018 compliance
• How to perform SLaMA for two-storey buildings
• How to check for compliance SBS

---

The reference guide for the modules in the viiaPackage can be found in the following sections:

Reference guide

• Module viiaAnalysis
• Module viiaChecking
• Module VIIAClassDefinition
• Module viiaConnections
• Module viiaGeneral
• Module viiaLoads
• Module viiaPictures
• Module viiaMaterials, viiaGeometries and viiaDatas
• Module viiaReferenceApproach
• Module viiaReporting
• Module viiaResults
• Module viiaShapeOperations
• Module viiaStatus
• Module viiaStrengthening
• Module viiaSupports
• Supporting modules for viiaPackage