OpenSeismoMatlab: New Features, Verification and Charting Future Endeavors
Abstract
:1. Introduction
- Elaborate on the new capabilities of OpenSeismoMatlab, including a comprehensive presentation of input/output variables for its various routines and, when necessary, flowcharts depicting the calculation process (Section 2 of this study).
- Demonstrate OpenSeismoMatlab’s capacity to yield highly accurate and reliable results. To achieve this, we replicated several cases from existing literature using OpenSeismoMatlab and compared the outcomes with those obtained through alternative methods (Section 3 of this study).
- Offer insights into prospective avenues for further research in two dimensions: (i) the refinement of OpenSeismoMatlab itself, and (ii) the advancement of seismic building design methodologies, leveraging OpenSeismoMatlab as a foundational tool (Section 4 of this study).
2. Structure and New Functionalities of OpenSeismoMatlab
2.1. High-Pass and Low-Pass Butterworth Filter
2.2. Constant Ductility and Constant Strength Response Spectra (CDRS and CSRS)
2.3. Effective Peak Ground Acceleration (EPGA)
2.4. Incremental Dynamic Analysis of SDOF System
- ‘SA_MU’: Spectral acceleration–displacement ductility
- ‘PGD_MU’: Peak displacement–displacement ductility
- ‘PGV_MU’: Peak velocity–displacement ductility
- ‘PGA_MU’: Peak acceleration–displacement ductility
- ‘SA_DISP’: Spectral acceleration–displacement
- ‘PGD_DISP’: Peak displacement–displacement
- ‘PGV_DISP’: Peak velocity–displacement
- ‘PGA_DISP’: Peak acceleration–displacement
- ‘SA_VEL’: Spectral acceleration–velocity
- ‘PGD_VEL’: Peak displacement–velocity
- ‘PGV_VEL’: Peak velocity–velocity
- ‘PGA_VEL’: Peak acceleration–velocity
- ‘SA_ACC’: Spectral acceleration–acceleration
- ‘PGD_ACC’: Peak displacement–acceleration
- ‘PGV_ACC’: Peak velocity–acceleration
- ‘PGA_ACC’: Peak acceleration–acceleration
2.5. Pulse Decomposition
- Near-fault pulse-like records tend to induce increased displacement responses, thereby elevating the potential for structural and/or nonstructural damage in both elastic and inelastic structures compared to non-pulse-like motions. Additionally, they tend to produce higher spectral accelerations at longer periods.
- The structural response is significantly influenced by the ratio of the pulse period in the ground motion velocity time history (Tp) to the first-mode period of the building (T1). When Tp is approximately equal to T1, elastic structures experience the highest response. In the case of ductile structures, it is presumed that the building’s effective fundamental period elongates as damage accumulates. It has been proposed that Tp being approximately twice T1 may be the most detrimental scenario for structures operating within the nonlinear range. For instances where Tp < T1, such as in tall buildings, the pulse may excite higher modes, leading to substantial displacement and shear force demands in the upper stories.
2.6. Resampling
2.7. Rigid-Plastic Sliding Response Spectrum
3. Verification of OpenSeismoMatlab Output
3.1. High-Pass and Low-Pass Butterworth Filter of OpenSeismoMatlab
3.2. Constant Ductility Response Spectra of OpenSeismoMatlab (CDRS)
3.3. Constant Strength Response Spectra of OpenSeismoMatlab (CSRS)
3.4. Incremental Dynamic Analysis of OpenSeismoMatlab (IDA)
3.5. Pulse Decomposition of OpenSeismoMatlab
3.6. Rigid-Plastic Sliding Response Spectrum of OpenSeismoMatlab
4. Discussion and Future Work
- OpenSeismoMatlab exclusively employs the bilinear kinematic model for conducting nonlinear analyses, encompassing a range of nonlinear spectra, including constant ductility, constant strength, and rigid-plastic sliding spectra.
5. Conclusions
Author Contributions
Funding
Data Availability Statement
Conflicts of Interest
References
- Papazafeiropoulos, G.; Plevris, V. OpenSeismoMatlab: A new open-source software for strong ground motion data processing. Heliyon 2018, 4, e00784. [Google Scholar] [CrossRef] [PubMed]
- Papazafeiropoulos, G.; Plevris, V. Kahramanmaraş—Gaziantep, Türkiye Mw 7.8 Earthquake on 6 February 2023: Strong Ground Motion and Building Response Estimations. Buildings 2023, 13, 1194. [Google Scholar] [CrossRef]
- Papazafeiropoulos, G.; Plevris, V.; Papadrakakis, M. A new energy-based structural design optimization concept under seismic actions. Front. Built Environ. 2017, 3, 1–16. [Google Scholar] [CrossRef]
- Housner, G.W. Spectrum Intensities of Strong-Motion Earthquakes. In Symposium on Earthquake and Blast Effects on Structures; Earthquake Engineering Research Institute: Los Angeles, CA, USA, 1952. [Google Scholar]
- Nau, J.M.; Hall, W.J. Scaling Methods for Earthquake Response Spectra. J. Struct. Eng. 1984, 110, 1533–1548. [Google Scholar] [CrossRef]
- Gustafsson, F. Determining the initial states in forward-backward filtering. IEEE Trans. Signal Process. 1996, 44, 988–992. [Google Scholar] [CrossRef]
- Boore, D.M. On Pads and Filters: Processing Strong-Motion Data. Bull. Seismol. Soc. Am. 2005, 95, 745–750. [Google Scholar] [CrossRef]
- Chanerley, A.A.; Alexander, N.A. Obtaining estimates of the low-frequency ‘fling’, instrument tilts and displacement timeseries using wavelet decomposition. Bull. Earthq. Eng. 2010, 8, 231–255. [Google Scholar] [CrossRef]
- Kamai, R.; Abrahamson, N. Are Near-Fault Fling Effects Captured in the New NGA West2 Ground Motion Models? Earthq. Spectra 2015, 31, 1629–1645. [Google Scholar] [CrossRef]
- Boore, D.M.; Akkar, S. Effect of causal and acausal filters on elastic and inelastic response spectra. Earthq. Eng. Struct. Dyn. 2003, 32, 1729–1748. [Google Scholar] [CrossRef]
- Pal, S.; Dasaka, S.S.; Jain, A.K. Inelastic response spectra. Comput. Struct. 1987, 25, 335–344. [Google Scholar] [CrossRef]
- Tena-Colunga, A. Displacement ductility demand spectra for the seismic evaluation of structures. Eng. Struct. 2001, 23, 1319–1330. [Google Scholar] [CrossRef]
- Mahin, S.A.; Lin, J. Construction of Inelastic Response Spectra for Single-Degree-of-Freedom Systems; (UCB/EERC-83/17); Earthquake Engineering Center, University of California: Berkeley, CA, USA, 1983. [Google Scholar]
- Musson, R.M.W. Effective Peak Acceleration as a Parameter for Seismic Hazard Studies. In Proceedings of the 12th European Conference on Earthquake Engineering, London, UK, 9–13 September 2002. [Google Scholar]
- Newmark, N.M.; Hall, W.J. Earthquake Spectra and Design; Earthquake Engineering Research Institute: Los Angeles, CA, USA, 1982. [Google Scholar]
- Matheu, E.E.; Yule, D.E.; Kala, R.V. Determination of Standard Response Spectra and Effective Peak Ground Accelerations for Seismic Design and Evaluation; (ERDC/CHL CHETN-VI-41); U.S. Army Engineer Research and Development Center: Vicksburg, MS, USA, 2005. [Google Scholar]
- Vamvatsikos, D.; Cornell, C.A. Incremental dynamic analysis. Earthq. Eng. Struct. Dyn. 2002, 31, 491–514. [Google Scholar] [CrossRef]
- Somerville, P.G.; Smith, N.F.; Graves, R.W.; Abrahamson, N.A. Modification of Empirical Strong Ground Motion Attenuation Relations to Include the Amplitude and Duration Effects of Rupture Directivity. Seismol. Res. Lett. 1997, 68, 199–222. [Google Scholar] [CrossRef]
- Champion, C.; Liel, A. The effect of near-fault adirectivity on building seismic collapse risk. Earthq. Eng. Struct. Dyn. 2012, 41, 1391–1409. [Google Scholar] [CrossRef]
- Baker, J.W. Quantitative classification of near-fault ground motions using wavelet analysis. Bull. Seismol. Soc. Am. 2007, 97, 1486–1501. [Google Scholar] [CrossRef]
- Soroushian, A. A technique for time integration analysis with steps larger than the excitation steps. Commun. Numer. Methods Eng. 2008, 24, 2087–2111. [Google Scholar] [CrossRef]
- Nigam, N.C.; Jennings, P.C. Calculation of response spectra from strong-motion earthquake records. Bull. Seismol. Soc. Am. 1969, 59, 909–922. [Google Scholar] [CrossRef]
- Boore, D.M.; Goulet, C.A. The effect of sampling rate and anti-aliasing filters on high-frequency response spectra. Bull. Earthq. Eng. 2014, 12, 203–216. [Google Scholar] [CrossRef]
- Proakis, J.G.; Manolakis, D. Digital Signal Processing: Principles, Algorithms and Applications, 4th ed.; Pearson: London, UK, 2006; ISBN 978-0131873742. [Google Scholar]
- Graizer, V. Effect of Low-Pass Filtering and Re-Sampling on Spectral and Peak Ground Acceleration in Strong-Motion Records. In Proceedings of the 15th World Conference of Earthquake Engineering, Lisbon, Portugal, 24–28 September 2012; pp. 24–28. [Google Scholar]
- Douglas, J.; Boore, D.M. High-frequency filtering of strong-motion records. Bull. Earthq. Eng. 2011, 9, 395–409. [Google Scholar] [CrossRef]
- Kanade, V.V.; Dawari, B.M. Prediction of Plastic motion under strong earthquakes using Rigid-plastic Response. In Proceedings of the 2015 International Conference on Industrial Instrumentation and Control (ICIC), Pune, India, 28–30 May 2015; pp. 1665–1669. [Google Scholar] [CrossRef]
- Paglietti, A.; Porcu, M.C. Rigid–plastic approximation to predict plastic motion under strong earthquakes. Earthq. Eng. Struct. Dyn. 2001, 30, 115–126. [Google Scholar] [CrossRef]
- Garini, E.; Gazetas, G. Rocking and Sliding Potential of the 2014 Cephalonia, Greece Earthquakes. In Proceedings of the 1st International Conference on Natural Hazards & Infrastructure (ICONHIC 2016), Chania, Greece, 28–30 June 2016. [Google Scholar]
- Gazetas, G. Should Elastic Response Spectra be the Basis of Seismic Design of Strongly Inelastic and Soft-Soil–Structure Systems? In Proceedings of the 3rd International Symposium on Advances in Urban Safety, Nanjing, China, 24–25 November 2012.
- Fan, C.L.; Zhang, S.Y. Rigid-plastic seismic design of reinforced concrete shear wall. Int. J. Mod. Phys. B 2008, 22, 5740–5746. [Google Scholar] [CrossRef]
- Porcu, M.C.; Mascia, M. Rigid-Plastic Pseudo-Spectra: Peak Response Charts for Seismic Design. Eur. Earthq. Eng. 2006, 3, 37–47. [Google Scholar]
- Chopra, A.K. Dynamics of Structures. In Theory and Applications to Earthquake Engineering, 5th ed.; Pearson: London, UK, 2016; ISBN 978-013455512. [Google Scholar]
- Paultre, P. Response to Earthquake Excitation. In Dynamics of Structures; Wiley: Hoboken, NJ, USA, 2013; pp. 307–345. [Google Scholar] [CrossRef]
- Tena-Colunga, A. Simplified seismic evaluation of existing structures. In Proceedings of the 8th Canadian Conference on Earthquake Engineering, Vancouver, BC, Canada, 13–16 June 1999; pp. 317–322. [Google Scholar]
- Mashayekhi, M.; Harati, M.; Darzi, A.; Estekanchi, H.E. Incorporation of strong motion duration in incremental-based seismic assessments. Eng. Struct. 2020, 223, 111144. [Google Scholar] [CrossRef]
- Deng, P.; Pei, S.; van de Lindt, J.W.; Liu, H.; Zhang, C. An approach to quantify the influence of ground motion uncertainty on elastoplastic system acceleration in incremental dynamic analysis. Adv. Struct. Eng. 2017, 20, 1744–1756. [Google Scholar] [CrossRef]
- Krawinkler, H.; Parisi, F.; Ibarra, L.; Ayoub, A.; Medina, R. Development of a Testing Protocol for Woodframe Structures; (CUREE publication No. W-02); Consortium of Universities for Research in Earthquake Engineering (CUREE): Richmond, CA, USA, 2001. [Google Scholar]
- De Luca, F.; Vamvatsikos, D.; Iervolino, I. Near-optimal bilinear fit of capacity curves for equivalent SDOF analysis. In Proceedings of the 3rd ECCOMAS Thematic Conference on Computational Methods in Structural Dynamics and Earthquake Engineering (COMPDYN 2011), Corfu, Greece, 26–28 May 2011; pp. 2470–2486. [Google Scholar]
- Shahi, S.K.; Baker, J.W. An Efficient Algorithm to Identify Strong—Velocity Pulses in Multicomponent Ground Motions. Bull. Seismol. Soc. Am. 2014, 104, 2456–2466. [Google Scholar] [CrossRef]
- Zhou, X.; Tamma, K.K. Design, analysis, and synthesis of generalized single step single solve and optimal algorithms for structural dynamics. Int. J. Numer. Methods Eng. 2004, 59, 597–668. [Google Scholar] [CrossRef]
- Papazafeiropoulos, G.; Plevris, V.; Papadrakakis, M. A generalized algorithm framework for non-linear structural dynamics. Bull. Earthq. Eng. 2017, 15, 411–441. [Google Scholar] [CrossRef]
- Lagaros, N.D.; Plevris, V. Artificial Intelligence (AI) Applied in Civil Engineering. Appl. Sci. 2022, 12, 7595. [Google Scholar] [CrossRef]
- Lagaros, N.D.; Plevris, V. (Eds.) . Artificial Intelligence (AI) Applied in Civil Engineering; MDPI: Basel, Switzerland, 2022; p. 698. [Google Scholar] [CrossRef]
- Plevris, V.; Ahmad, A.; Lagaros, N.D. (Eds.) . Artificial Intelligence and Machine Learning Techniques for Civil Engineering; IGI Global: Hershey, PA, USA, 2023. [Google Scholar] [CrossRef]
Syntax | Task |
---|---|
PARAM = OpenSeismoMatlab(DT,XGTT,SW,__) | General syntax with default input (switch is needed) |
PARAM = OpenSeismoMatlab(DT,XGTT,‘ARIAS’) | Arias intensity, cumulative energy, significant duration [1] |
PARAM = OpenSeismoMatlab(DT,XGTT,… ‘BUTTERWORTHHIGH’,BORDER,FLC) | High-pass Butterworth filter |
PARAM = OpenSeismoMatlab(DT,XGTT,… ‘BUTTERWORTHLOW’,BORDER,FHC) | Low-pass Butterworth filter |
PARAM = OpenSeismoMatlab(DT,XGTT,‘CDRS’,T,KSI,MU,PYSF,DTTOL,ALGID,RINF,MAXTOL,JMAX,DAK) | Constant ductility response spectrum [1] |
PARAM = OpenSeismoMatlab(DT,XGTT,‘CSRS’,T,KSI,FYR,PYSF,DTTOL,ALGID,RINF,MAXTOL,JMAX,DAK) | Constant strength response spectrum |
PARAM = OpenSeismoMatlab(DT,XGTT,‘ELRS’,T,KSI,ALGID,RINF,DTTOL) | Linear elastic response spectrum [1] |
PARAM = OpenSeismoMatlab(DT,XGTT,‘EPGA’) | Effective peak ground acceleration |
PARAM = OpenSeismoMatlab(DT,XGTT,‘FAS’) | Fourier amplitude spectrum [1] |
PARAM = OpenSeismoMatlab(DT,XGTT,‘IDA’,T,… LAMBDAF,IM_DM,M,UY,PYSF,KSI,ALGID,U0,UT0,… RINF,MAXTOL,JMAX,DAK) | Incremental dynamic analysis of SDOF system |
PARAM = OpenSeismoMatlab(DT,XGTT,‘PGA’) | Peak ground acceleration [1] |
PARAM = OpenSeismoMatlab(DT,XGTT,‘PGD’) | Peak ground displacement [1] |
PARAM = OpenSeismoMatlab(DT,XGTT,‘PGV’) | Peak ground velocity [1] |
PARAM = OpenSeismoMatlab(DT,XGT,‘PULSEDECOMP’,WNAME,TPMIN,TPMAX,NSCALES) | Pulse decomposition |
PARAM = OpenSeismoMatlab(DT,XGTT, ‘SINCRESAMPLE’,DTI) | Resampling (change time step size) |
PARAM = OpenSeismoMatlab(DT,XGTT,‘RPSRS’,CF,… ALGID,RINF,MAXTOL,JMAX,DAK) | Rigid-plastic sliding response spectrum |
PARAM = OpenSeismoMatlab(DT,XGTT,‘SIH1952’) | Spectral intensity [4] |
PARAM = OpenSeismoMatlab(DT,XGTT,‘SINH1984’) | Spectral intensity [5] |
PARAM = OpenSeismoMatlab(DT,XGTT,‘TIMEHIST’,… BASELINESW) | Velocity and displacement time histories with baseline correction or not [1] |
Notation | Default | Description |
---|---|---|
Input | ||
DT | (-) s | Time step of the input acceleration time history XGTT |
XGTT | (-) m/s2 | Input acceleration time history |
BORDER | 4 | Order of Butterworth filter |
FLC | 0.1 Hz | Low cutoff frequency (for ‘BUTTERWORTHHIGH’) |
FHC | 10 Hz | High cutoff frequency (for ‘BUTTERWORTHLOW’) |
Output | ||
ACC | - | Filtered acceleration |
Notation | Default | Description |
---|---|---|
Input | ||
DT | (-) s | Time step of the input acceleration time history XGTT |
XGTT | (-) m/s2 | Input acceleration time history |
T | [0.02, 50] s | Eigenperiods for which the response spectra are requested |
KSI | 0.05 | Fraction of critical viscous damping |
MU | 2 | Target ductility |
N | 100 | Maximum number of convergence iterations |
PYSF | 0.01 | Post-yield stiffness factor (ratio of post-yield stiffness to small strain stiffness) |
DTTOL | 0.01 | Tolerance for resampling of XGTT |
Output | ||
PSA | - | Pseudoacceleration |
PSV | - | Pseudovelocity |
SD | - | Spectral displacement |
SV | - | Spectral velocity |
SA | - | Spectral acceleration |
FYK | - | Yield strength corresponding to target ductility MU |
MUK | - | Ductility achieved. Must be close to MU |
ITERK | - | Iterations needed for convergence to MUK |
Notation | Default | Description |
---|---|---|
Input | ||
DT | (-) s | Time step of the input acceleration time history XGTT |
XGTT | (-) m/s2 | Input acceleration time history |
T | [0.02, 50] s | Eigenperiods for which the response spectra are requested |
KSI | 0.05 | Fraction of critical viscous damping |
FYR | 0.1 | Yield strength ratio (yield shear to structure weight ratio) |
PYSF | 0.01 | Post-yield stiffness factor (ratio of post-yield stiffness to small strain stiffness) |
DTTOL | 0.01 | Tolerance for resampling of XGTT |
Output | ||
SMU | - | Spectral ductility demand |
SD | - | Spectral displacement |
SV | - | Spectral velocity |
SA | - | Spectral acceleration |
SEY | - | Spectral yield energy |
SED | - | Spectral damping energy |
Notation | Default | Description |
---|---|---|
Input | ||
DT | (-) s | Time step of the input acceleration time history XGTT |
XGTT | (-) m/s2 | Input acceleration time history |
T | 1 s | Eigenperiod of the SDOF system |
LAMBDAF | [0.05, 4] | Scaling factor (λ factor) for the IDA |
IM_DM | ‘SA_DISP’ | Intensity Measure (IM)–Damage Measure (DM) pair |
M | 1 kg | Mass of the SDOF oscillator |
UY | 0.01 m | Yield displacement |
PYSF | 0.01 | Post-yield stiffness factor (ratio of post-yield stiffness to small strain stiffness) |
KSI | 0.05 | Fraction of critical viscous damping |
Output | ||
DM | - | Values of damage measure |
IM | - | Values of intensity measure |
Notation | Default | Description |
---|---|---|
Input | ||
DT | (-) s | Time step of the input acceleration or velocity time history XGTT or XGT |
XGTT | (-) m/s2 | Input acceleration time history |
XGT | (-) m/s | Input velocity time history |
WNAME | Daubechies wavelet of order 4 | Wavelet family |
TPMIN | 0.25 s | Minimum pulse period for continuous wavelet transform |
TPMAX | 15 s | Maximum pulse period for continuous wavelet transform |
NSCALES | 50 | Number of values between TPMIN and TPMAX |
Output | ||
PULSETH | - | Time history of the pulse |
RESTH | - | Time history of the residual motion |
TP | - | Period of the extracted pulse |
WAVSCALE | - | Scale of largest wavelet found |
WAVCOEFS | - | Coefficient for the extracted wavelet |
Notation | Default | Description |
---|---|---|
Input | ||
DT | (-) s | Time step of the input acceleration or velocity time history XGTT or XGT |
XGTT | (-) m/s2 | Input acceleration time history |
DTI | 0.01 s | Time step of the resampled time history |
Output | ||
ACC | - | Resampled acceleration time history |
TIME | - | Time steps for the resampled acceleration time history |
Notation | Default | Description |
---|---|---|
Input | ||
DT | (-) s | Time step of the input acceleration time history XGTT |
XGTT | (-) m/s2 | Input acceleration time history |
CF | [0.05, 0.5] | Range of Coulomb friction coefficients |
Output | ||
SD | - | Spectral displacement |
SV | - | Spectral velocity |
SA | - | Spectral acceleration |
Disclaimer/Publisher’s Note: The statements, opinions and data contained in all publications are solely those of the individual author(s) and contributor(s) and not of MDPI and/or the editor(s). MDPI and/or the editor(s) disclaim responsibility for any injury to people or property resulting from any ideas, methods, instructions or products referred to in the content. |
© 2024 by the authors. Licensee MDPI, Basel, Switzerland. This article is an open access article distributed under the terms and conditions of the Creative Commons Attribution (CC BY) license (https://creativecommons.org/licenses/by/4.0/).
Share and Cite
Papazafeiropoulos, G.; Plevris, V. OpenSeismoMatlab: New Features, Verification and Charting Future Endeavors. Buildings 2024, 14, 304. https://doi.org/10.3390/buildings14010304
Papazafeiropoulos G, Plevris V. OpenSeismoMatlab: New Features, Verification and Charting Future Endeavors. Buildings. 2024; 14(1):304. https://doi.org/10.3390/buildings14010304
Chicago/Turabian StylePapazafeiropoulos, George, and Vagelis Plevris. 2024. "OpenSeismoMatlab: New Features, Verification and Charting Future Endeavors" Buildings 14, no. 1: 304. https://doi.org/10.3390/buildings14010304
APA StylePapazafeiropoulos, G., & Plevris, V. (2024). OpenSeismoMatlab: New Features, Verification and Charting Future Endeavors. Buildings, 14(1), 304. https://doi.org/10.3390/buildings14010304