MaterialModels Namespace Reference

Module for the material models. More...

Classes
class	ConfMander1988Circ
	Class that stores funcions and material properties of a RC circular section with Mander 1988 as the material model for the confined reinforced concrete and the OpenSeesPy command type used to model it is Concrete04 or Concrete01. More...
class	ConfMander1988CircRCCircShape
	Class that is the children of ConfMander1988Circ and combine the class RCCircShape (section) to retrieve the information needed. More...
class	ConfMander1988Rect
	Class that stores funcions and material properties of a RC rectangular section with Mander 1988 as the material model for the confined reinforced concrete and the OpenSeesPy command type used to model it is Concrete04 or Concrete01. More...
class	ConfMander1988RectRCRectShape
	Class that is the children of ConfMander1988Rect and combine the class RCRectShape (section) to retrieve the information needed. More...
class	GMP1970
	Class that stores funcions and material properties of the vertical steel reinforcement bars with Giuffré, Menegotto and Pinto 1970 as the material model and the OpenSeesPy command type used to model it is Steel02. More...
class	GMP1970RCRectShape
	Class that is the children of GMP1970 and combine the class RCRectShape (section) to retrieve the information needed. More...
class	Gupta1999
	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...
class	Gupta1999SteelIShape
	Class that is the children of Gupta1999 and combine the class SteelIShape (section) to retrieve the information needed. More...
class	MaterialModels
	Parent abstract class for the storage and manipulation of a material model's information (mechanical and geometrical parameters, etc) and initialisation in the model. More...
class	ModifiedIMK
	Class that stores funcions and material properties of a steel double symmetric I-shape profile with modified Ibarra-Medina-Krawinkler as the material model for the nonlinear springs and the OpenSeesPy command type used to model it is Bilin. More...
class	ModifiedIMKSteelIShape
	Class that is the children of ModifiedIMK and combine the class SteelIShape (section) to retrieve the information needed. More...
class	Skiadopoulos2021
	Class that stores funcions and material properties of a steel double symmetric I-shape profile with Skiadopoulos 2021 as the material model for the panel zone and the OpenSeesPy command type used to model it is Hysteresis. More...
class	Skiadopoulos2021RCS
	WIP: Class that is the children of Skiadopoulos2021 and it's used for the panel zone spring in a RCS (RC column continous, Steel beam). More...
class	Skiadopoulos2021SteelIShape
	Class that is the children of Skiadopoulos2021 and combine the class SteelIShape (section) to retrieve the information needed. More...
class	UnconfMander1988
	Class that stores funcions and material properties of a RC rectangular or circular section with Mander 1988 as the material model for the unconfined reinforced concrete and the OpenSeesPy command type used to model it is Concrete04 or Concrete01. More...
class	UnconfMander1988RCCircShape
	Class that is the children of UnconfMander1988 and combine the class RCCircShape (section) to retrieve the information needed. More...
class	UnconfMander1988RCRectShape
	Class that is the children of UnconfMander1988 and combine the class RCRectShape (section) to retrieve the information needed. More...
class	UniaxialBilinear
	Class that stores funcions and material properties of a simple uniaxial bilinear model with the OpenSeesPy command type used to model it is Steel01. More...
class	UniaxialBilinearSteelIShape
	Class that is the children of UniaxialBilinear and combine the class SteelIShape (section) to retrieve the information needed. More...
class	UVC
	Class that stores funcions and material properties of a steel profile or reinforcing bar with Updated Voce-Chaboche as the material model and the OpenSeesPy command type used to model it is UVCuniaxial. More...
class	UVCCalibrated
	Class that is the children of UVC that retrieve calibrated parameters from UVC_calibrated_parameters.txt. More...
class	UVCCalibratedRCCircShape
	Class that is the children of UVCCalibrated and combine the class RCCircShape (section) to retrieve the information needed. More...
class	UVCCalibratedRCRectShape
	Class that is the children of UVCCalibrated and combines the class RCRectShape (section) to retrieve the information needed. More...
class	UVCCalibratedSteelIShapeFlange
	Class that is the children of UVCCalibrated and combine the class SteelIShape (section) to retrieve the information needed for the material model of the flange (often used fo the entire section). More...
class	UVCCalibratedSteelIShapeWeb
	Class that is the children of UVCCalibrated and combine the class SteelIShape (section) to retrieve the information needed for the material model of the web. More...

Functions
def	Concrete01Funct (fc, ec, fpcu, ecu, discretized_eps)
	Function with the equation of the curve of the Concrete01 model. More...
def	Concrete04Funct (fc, discretized_eps, ec, Ec)
	Function with the equation of the curve of the confined and unconfined concrete (Popovics 1973). More...
def	PlotConcrete01 (fc, ec, fpcu, ecu, ax, ID=0)
	Function that plots the Concrete01 stress-strain curve. More...
def	PlotConcrete04 (fc, Ec, ec, ecu, str Type, ax, ID=0)
	Function that plots the confined/unconfined Concrete04 stress-strain curve. More...

Detailed Description

Module for the material models.

Carmine Schipani, 2021

Function Documentation

Concrete01Funct()

def MaterialModels.Concrete01Funct	(		fc,
			ec,
			fpcu,
			ecu,
			discretized_eps
	)

Function with the equation of the curve of the Concrete01 model.

For more information, see Kent-Scott-Park concrete material object with degraded linear unloading/reloading stiffness according to the work of Karsan-Jirsa and no tensile strength.

Parameters

fc	(float): Compressive concrete yield stress (negative).
ec	(float): Compressive concrete yield strain (negative).
fpcu	(float): Concrete crushing strength (negative).
ecu	(float): Concrete strain at crushing strength (negative).
discretized_eps	(float): Variable strain.

Returns

float: Stress in function of variable strain.

Definition at line 2969 of file MaterialModels.py.

def Concrete01Funct(fc, ec, fpcu, ecu, discretized_eps):
    """
    Function with the equation of the curve of the Concrete01 model.
    For more information, see Kent-Scott-Park concrete material object with
        degraded linear unloading/reloading stiffness according to the work of Karsan-Jirsa and no tensile strength.
 
    @param fc (float): Compressive concrete yield stress (negative).
    @param ec (float): Compressive concrete yield strain (negative).
    @param fpcu (float): Concrete crushing strength (negative).
    @param ecu (float): Concrete strain at crushing strength (negative).
    @param discretized_eps (float): Variable strain.
 
    @returns float: Stress in function of variable strain.
    """
    if discretized_eps > ec:
        eta = discretized_eps/ec;
        return fc*(2*eta-eta*eta);
    else:
        Ttangent = (fc-fpcu)/(ec-ecu)
        return fc + Ttangent*(discretized_eps-ec);
 
 

Concrete04Funct()

def MaterialModels.Concrete04Funct	(		fc,
			discretized_eps,
			ec,
			Ec
	)

Function with the equation of the curve of the confined and unconfined concrete (Popovics 1973).

Parameters

fc	(float): Compressive concrete yield stress (negative).
discretized_eps	(float): Variable strain.
ec	(float): Compressive concrete yield strain (negative).
Ec	(float): Concrete Young modulus.

Returns

float: Stress in function of variable strain.

Definition at line 2913 of file MaterialModels.py.

def Concrete04Funct(fc, discretized_eps, ec, Ec):
    """
    Function with the equation of the curve of the confined and unconfined concrete (Popovics 1973).
 
    @param fc (float): Compressive concrete yield stress (negative).
    @param discretized_eps (float): Variable strain.
    @param ec (float): Compressive concrete yield strain (negative).
    @param Ec (float): Concrete Young modulus.
 
    @returns float: Stress in function of variable strain.
    """
    x = discretized_eps/ec
    r = Ec / (Ec - fc/ec)
    return fc*x*r / (r-1+x**r)
 
 

PlotConcrete01()

def MaterialModels.PlotConcrete01	(		fc,
			ec,
			fpcu,
			ecu,
			ax,
			ID = 0
	)

Function that plots the Concrete01 stress-strain curve.

Parameters

fc	(float): Compressive concrete yield stress (negative).
ec	(float): Compressive concrete yield strain (negative).
fpcu	(float): Concrete crushing strength (negative).
ecu	(float): Concrete strain at crushing strength (negative).
ax	(matplotlib.axes._subplots.AxesSubplot): The figure's wrapper.
ID	(int, optional): ID of the material model. Defaults to 0 (= not defined).

Example: to create the plot, call this line to pass the correct ax: fig, ax = plt.subplots()

Definition at line 2991 of file MaterialModels.py.

def PlotConcrete01(fc, ec, fpcu, ecu, ax, ID = 0):
    """
    Function that plots the Concrete01 stress-strain curve.
 
    @param fc (float): Compressive concrete yield stress (negative).
    @param ec (float): Compressive concrete yield strain (negative).
    @param fpcu (float): Concrete crushing strength (negative).
    @param ecu (float): Concrete strain at crushing strength (negative).
    @param ax (matplotlib.axes._subplots.AxesSubplot): The figure's wrapper.
    @param ID (int, optional): ID of the material model. Defaults to 0 (= not defined).
    
    Example: to create the plot, call this line to pass the correct ax:
        fig, ax = plt.subplots()
    """
 
    # Data for plotting
    N = 1000
    x_axis = np.zeros(N)
    y_axis = np.zeros(N)
    for i in range(N):
        x_axis[i] = i/N*ecu
        y_axis[i] = Concrete01Funct(fc, ec, fpcu, ecu, x_axis[i])
 
 
    ax.plot(x_axis*100.0, y_axis/MPa_unit, 'k--', label = "Co01")
    ax.set(xlabel='Strain [%]', ylabel='Stress [MPa]', 
                    title='Mander 1988 (Concrete01) material model (ID={})'.format(ID))
    plt.legend()
    plt.grid()
 
 
# Private functions

PlotConcrete04()

def MaterialModels.PlotConcrete04	(		fc,
			Ec,
			ec,
			ecu,
		str	Type,
			ax,
			ID = 0
	)

Function that plots the confined/unconfined Concrete04 stress-strain curve.

Parameters

fc	(float): Compressive concrete yield strength (needs to be negative).
Ec	(float): Young modulus.
ec	(float): Compressive concrete yield strain.
ecu	(float): Compressive concrete failure strain (negative).
Type	(str): Type of concrete (confined = 'C', unconfined = 'U')
ax	(matplotlib.axes._subplots.AxesSubplot): The figure's wrapper.
ID	(int, optional): ID of the material model. Defaults to 0 (= not defined).

Exceptions

NameError

Example: to create the plot, call this line to pass the correct ax: fig, ax = plt.subplots()

Definition at line 2929 of file MaterialModels.py.

def PlotConcrete04(fc, Ec, ec, ecu, Type: str, ax, ID = 0):
    """
    Function that plots the confined/unconfined Concrete04 stress-strain curve.
 
    @param fc (float): Compressive concrete yield strength (needs to be negative).
    @param Ec (float): Young modulus. 
    @param ec (float): Compressive concrete yield strain.
    @param ecu (float): Compressive concrete failure strain (negative).
    @param Type (str): Type of concrete (confined = 'C', unconfined = 'U')
    @param ax (matplotlib.axes._subplots.AxesSubplot): The figure's wrapper.
    @param ID (int, optional): ID of the material model. Defaults to 0 (= not defined).
 
    @exception NameError: 
    
    Example: to create the plot, call this line to pass the correct ax:
        fig, ax = plt.subplots()
    """
    if Type == "C":
        name = "Confined (Co04)"
    elif Type == "U":
        name = "Unconfined (Co04)"
    else:
        raise NameError("Type should be C or U (ID={})".format(ID))
 
    # Data for plotting
    N = 1000
    x_axis = np.zeros(N)
    y_axis = np.zeros(N)
    for i in range(N):
        x_axis[i] = i/N*ecu
        y_axis[i] = Concrete04Funct(fc, x_axis[i], ec, Ec)
 
 
    ax.plot(x_axis*100.0, y_axis/MPa_unit, 'k-', label = name)
    ax.set(xlabel='Strain [%]', ylabel='Stress [MPa]', 
                    title='Mander 1988 (Concrete04) material model (ID={})'.format(ID))
    plt.legend()
    plt.grid()