FibersRect Class Reference

Class that stores funcions, material properties, geometric and mechanical parameters for a rectangular RC fiber section. More...

Inheritance diagram for FibersRect:

Public Member Functions
def	__init__ (self, int ID, b, d, Ay, D_hoops, e, int unconf_mat_ID, int conf_mat_ID, int bars_mat_ID, np.ndarray bars_x, np.ndarray ranges_y, list discr_core, list discr_cover_lateral, list discr_cover_topbottom, GJ=0.0)
	Constructor of the class. More...
def	CreateFibers (self)
	Method that initialises the fiber by calling the OpenSeesPy commands. 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...

Public Attributes
	Ay
	b
	bars_mat_ID
	bars_x
	conf_mat_ID
	d
	D_hoops
	data
	discr_core
	discr_cover_lateral
	discr_cover_topbottom
	e
	fib_sec
	GJ
	ID
	Initialized
	ranges_y
	rebarYZ
	section_name_tag
	unconf_mat_ID

Detailed Description

Class that stores funcions, material properties, geometric and mechanical parameters for a rectangular RC fiber section.

Coordinates: plotting coordinte (x, y) = fiber section coordinate (z, y) = (-x, y). For more information, see the OpenSeesPy documentation.

Parameters

Fibers

Parent abstract class.

Definition at line 28 of file Fibers.py.

Constructor & Destructor Documentation

__init__()

def __init__	(		self,
		int	ID,
			b,
			d,
			Ay,
			D_hoops,
			e,
		int	unconf_mat_ID,
		int	conf_mat_ID,
		int	bars_mat_ID,
		np.ndarray	bars_x,
		np.ndarray	ranges_y,
		list	discr_core,
		list	discr_cover_lateral,
		list	discr_cover_topbottom,
			GJ = 0.0
	)

Constructor of the class.

Parameters

ID	(int): Unique fiber section ID.
b	(float): Width of the section.
d	(float): Depth of the section.
Ay	(float): Area of one vertical reinforcing bar.
D_hoops	(float): Diameter of the hoops.
e	(float): Concrete cover.
unconf_mat_ID	(int): ID of material model that will be assigned to the unconfined fibers.
conf_mat_ID	(int): ID of material model that will be assigned to the confined fibers.
bars_mat_ID	(int): ID of material model that will be assigned to the reinforcing bars fibers.
bars_x	(np.ndarray): Array with a range of aligned vertical reinforcing bars for each row in x direction. Distances from border to bar centerline, bar to bar centerlines and finally bar centerline to border in the x direction (aligned). Starting from the left to right, from the top range to the bottom one. The number of bars for each range can vary; in this case, add this argument when defining the array " dtype = object"
ranges_y	(np.ndarray): Array of dimension 1 with the position or spacing in y of the ranges in bars_x. Distances from border to range centerlines, range to range centerlines and finally range centerline to border in the y direction. Starting from the top range to the bottom one.
discr_core	(list): List with two entries: discretisation in IJ (x/z) and JK (y) for the confined core.
discr_cover_lateral	(list): List with two entries: discretisation in IJ (x/z) and JK (y) for the lateral unconfined cover.
discr_cover_topbottom	(list): List with two entries: discretisation in IJ (x/z) and JK (y) for the top and bottom unconfined cover.
GJ	(float, optional): Linear-elastic torsional stiffness assigned to the section. Defaults to 0.0, assume no torsional stiffness.

Exceptions

NegativeValue	ID needs to be a positive integer.
NegativeValue	b needs to be positive.
NegativeValue	d needs to be positive.
NegativeValue	Ay needs to be positive.
NegativeValue	D_hoops needs to be positive.
NegativeValue	e needs to be positive.
NegativeValue	unconf_mat_ID needs to be a positive integer.
NegativeValue	conf_mat_ID needs to be a positive integer.
NegativeValue	bars_mat_ID needs to be a positive integer.
WrongDimension	Number of rows in the list bars_x needs to be the same of the length of ranges_y - 1.
InconsistentGeometry	The sum of the distances for each row in bars_x should be equal to the section's width (tol = 5 mm).
InconsistentGeometry	The sum of the distances in ranges_y should be equal to the section's depth (tol = 5 mm).
InconsistentGeometry	e should be smaller than half the depth and the width of the section.
WrongDimension	discr_core has a length of 2.
WrongDimension	discr_cover_lateral has a length of 2.
WrongDimension	discr_cover_topbottom has a length of 2.
NegativeValue	GJ needs to be positive.

Reimplemented in FibersRectRCRectShape.

Definition at line 35 of file Fibers.py.

        bars_x: np.ndarray, ranges_y: np.ndarray, discr_core: list, discr_cover_lateral: list, discr_cover_topbottom: list, GJ = 0.0):
        """
        Constructor of the class.
 
        @param ID (int): Unique fiber section ID.
        @param b (float): Width of the section.
        @param d (float): Depth of the section.
        @param Ay (float): Area of one vertical reinforcing bar.
        @param D_hoops (float): Diameter of the hoops.
        @param e (float): Concrete cover.
        @param unconf_mat_ID (int): ID of material model that will be assigned to the unconfined fibers.
        @param conf_mat_ID (int): ID of material model that will be assigned to the confined fibers.
        @param bars_mat_ID (int): ID of material model that will be assigned to the reinforcing bars fibers.
        @param bars_x (np.ndarray): Array with a range of aligned vertical reinforcing bars for each row in x direction.
            Distances from border to bar centerline, bar to bar centerlines and finally bar centerline to border in the x direction (aligned).
            Starting from the left to right, from the top range to the bottom one.
            The number of bars for each range can vary; in this case, add this argument when defining the array " dtype = object"
        @param ranges_y (np.ndarray): Array of dimension 1 with the position or spacing in y of the ranges in bars_x.
            Distances from border to range centerlines, range to range centerlines and finally range centerline to border in the y direction.
            Starting from the top range to the bottom one.
        @param discr_core (list): List with two entries: discretisation in IJ (x/z) and JK (y) for the confined core.
        @param discr_cover_lateral (list): List with two entries: discretisation in IJ (x/z) and JK (y) for the lateral unconfined cover.
        @param discr_cover_topbottom (list): List with two entries: discretisation in IJ (x/z) and JK (y) for the top and bottom unconfined cover.
        @param GJ (float, optional): Linear-elastic torsional stiffness assigned to the section. Defaults to 0.0, assume no torsional stiffness.
 
        @exception NegativeValue: ID needs to be a positive integer.
        @exception NegativeValue: b needs to be positive.
        @exception NegativeValue: d needs to be positive.
        @exception NegativeValue: Ay needs to be positive.
        @exception NegativeValue: D_hoops needs to be positive.
        @exception NegativeValue: e needs to be positive.
        @exception NegativeValue: unconf_mat_ID needs to be a positive integer.
        @exception NegativeValue: conf_mat_ID needs to be a positive integer.
        @exception NegativeValue: bars_mat_ID needs to be a positive integer.
        @exception WrongDimension: Number of rows in the list bars_x needs to be the same of the length of ranges_y - 1.
        @exception InconsistentGeometry: The sum of the distances for each row in bars_x should be equal to the section's width (tol = 5 mm).
        @exception InconsistentGeometry: The sum of the distances in ranges_y should be equal to the section's depth (tol = 5 mm).
        @exception InconsistentGeometry: e should be smaller than half the depth and the width of the section.
        @exception WrongDimension: discr_core has a length of 2.
        @exception WrongDimension: discr_cover_lateral has a length of 2.
        @exception WrongDimension: discr_cover_topbottom has a length of 2.
        @exception NegativeValue: GJ needs to be positive.
        """
        # Check
        if ID < 1: raise NegativeValue()
        if b < 0: raise NegativeValue()
        if d < 0: raise NegativeValue()
        if Ay < 0: raise NegativeValue()
        if D_hoops < 0: raise NegativeValue()
        if e < 0: raise NegativeValue()
        if unconf_mat_ID < 1: raise NegativeValue()
        if conf_mat_ID < 1: raise NegativeValue()
        if bars_mat_ID < 1: raise NegativeValue()
        if np.size(bars_x) != np.size(ranges_y)-1: raise WrongDimension()
        geometry_tol = 5*mm_unit
        for bars in bars_x:
            if abs(np.sum(bars) - b) > geometry_tol: raise InconsistentGeometry()
        if abs(np.sum(ranges_y) - d) > geometry_tol: raise InconsistentGeometry()
        if e > b/2 or e > d/2: raise InconsistentGeometry()
        if len(discr_core) != 2: raise WrongDimension()
        if len(discr_cover_lateral) != 2: raise WrongDimension()
        if len(discr_cover_topbottom) != 2: raise WrongDimension()
        if GJ < 0: raise NegativeValue()
 
        # Arguments
        self.ID = ID
        self.b = b
        self.d = d
        self.Ay = Ay
        self.D_hoops = D_hoops
        self.e = e
        self.unconf_mat_ID = unconf_mat_ID
        self.conf_mat_ID = conf_mat_ID
        self.bars_mat_ID = bars_mat_ID
        self.bars_x = deepcopy(bars_x)
        self.ranges_y = copy(ranges_y)
        self.discr_core = copy(discr_core)
        self.discr_cover_lateral = copy(discr_cover_lateral)
        self.discr_cover_topbottom = copy(discr_cover_topbottom)
        self.GJ = GJ
 
        # Initialized the parameters that are dependent from others
        self.section_name_tag = "None"
        self.Initialized = False
        self.ReInit()
 

Member Function Documentation

CreateFibers()

def CreateFibers

(

self

)

Method that initialises the fiber by calling the OpenSeesPy commands.

Definition at line 226 of file Fibers.py.

    def CreateFibers(self):
        """
        Method that initialises the fiber by calling the OpenSeesPy commands.
        """
        create_fiber_section(self.fib_sec)
        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 122 of file Fibers.py.

    def ReInit(self):
        """
        Implementation of the homonym abstract method.
        See parent class DataManagement for detailed information.
        """
        # Memebers
        if self.section_name_tag != "None": self.section_name_tag = self.section_name_tag + " (modified)"
        
        # Parameters
        z1 = self.b/2
        y1 = self.d/2
        zc = z1-self.e-self.D_hoops/2
        yc = y1-self.e-self.D_hoops/2
 
        # Create the concrete core fibers
        core = [-yc, -zc, yc, zc]
        core_cmd = ['patch', 'rect', self.conf_mat_ID, *self.discr_core, *core]
 
        # Create the concrete cover fibers (bottom left, top right)
        cover_up = [yc, -z1, y1, z1]
        cover_down = [-y1, -z1, -yc, z1]
        cover_left = [-yc, zc, yc, z1]
        cover_right = [-yc, -z1, yc, -zc]
        cover_up_cmd = ['patch', 'rect', self.unconf_mat_ID, *self.discr_cover_topbottom, *cover_up]
        cover_down_cmd = ['patch', 'rect', self.unconf_mat_ID, *self.discr_cover_topbottom, *cover_down]
        cover_left_cmd = ['patch', 'rect', self.unconf_mat_ID, *self.discr_cover_lateral, *cover_left]
        cover_right_cmd = ['patch', 'rect', self.unconf_mat_ID, *self.discr_cover_lateral, *cover_right]
        self.fib_sec = [['section', 'Fiber', self.ID, '-GJ', self.GJ], 
            core_cmd, cover_up_cmd, cover_down_cmd, cover_left_cmd, cover_right_cmd]
        
        # Create the reinforcing fibers (top, middle, bottom)
        # NB: note the order of definition of bars_x and ranges_y
        nr_bars = 0
        for range in self.bars_x:
            nr_bars += np.size(range)-1
        rebarY = -np.cumsum(self.ranges_y[0:-1]) + y1
        self.rebarYZ = np.zeros((nr_bars, 2))
 
        iter = 0
        for ii, Y in enumerate(rebarY):
            rebarZ = -np.cumsum(self.bars_x[ii][0:-1]) + z1
            for Z in rebarZ:
                self.rebarYZ[iter, :] = [Y, Z]
                iter = iter + 1
        
        for YZ in self.rebarYZ:
            self.fib_sec.append(['layer', 'bar', self.bars_mat_ID, self.Ay, *YZ])
 
        # 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 fiber. 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 199 of file Fibers.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 fiber. 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 FibersRect, ID = {}".format(self.ID))
        print("Section associated: {} ".format(self.section_name_tag))
        print("Base b = {} mm and depth d = {} mm".format(self.b/mm_unit, self.d/mm_unit))
        print("Confined material model ID = {}".format(self.conf_mat_ID))
        print("Unconfined material model ID = {}".format(self.unconf_mat_ID))
        print("Bars material model ID = {}".format(self.bars_mat_ID))
        print("Discretisation in the core [IJ or x/z dir, JK or y dir] = {}".format(self.discr_core))
        print("Discretisation in the lateral covers [IJ or x/z dir, JK or y dir] = {}".format(self.discr_cover_lateral))
        print("Discretisation in the top and bottom covers [IJ or x/z dir, JK or y dir] = {}".format(self.discr_cover_topbottom))
        print("")
 
        if plot:
            plot_fiber_section(self.fib_sec, matcolor=['#808080', '#D3D3D3', 'k'])
            
            if block:
                plt.show()
 
 

UpdateStoredData()

def UpdateStoredData

(

self

)

Implementation of the homonym abstract method.

See parent class DataManagement for detailed information.

Definition at line 175 of file Fibers.py.

    def UpdateStoredData(self):
        """
        Implementation of the homonym abstract method.
        See parent class DataManagement for detailed information.
        """
        self.data = [["INFO_TYPE", "FibersRect"], # Tag for differentiating different data
            ["ID", self.ID],
            ["section_name_tag", self.section_name_tag],
            ["b", self.b],
            ["d", self.d],
            ["Ay", self.Ay],
            ["D_hoops", self.D_hoops],
            ["e", self.e],
            ["GJ", self.GJ],
            ["conf_mat_ID", self.conf_mat_ID],
            ["discr_core", self.discr_core],
            ["unconf_mat_ID", self.unconf_mat_ID],
            ["discr_cover_topbottom", self.discr_cover_topbottom],
            ["discr_cover_lateral", self.discr_cover_lateral],
            ["bars_mat_ID", self.bars_mat_ID],
            ["bars_x", self.bars_x],
            ["ranges_y", self.ranges_y],
            ["Initialized", self.Initialized]]
 

Member Data Documentation

Ay

Ay

Definition at line 104 of file Fibers.py.

b

b

Definition at line 102 of file Fibers.py.

bars_mat_ID

bars_mat_ID

Definition at line 109 of file Fibers.py.

bars_x

bars_x

Definition at line 110 of file Fibers.py.

conf_mat_ID

conf_mat_ID

Definition at line 108 of file Fibers.py.

d

d

Definition at line 103 of file Fibers.py.

D_hoops

D_hoops

Definition at line 105 of file Fibers.py.

data

data

Definition at line 180 of file Fibers.py.

discr_core

discr_core

Definition at line 112 of file Fibers.py.

discr_cover_lateral

discr_cover_lateral

Definition at line 113 of file Fibers.py.

discr_cover_topbottom

discr_cover_topbottom

Definition at line 114 of file Fibers.py.

e

e

Definition at line 106 of file Fibers.py.

fib_sec

fib_sec

Definition at line 149 of file Fibers.py.

GJ

GJ

Definition at line 115 of file Fibers.py.

ID

ID

Definition at line 101 of file Fibers.py.

Initialized

Initialized

Definition at line 119 of file Fibers.py.

ranges_y

ranges_y

Definition at line 111 of file Fibers.py.

rebarYZ

rebarYZ

Definition at line 158 of file Fibers.py.

section_name_tag

section_name_tag

Definition at line 118 of file Fibers.py.

unconf_mat_ID

unconf_mat_ID

Definition at line 107 of file Fibers.py.

---

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

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