Calibration of Material#

The calibration commands are used for material calibration.

Create material calibrations#

class CalibrationModel(name: str, description: str = '', stefanBoltzmann: float | None = None, absoluteZero: float | None = None, waveFormulation: SymbolicConstantType = 'NOT_SET', modelType: SymbolicConstantType = 'STANDARD_EXPLICIT', universalGas: float | None = None, copyConstraints: BooleanType = 1, copyConnectors: BooleanType = 1, copyInteractions: BooleanType = 1)[source]#

Abaqus creates a Model object named Model-1 when a session is started.

Notes

This object can be accessed by:

mdb.models[name]

Methods

Calibration(name)

This method creates a Calibration object.

Calibration(name: str) → Calibration[source]#

This method creates a Calibration object.

Parameters:

name: A String specifying the name of the new calibration.

Returns:

A Calibration object.

Notes

This function can be accessed by:

mdb.models[name].Calibration

Object features#

Calibration#

class Calibration(name: str)[source]#

A Calibration object is the object used to specify a material calibration. The Calibration object stores the data that is used for specifying materials from test data.

Notes

This object can be accessed by:

import calibration
mdb.models[name].calibrations[name]

Attributes:

dataSets: DataSet: A DataSet object.
behaviors: Behavior: A Behavior object.

Methods

`Behavior`(name, typeName)	This method creates a Behavior object.
`DataSet`(name[, data, type, form])	This method creates a DataSet object.

Behavior(name: str, typeName: str) → Behavior[source]#

This method creates a Behavior object.

Parameters:

name: A String specifying the name of the new behavior.
typeName: A String specifying the type of the new Behavior. Values can be “ElasIsoBehavior”, “ElasPlasIsoBehavior”, “FeFpBehavior”, or a user plug-in behavior type.

Returns:

A Behavior object.

Notes

This function can be accessed by:

mdb.models[name].Calibration

DataSet(name: str, data: tuple = (), type: str = '', form: str = '') → DataSet[source]#

This method creates a DataSet object.

Parameters:

name: A String specifying the name of the new dataset.
data: A sequence of pairs of Floats specifying data set type pairs. Possible values are for stress/strain, force/displacement, or transverse strain/axial strain pairs.
type: A String specifying the type of the new dataset. Values can be “STRESS/STRAIN”, “FORCE/DISPLACEMENT”, or “AXIALSTRAIN/TRANSVERSESTRAIN”. The default value is “STRESS/STRAIN”.
form: A String specifying the form of the new dataset. Values can be “NOMINAL” or “TRUE”. The default value is “NOMINAl”.

Returns:

A DataSet object.

Notes

This function can be accessed by:

mdb.models[name].Calibration

Behavior#

class Behavior(name: str, typeName: str)[source]#

The Behavior object specifies the method used for calibrating a material.

Notes

This object can be accessed by:

import calibration
mdb.models[name].calibrations[name].behaviors[name]

Attributes:

modelName: str: A string specifying the name of the model to which the behavior belongs.
calibrationName: str: A string specifying the name of calibration to which the behavior belongs.
biAxialAllName: str: A String specifying the name of the dataset containing all the raw data in the test data file. Only valid if the behavior is of type FeFpBehavior
uniAxialAllName: str: A String specifying the name of the dataset containing all the raw data in the test data file. Only valid if the behavior is of type FeFpBehavior

Methods

`compute_E`(dataSet)	This method computes the value of young's modulus from the existing DataSet object.
`compute_elasticModulus`(yieldPoint)	This method computes the value of the elastic modulus from the yieldpoint value.
`compute_nu`(dataSet)	This method computes the value of Poisson's Ratio from the existing DataSet object.
`compute_plasticPoints`(dataSet, slider_val, ...)	This method extracts the coordinates of the Plastic Points.
`compute_ultimatePoint`(dataSet)	This method computes the coordinates of the Ultimate point from the existing DataSet object.
`mapToMaterial`(materialName)	This method appends the calibration data obtained from the DataSet object to an existing material object.
`setValues`([E, nu, ds1Name, ds2Name, ...])	This method modifies the data for an existing behavior object.
`xyDataDissect`(dsName, modelName, calibrationName)	This method extracts primary, unload, reload and permanent DataSet objects from the existing DataSet object.The method is only valid for FeFpBehavior type of behavior.

compute_E(dataSet: DataSet)[source]#

This method computes the value of young’s modulus from the existing DataSet object. The method is only valid for ElasIsoBehavior type of behavior.

Parameters:

dataSet: A DataSet object.

Returns:

A python:tuple consisting of a and b values of the regression line(y = ax + b), coefficient of
determination(r-squared) value and the start and end-points of the line.

compute_elasticModulus(yieldPoint: tuple)[source]#

This method computes the value of the elastic modulus from the yieldpoint value. The method is only valid for ElasPlasIsoBehavior type of behavior.

Parameters:

yieldPoint: A tuple consisting of coordinates of the yieldpoint.

Returns:

A python:float specifying the value of elastic modulus.

compute_nu(dataSet: DataSet)[source]#

This method computes the value of Poisson’s Ratio from the existing DataSet object. The method is only valid for ElasIsoBehavior and ElasPlasIsoBehavior type of behavior.

Parameters:

dataSet: A DataSet object.

Returns:

A python:tuple consisting of a and b values of the regression line(y = ax + b), coefficient of
determination(r-squared) value and the start and end-points of the line.

compute_plasticPoints(dataSet: DataSet, slider_val: str, start_index: str, end_index: str, yp: str = '')[source]#

This method extracts the coordinates of the Plastic Points. The method is only valid for ElasPlasIsoBehavior type of behavior.

Parameters:

dataSet: A DataSet object.
slider_val: A float specifying the number of values to be taken.
start_index: A float specifying the lower limit of the range.
end_index: A float specifying the upper limit of the range.
yp: Coordinates of the yieldpoint. The default value is (0,0).

Returns:

A python:sequence of coordinates of the Plastic points..

compute_ultimatePoint(dataSet: DataSet)[source]#

This method computes the coordinates of the Ultimate point from the existing DataSet object. The method is only valid for ElasPlasIsoBehavior type of behavior.

Parameters:

dataSet: A DataSet object.

Returns:

Coordinates of the ultimate point.

mapToMaterial(materialName: str)[source]#

This method appends the calibration data obtained from the DataSet object to an existing material object. In the case of ElasIsoBehavior, it appends the young’s modulus and poisson’s ratio. For ElasPlasIsoBehavior it appends the young’s modulus, poisson’s ratio and Plastic points range and for FeFpBehavior it appends Plastic points range and Mullins effect properties.

Parameters:

materialName: A String specifying the name of the existing material

setValues(E: str = '', nu: str = '', ds1Name: str = '', ds2Name: str = '', materialName: str = '', yieldPoint: str = '', ultimatePoint: str = '', plasticPoints: str = '', PoissonsRatio: str = '', elasticModulus: str = '', plasticPointsRange: str = '', name: str = '', uniaxialName: str = '', biaxialName: str = '', interpolation: str = '', uniWeight: str = '', biWeight: str = '', uMullinsReload: str = '', uMullinsUnload: str = '', uPYieldPoint: tuple = (), uPermSet: str = '', uPrimary: str = '', bMullinsReload: str = '', bMullinsUnload: str = '', bPYieldPoint: tuple = (), bPermSet: str = '', bPrimary: str = '')[source]#

This method modifies the data for an existing behavior object.

Parameters:

E: Young’s modulus. Only valid if the behavior type is ElasIsoBehavior.
nu: Poisson’s ratio. Only valid if the behavior type is ElasIsoBehavior.
ds1Name: The name of the first data set. Only valid if the behavior type is ElasIsoBehavior or ElasPlasIsoBehavior
ds2Name: The name of the second data set. Only valid if the behavior type is ElasIsoBehavior or ElasPlasIsoBehavior
materialName: Material Name.
yieldPoint: Stress/strain value for the material yield point.Only valid if the behavior type is ElasPlasIsoBehavior
ultimatePoint: Stress/strain value for the material ultimate point.Only valid if the behavior type is ElasPlasIsoBehavior
plasticPoints: Stress/strain values for the Plastic portion of material curve. Only valid if the behavior type is ElasPlasIsoBehavior
PoissonsRatio: Poisson’s Ratio. Only valid if the behavior type is ElasPlasIsoBehavior
elasticModulus: Young’s Modulus for the elastic portion of the material curve. Only valid if the behavior type is ElasPlasIsoBehavior
plasticPointsRange: Extent of the material Plastic points. Only valid if the behavior type is ElasPlasIsoBehavior
name: Name of the behavior.
uniaxialName: Name of the uniaxial dataset. Only valid if the behavior type is FeFpBehavior
biaxialName: Name of the biaxial dataset. Only valid if the behavior type is FeFpBehavior
interpolation: ‘linear’ specifies linear interpolation between data points, otherwise ‘logarithmic’. Only valid if the behavior type is FeFpBehavior
uniWeight: Uniaxial weight factor, uniWeight + biWeight should equal 1.0. Only valid if the behavior type is FeFpBehavior
biWeight: Biaxial weight factor, uniWeight + biWeight should equal 1.0. Only valid if the behavior type is FeFpBehavior
uMullinsReload: A List of strings, specifying names of reloading DataSet objects obtained from uniaxial test data. Only valid if the behavior is of type FeFpBehavior
uMullinsUnload: A List of strings, specifying names of reloading DataSet objects obtained from uniaxial test data. Only valid if the behavior is of type FeFpBehavior
uPYieldPoint: A tuple specifying the coordinates of yield point of the permanent data set. Only valid if the behavior is of type FeFpBehavior
uPermSet: A List of strings, specifying names of permanent DataSet objects obtained from uniaxial test data. Only valid if the behavior is of type FeFpBehavior
uPrimary: A string specifying name of Primary DataSet object.Only valid if the behavior is of type FeFpBehavior
bMullinsReload: A List of strings, specifying names of reloading DataSet objects obtained from biaxial test data. Only valid if the behavior is of type FeFpBehavior
bMullinsUnload: A List of strings, specifying names of unloading DataSet objects obtained from biaxial test data. Only valid if the behavior is of type FeFpBehavior
bPYieldPoint: A tuple specifying the coordinates of yield point of the permanent data set. Only valid if the behavior is of type FeFpBehavior
bPermSet: A List of strings, specifying names of permanent DataSet objects obtained from biaxial test data. Only valid if the behavior is of type FeFpBehavior
bPrimary: A string specifying name of Primary DataSet object. Only valid if the behavior is of type FeFpBehavior

xyDataDissect(dsName: str, modelName: str, calibrationName: str, biaxial: BooleanType = True)[source]#

This method extracts primary, unload, reload and permanent DataSet objects from the existing DataSet object.The method is only valid for FeFpBehavior type of behavior.

Parameters:

dsName: A string specifying the name of the uniaxial/biaxial test dataset.
modelName: A string specifying the name of the model to which the calibration behavior belongs.
calibrationName: A string specifying the name of the Calibration object to which the behavior belongs.
biaxial: A boolean specifying whether the test data is biaxial or uniaxial. The default value is True.

Returns:

A python:sequence of strings specifying names of the DataSet objects containing loading,
unloading, reloading and primary datasets.

DataSet#

class DataSet(name: str, data: tuple = (), type: str = '', form: str = '')[source]#

The DataSetobject specifies material test data.

Notes

This object can be accessed by:

import calibration
mdb.models[name].calibrations[name].dataSets[name]

Methods

setValues([data])

This method modifies the data for an existing DataSet object.

setValues(data: tuple = ())[source]#

This method modifies the data for an existing DataSet object.

Parameters:

data: A sequence of pairs of Floats specifying data set type pairs.