Class that handles the storage and manipulation of a Gradient-Inelastic Flexibility-based element's information (mechanical and geometrical parameters, etc) and the initialisation in the model. More...

Inheritance diagram for GIFBElement:

Public Member Functions
def	__init__ (self, int iNode_ID, int jNode_ID, int fiber_ID, D_bars, fy, int geo_transf_ID, lambda_i=-1, lambda_j=-1, Lp=-1, Ip=-1, new_integration_ID=-1, min_tol=TOL_INTEGRATION, max_tol=TOL_INTEGRATION *1e4, max_iter=MAX_ITER_INTEGRATION, ele_ID=-1)
	Constructor of the class. More...

def	ComputeIp (self)
	Compute the number of integration points with equal distance along the element. More...

def	ComputeLp (self)
	Method that computes the plastic length using Paulay 1992. More...

def	CreateMember (self)
	Method that initialises the member by calling the OpenSeesPy commands through various functions. More...

def	Record (self, str name_txt, str data_dir, force_rec=True, def_rec=True, time_rec=True)
	Implementation of the homonym abstract method. More...

def	RecordNodeDef (self, str name_txt, str data_dir, time_rec=True)
	Implementation of the homonym abstract method. More...

def	ReInit (self, lambda_i=-1, lambda_j=-1, Lp=-1, Ip=5, new_integration_ID=-1, ele_ID=-1)
	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	Record (self, ele_ID, str name_txt, str data_dir, force_rec=True, def_rec=True, time_rec=True)
	Abstract method that records the forces, deformation and time of the member associated with the class. More...

def	RecordNodeDef (self, int iNode_ID, int jNode_ID, str name_txt, str data_dir, time_rec=True)
	Abstract method that records the deformation and time of the member's nodes associated with the class. More...

Public Attributes
	D_bars

	data

	element_array

	element_ID

	fiber_ID

	fy

	geo_transf_ID

	Initialized

	iNode_ID

	Ip

	jNode_ID

	L

	lambda_i

	lambda_j

	Lp

	max_iter

	max_tol

	min_tol

	new_integration_ID

	section_name_tag

Detailed Description

Class that handles the storage and manipulation of a Gradient-Inelastic Flexibility-based element's information (mechanical and geometrical parameters, etc) and the initialisation in the model.

The integration technique is Simpson. For more information, see Sideris and Salehi 2016, 2017 and 2020.

Parameters

MemberModel Parent abstract class.

Definition at line 1221 of file MemberModel.py.

Constructor & Destructor Documentation

◆ init()

def __init__	(		self,
		int	iNode_ID,
		int	jNode_ID,
		int	fiber_ID,
			D_bars,
			fy,
		int	geo_transf_ID,
			lambda_i = `-1`,
			lambda_j = `-1`,
			Lp = `-1`,
			Ip = `-1`,
			new_integration_ID = `-1`,
			min_tol = `TOL_INTEGRATION`,
			max_tol = `TOL_INTEGRATION*1e4`,
			max_iter = `MAX_ITER_INTEGRATION`,
			ele_ID = `-1`
	)

Constructor of the class.

Parameters

iNode_ID	(int): ID of the first end node.
jNode_ID	(int): ID of the second end node.
fiber_ID	(int): ID of the fiber section.
D_bars	(float): Diameter of the vertical reinforcing bars.
fy	(float): Yield stress of the reinforcing bars.
geo_transf_ID	(int): The geometric transformation (for more information, see OpenSeesPy documentation).
lambda_i	(float, optional): Fraction of beam length over the plastic hinge length at end i (0 = no plastic hinge). Defaults to -1, e.g. plastic hinge in the end i.
lambda_j	(float, optional): Fraction of beam length over the plastic hinge length at end j (0 = no plastic hinge). Defaults to -1, e.g. plastic hinge in the end j.
Lp	(float, optional): Plastic hinge length. Defaults to -1, e.g. computed in ReInit().
Ip	(int, optional): Number of integration points (min. 3). Defaults to 5.
new_integration_ID	(int, optional): ID of the integration technique. Defaults to -1, e.g. computed in ReInit().
min_tol	(float, optional): Minimal tolerance for the integration convergence. Defaults to TOL_INTEGRATION (Units).
max_tol	(float, optional): Maximal tolerance for the integration convergence. Defaults to TOL_INTEGRATION*1e4.
max_iter	(int, optional): Maximal number of iteration to reach the integretion convergence. Defaults to MAX_ITER_INTEGRATION (Units).
ele_ID	(int, optional): Optional ID of the element. Defaults to -1, e.g. use IDConvention to define it.

Exceptions

NegativeValue	ID needs to be a positive integer.
NegativeValue	ID needs to be a positive integer.
NegativeValue	ID needs to be a positive integer.
NegativeValue	D_bars needs to be positive.
NegativeValue	fy needs to be positive.
NegativeValue	ID needs to be a positive integer.
NegativeValue	lambda_i needs to be positive.
NegativeValue	lambda_j needs to be positive.
NegativeValue	No plastic length defined.
NegativeValue	Lp needs to be positive, if different from -1.
NegativeValue	Ip needs to be a positive integer bigger than 3, if different from -1.
NegativeValue	ID needs to be a positive integer.
NegativeValue	min_tol needs to be positive.
NegativeValue	max_tol needs to be positive.
NegativeValue	max_iter needs to be a positive integer.
NegativeValue	ID needs to be a positive integer, if different from -1.

Reimplemented in GIFBElementFibersCircRCCircShape, GIFBElementFibersRectRCRectShape, GIFBElementRCCircShape, and GIFBElementRCRectShape.

Definition at line 1229 of file MemberModel.py.

        min_tol = TOL_INTEGRATION, max_tol = TOL_INTEGRATION*1e4, max_iter = MAX_ITER_INTEGRATION, ele_ID = -1):
        """
        Constructor of the class.
 
        @param iNode_ID (int): ID of the first end node.
        @param jNode_ID (int): ID of the second end node.
        @param fiber_ID (int): ID of the fiber section.
        @param D_bars (float): Diameter of the vertical reinforcing bars.
        @param fy (float): Yield stress of the reinforcing bars.
        @param geo_transf_ID (int): The geometric transformation (for more information, see OpenSeesPy documentation).
        @param lambda_i (float, optional): Fraction of beam length over the plastic hinge length at end i (0 = no plastic hinge).
            Defaults to -1, e.g. plastic hinge in the end i.
        @param lambda_j (float, optional): Fraction of beam length over the plastic hinge length at end j (0 = no plastic hinge).
            Defaults to -1, e.g. plastic hinge in the end j.
        @param Lp (float, optional): Plastic hinge length. Defaults to -1, e.g. computed in ReInit().
        @param Ip (int, optional): Number of integration points (min. 3). Defaults to 5.
        @param new_integration_ID (int, optional): ID of the integration technique. Defaults to -1, e.g. computed in ReInit().
        @param min_tol (float, optional): Minimal tolerance for the integration convergence. Defaults to TOL_INTEGRATION (Units).
        @param max_tol (float, optional): Maximal tolerance for the integration convergence. Defaults to TOL_INTEGRATION*1e4.
        @param max_iter (int, optional): Maximal number of iteration to reach the integretion convergence. Defaults to MAX_ITER_INTEGRATION (Units).
        @param ele_ID (int, optional): Optional ID of the element. Defaults to -1, e.g. use IDConvention to define it.
 
        @exception NegativeValue: ID needs to be a positive integer.
        @exception NegativeValue: ID needs to be a positive integer.
        @exception NegativeValue: ID needs to be a positive integer.
        @exception NegativeValue: D_bars needs to be positive.
        @exception NegativeValue: fy needs to be positive.
        @exception NegativeValue: ID needs to be a positive integer.
        @exception NegativeValue: lambda_i needs to be positive.
        @exception NegativeValue: lambda_j needs to be positive.
        @exception NegativeValue: No plastic length defined.
        @exception NegativeValue: Lp needs to be positive, if different from -1.
        @exception NegativeValue: Ip needs to be a positive integer bigger than 3, if different from -1.
        @exception NegativeValue: ID needs to be a positive integer.
        @exception NegativeValue: min_tol needs to be positive.
        @exception NegativeValue: max_tol needs to be positive.
        @exception NegativeValue: max_iter needs to be a positive integer.
        @exception NegativeValue: ID needs to be a positive integer, if different from -1.
        """
        # Check
        if iNode_ID < 1: raise NegativeValue()
        if jNode_ID < 1: raise NegativeValue()
        if fiber_ID < 1: raise NegativeValue()
        if D_bars < 0: raise NegativeValue()
        if fy < 0: raise NegativeValue()
        if geo_transf_ID < 1: raise NegativeValue()
        if lambda_i != -1 and lambda_i < 0: raise NegativeValue()
        if lambda_j != -1 and lambda_j < 0: raise NegativeValue()
        if lambda_i == 0 and lambda_j == 0: print("!!!!!!! WARNING !!!!!!! No plastic length defined for element ID = {}".format(IDConvention(iNode_ID, jNode_ID)))
        if Lp != -1 and Lp < 0: raise NegativeValue()
        if Ip != -1 and Ip < 3: raise NegativeValue()
        if new_integration_ID != -1 and new_integration_ID < 1: raise NegativeValue()
        if min_tol < 0: raise NegativeValue()
        if max_tol < 0: raise NegativeValue()
        if max_iter < 0: raise NegativeValue()
        if ele_ID != -1 and ele_ID < 0: raise NegativeValue()
 
        # Arguments
        self.iNode_ID = iNode_ID
        self.jNode_ID = jNode_ID
        self.D_bars = D_bars
        self.fy = fy
        self.geo_transf_ID = geo_transf_ID
        self.fiber_ID = fiber_ID 
        self.min_tol = min_tol
        self.max_tol = max_tol
        self.max_iter = max_iter
 
        # Initialized the parameters that are dependent from others
        self.section_name_tag = "None"
        self.Initialized = False
        self.ReInit(lambda_i, lambda_j, Lp, Ip, new_integration_ID, ele_ID)
 

Member Function Documentation

◆ ComputeIp()

def ComputeIp ( self )

Compute the number of integration points with equal distance along the element.

For more information, see Salehi and Sideris 2020.

Returns: int: Number of integration points

Definition at line 1439 of file MemberModel.py.

    def ComputeIp(self):
        """
        Compute the number of integration points with equal distance along the element. For more information, see Salehi and Sideris 2020.
 
        @returns int: Number of integration points
        """
        tmp = math.ceil(1.5*self.L/self.Lp + 1)
        if (tmp % 2) == 0:
            return tmp + 1
        else:
            return tmp
 
 

◆ ComputeLp()

def ComputeLp ( self )

Method that computes the plastic length using Paulay 1992.

Returns: double: Plastic length

Definition at line 1430 of file MemberModel.py.

    def ComputeLp(self):
        """
        Method that computes the plastic length using Paulay 1992.
 
        @returns double: Plastic length
        """
        return (0.08*self.L/m_unit + 0.022*self.D_bars/m_unit*self.fy/MPa_unit)*m_unit
 
 

◆ CreateMember()

def CreateMember ( self )

Method that initialises the member by calling the OpenSeesPy commands through various functions.

Definition at line 1396 of file MemberModel.py.

    def CreateMember(self):
        """
        Method that initialises the member by calling the OpenSeesPy commands through various functions.
        """
        self.element_array = [[self.element_ID, self.iNode_ID, self.jNode_ID]]
 
        # Define integration type
        beamIntegration('Simpson', self.new_integration_ID, self.fiber_ID, self.Ip)
        
        # Define element TODO: Dr. Salehi: lambda useless
        element('gradientInelasticBeamColumn', self.element_ID, self.iNode_ID, self.jNode_ID, self.geo_transf_ID,
            self.new_integration_ID, self.lambda_i, self.lambda_j, self.Lp, '-iter', self.max_iter, self.min_tol, self.max_tol)
        
        # Update class
        self.Initialized = True
        self.UpdateStoredData()
 
 

◆ Record()

def Record	(		self,
		str	name_txt,
		str	data_dir,
			force_rec = `True`,
			def_rec = `True`,
			time_rec = `True`
	)

Implementation of the homonym abstract method.

See parent class MemberModel for detailed information.

Reimplemented from MemberModel.

Definition at line 1414 of file MemberModel.py.

    def Record(self, name_txt: str, data_dir: str, force_rec=True, def_rec=True, time_rec=True):
        """
        Implementation of the homonym abstract method.
        See parent class MemberModel for detailed information.
        """
        super().Record(self.element_ID, name_txt, data_dir, force_rec=force_rec, def_rec=def_rec, time_rec=time_rec)
 
 

◆ RecordNodeDef()

def RecordNodeDef	(		self,
		str	name_txt,
		str	data_dir,
			time_rec = `True`
	)

Implementation of the homonym abstract method.

See parent class MemberModel for detailed information.

Reimplemented from MemberModel.

Definition at line 1422 of file MemberModel.py.

    def RecordNodeDef(self, name_txt: str, data_dir: str, time_rec=True):
        """
        Implementation of the homonym abstract method.
        See parent class MemberModel for detailed information.
        """
        super().RecordNodeDef(self.iNode_ID, self.jNode_ID, name_txt, data_dir, time_rec=time_rec)
 
 

◆ ReInit()

def ReInit	(	self,
		lambda_i = `-1`,
		lambda_j = `-1`,
		Lp = `-1`,
		Ip = `5`,
		new_integration_ID = `-1`,
		ele_ID = `-1`
	)

Implementation of the homonym abstract method.

See parent class DataManagement for detailed information.

Parameters

lambda_i	(float, optional): Fraction of beam length over the plastic hinge length at end i (0 = no plastic hinge). Defaults to -1, e.g. plastic hinge in the end i.
lambda_j	(float, optional): Fraction of beam length over the plastic hinge length at end j (0 = no plastic hinge). Defaults to -1, e.g. plastic hinge in the end j.
Lp	(float, optional): Plastic hinge length. Defaults to -1, e.g. computed here.
Ip	(int, optional): Number of integration points (min. 3). Defaults to 5.
new_integration_ID	(int, optional): ID of the integration technique. Defaults to -1, e.g. computed in ReInit().
ele_ID	(int, optional): Optional ID of the element. Defaults to -1, e.g. use IDConvention to define it.

Definition at line 1304 of file MemberModel.py.

    def ReInit(self, lambda_i = -1, lambda_j = -1, Lp = -1, Ip = 5, new_integration_ID = -1, ele_ID = -1):
        """
        Implementation of the homonym abstract method.
        See parent class DataManagement for detailed information.
 
        @param lambda_i (float, optional): Fraction of beam length over the plastic hinge length at end i (0 = no plastic hinge).
            Defaults to -1, e.g. plastic hinge in the end i.
        @param lambda_j (float, optional): Fraction of beam length over the plastic hinge length at end j (0 = no plastic hinge).
            Defaults to -1, e.g. plastic hinge in the end j.
        @param Lp (float, optional): Plastic hinge length. Defaults to -1, e.g. computed here.
        @param Ip (int, optional): Number of integration points (min. 3). Defaults to 5.
        @param new_integration_ID (int, optional): ID of the integration technique. Defaults to -1, e.g. computed in ReInit().
        @param ele_ID (int, optional): Optional ID of the element. Defaults to -1, e.g. use IDConvention to define it.
        """
        # Precompute some members
        iNode = np.array(nodeCoord(self.iNode_ID))
        jNode = np.array(nodeCoord(self.jNode_ID))
        self.L = np.linalg.norm(iNode-jNode)
        self.element_ID = IDConvention(self.iNode_ID, self.jNode_ID) if ele_ID == -1 else ele_ID
 
        # Arguments
        self.Lp = self.ComputeLp() if Lp == -1 else Lp
        self.Ip = self.ComputeIp() if Ip == -1 else Ip
        self.lambda_i = self.Lp/self.L if lambda_i == -1 else lambda_i
        self.lambda_j = self.Lp/self.L if lambda_j == -1 else lambda_j
        self.new_integration_ID = self.element_ID if new_integration_ID == -1 else new_integration_ID
 
        # Members
        if self.section_name_tag != "None": self.section_name_tag = self.section_name_tag + " (modified)"
        
        # 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 1365 of file MemberModel.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 GIFBElement member model, ID = {}".format(self.element_ID))
        print("Fiber associated, ID = {} ".format(self.fiber_ID))
        print("Integration type 'Simpson', ID = {}".format(self.new_integration_ID))
        print("Section associated {} ".format(self.section_name_tag))
        print("Length L = {} m".format(self.L/m_unit))
        print("Diameter of the reinforcing bars D_bars = {} mm2".format(self.D_bars/mm2_unit))
        print("Reinforcing bar steel strength fy = {} MPa".format(self.fy/MPa_unit))
        print("Plastic length Lp = {} mm".format(self.Lp/mm_unit))
        print("Number of integration points along the element Ip = {}, max iter = {}, (min, max tol) = ({},{})".format(self.Ip, self.max_iter, self.min_tol, self.max_tol))
        print("Lambda_i = {} and lambda_j = {}".format(self.lambda_i, self.lambda_j))
        print("Geometric transformation = {}".format(self.geo_transf_ID))
        print("")
 
        if plot:
            if self.Initialized:
                plot_member(self.element_array, "GIFB Element, ID = {}".format(self.element_ID))
                if block:
                    plt.show()
            else:
                print("The GIFBElement is not initialized (element not created), ID = {}".format(self.element_ID))
 
 

◆ UpdateStoredData()

def UpdateStoredData ( self )

Implementation of the homonym abstract method.

See parent class DataManagement for detailed information.

Definition at line 1339 of file MemberModel.py.

    def UpdateStoredData(self):
        """
        Implementation of the homonym abstract method.
        See parent class DataManagement for detailed information.
        """
        self.data = [["INFO_TYPE", "GIFBElement"], # Tag for differentiating different data
            ["element_ID", self.element_ID],
            ["section_name_tag", self.section_name_tag],
            ["L", self.L],
            ["D_bars", self.D_bars],
            ["fy", self.fy],
            ["Lp", self.Lp],
            ["Ip", self.Ip],
            ["iNode_ID", self.iNode_ID],
            ["lambda_i", self.lambda_i],
            ["jNode_ID", self.jNode_ID],
            ["lambda_j", self.lambda_j],
            ["fiber_ID", self.fiber_ID],
            ["new_integration_ID", self.new_integration_ID],
            ["min_tol", self.min_tol],
            ["max_tol", self.max_tol],
            ["max_iter", self.max_iter],
            ["tranf_ID", self.geo_transf_ID],
            ["Initialized", self.Initialized]]
 
 

Member Data Documentation

◆ D_bars

D_bars

Definition at line 1291 of file MemberModel.py.

◆ data

data

Definition at line 1344 of file MemberModel.py.

◆ element_array

element_array

Definition at line 1400 of file MemberModel.py.

◆ element_ID

element_ID

Definition at line 1322 of file MemberModel.py.

◆ fiber_ID

fiber_ID

Definition at line 1294 of file MemberModel.py.

◆ fy

fy

Definition at line 1292 of file MemberModel.py.

◆ geo_transf_ID

geo_transf_ID

Definition at line 1293 of file MemberModel.py.

◆ Initialized

Initialized

Definition at line 1301 of file MemberModel.py.

◆ iNode_ID

iNode_ID

Definition at line 1289 of file MemberModel.py.

◆ Ip

Ip

Definition at line 1326 of file MemberModel.py.

◆ jNode_ID

jNode_ID

Definition at line 1290 of file MemberModel.py.

◆ L

L

Definition at line 1321 of file MemberModel.py.

◆ lambda_i

lambda_i

Definition at line 1327 of file MemberModel.py.

◆ lambda_j

lambda_j

Definition at line 1328 of file MemberModel.py.

◆ Lp

Lp

Definition at line 1325 of file MemberModel.py.

◆ max_iter

max_iter

Definition at line 1297 of file MemberModel.py.

◆ max_tol

max_tol

Definition at line 1296 of file MemberModel.py.

◆ min_tol

min_tol

Definition at line 1295 of file MemberModel.py.

◆ new_integration_ID

new_integration_ID

Definition at line 1329 of file MemberModel.py.

◆ section_name_tag

section_name_tag

Definition at line 1300 of file MemberModel.py.

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

/media/carmine/DATA/Programmi/OpenSeesPyAssistant/MemberModel.py

Public Member Functions

Public Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __init__()

Member Function Documentation

◆ ComputeIp()

◆ ComputeLp()

◆ CreateMember()

◆ Record()

◆ RecordNodeDef()

◆ ReInit()

◆ ShowInfo()

◆ UpdateStoredData()

Member Data Documentation

◆ D_bars

◆ data

◆ element_array

◆ element_ID

◆ fiber_ID

◆ fy

◆ geo_transf_ID

◆ Initialized

◆ iNode_ID

◆ Ip

◆ jNode_ID

◆ L

◆ lambda_i

◆ lambda_j

◆ Lp

◆ max_iter

◆ max_tol

◆ min_tol

◆ new_integration_ID

◆ section_name_tag

◆ init()