UVC Class Reference

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...

Inheritance diagram for UVC:

Public Member Functions
def	__init__ (self, int ID, fy, Ey, QInf, b, DInf, a, np.ndarray cK, np.ndarray gammaK)
	Constructor of the class. More...
def	CheckApplicability (self)
	Implementation of the homonym abstract method. More...
def	ReInit (self)
	Implementation of the homonym abstract method. More...
def	ShowInfo (self)
	Implementation of the homonym abstract method. More...
def	UpdateStoredData (self)
	Implementation of the homonym abstract method. More...
def	UVCuniaxial (self)
	Generate the material model Updated Voce-Chaboche (UVC) for uniaxial stress states. More...
def	CheckApplicability (self)
	Abstract function used to check the applicability of the material model. More...

Public Attributes
	a
	b
	cK
	data
	DInf
	Ey
	fy
	gammaK
	ID
	Initialized
	N
	QInf
	section_name_tag

Detailed Description

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.

For more information about the how to calibrate the set of parameters, see de Castro e Sousa, Suzuki and Lignos 2020 and Hartloper, de Castro e Sousa and Lignos 2021.

Parameters

MaterialModels

Parent abstract class.

Definition at line 2629 of file MaterialModels.py.

Constructor & Destructor Documentation

__init__()

def __init__	(		self,
		int	ID,
			fy,
			Ey,
			QInf,
			b,
			DInf,
			a,
		np.ndarray	cK,
		np.ndarray	gammaK
	)

Constructor of the class.

Parameters

ID	(int): Unique material model ID.
fy	(float): Initial yield stress of the steel material.
Ey	(float): Elastic modulus of the steel material.
QInf	(float): Maximum increase in yield stress due to cyclic hardening (isotropic hardening).
b	(float): Saturation rate of QInf.
DInf	(float): Decrease in the initial yield stress, to neglect the model updates set DInf = 0.
a	(float): Saturation rate of DInf, a > 0. If DInf == 0, then a is arbitrary (but still a > 0).
cK	(np.ndarray): Array of 1 dimension; each entry is one kinematic hardening parameter associated with one backstress, up to 8 may be specified.
gammaK	(np.ndarray): Array of 1 dimension; each entry is one saturation rate of kinematic hardening associated with one backstress, up to 8 may be specified.

Exceptions

NegativeValue	ID needs to be a positive integer.
NegativeValue	fy needs to be positive.
NegativeValue	Ey needs to be positive.
NegativeValue	QInf needs to be positive.
NegativeValue	b needs to be positive.
NegativeValue	DInf needs to be positive.
NegativeValue	a needs to be positive.
WrongArgument	cK can't be empty.
WrongArgument	cK and gammaK have as many entries as the number of backstresses (thus they have the same length).

Reimplemented in UVCCalibratedRCCircShape, UVCCalibratedRCRectShape, UVCCalibratedSteelIShapeFlange, UVCCalibratedSteelIShapeWeb, and UVCCalibrated.

Definition at line 2638 of file MaterialModels.py.

    def __init__(self, ID: int, fy, Ey, QInf, b, DInf, a, cK: np.ndarray, gammaK: np.ndarray):
        """
        Constructor of the class.
 
        @param ID (int): Unique material model ID.
        @param fy (float): Initial yield stress of the steel material.
        @param Ey (float): Elastic modulus of the steel material.
        @param QInf (float): Maximum increase in yield stress due to cyclic hardening (isotropic hardening).
        @param b (float): Saturation rate of QInf.
        @param DInf (float): Decrease in the initial yield stress, to neglect the model updates set DInf = 0.
        @param a (float): Saturation rate of DInf, a > 0. If DInf == 0, then a is arbitrary (but still a > 0).
        @param cK (np.ndarray): Array of 1 dimension; each entry is one kinematic hardening parameter associated with one backstress, up to 8 may be specified.
        @param gammaK (np.ndarray): Array of 1 dimension; each entry is one saturation rate of kinematic hardening associated with one backstress, up to 8 may be specified.
 
        @exception NegativeValue: ID needs to be a positive integer.
        @exception NegativeValue: fy needs to be positive.
        @exception NegativeValue: Ey needs to be positive.
        @exception NegativeValue: QInf needs to be positive.
        @exception NegativeValue: b needs to be positive.
        @exception NegativeValue: DInf needs to be positive.
        @exception NegativeValue: a needs to be positive.
        @exception WrongArgument: cK can't be empty.
        @exception WrongArgument: cK and gammaK have as many entries as the number of backstresses (thus they have the same length).
        """
        # Check
        if ID < 1: raise NegativeValue()
        if fy < 0: raise NegativeValue()
        if Ey < 0: raise NegativeValue()
        if QInf < 0: raise NegativeValue()
        if b < 0: raise NegativeValue()
        if DInf < 0: raise NegativeValue()
        if a < 0: raise NegativeValue()
        if len(cK) == 0: raise WrongArgument()
        if len(cK) != len(gammaK): raise WrongArgument()
        if len(cK) != 2: print("!!!!!!! WARNING !!!!!!! Number of backstresses should be 2 for optimal performances")
        if DInf == 0: print("!!!!!!! WARNING !!!!!!! With DInf = 0, the model used is Voce-Chaboche (VC) not updated (UVC)")
 
        # Arguments
        self.ID = ID
        self.fy = fy
        self.Ey = Ey
        self.QInf = QInf
        self.b = b
        self.DInf = DInf
        self.a = a
        self.cK = copy(cK)
        self.gammaK = copy(gammaK)
 
        # Initialized the parameters that are dependent from others
        self.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 2747 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 UVC, ID=", self.ID)
            print("")
 
 

ReInit()

def ReInit

(

self

)

Implementation of the homonym abstract method.

See parent class DataManagement for detailed information.

Definition at line 2691 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
        self.N = len(self.cK)
        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

)

Implementation of the homonym abstract method.

See parent class DataManagement for detailed information.

Definition at line 2728 of file MaterialModels.py.

    def ShowInfo(self):
        """
        Implementation of the homonym abstract method.
        See parent class DataManagement for detailed information.
        """
        print("")
        print("Requested info for UVC material model Parameters, ID = {}".format(self.ID))
        print("Section associated: {} ".format(self.section_name_tag))
        print("Yield strength fy = {} MPa".format(self.fy/MPa_unit))
        print("Young modulus Ey = {} MPa".format(self.Ey/MPa_unit))
        print("Isotropic hardening factor QInf = {} MPa and saturation rate  b = {}".format(self.QInf/MPa_unit, self.b))
        print("Decrease the initial yield stress DInf = {} MPa and saturation rate a = {}".format(self.DInf/MPa_unit, self.a))
        print("Kinematic hardening vector ({} backstresses) cK = {} MPa".format(self.N, self.cK/MPa_unit))
        print("And associated saturation rate gammaK = {}".format(self.gammaK))
        print("")
 
        #TODO: implement plot (too complex for now)
 
 

UpdateStoredData()

def UpdateStoredData

(

self

)

Implementation of the homonym abstract method.

See parent class DataManagement for detailed information.

Definition at line 2708 of file MaterialModels.py.

    def UpdateStoredData(self):
        """
        Implementation of the homonym abstract method.
        See parent class DataManagement for detailed information.
        """
        self.data = [["INFO_TYPE", "UVC"], # Tag for differentiating different data
            ["ID", self.ID],
            ["section_name_tag", self.section_name_tag],
            ["fy", self.fy],
            ["Ey", self.Ey],
            ["QInf", self.QInf],
            ["b", self.b],
            ["DInf", self.DInf],
            ["a", self.a],
            ["N", self.N],
            ["ck", self.cK],
            ["gammaK", self.gammaK],
            ["Initialized", self.Initialized]]
 
 

UVCuniaxial()

def UVCuniaxial

(

self

)

Generate the material model Updated Voce-Chaboche (UVC) for uniaxial stress states.

See _UVCuniaxial function for more information.

Definition at line 2760 of file MaterialModels.py.

    def UVCuniaxial(self):
        """
        Generate the material model Updated Voce-Chaboche (UVC) for uniaxial stress states.
        See _UVCuniaxial function for more information.
        """
        _UVCuniaxial(self.ID, self.Ey, self.fy, self.QInf, self.b, self.DInf, self.a, self.N, self.cK, self.gammaK)
        self.Initialized = True
        self.UpdateStoredData()
 
 

Member Data Documentation

a

a

Definition at line 2682 of file MaterialModels.py.

b

b

Definition at line 2680 of file MaterialModels.py.

cK

cK

Definition at line 2683 of file MaterialModels.py.

data

data

Definition at line 2713 of file MaterialModels.py.

DInf

DInf

Definition at line 2681 of file MaterialModels.py.

Ey

Ey

Definition at line 2678 of file MaterialModels.py.

fy

fy

Definition at line 2677 of file MaterialModels.py.

gammaK

gammaK

Definition at line 2684 of file MaterialModels.py.

ID

ID

Definition at line 2676 of file MaterialModels.py.

Initialized

Initialized

Definition at line 2688 of file MaterialModels.py.

N

N

Definition at line 2700 of file MaterialModels.py.

QInf

QInf

Definition at line 2679 of file MaterialModels.py.

section_name_tag

section_name_tag

Definition at line 2687 of file MaterialModels.py.

---

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

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