Skip to content

Latest commit



116 lines (66 loc) · 6.44 KB


File metadata and controls

116 lines (66 loc) · 6.44 KB

Inno3DPnPJoint Element

This command is used to construct a three-dimensional beam-column-joint element object for the 3D innovative plug-and-play steel tubular joint configuration proposed within the INNO3DJOINTS project.

Command Lines


element Inno3DPnPJoint $eleTag $Node1 $Node2 $Node3 $Node4 $Node5 $SprMatTag01 $SprMatTag02 $SprMatTag03 $SprMatTag04 $SprMatTag05 $SprMatTag06 $SprMatTag07 $SprMatTag08 $SprMatTag09 $SprMatTag10 $SprMatTag11 $SprMatTag12 $SprMatTag13 $SprMatTag14 $SprMatTag15 $SprMatTag16 $SprMatTag17 $SprMatTag18 $SprMatTag19 $SprMatTag20 $SprMatTag21 $SprMatTag22 $SprMatTag23 $SprMatTag24 $SprMatTag25 $SprMatTag26 $SprMatTag27 $SprMatTag28 $SprMatTag29 $SprMatTag30 $SprMatTag31 $SprMatTag32


element('Inno3DPnPJoint', eleTag, Node1, Node2, Node3, Node4, Node5, SprMatTag01, SprMatTag02, SprMatTag03, SprMatTag04, SprMatTag05, SprMatTag06, SprMatTag07, SprMatTag08, SprMatTag09, SprMatTag10, SprMatTag11, SprMatTag12, SprMatTag13, SprMatTag14, SprMatTag15, SprMatTag16, SprMatTag17, SprMatTag18, SprMatTag19, SprMatTag20, SprMatTag21, SprMatTag22, SprMatTag23, SprMatTag24, SprMatTag25, SprMatTag26, SprMatTag27, SprMatTag28, SprMatTag29, SprMatTag30, SprMatTag31, SprMatTag32)


Argument Type Description
$eleTag Unique element object tag
$Node1 ... $Node5 Node tags
$SprMatTag1 ... $SprMatTag32 Uniaxial material tags

Inno3DPnPJoint Element: 32 components.

Inno3DPnPJoint Element: 32 components.

Output Recorders

The simulation results of the Inno3DPnPJoint beam-to-column joint finite element can be analyzed by defining output records at both the element and component levels.

At the element level, valid inquiries include:

  • `extDisp (or extdisp)`: Returns the displacement for the external DOFs, comprising 30 values.
  • `intDisp (or intdisp)`: Returns the displacement for the internal DOFs, comprising 4 values.
  • `Disp (or disp)`: Returns the displacement for the external and internal DOFs, comprising 34 values.
  • `Reaction (or reaction)`: Returns the global residual forces for all DOFs, comprising 34 values.
  • `matStress (or matstress or Stress or stress)`: Returns the stress values from the joint components, comprising 32 values.
  • `matStrain (or matstrain or Strain or strain)`: Returns the strain values from the joint components, comprising 32 values.
  • `matStressStrain (or matstressstrain or StressStrain or stressStrain)`: Returns the stress and strain values from the joint components, comprising 64 values.

At the component level, valid inquiries include:

  • `spring (or -spring or material or -material)`: Returns a pair of stress-strain for each time step, comprising 2 values.


Command Lines

The following example constructs constructs an Inno3DPnPJoint joint element with element tag 99, that is connected to nodes 101, 102, 103, 104 and 105 and uses for the components’ behavior the uniaxial material object tags from 1 to 32.

  1. Tcl
element Inno3DPnPJoint 99 101 102 103 104 105 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32; 
  1. Python
element('Inno3DPnPJoint', 99, 101, 102, 103, 104, 105, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32)

Advanced Tool for Calculating Initial Stiffness of Tube Components """"""""""""""""""""""" The calculation of initial stiffness for tube components, encompassing face (components no. 25, 26, 27, and 28) and interaction components (components no. 29, 30, 31, and 32), within the Inno3DPnPJoint beam-to-column finite element, is facilitated through a specialized Jupyter notebook. This notebook allows dynamic execution via Binder, offering users an interactive platform for computational analysis.

The notebook is publicly accessible on GitHub:

Additionally, a comprehensive video tutorial titled "Inno3DPnPJoint Element: Tube Components Initial Stiffness Calculator with Jupyter Notebook & Binder" is available on YouTube:

When citing this notebook, please use the following format: "Cristian V. Miculaș. (2023). Tube Components Initial Stiffness Calculator for Inno3DPnPJoint Element from OpenSees (Version 0.1.0) [Interactive Notebook]. Zenodo."


More information available in the following reference:

  1. C.V. Miculaş, Innovative plug and play joints for hybrid tubular constructions (Ph.D. thesis), University of Coimbra, Portugal, 2023,
  2. C.V. Miculaş, R. J. Costa, L. S. da Silva, R. Simões, H. Craveiro, T. Tankova, 3D macro-element for innovative plug-and-play joints, J. Constructional Steel Research 214 (2024),
  3. C.V. Miculaş, R.J. Costa, L. Simões da Silva, R. Simões, H. Craveiro, T. Tankova, Macro-modelling of the three-dimensional interaction between the faces of a steel tubular column joint, in: F. Di Trapani, C. Demartino, G.C. Marano, G. Monti (Eds.), Proceedings of the 2022 Eurasian OpenSees Days, Springer Nature Switzerland, Cham, 2023, pp. 408–422,

Other info


Code development: Cristian V. Miculaș (github user name: cvmiculas)

Element conceptualization: Cristian V. Miculaș (, Ricardo J. Costa ( and Luís Simões da Silva (

Affiliation: Civil Engineering Department, Institute for Sustainability and Innovation in Structural Engineering (ISISE), University of Coimbra, Portugal.

Acknowledgements: This work has been supported in part by national funds through Foundation for Science and Technology (FCT), Portugal, under grant agreement SFRH/BD/138151/2018 awarded to Cristian V. Miculaş.

Code developed by: