Calibration of Material

The calibration commands are used for material calibration.

Create material calibrations

class CalibrationModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=1, copyConnectors=1, copyInteractions=1)[source]

Bases: ModelBase

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

Note

This object can be accessed by:

mdb.models[name]

Note

Check CalibrationModel on help.3ds.com/2023.

This method creates a Model object.

Note

This function can be accessed by:

mdb.Model
Parameters:

  • name (str) – A String specifying the repository key.

  • description (str, default: '') – A String specifying the purpose and contents of the Model object. The default value is an empty string.

  • stefanBoltzmann (Optional[float], default: None) – None or a Float specifying the Stefan-Boltzmann constant. The default value is None.

  • absoluteZero (Optional[float], default: None) – None or a Float specifying the absolute zero constant. The default value is None.

  • waveFormulation (Literal[SCATTERED, NOT_SET, TOTAL], default: NOT_SET) – A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems. Possible values are NOT_SET, SCATTERED, and TOTAL. The default value is NOT_SET.

  • modelType (Literal[STANDARD_EXPLICIT, ELECTROMAGNETIC], default: STANDARD_EXPLICIT) – A SymbolicConstant specifying the analysis model type. Possible values are STANDARD_EXPLICIT and ELECTROMAGNETIC. The default is STANDARD_EXPLICIT.

  • universalGas (Optional[float], default: None) – None or a Float specifying the universal gas constant. The default value is None.

  • copyConstraints (Union[AbaqusBoolean, bool], default: 1) – A boolean specifying whether to copy the constraints created in the model to the model that instances this model. The default value is ON.

  • copyConnectors (Union[AbaqusBoolean, bool], default: 1) – A boolean specifying whether to copy the connectors created in the model to the model that instances this model. The default value is ON.

  • copyInteractions (Union[AbaqusBoolean, bool], default: 1) – A boolean specifying whether to copy the interactions created in the model to the model that instances this model. The default value is ON.

Returns:

A Model object.

Return type:

Model

Public Data Attributes:

Inherited from ModelBase

name

A String specifying the repository key.

stefanBoltzmann

None or a Float specifying the Stefan-Boltzmann constant.

absoluteZero

None or a Float specifying the absolute zero constant.

waveFormulation

A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.

universalGas

None or a Float specifying the universal gas constant.

noPartsInputFile

A Boolean specifying whether an input file should be written without parts and assemblies.

endRestartStep

A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.

shellToSolid

A Boolean specifying that a shell global model drives a solid submodel.

lastChangedCount

A Float specifying the time stamp that indicates when the model was last changed.

description

A String specifying the purpose and contents of the Model object.

restartJob

A String specifying the name of the job that generated the restart data.

restartStep

A String specifying the name of the step where the restart analysis will start.

globalJob

A String specifying the name of the job that generated the results for the global model.

copyConstraints

A boolean specifying the status of constraints created in a model, in the model which instances this model.

copyConnectors

A boolean specifying the status of connectors created in a model, in the model which instances this model.

copyInteractions

A boolean specifying the status of interactions created in a model, in the model which instances this model.

keywordBlock

A KeywordBlock object.

rootAssembly

An Assembly object.

amplitudes

A repository of Amplitude objects.

profiles

A repository of Profile objects.

boundaryConditions

A repository of BoundaryCondition objects.

constraints

A repository of ConstrainedSketchConstraint objects.

analyticalFields

A repository of AnalyticalField objects.

discreteFields

A repository of DiscreteField objects.

predefinedFields

A repository of PredefinedField objects.

interactions

A repository of Interaction objects.

interactionProperties

A repository of InteractionProperty objects.

contactControls

A repository of ContactControl objects.

contactInitializations

A repository of ContactInitialization objects.

contactStabilizations

A repository of ContactStabilization objects.

linkedInstances

A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.

linkedParts

A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.

loads

A repository of Load objects.

materials

A repository of Material objects.

calibrations

A repository of Calibration objects.

sections

A repository of Section objects.

remeshingRules

A repository of RemeshingRule objects.

sketches

A repository of ConstrainedSketch objects.

parts

A repository of Part objects.

steps

A repository of Step objects.

featureOptions

A FeatureOptions object.

adaptiveMeshConstraints

A repository of AdaptiveMeshConstraint objects.

adaptiveMeshControls

A repository of AdaptiveMeshControl objects.

timePoints

A repository of TimePoint objects.

filters

A repository of Filter objects.

integratedOutputSections

A repository of IntegratedOutputSection objects.

fieldOutputRequests

A repository of FieldOutputRequest objects.

historyOutputRequests

A repository of HistoryOutputRequest objects.

optimizationTasks

A repository of OptimizationTask objects.

tableCollections

A repository of TableCollection objects.

eventSeriesTypes

A repository of EventSeriesType objects.

eventSeriesDatas

A repository of EventSeriesData objects.

restartIncrement

An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.

Public Methods:

Calibration(name)

This method creates a Calibration object.
Inherited from ModelBase

__init__(name[, description, ...])

This method creates a Model object.

ModelFromInputFile(name, inputFileName)

This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.

ModelFromOdbFile(name, odbFileName)

This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.

ModelFromNastranFile(modelName, inputFileName)

This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.

setValues([description, noPartsInputFile, ...])

This method modifies the Model object.

Member Details:

Calibration(name)[source]

This method creates a Calibration object.

Note

This function can be accessed by:

mdb.models[name].Calibration

Note

Check Calibration on help.3ds.com/2023.

Parameters:

name (str) – A String specifying the name of the new calibration.

Returns:

A Calibration object.

Return type:

Calibration

Other Classes

class Behavior(name, typeName)[source]

Bases: object

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

Note

This object can be accessed by:

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

Note

Check Behavior on help.3ds.com/2023.

This method creates a Behavior object.

Note

This function can be accessed by:

mdb.models[name].calibrations[name].Behavior
Parameters:

  • name (str) – A String specifying the name of the new behavior.

  • typeName (str) – 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.

Return type:

Behavior

Member Details:

biAxialAllName: str = ''[source]

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

calibrationName: str = ''[source]

A string specifying the name of calibration to which the behavior belongs.

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

Note

Check Behavior.compute_E on help.3ds.com/2023.

Parameters:

dataSet (DataSet) – A DataSet object.

Returns:

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

Return type:

Sequence[float]

compute_elasticModulus(yieldPoint)[source]

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

Note

Check Behavior.compute_elasticModulus on help.3ds.com/2023.

Parameters:

yieldPoint (tuple) – A tuple consisting of coordinates of the yieldpoint.

Returns:

A float specifying the value of elastic modulus.

Return type:

float

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

Note

Check Behavior.compute_nu on help.3ds.com/2023.

Parameters:

dataSet (DataSet) – A DataSet object.

Returns:

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

Return type:

Sequence[float]

compute_plasticPoints(dataSet, slider_val, start_index, end_index, yp='')[source]

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

Note

Check Behavior.compute_plasticPoints on help.3ds.com/2023.

Parameters:

  • dataSet (DataSet) – A DataSet object.

  • slider_val (str) – A float specifying the number of values to be taken.

  • start_index (str) – A float specifying the lower limit of the range.

  • end_index (str) – A float specifying the upper limit of the range.

  • yp (str, default: '') – Coordinates of the yieldpoint. The default value is (0,0).

Returns:

A sequence of coordinates of the Plastic points..

Return type:

Sequence[tuple[float]]

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

Note

Check Behavior.compute_ultimatePoint on help.3ds.com/2023.

Parameters:

dataSet (DataSet) – A DataSet object.

Returns:

Coordinates of the ultimate point.

Return type:

Sequence[float]

mapToMaterial(materialName)[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.

Note

Check Behavior.mapToMaterial on help.3ds.com/2023.

Parameters:

materialName (str) – A String specifying the name of the existing material

modelName: str = ''[source]

A string specifying the name of the model to which the behavior belongs.

name: str[source]

A String specifying the name of the new behavior.

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

This method modifies the data for an existing behavior object.

Note

Check Behavior.setValues on help.3ds.com/2023.

Parameters:

  • E (str, default: '') – Young’s modulus. Only valid if the behavior type is ElasIsoBehavior.

  • nu (str, default: '') – Poisson’s ratio. Only valid if the behavior type is ElasIsoBehavior.

  • ds1Name (str, default: '') – The name of the first data set. Only valid if the behavior type is ElasIsoBehavior or ElasPlasIsoBehavior

  • ds2Name (str, default: '') – The name of the second data set. Only valid if the behavior type is ElasIsoBehavior or ElasPlasIsoBehavior

  • materialName (str, default: '') – Material Name.

  • yieldPoint (str, default: '') – Stress/strain value for the material yield point.Only valid if the behavior type is ElasPlasIsoBehavior

  • ultimatePoint (str, default: '') – Stress/strain value for the material ultimate point.Only valid if the behavior type is ElasPlasIsoBehavior

  • plasticPoints (str, default: '') – Stress/strain values for the Plastic portion of material curve. Only valid if the behavior type is ElasPlasIsoBehavior

  • PoissonsRatio (str, default: '') – Poisson’s Ratio. Only valid if the behavior type is ElasPlasIsoBehavior

  • elasticModulus (str, default: '') – Young’s Modulus for the elastic portion of the material curve. Only valid if the behavior type is ElasPlasIsoBehavior

  • plasticPointsRange (str, default: '') – Extent of the material Plastic points. Only valid if the behavior type is ElasPlasIsoBehavior

  • name (str, default: '') – Name of the behavior.

  • uniaxialName (str, default: '') – Name of the uniaxial dataset. Only valid if the behavior type is FeFpBehavior

  • biaxialName (str, default: '') – Name of the biaxial dataset. Only valid if the behavior type is FeFpBehavior

  • interpolation (str, default: '') – ‘linear’ specifies linear interpolation between data points, otherwise ‘logarithmic’. Only valid if the behavior type is FeFpBehavior

  • uniWeight (str, default: '') – Uniaxial weight factor, uniWeight + biWeight should equal 1.0. Only valid if the behavior type is FeFpBehavior

  • biWeight (str, default: '') – Biaxial weight factor, uniWeight + biWeight should equal 1.0. Only valid if the behavior type is FeFpBehavior

  • uMullinsReload (str, default: '') – 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 (str, default: '') – 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 (tuple[float, float, float], default: (0.0, 0.0, 0.0)) – A tuple specifying the coordinates of yield point of the permanent data set. Only valid if the behavior is of type FeFpBehavior

  • uPermSet (str, default: '') – 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 (str, default: '') – A string specifying name of Primary DataSet object.Only valid if the behavior is of type FeFpBehavior

  • bMullinsReload (str, default: '') – 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 (str, default: '') – 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 (tuple[float, float, float], default: (0.0, 0.0, 0.0)) – A tuple specifying the coordinates of yield point of the permanent data set. Only valid if the behavior is of type FeFpBehavior

  • bPermSet (str, default: '') – 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 (str, default: '') – A string specifying name of Primary DataSet object. Only valid if the behavior is of type FeFpBehavior

typeName: str[source]

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

uniAxialAllName: str = ''[source]

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

xyDataDissect(dsName, modelName, calibrationName, biaxial=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.

Note

Check Behavior.xyDataDissect on help.3ds.com/2023.

Parameters:

  • dsName (str) – A string specifying the name of the uniaxial/biaxial test dataset.

  • modelName (str) – A string specifying the name of the model to which the calibration behavior belongs.

  • calibrationName (str) – A string specifying the name of the Calibration object to which the behavior belongs.

  • biaxial (Union[AbaqusBoolean, bool], default: True) – A boolean specifying whether the test data is biaxial or uniaxial. The default value is True.

Returns:

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

Return type:

Sequence[str]

class DataSet(name, data=(), type='', form='')[source]

Bases: object

The DataSetobject specifies material test data.

Note

This object can be accessed by:

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

Note

Check DataSet on help.3ds.com/2023.

This method creates a DataSet object.

Note

This function can be accessed by:

mdb.models[name].calibrations[name].DataSet
Parameters:

  • name (str) – A String specifying the name of the new dataset.

  • data (tuple, default: ()) – 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 (str, default: '') – 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 (str, default: '') – A String specifying the form of the new dataset. Values can be “NOMINAL” or “TRUE”. The default value is “NOMINAl”.

Returns:

A DataSet object.

Return type:

DataSet

Member Details:

data: tuple = ()[source]

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.

form: str = ''[source]

A String specifying the form of the new dataset. Values can be “NOMINAL” or “TRUE”. The default value is “NOMINAl”.

name: str[source]

A String specifying the name of the new dataset.

setValues(data=())[source]

This method modifies the data for an existing DataSet object.

Note

Check DataSet.setValues on help.3ds.com/2023.

Parameters:

data (tuple, default: ()) – A sequence of pairs of Floats specifying data set type pairs.

type: str = ''[source]

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

class Calibration(name)[source]

Bases: object

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.

Note

This object can be accessed by:

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

Note

Check Calibration on help.3ds.com/2023.

This method creates a Calibration object.

Note

This function can be accessed by:

mdb.models[name].Calibration
Parameters:

name (str) – A String specifying the name of the new calibration.

Returns:

A Calibration object.

Return type:

Calibration

Member Details:

Behavior(name, typeName)[source]

This method creates a Behavior object.

Note

This function can be accessed by:

mdb.models[name].Calibration

Note

Check Behavior on help.3ds.com/2023.

Parameters:

  • name (str) – A String specifying the name of the new behavior.

  • typeName (str) – 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.

Return type:

Behavior

DataSet(name, data=(), type='', form='')[source]

This method creates a DataSet object.

Note

This function can be accessed by:

mdb.models[name].Calibration

Note

Check DataSet on help.3ds.com/2023.

Parameters:

  • name (str) – A String specifying the name of the new dataset.

  • data (tuple, default: ()) – 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 (str, default: '') – 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 (str, default: '') – A String specifying the form of the new dataset. Values can be “NOMINAL” or “TRUE”. The default value is “NOMINAl”.

Returns:

A DataSet object.

Return type:

DataSet

behaviors: Optional[Behavior] = None[source]

A Behavior object.

dataSets: Optional[DataSet] = None[source]

A DataSet object.

name: str[source]

A String specifying the name of the new calibration.