Gupta1999 Class Reference

Class that stores funcions and material properties of a steel double symmetric I-shape profile with Gupta 1999 as the material model for the panel zone and the OpenSeesPy command type used to model it is Hysteresis. More...

Inheritance diagram for Gupta1999:

Public Member Functions
def	__init__ (self, int ID, d_c, bf_c, tf_c, I_c, d_b, tf_b, Fy, E, t_p, t_dp=0.0, a_s=0.03, pinchx=0.25, pinchy=0.75, dmg1=0.0, dmg2=0.0, beta=0.0, safety_factor=False)
	Constructor of the class. More...
def	CheckApplicability (self)
	Implementation of the homonym abstract method. More...
def	Hysteretic (self)
	Generate the material model Hysteretic (Gupta 1999) using the computed parameters. More...
def	ReInit (self)
	Implementation of the homonym abstract method. More...
def	ShowInfo (self, plot=False, block=False)
	Implementation of the homonym abstract method. More...
def	UpdateStoredData (self)
	Implementation of the homonym abstract method. More...
def	CheckApplicability (self)
	Abstract function used to check the applicability of the material model. More...

Public Attributes
	a_s
	beam_section_name_tag
	beta
	bf_c
	col_section_name_tag
	d_b
	d_c
	data
	dmg1
	dmg2
	E
	Fy
	G
	gamma1_y
	gamma2_y
	gamma3_y
	I_c
	ID
	Initialized
	Ke
	Kp
	M1y
	M2y
	M3y
	pinchx
	pinchy
	Ry
	t_dp
	t_p
	t_pz
	tf_b
	tf_c
	Vy

Detailed Description

Class that stores funcions and material properties of a steel double symmetric I-shape profile with Gupta 1999 as the material model for the panel zone and the OpenSeesPy command type used to model it is Hysteresis.

The material model is valid only if the column is continuous. For more information about the empirical model for the computation of the parameters, see Gupta 1999.

Parameters

MaterialModels

Parent abstract class.

Definition at line 522 of file MaterialModels.py.

Constructor & Destructor Documentation

__init__()

def __init__	(		self,
		int	ID,
			d_c,
			bf_c,
			tf_c,
			I_c,
			d_b,
			tf_b,
			Fy,
			E,
			t_p,
			t_dp = 0.0,
			a_s = 0.03,
			pinchx = 0.25,
			pinchy = 0.75,
			dmg1 = 0.0,
			dmg2 = 0.0,
			beta = 0.0,
			safety_factor = False
	)

Constructor of the class.

Parameters

ID	(int): Unique material model ID.
d_c	(float): Column depth.
bf_c	(float): Column flange width.
tf_c	(float): Column flange thickness.
I_c	(float): Column moment of inertia (strong axis).
d_b	(float): Beam depth.
tf_b	(float): Beam flange thickness.
Fy	(float): Yield strength (if assume continous column, Fy of the web).
E	(float): Young modulus.
t_p	(float): Panel zone thickness.
t_dp	(float, optional): Doubler plate thickness. Defaults to 0.0.
a_s	(float, optional): Strain hardening. Defaults to 0.03.
pinchx	(float, optional): Pinching factor for strain (or deformation) during reloading. Defaults to 0.25.
pinchy	(float, optional): Pinching factor for stress (or force) during reloading. Defaults to 0.75.
dmg1	(float, optional): Damage due to ductility: D1(mu-1). Defaults to 0.0.
dmg2	(float, optional): Damage due to energy: D2(Eii/Eult). Defaults to 0.0.
beta	(float, optional): Power used to determine the degraded unloading stiffness based on ductility, mu-beta. Defaults to 0.0.
safety_factor	(bool, optional): Safety factor used if standard mechanical parameters are used (not test results). Defaults to False.

Exceptions

NegativeValue	ID needs to be a positive integer.
NegativeValue	d_c needs to be positive.
NegativeValue	bf_c needs to be positive.
NegativeValue	tf_c needs to be positive.
NegativeValue	d_b needs to be positive.
NegativeValue	tf_b needs to be positive.
NegativeValue	Fy needs to be positive.
NegativeValue	E needs to be positive.
NegativeValue	t_p needs to be positive.
NegativeValue	a_s needs to be positive.

Reimplemented in Gupta1999SteelIShape.

Definition at line 531 of file MaterialModels.py.

        t_dp = 0.0, a_s = 0.03, pinchx = 0.25, pinchy = 0.75, dmg1 = 0.0, dmg2 = 0.0, beta = 0.0, safety_factor = False):
        """
        Constructor of the class.
 
        @param ID (int): Unique material model ID.
        @param d_c (float): Column depth.
        @param bf_c (float): Column flange width.
        @param tf_c (float): Column flange thickness.
        @param I_c (float): Column moment of inertia (strong axis).
        @param d_b (float): Beam depth.
        @param tf_b (float): Beam flange thickness.
        @param Fy (float): Yield strength (if assume continous column, Fy of the web).
        @param E (float): Young modulus.
        @param t_p (float): Panel zone thickness.
        @param t_dp (float, optional): Doubler plate thickness. Defaults to 0.0.
        @param a_s (float, optional): Strain hardening. Defaults to 0.03.
        @param pinchx (float, optional): Pinching factor for strain (or deformation) during reloading. Defaults to 0.25.
        @param pinchy (float, optional): Pinching factor for stress (or force) during reloading. Defaults to 0.75.
        @param dmg1 (float, optional): Damage due to ductility: D1(mu-1). Defaults to 0.0.
        @param dmg2 (float, optional): Damage due to energy: D2(Eii/Eult). Defaults to 0.0.
        @param beta (float, optional): Power used to determine the degraded unloading stiffness based on ductility, mu-beta. Defaults to 0.0.
        @param safety_factor (bool, optional): Safety factor used if standard mechanical parameters are used (not test results). Defaults to False.
 
        @exception NegativeValue: ID needs to be a positive integer.
        @exception NegativeValue: d_c needs to be positive.
        @exception NegativeValue: bf_c needs to be positive.
        @exception NegativeValue: tf_c needs to be positive.
        @exception NegativeValue: d_b needs to be positive.
        @exception NegativeValue: tf_b needs to be positive.
        @exception NegativeValue: Fy needs to be positive.
        @exception NegativeValue: E needs to be positive.
        @exception NegativeValue: t_p needs to be positive.
        @exception NegativeValue: a_s needs to be positive.
        """
        # Check
        if ID < 1: raise NegativeValue()
        if d_c < 0: raise NegativeValue()
        if bf_c < 0: raise NegativeValue()
        if tf_c < 0: raise NegativeValue()
        if d_b < 0: raise NegativeValue()
        if tf_b < 0: raise NegativeValue()
        if Fy < 0: raise NegativeValue()
        if E < 0: raise NegativeValue()
        if t_p < 0: raise NegativeValue()
        if a_s < 0: raise NegativeValue()
 
        # Arguments
        self.ID = ID
        self.d_c = d_c
        self.bf_c = bf_c
        self.tf_c = tf_c
        self.I_c = I_c
        self.d_b = d_b
        self.tf_b = tf_b
        self.Fy = Fy
        self.E = E
        self.t_p = t_p
        self.t_dp = t_dp
        self.a_s = a_s
        self.pinchx = pinchx
        self.pinchy = pinchy
        self.dmg1 = dmg1
        self.dmg2 = dmg2
        self.beta = beta
        if safety_factor:
            self.Ry = 1.2
        else:
            self.Ry = 1.0
 
        # Initialized the parameters that are dependent from others
        self.beam_section_name_tag = "None"
        self.col_section_name_tag = "None"
        self.Initialized = False
        self.ReInit()
 
 

Member Function Documentation

CheckApplicability()

def CheckApplicability

(

self

)

Implementation of the homonym abstract method.

See parent class MaterialModels for detailed information.

Reimplemented from MaterialModels.

Definition at line 722 of file MaterialModels.py.

    def CheckApplicability(self):
        """
        Implementation of the homonym abstract method.
        See parent class MaterialModels for detailed information.
        """
        Check = True
        # No checks
        if not Check:
            print("The validity of the equations is not fullfilled.")
            print("!!!!!!! WARNING !!!!!!! Check material model of Gupta 1999, ID=", self.ID)
            print("")
 
 

Hysteretic()

def Hysteretic

(

self

)

Generate the material model Hysteretic (Gupta 1999) using the computed parameters.

See _Hysteretic function for more information.

Definition at line 735 of file MaterialModels.py.

    def Hysteretic(self):
        """
        Generate the material model Hysteretic (Gupta 1999) using the computed parameters.
        See _Hysteretic function for more information.
        """
        _Hysteretic(self.ID, self.M1y, self.gamma1_y, self.M2y, self.gamma2_y, self.M3y, self.gamma3_y,
            self.pinchx, self.pinchy, self.dmg1, self.dmg2, self.beta)
        self.Initialized = True
        self.UpdateStoredData()
 
 

ReInit()

def ReInit

(

self

)

Implementation of the homonym abstract method.

See parent class DataManagement for detailed information.

Definition at line 609 of file MaterialModels.py.

    def ReInit(self):
        """
        Implementation of the homonym abstract method.
        See parent class DataManagement for detailed information.
        """
        # Check applicability
        self.CheckApplicability()
 
        # Members
        if self.beam_section_name_tag != "None": self.beam_section_name_tag = self.beam_section_name_tag + " (modified)"
        if self.col_section_name_tag != "None": self.col_section_name_tag = self.col_section_name_tag + " (modified)"
 
        # Trilinear Parameters
        self.t_pz = self.t_p + self.t_dp
        self.Vy = 0.55 * self.Fy * self.Ry * self.d_c * self.t_pz # Yield Shear
        self.G = self.E/(2.0 * (1.0 + 0.30)) # Shear Modulus
        self.Ke = 0.95 * self.G * self.t_pz * self.d_c # Elastic Stiffness
        self.Kp = 0.95 * self.G * self.bf_c * (self.tf_c * self.tf_c) / self.d_b # Plastic Stiffness
 
        # Define Trilinear Equivalent Rotational Spring
        # Yield point for Trilinear Spring at gamma1_y
        self.gamma1_y = self.Vy / self.Ke
        self.M1y = self.gamma1_y * (self.Ke * self.d_b)
        # Second Point for Trilinear Spring at 4 * gamma1_y
        self.gamma2_y = 4.0 * self.gamma1_y
        self.M2y = self.M1y + (self.Kp * self.d_b) * (self.gamma2_y - self.gamma1_y)
        # Third Point for Trilinear Spring at 100 * gamma1_y
        self.gamma3_y = 100.0 * self.gamma1_y
        self.M3y = self.M2y + (self.a_s * self.Ke * self.d_b) * (self.gamma3_y - self.gamma2_y)
 
        # Data storage for loading/saving
        self.UpdateStoredData()
 
 

ShowInfo()

def ShowInfo	(		self,
			plot = False,
			block = False
	)

Implementation of the homonym abstract method.

See parent class DataManagement for detailed information.

Parameters

plot	(bool, optional): Option to show the plot of the material model. Defaults to False.
block	(bool, optional): Option to wait the user command 'plt.show()' (avoiding the stop of the program everytime that a plot should pop up). Defaults to False.

Definition at line 682 of file MaterialModels.py.

    def ShowInfo(self, plot = False, block = False):
        """
        Implementation of the homonym abstract method.
        See parent class DataManagement for detailed information.
 
        @param plot (bool, optional): Option to show the plot of the material model. Defaults to False.
        @param block (bool, optional): Option to wait the user command 'plt.show()' (avoiding the stop of the program everytime that a plot should pop up). Defaults to False.
        """
        print("")
        print("Requested info for Gupta 1999 material model Parameters, ID = {}".format(self.ID))
        print("Sections associated, column: {} ".format(self.col_section_name_tag))
        print("Sections associated, beam: {} ".format(self.beam_section_name_tag))
        print("gamma1_y = {} rad".format(self.gamma1_y))
        print("gamma2_y = {} rad".format(self.gamma2_y))
        print("gamma3_y = {} rad".format(self.gamma3_y))
        print("M1y = {} kNm".format(self.M1y/kNm_unit))
        print("M2y = {} kNm".format(self.M2y/kNm_unit))
        print("M3y = {} kNm".format(self.M3y/kNm_unit))
        print("")
        
        if plot:
            # Data for plotting
            # Last point for plot
            gamma3_y_plot = 10.0 * self.gamma1_y
            M3y_plot = self.M2y + (self.a_s * self.Ke * self.d_b) * (gamma3_y_plot - self.gamma2_y)
 
            x_axis = np.array([0.0, self.gamma1_y, self.gamma2_y, gamma3_y_plot])
            y_axis = np.array([0.0, self.M1y, self.M2y, M3y_plot])/kNm_unit
 
            fig, ax = plt.subplots()
            ax.plot(x_axis, y_axis, 'k-')
 
            ax.set(xlabel='Rotation [rad]', ylabel='Moment [kNm]', 
                title='Gupta 1999 material model (ID={})'.format(self.ID))
            ax.grid()
 
            if block:
                plt.show()
 
 

UpdateStoredData()

def UpdateStoredData

(

self

)

Implementation of the homonym abstract method.

See parent class DataManagement for detailed information.

Definition at line 643 of file MaterialModels.py.

    def UpdateStoredData(self):
        """
        Implementation of the homonym abstract method.
        See parent class DataManagement for detailed information.
        """
        self.data = [["INFO_TYPE", "Gupta1999"], # Tag for differentiating different data
            ["ID", self.ID],
            ["beam_section_name_tag", self.beam_section_name_tag], 
            ["col_section_name_tag", self.col_section_name_tag], 
            ["d_c", self.d_c],
            ["bf_c", self.bf_c],
            ["tf_c", self.tf_c],
            ["I_c", self.I_c],
            ["d_b", self.d_b],
            ["tf_b", self.tf_b],
            ["Fy", self.Fy],
            ["E", self.E],
            ["G", self.G],
            ["t_p", self.t_p],
            ["t_dp", self.t_dp],
            ["t_pz", self.t_pz],
            ["a_s", self.a_s],
            ["pinchx", self.pinchx],
            ["pinchy", self.pinchy],
            ["dmg1", self.dmg1],
            ["dmg2", self.dmg2],
            ["beta", self.beta],
            ["Ry", self.Ry],
            ["Vy", self.Vy],
            ["Ke", self.Ke],
            ["Kp", self.Kp],
            ["gamma1_y", self.gamma1_y],
            ["M1y", self.M1y],
            ["gamma2_y", self.gamma2_y],
            ["M2y", self.M2y],
            ["gamma3_y", self.gamma3_y],
            ["M3y", self.M3y],
            ["Initialized", self.Initialized]]
 

Member Data Documentation

a_s

a_s

Definition at line 590 of file MaterialModels.py.

beam_section_name_tag

beam_section_name_tag

Definition at line 602 of file MaterialModels.py.

beta

beta

Definition at line 595 of file MaterialModels.py.

bf_c

bf_c

Definition at line 581 of file MaterialModels.py.

col_section_name_tag

col_section_name_tag

Definition at line 603 of file MaterialModels.py.

d_b

d_b

Definition at line 584 of file MaterialModels.py.

d_c

d_c

Definition at line 580 of file MaterialModels.py.

data

data

Definition at line 648 of file MaterialModels.py.

dmg1

dmg1

Definition at line 593 of file MaterialModels.py.

dmg2

dmg2

Definition at line 594 of file MaterialModels.py.

E

E

Definition at line 587 of file MaterialModels.py.

Fy

Fy

Definition at line 586 of file MaterialModels.py.

G

G

Definition at line 624 of file MaterialModels.py.

gamma1_y

gamma1_y

Definition at line 630 of file MaterialModels.py.

gamma2_y

gamma2_y

Definition at line 633 of file MaterialModels.py.

gamma3_y

gamma3_y

Definition at line 636 of file MaterialModels.py.

I_c

I_c

Definition at line 583 of file MaterialModels.py.

ID

ID

Definition at line 579 of file MaterialModels.py.

Initialized

Initialized

Definition at line 604 of file MaterialModels.py.

Ke

Ke

Definition at line 625 of file MaterialModels.py.

Kp

Kp

Definition at line 626 of file MaterialModels.py.

M1y

M1y

Definition at line 631 of file MaterialModels.py.

M2y

M2y

Definition at line 634 of file MaterialModels.py.

M3y

M3y

Definition at line 637 of file MaterialModels.py.

pinchx

pinchx

Definition at line 591 of file MaterialModels.py.

pinchy

pinchy

Definition at line 592 of file MaterialModels.py.

Ry

Ry

Definition at line 597 of file MaterialModels.py.

t_dp

t_dp

Definition at line 589 of file MaterialModels.py.

t_p

t_p

Definition at line 588 of file MaterialModels.py.

t_pz

t_pz

Definition at line 622 of file MaterialModels.py.

tf_b

tf_b

Definition at line 585 of file MaterialModels.py.

tf_c

tf_c

Definition at line 582 of file MaterialModels.py.

Vy

Vy

Definition at line 623 of file MaterialModels.py.

---

The documentation for this class was generated from the following file:

• /media/carmine/DATA/Programmi/OpenSeesPyAssistant/MaterialModels.py