journal article·2025-07-18Open access

Visualization of Distributed Plasticity in Concrete Piles Using OpenSeesPy

Juan-Carlos Pantoja, Joaquim Tinoco, Jhon Paul Smith-Pardo, Gustavo Boada-Parra, José Matos

Applied Sciences· Volume 15· Issue 14

Abstract

Lumped plasticity models available in commercial software offer a limited resolution of damage distribution along structural members. This study presents an open-source workflow that combines force-based fiber elements in OpenSeesPy with automated 3D post-processing for visualizing distributed plasticity in reinforced concrete piles. A 60 cm diameter pile subjected to monotonic lateral loading is analyzed using both SAP2000’s default plastic hinges and OpenSeesPy fiber sections (Concrete02/Steel02). Although the fiber model incurs a runtime approximately 2.5 times greater, it captures the gradual spread of yielding and deterioration with improved fidelity. The presented workflow includes Python routines for interactive stress–strain visualization, facilitating the identification of critical sections and verification of strain limits. This approach offers a computationally feasible alternative for performance-based analysis with enhanced insight into member-level behavior. Because the entire workflow—from model definition through post-processing—is fully scripted in Python, any change to geometry, materials, or loading can be re-run in seconds, dramatically reducing the time taken to execute sensitivity analyses.
Source: crossref · Quality: baseline

Research context

OpenAlex topics: Structural Behavior of Reinforced Concrete · Concrete Corrosion and Durability · Innovative concrete reinforcement materials

SciVX discovery tags are terminology-based. OpenAlex topics are source-provided classifications.

Affiliations

Department of Civil Engineering, Advanced Production and Intelligent Systems (ARISE), Institute for Sustainability and Innovation in Structural Engineering (ISISE), University of Minho, 4800-058 Guimarães, Portugal

Department of Civil and Environmental Engineering, Seattle University, Seattle, WA 98122, USA

Departamento de Ingeniería Del Transporte, Territorio y Urbanismo, Universidad Politécnica de Madrid, C/Profesor Aranguren 3, 28040 Madrid, Spain

Funding

FCT (Fundação para a Ciência e Tecnologia), I.P. · FCT/MCTES through national funds (PIDDAC) under the R&D Unit Institute for Sustainability and Innovation in Structural Engineering (ISISE) · Associate Laboratory Advanced Production and Intelligent Systems ARISE

References (58)

Show source-provided references
1. (2014). Seismic Design of Piers and Wharves (Standard No. ASCE/COPRI 61-14).
2. (2017). Seismic Evaluation and Retrofit of Existing Buildings (Standard No. ASCE 41-17).
3. (2024). Eurocode 8: Design of Structures for Earthquake Resistance—Part 1-1: General Rules and Seismic Action (Standard No. EN 1998-1-1:2024).
4. (2019). Building Code Requirements for Structural Concrete and Commentary (Standard No. ACI CODE-318-19(22)). Reapproved 2022.
5. POLB (2021). Port of Long Beach Wharf Design Criteria, Port of Long Beach.
6. POLA (2010). The Port of Los Angeles Code for Seismic Design, Upgrade and Repair of Container Wharves, Port of Los Angeles.
7. OCDI (2025). Technical Standards and Commentaries for Port and Harbour Facilities in Japan, The Overseas Coastal Area Development Institute of Japan.
8. Nonlinear structural analysis for seismic design
9. The accuracy of the lumped plasticity model for estimating nonlinear behavior of reinforced concrete frames under gradually increasing vertical loads10.1002/suco.201800357 ↗
10. Ilyas, M., Ahmad, A., Riaz, A., Khan, F.A., Sher, S., Waseem, M., Ali, S.Z., Badrashi, Y.I., Waqas, H.A., and Seitz, H. (2022). Review of modeling techniques for analysis and assessment of RC beam–column joints subjected to seismic loads. Materials, 15.10.3390/ma15217448 ↗
11. Refani, A.N., and Nagao, T. (2023). Simplified Method for Nonlinear Seismic Response Analysis of Corroded Pile-Supported Wharf. Appl. Sci., 13.10.3390/app131910936 ↗
12. New spread plasticity model for reinforced concrete structural elements accounting for both gravity and lateral load effects10.1061/(ASCE)ST.1943-541X.0002016 ↗
13. ASCE/SEI 41 assessment of reinforced concrete buildings: Benchmarking nonlinear dynamic procedures with empirical damage observations10.1177/87552930231173453 ↗
14. Abuduweili, Y., Ma, L., Shi, K., and Zhu, X. (2025). Bearing Capacity and Deformation of Micropiles Considering Plastic Hinge. Buildings, 15.10.3390/buildings15071168 ↗
15. Seismic vulnerability assessment of pile-supported wharves using fragility curves10.1080/15732479.2013.823453 ↗
16. The influence of the soil constitutive models on the seismic analysis of pile-supported wharf structures with batter piles in cut-slope rock dike10.2478/sgem-2019-0050 ↗
17. Boyke, C., and Nagao, T. (2023). Seismic Performance Assessment of Pile-Supported Wharfs: 2D Frame Analysis Method Considering Both Inertial and Kinematic Forces. Appl. Sci., 13.10.3390/app13063629 ↗
18. Zhao, J., Cui, C., Zhang, P., Wang, K., and Zhao, M. (2023). Parameter sensitivity analysis of the seismic response of a piled wharf structure. Buildings, 13.10.3390/buildings13020349 ↗
19. Dynamic non-linear soil-structure interaction analyses of a large diameter pile-supported wharf founded on liquefiable soils
20. Roth, W., and Dawson, E. (2003). Analyzing the seismic performance of wharves, part 2: SSI analysis with non-linear, effective-stress soil models. Advancing Mitigation Technologies and Disaster Response for Lifeline Systems, American Society of Civil Engineers.10.1061/40687(2003)41 ↗
21. Implications of the observed seismic performance of a pile-supported wharf for numerical modeling10.1193/1.1978887 ↗
22. Pushover analysis for flexible and semi-flexible pile-supported wharf structures accounting the dynamic magnification factors due to torsional effects10.1002/suco.202000137 ↗
23. Seismic vulnerability assessment of pile-supported wharves using fragility surfaces10.1080/13632469.2021.1961926 ↗
24. Geometrically nonlinear flexibility-based frame finite element10.1061/(ASCE)0733-9445(1998)124:6(704) ↗
25. Displacement, flexibility, and mixed beam–column finite element formulations for distributed plasticity analysis10.1061/(ASCE)0733-9445(2005)131:12(1811) ↗
26. Zeng, X.G., Jiang, S.F., Xu, X.C., and Huang, H.S. (2019). Numerical modeling of earthquake-damaged circular bridge columns repaired using combination of near-surface-mounted BFRP bars with external BFRP sheets jacketing. Materials, 12.10.3390/ma12020258 ↗
27. Darmawan, M.F., Fajar, A., Satyarno, I., Awaludin, A., and Yogatama, B.A. Seismic Performance Comparison of Pile Supported Slab Viaduct with PHC Pile and RC Bored Pile in South Part of Java Island. Proceedings of the 5th International Conference on Sustainable Civil Engineering Structures and Construction Materials.
28. Goswami, K., Bose, S., Banerjee, A., and Chakraborty, S. (2022). ML-Based Surrogate Model for RC Bridge Pier Collapse Fragility Prediction. Proceedings of 17th Symposium on Earthquake Engineering, Springer.
29. Nonlinear numerical simulation of dynamic response of pile site and pile foundation under earthquake10.1515/nleng-2022-0228 ↗
30. Nonlinear analysis for investigating seismic performance of a spun pile-column of viaduct structure10.28991/CEJ-2023-09-07-02 ↗
31. Tipsunavee, T., Arangjelovski, G., and Jongpradist, P. (2023). Numerical analysis on effects of soil improvement on pile forces on existing high-rise building. Buildings, 13.10.3390/buildings13061523 ↗
32. Çetindemir, O., and Zülfikar, A.C. (2024). Numerical validation of fully coupled nonlinear seismic soil–pile–structure interaction. Buildings, 14.10.3390/buildings14061502 ↗
33. Seismic analyses of conventional and improved marginal wharves10.1002/eqe.2280 ↗
34. Evaluation of in-ground plastic-hinge length and depth for piles in marine oil terminals10.1193/071813EQS207M ↗
35. Seismic performance of a pile-supported wharf: Three-dimensional finite element simulation10.1016/j.soildyn.2017.01.009 ↗
36. Seismic performance evaluation of a pile-supported wharf system at two seismic hazard levels10.1016/j.oceaneng.2020.108333 ↗
37. Response characteristic of crane-wharf interaction system: Numerical simulation and global sensitivity analysis10.1016/j.oceaneng.2022.113011 ↗
38. ASDEA Software Technology (2025, July 05). STKO—Scientific ToolKit for OpenSees. Version 4.0.0. Available online: https://asdea.eu/software/.
39. (2025, February 05). vfo—Visualization for OpenSees. Available online: https://vfo.readthedocs.io/en/latest/.
40. OpenSeesPy: Python library for the OpenSees finite element framework10.1016/j.softx.2017.10.009 ↗
41. OpenSees: A framework for earthquake engineering simulation10.1109/MCSE.2011.66 ↗
42. opseestools: A Python library to streamline OpenSeesPy workflows10.1016/j.softx.2024.101832 ↗
43. opstool: A Python library for OpenSeesPy analysis automation, streamlined pre-and post-processing, and enhanced data visualization10.1016/j.softx.2025.102126 ↗
44. An Open-Source Framework for Modeling RC Shear Walls Using Deep Neural Networks
45. Smyl, D. (2025). OpenPyStruct: Open-Source Toolkit for Machine Learning-Driven Structural Optimization. engrxiv.10.31224/4365 ↗
46. McGann, C., and Arduino, P. (2025, February 05). Laterally-Loaded Pile Foundation. Available online: https://opensees.berkeley.edu/wiki/index.php/Laterally-Loaded_Pile_Foundation.
47. Nonlinear modelling strategies for seismic performance evaluation of reinforced concrete structures
48. Segura Jr, C.L., Sattar, S., and Hariri-Ardebili, M.A. (2022). Quantifying material uncertainty in seismic evaluations of reinforced concrete bridge column structures. ACI Struct. J., 119.10.14359/51734486 ↗
49. Koronides, M., Michailides, C., and Onoufriou, T. (2024). Nonlinear Soil–Pile–Structure Interaction Behaviour of Marine Jetty Structures. J. Mar. Sci. Eng., 12.10.3390/jmse12071153 ↗
50. Koronides, M., Michailides, C., Stylianidis, P., and Onoufriou, T. (2024). Numerical Study of the Nonlinear Soil–Pile–Structure Interaction Effects on the Lateral Response of Marine Jetties. J. Mar. Sci. Eng., 12.10.3390/jmse12112075 ↗
51. API (2019). API Recommended Practice 2A-LRFD: Planning, Designing, and Constructing Fixed Offshore Platforms—Load and Resistance Factor Design, American Petroleum Institute. [2nd ed.].
52. Mosher, R.L. (1984). Load-Transfer Criteria for Numerical Analysis of Axially Loaded Piles in Sand. Part 1: Load-Transfer Criteria, US Army Engineer Waterways Experiment Station. Final Report.10.21236/ADA139621 ↗
53. Kulhawy, F.H. (1991). Drilled Shaft Foundations, Springer.10.1007/978-1-4615-3928-5_14 ↗
54. Bearing capacity and settlement of pile foundations10.1061/AJGEB6.0000243 ↗
55. Vijivergiya, V. (1977, January 9–11). Load-movement characteristics of piles. Proceedings of the 4th Symp. of Waterway, Port, Coastal and Occean Div., ASCE, Long Beach, CA, USA.
56. Kulhawy, F.H., and Mayne, P.W. (1990). Manual on Estimating Soil Properties for Foundation Design, Cornell University. Technical Report.
57. Theoretical stress-strain model for confined concrete10.1061/(ASCE)0733-9445(1988)114:8(1804) ↗
58. Park, R., and Paulay, T. (1991). Reinforced Concrete Structures, John Wiley & Sons.