Amplitude#

Amplitude commands are used to create arbitrary time or frequency variations of load, displacement, and some interaction attributes throughout a step using step time or throughout an analysis using total time.

Create amplitudes#

In Mdb#

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

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 AmplitudeModel on help.3ds.com/0.1..

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.

restartIncrement

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

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.

Public Methods:

ActuatorAmplitude(name[, timeSpan])

This method creates a ActuatorAmplitude object.

DecayAmplitude(name, initial, maximum, ...)

This method creates a DecayAmplitude object.

EquallySpacedAmplitude(name, fixedInterval, data)

This method creates an EquallySpacedAmplitude object.

ModulatedAmplitude(name, initial, magnitude, ...)

This method creates a ModulatedAmplitude object.

PeriodicAmplitude(name, frequency, start, ...)

This method creates a PeriodicAmplitude object.

PsdDefinition(name, data[, unitType, ...])

This method creates a PsdDefinition object.

SmoothStepAmplitude(name, data[, timeSpan])

This method creates a SmoothStepAmplitude object.

SolutionDependentAmplitude(name[, initial, ...])

This method creates a SolutionDependentAmplitude object.

SpectrumAmplitude(name, method, data[, ...])

This method creates a SpectrumAmplitude object.

TabularAmplitude(name, data[, smooth, timeSpan])

This method creates a TabularAmplitude 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.
ActuatorAmplitude(name, timeSpan=abaqusConstants.STEP)[source]#

This method creates a ActuatorAmplitude object.

Note

This function can be accessed by:

mdb.models[name].ActuatorAmplitude
session.odbs[name].ActuatorAmplitude

Note

Check ActuatorAmplitude on help.3ds.com/0.1..

Parameters:

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

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

An ActuatorAmplitude object.

Return type:

ActuatorAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

DecayAmplitude(name, initial, maximum, start, decayTime, timeSpan=abaqusConstants.STEP)[source]#

This method creates a DecayAmplitude object.

Note

This function can be accessed by:

mdb.models[name].DecayAmplitude
session.odbs[name].DecayAmplitude

Note

Check DecayAmplitude on help.3ds.com/0.1..

Parameters:

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

  • initial (float) – A Float specifying the constant A0A0.

  • maximum (float) – A Float specifying the coefficient AA.

  • start (float) – A Float specifying the starting time t0t0. Possible values are non-negative numbers.

  • decayTime (float) – A Float specifying the decay time tdtd. Possible values are non-negative numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A DecayAmplitude object.

Return type:

DecayAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

EquallySpacedAmplitude(name, fixedInterval, data, begin=0, smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]#

This method creates an EquallySpacedAmplitude object.

Note

This function can be accessed by:

mdb.models[name].EquallySpacedAmplitude
session.odbs[name].EquallySpacedAmplitude

Note

Check EquallySpacedAmplitude on help.3ds.com/0.1..

Parameters:

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

  • fixedInterval (float) – A Float specifying the fixed time interval at which the amplitude data are given. Possible values are positive numbers.

  • data (tuple) – A sequence of Floats specifying the amplitude values.

  • begin (float, default: 0) – A Float specifying the time at which the first amplitude data are given. Possible values are non-negative numbers. The default value is 0.0.

  • smooth (Union[SymbolicConstant, float], default: SOLVER_DEFAULT) – The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are 0 ≤ smoothing ≤ 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

An EquallySpacedAmplitude object.

Return type:

EquallySpacedAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

ModulatedAmplitude(name, initial, magnitude, start, frequency1, frequency2, timeSpan=abaqusConstants.STEP)[source]#

This method creates a ModulatedAmplitude object.

Note

This function can be accessed by:

mdb.models[name].ModulatedAmplitude
session.odbs[name].ModulatedAmplitude

Note

Check ModulatedAmplitude on help.3ds.com/0.1..

Parameters:

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

  • initial (float) – A Float specifying the constant A0A0.

  • magnitude (float) – A Float specifying the coefficient AA.

  • start (float) – A Float specifying the starting time t0t0. Possible values are non-negative numbers.

  • frequency1 (float) – A Float specifying the circular frequency 1 (ω1ω1). Possible values are positive numbers.

  • frequency2 (float) – A Float specifying the circular frequency 2 (ω2ω2). Possible values are positive numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A ModulatedAmplitude object.

Return type:

ModulatedAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

PeriodicAmplitude(name, frequency, start, a_0, data, timeSpan=abaqusConstants.STEP)[source]#

This method creates a PeriodicAmplitude object.

Note

This function can be accessed by:

mdb.models[name].PeriodicAmplitude
session.odbs[name].PeriodicAmplitude

Note

Check PeriodicAmplitude on help.3ds.com/0.1..

Parameters:

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

  • frequency (float) – A Float specifying the circular frequency ωω. Possible values are positive numbers.

  • start (float) – A Float specifying the starting time t0t0. Possible values are positive numbers.

  • a_0 (float) – A Float specifying the constant A0A0.

  • data (tuple) – A sequence of pairs of Floats specifying AiAi and BiBi pairs.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A PeriodicAmplitude object.

Return type:

PeriodicAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

PsdDefinition(name, data, unitType=abaqusConstants.FORCE, referenceGravityAcceleration=1, referenecePower=0, user=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]#

This method creates a PsdDefinition object.

Note

This function can be accessed by:

mdb.models[name].PsdDefinition
session.odbs[name].PsdDefinition

Note

Check PsdDefinition on help.3ds.com/0.1..

Parameters:

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

  • data (tuple) – A sequence of sequences of Floats specifying the real part of the frequency function, the imaginary part of the frequency function, and the frequency or frequency band number values, depending on the value of unitType.

  • unitType (SymbolicConstant, default: FORCE) – A SymbolicConstant specifying the type of units for specifying the frequency function. FORCE implies power units. BASE implies gravity used to define base motion. DB implies decibel units. Possible values are FORCE, BASE, and DB. The default value is FORCE.

  • referenceGravityAcceleration (float, default: 1) – A Float specifying the reference gravity acceleration. This argument applies when unitType = BASE. The default value is 1.0.

  • referenecePower (float, default: 0) – A Float specifying the reference power value, in load units squared. This argument applies when unitType = DB. The default value is 0.0.

  • user (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the frequency function is defined in user subroutine UPSD. If specified, then data is not applicable, and the unitType value must not be DB. The default value is OFF.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

  • amplitude (str, default: '') – A String specifying the name of the amplitude that describes the dynamic event used to define the cross-spectral density frequency function. The default value is an empty string.

Returns:

A PsdDefinition object.

Return type:

PsdDefinition

Raises:

  • InvalidNameError –

  • RangeError –

SmoothStepAmplitude(name, data, timeSpan=abaqusConstants.STEP)[source]#

This method creates a SmoothStepAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SmoothStepAmplitude
session.odbs[name].SmoothStepAmplitude

Note

Check SmoothStepAmplitude on help.3ds.com/0.1..

Parameters:

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

  • data (tuple) – A sequence of pairs of Floats specifying time/frequency and amplitude pairs. Possible values for time/frequency are positive numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A SmoothStepAmplitude object.

Return type:

SmoothStepAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

SolutionDependentAmplitude(name, initial=1, minimum=0, maximum=1000, timeSpan=abaqusConstants.STEP)[source]#

This method creates a SolutionDependentAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SolutionDependentAmplitude
session.odbs[name].SolutionDependentAmplitude

Note

Check SolutionDependentAmplitude on help.3ds.com/0.1..

Parameters:

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

  • initial (float, default: 1) – A Float specifying the initial amplitude value. Possible values are those between minimum and maximum. The default value is 1.0.

  • minimum (float, default: 0) – A Float specifying the minimum amplitude value. Possible values are those smaller than maximum and initial. The default value is 0.1.

  • maximum (float, default: 1000) – A Float specifying the maximum amplitude value. Possible values are those larger than minimum and initial. The default value is 1000.0.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A SolutionDependentAmplitude object.

Return type:

SolutionDependentAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

SpectrumAmplitude(name, method, data, specificationUnits=abaqusConstants.ACCELERATION, eventUnits=abaqusConstants.EVENT_ACCELERATION, solution=abaqusConstants.ABSOLUTE_VALUE, timeIncrement=0, gravity=1, criticalDamping=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]#

This method creates a SpectrumAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SpectrumAmplitude
session.odbs[name].SpectrumAmplitude

Note

Check SpectrumAmplitude on help.3ds.com/0.1..

Parameters:

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

  • method (SymbolicConstant) – A SymbolicConstant specifying the method for specifying the spectrum. Possible values are DEFINE and CALCULATE.

  • data (tuple) – A sequence of sequences of Floats specifying the magnitude, frequency, and damping values.

  • specificationUnits (SymbolicConstant, default: ACCELERATION) – A SymbolicConstant specifying the units used for specifying the spectrum. Possible values are DISPLACEMENT, VELOCITY, ACCELERATION, and GRAVITY. The default value is ACCELERATION.

  • eventUnits (SymbolicConstant, default: EVENT_ACCELERATION) – A SymbolicConstant specifying the units used to describe the dynamic event in the amplitude used for the calculation. Possible values are EVENT_DISPLACEMENT, EVENT_VELOCITY, EVENT_ACCELERATION, and EVENT_GRAVITY. The default value is EVENT_ACCELERATION.

  • solution (SymbolicConstant, default: ABSOLUTE_VALUE) – A SymbolicConstant specifying the solution method for the dynamic equations. Possible values are ABSOLUTE_VALUE and RELATIVE_VALUE. The default value is ABSOLUTE_VALUE.

  • timeIncrement (float, default: 0) – A Float specifying the implicit time increment used to calculate the spectrum. This argument is required when the method = CALCULATE. The default value is 0.0.

  • gravity (float, default: 1) – A Float specifying the acceleration due to gravity. This argument applies only when specificationUnits = GRAVITY or*eventUnits* = GRAVITY. The default value is 1.0.

  • criticalDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to calculate the spectrum for only the specified range of critical damping values or a list of values. If criticalDamping = ON, the spectrum is calculated only for the specified range of critical damping values. If criticalDamping = OFF, the spectrum is calculated for a list of damping values. The default value is OFF.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

  • amplitude (str, default: '') – A String specifying the name of the amplitude that describes the dynamic event used to calculate the spectrum. The default value is an empty string.

Returns:

A SpectrumAmplitude object.

Return type:

SpectrumAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

TabularAmplitude(name, data, smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]#

This method creates a TabularAmplitude object.

Note

This function can be accessed by:

mdb.models[name].TabularAmplitude
session.odbs[name].TabularAmplitude

Note

Check TabularAmplitude on help.3ds.com/0.1..

Parameters:

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

  • data (tuple) – A sequence of pairs of Floats specifying time/frequency and amplitude pairs. Possible values for time/frequency are positive numbers.

  • smooth (Union[SymbolicConstant, float], default: SOLVER_DEFAULT) – The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are between 0 and 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A TabularAmplitude object.

Return type:

TabularAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

In Odb#

class AmplitudeOdb(name, analysisTitle='', description='', path='')[source]#

The Odb object is the in-memory representation of an output database (ODB) file.

Note

This object can be accessed by:

import odbAccess
session.odbs[name]

Note

Check AmplitudeOdb on help.3ds.com/0.1..

Public Data Attributes:

Inherited from OdbBase

isReadOnly

A Boolean specifying whether the output database was opened with read-only access.

amplitudes

A repository of Amplitude objects.

filters

A repository of Filter objects.

rootAssembly

An OdbAssembly object.

jobData

A JobData object.

parts

A repository of OdbPart objects.

materials

A repository of Material objects.

steps

A repository of OdbStep objects.

sections

A repository of Section objects.

sectionCategories

A repository of SectionCategory objects.

sectorDefinition

A SectorDefinition object.

userData

A UserData object.

customData

A RepositorySupport object.

profiles

A repository of Profile objects.

Public Methods:

ActuatorAmplitude(name[, timeSpan])

This method creates a ActuatorAmplitude object.

DecayAmplitude(name, initial, maximum, ...)

This method creates a DecayAmplitude object.

EquallySpacedAmplitude(name, fixedInterval, data)

This method creates an EquallySpacedAmplitude object.

ModulatedAmplitude(name, initial, magnitude, ...)

This method creates a ModulatedAmplitude object.

PeriodicAmplitude(name, frequency, start, ...)

This method creates a PeriodicAmplitude object.

PsdDefinition(name, data[, unitType, ...])

This method creates a PsdDefinition object.

SmoothStepAmplitude(name, data[, timeSpan])

This method creates a SmoothStepAmplitude object.

SolutionDependentAmplitude(name[, initial, ...])

This method creates a SolutionDependentAmplitude object.

SpectrumAmplitude(name, method, data[, ...])

This method creates a SpectrumAmplitude object.

TabularAmplitude(name, data[, smooth, timeSpan])

This method creates a TabularAmplitude object.
Inherited from OdbBase

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

This method creates a new Odb object.

close()

This method closes an output database.

getFrame(frameValue[, match])

This method returns the frame at the specified time, frequency, or mode.

save()

This method saves output to an output database (.odb ) file.

update()

This method is used to update an Odb object in memory while an Abaqus analysis writes data to the associated output database.
ActuatorAmplitude(name, timeSpan=abaqusConstants.STEP)[source]#

This method creates a ActuatorAmplitude object.

Note

This function can be accessed by:

mdb.models[name].ActuatorAmplitude
session.odbs[name].ActuatorAmplitude

Note

Check ActuatorAmplitude on help.3ds.com/0.1..

Parameters:

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

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

An ActuatorAmplitude object.

Return type:

ActuatorAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

DecayAmplitude(name, initial, maximum, start, decayTime, timeSpan=abaqusConstants.STEP)[source]#

This method creates a DecayAmplitude object.

Note

This function can be accessed by:

mdb.models[name].DecayAmplitude
session.odbs[name].DecayAmplitude

Note

Check DecayAmplitude on help.3ds.com/0.1..

Parameters:

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

  • initial (float) – A Float specifying the constant A0A0.

  • maximum (float) – A Float specifying the coefficient AA.

  • start (float) – A Float specifying the starting time t0t0. Possible values are non-negative numbers.

  • decayTime (float) – A Float specifying the decay time tdtd. Possible values are non-negative numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A DecayAmplitude object.

Return type:

DecayAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

EquallySpacedAmplitude(name, fixedInterval, data, begin=0, smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]#

This method creates an EquallySpacedAmplitude object.

Note

This function can be accessed by:

mdb.models[name].EquallySpacedAmplitude
session.odbs[name].EquallySpacedAmplitude

Note

Check EquallySpacedAmplitude on help.3ds.com/0.1..

Parameters:

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

  • fixedInterval (float) – A Float specifying the fixed time interval at which the amplitude data are given. Possible values are positive numbers.

  • data (tuple) – A sequence of Floats specifying the amplitude values.

  • begin (float, default: 0) – A Float specifying the time at which the first amplitude data are given. Possible values are non-negative numbers. The default value is 0.0.

  • smooth (Union[SymbolicConstant, float], default: SOLVER_DEFAULT) – The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are 0 ≤ smoothing ≤ 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

An EquallySpacedAmplitude object.

Return type:

EquallySpacedAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

ModulatedAmplitude(name, initial, magnitude, start, frequency1, frequency2, timeSpan=abaqusConstants.STEP)[source]#

This method creates a ModulatedAmplitude object.

Note

This function can be accessed by:

mdb.models[name].ModulatedAmplitude
session.odbs[name].ModulatedAmplitude

Note

Check ModulatedAmplitude on help.3ds.com/0.1..

Parameters:

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

  • initial (float) – A Float specifying the constant A0A0.

  • magnitude (float) – A Float specifying the coefficient AA.

  • start (float) – A Float specifying the starting time t0t0. Possible values are non-negative numbers.

  • frequency1 (float) – A Float specifying the circular frequency 1 (ω1ω1). Possible values are positive numbers.

  • frequency2 (float) – A Float specifying the circular frequency 2 (ω2ω2). Possible values are positive numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A ModulatedAmplitude object.

Return type:

ModulatedAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

PeriodicAmplitude(name, frequency, start, a_0, data, timeSpan=abaqusConstants.STEP)[source]#

This method creates a PeriodicAmplitude object.

Note

This function can be accessed by:

mdb.models[name].PeriodicAmplitude
session.odbs[name].PeriodicAmplitude

Note

Check PeriodicAmplitude on help.3ds.com/0.1..

Parameters:

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

  • frequency (float) – A Float specifying the circular frequency ωω. Possible values are positive numbers.

  • start (float) – A Float specifying the starting time t0t0. Possible values are positive numbers.

  • a_0 (float) – A Float specifying the constant A0A0.

  • data (tuple) – A sequence of pairs of Floats specifying AiAi and BiBi pairs.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A PeriodicAmplitude object.

Return type:

PeriodicAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

PsdDefinition(name, data, unitType=abaqusConstants.FORCE, referenceGravityAcceleration=1, referenecePower=0, user=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]#

This method creates a PsdDefinition object.

Note

This function can be accessed by:

mdb.models[name].PsdDefinition
session.odbs[name].PsdDefinition

Note

Check PsdDefinition on help.3ds.com/0.1..

Parameters:

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

  • data (tuple) – A sequence of sequences of Floats specifying the real part of the frequency function, the imaginary part of the frequency function, and the frequency or frequency band number values, depending on the value of unitType.

  • unitType (SymbolicConstant, default: FORCE) – A SymbolicConstant specifying the type of units for specifying the frequency function. FORCE implies power units. BASE implies gravity used to define base motion. DB implies decibel units. Possible values are FORCE, BASE, and DB. The default value is FORCE.

  • referenceGravityAcceleration (float, default: 1) – A Float specifying the reference gravity acceleration. This argument applies when unitType = BASE. The default value is 1.0.

  • referenecePower (float, default: 0) – A Float specifying the reference power value, in load units squared. This argument applies when unitType = DB. The default value is 0.0.

  • user (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the frequency function is defined in user subroutine UPSD. If specified, then data is not applicable, and the unitType value must not be DB. The default value is OFF.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

  • amplitude (str, default: '') – A String specifying the name of the amplitude that describes the dynamic event used to define the cross-spectral density frequency function. The default value is an empty string.

Returns:

A PsdDefinition object.

Return type:

PsdDefinition

Raises:

  • InvalidNameError –

  • RangeError –

SmoothStepAmplitude(name, data, timeSpan=abaqusConstants.STEP)[source]#

This method creates a SmoothStepAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SmoothStepAmplitude
session.odbs[name].SmoothStepAmplitude

Note

Check SmoothStepAmplitude on help.3ds.com/0.1..

Parameters:

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

  • data (tuple) – A sequence of pairs of Floats specifying time/frequency and amplitude pairs. Possible values for time/frequency are positive numbers.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A SmoothStepAmplitude object.

Return type:

SmoothStepAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

SolutionDependentAmplitude(name, initial=1, minimum=0, maximum=1000, timeSpan=abaqusConstants.STEP)[source]#

This method creates a SolutionDependentAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SolutionDependentAmplitude
session.odbs[name].SolutionDependentAmplitude

Note

Check SolutionDependentAmplitude on help.3ds.com/0.1..

Parameters:

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

  • initial (float, default: 1) – A Float specifying the initial amplitude value. Possible values are those between minimum and maximum. The default value is 1.0.

  • minimum (float, default: 0) – A Float specifying the minimum amplitude value. Possible values are those smaller than maximum and initial. The default value is 0.1.

  • maximum (float, default: 1000) – A Float specifying the maximum amplitude value. Possible values are those larger than minimum and initial. The default value is 1000.0.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A SolutionDependentAmplitude object.

Return type:

SolutionDependentAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

SpectrumAmplitude(name, method, data, specificationUnits=abaqusConstants.ACCELERATION, eventUnits=abaqusConstants.EVENT_ACCELERATION, solution=abaqusConstants.ABSOLUTE_VALUE, timeIncrement=0, gravity=1, criticalDamping=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]#

This method creates a SpectrumAmplitude object.

Note

This function can be accessed by:

mdb.models[name].SpectrumAmplitude
session.odbs[name].SpectrumAmplitude

Note

Check SpectrumAmplitude on help.3ds.com/0.1..

Parameters:

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

  • method (SymbolicConstant) – A SymbolicConstant specifying the method for specifying the spectrum. Possible values are DEFINE and CALCULATE.

  • data (tuple) – A sequence of sequences of Floats specifying the magnitude, frequency, and damping values.

  • specificationUnits (SymbolicConstant, default: ACCELERATION) – A SymbolicConstant specifying the units used for specifying the spectrum. Possible values are DISPLACEMENT, VELOCITY, ACCELERATION, and GRAVITY. The default value is ACCELERATION.

  • eventUnits (SymbolicConstant, default: EVENT_ACCELERATION) – A SymbolicConstant specifying the units used to describe the dynamic event in the amplitude used for the calculation. Possible values are EVENT_DISPLACEMENT, EVENT_VELOCITY, EVENT_ACCELERATION, and EVENT_GRAVITY. The default value is EVENT_ACCELERATION.

  • solution (SymbolicConstant, default: ABSOLUTE_VALUE) – A SymbolicConstant specifying the solution method for the dynamic equations. Possible values are ABSOLUTE_VALUE and RELATIVE_VALUE. The default value is ABSOLUTE_VALUE.

  • timeIncrement (float, default: 0) – A Float specifying the implicit time increment used to calculate the spectrum. This argument is required when the method = CALCULATE. The default value is 0.0.

  • gravity (float, default: 1) – A Float specifying the acceleration due to gravity. This argument applies only when specificationUnits = GRAVITY or*eventUnits* = GRAVITY. The default value is 1.0.

  • criticalDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to calculate the spectrum for only the specified range of critical damping values or a list of values. If criticalDamping = ON, the spectrum is calculated only for the specified range of critical damping values. If criticalDamping = OFF, the spectrum is calculated for a list of damping values. The default value is OFF.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

  • amplitude (str, default: '') – A String specifying the name of the amplitude that describes the dynamic event used to calculate the spectrum. The default value is an empty string.

Returns:

A SpectrumAmplitude object.

Return type:

SpectrumAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

TabularAmplitude(name, data, smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]#

This method creates a TabularAmplitude object.

Note

This function can be accessed by:

mdb.models[name].TabularAmplitude
session.odbs[name].TabularAmplitude

Note

Check TabularAmplitude on help.3ds.com/0.1..

Parameters:

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

  • data (tuple) – A sequence of pairs of Floats specifying time/frequency and amplitude pairs. Possible values for time/frequency are positive numbers.

  • smooth (Union[SymbolicConstant, float], default: SOLVER_DEFAULT) – The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are between 0 and 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Returns:

A TabularAmplitude object.

Return type:

TabularAmplitude

Raises:

  • InvalidNameError –

  • RangeError –

Object features#

Amplitude#

class Amplitude[source]#

The Amplitude object is the abstract base type for other Amplitude objects. The Amplitude object has no explicit constructor. The methods and members of the Amplitude object are common to all objects derived from the Amplitude.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name]
import odbAmplitude
session.odbs[name].amplitudes[name]

Note

Check Amplitude on help.3ds.com/0.1..

Public Data Attributes:

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.
name: str = ''[source]#

A String specifying the repository key.

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

ActuatorAmplitude#

class ActuatorAmplitude(name, timeSpan=abaqusConstants.STEP)[source]#

The ActuatorAmplitude object defines an actuator amplitude curve. The ActuatorAmplitude object is derived from the Amplitude object.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name]
import odbAmplitude
session.odbs[name].amplitudes[name]

The corresponding analysis keywords are:

  • AMPLITUDE

Note

Check ActuatorAmplitude on help.3ds.com/0.1..

Public Data Attributes:

timeSpan

A SymbolicConstant specifying the time span of the amplitude.
Inherited from Amplitude

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

Public Methods:

__init__(name[, timeSpan])

This method creates a ActuatorAmplitude object.

setValues([timeSpan])

This method modifies the ActuatorAmplitude object.
setValues(timeSpan=abaqusConstants.STEP)[source]#

This method modifies the ActuatorAmplitude object.

Note

Check ActuatorAmplitude.setValues on help.3ds.com/0.1..

Parameters:

timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Raises:

RangeError –

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

BaselineCorrection#

class BaselineCorrection(intervals=())[source]#

The BaselineCorrection object modifies an acceleration history to minimize the overall drift of the displacement obtained from the time integration of the given acceleration.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name].baselineCorrection
import odbAmplitude
session.odbs[name].amplitudes[name].baselineCorrection

The corresponding analysis keywords are:

  • BASELINE CORRECTION

Note

Check BaselineCorrection on help.3ds.com/0.1..

Public Data Attributes:

intervals

A sequence of Floats specifying the correction time interval end points.

Public Methods:

__init__([intervals])

This method creates a BaselineCorrection object.

setValues(*args, **kwargs)

This method modifies the BaselineCorrection object.
intervals: tuple = ()[source]#

A sequence of Floats specifying the correction time interval end points. Possible values are positive and monotonically increasing Floats. The default value is an empty sequence.

setValues(*args, **kwargs)[source]#

This method modifies the BaselineCorrection object.

Raises:

RangeError –

Correlation#

class Correlation[source]#

A Correlation is an object used to define the cross-correlation as part of the definition of random loading. The Correlation object is derived from the Amplitude object.

Note

This object can be accessed by:

import load
mdb.models[name].boundaryConditions[name].correlation[i]

Note

Check Correlation on help.3ds.com/0.1..

Public Data Attributes:

name

A String specifying the repository key.

approach

A SymbolicConstant specifying the approach used in the correlation data representation.

data

A tuple of tuples of Floats specifying the real and imaginary part of the scaling factor.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.
Inherited from Amplitude

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.
approach: SymbolicConstant = CORRELATED[source]#

A SymbolicConstant specifying the approach used in the correlation data representation. Possible values are CORRELATED, MOVING_NOISE, UNCORRELATED, and USER. The default value is CORRELATED.

data: Optional[float] = None[source]#

A tuple of tuples of Floats specifying the real and imaginary part of the scaling factor. If approach = MOVING_NOISE, then data represents the noise velocity components 1, 2, and 3.

name: str = ''[source]#

A String specifying the repository key.

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

DecayAmplitude#

class DecayAmplitude(name, initial, maximum, start, decayTime, timeSpan=abaqusConstants.STEP)[source]#

The DecayAmplitude object defines an amplitude curve using an exponential decay. The DecayAmplitude object is derived from the Amplitude object.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name]
import odbAmplitude
session.odbs[name].amplitudes[name]

The corresponding analysis keywords are:

  • AMPLITUDE

Note

Check DecayAmplitude on help.3ds.com/0.1..

Public Data Attributes:

timeSpan

A SymbolicConstant specifying the time span of the amplitude.
Inherited from Amplitude

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

Public Methods:

__init__(name, initial, maximum, start, ...)

This method creates a DecayAmplitude object.

setValues([timeSpan])

This method modifies the DecayAmplitude object.
decayTime: float[source]#

A Float specifying the decay time tdtd. Possible values are non-negative numbers.

initial: float[source]#

A Float specifying the constant A0A0.

maximum: float[source]#

A Float specifying the coefficient AA.

setValues(timeSpan=abaqusConstants.STEP)[source]#

This method modifies the DecayAmplitude object.

Note

Check DecayAmplitude.setValues on help.3ds.com/0.1..

Parameters:

timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Raises:

RangeError –

start: float[source]#

A Float specifying the starting time t0t0. Possible values are non-negative numbers.

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

EquallySpacedAmplitude#

class EquallySpacedAmplitude(name, fixedInterval, data, begin=0, smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]#

The EquallySpacedAmplitude object defines a list of amplitude values at fixed time intervals beginning at a specified value of time. The EquallySpacedAmplitude object is derived from the Amplitude object.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name]
import odbAmplitude
session.odbs[name].amplitudes[name]

The corresponding analysis keywords are:

  • AMPLITUDE

Note

Check EquallySpacedAmplitude on help.3ds.com/0.1..

Public Data Attributes:

baselineCorrection

A BaselineCorrection object.

begin

A Float specifying the time at which the first amplitude data are given.

smooth

The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.
Inherited from Amplitude

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

Public Methods:

__init__(name, fixedInterval, data[, begin, ...])

This method creates an EquallySpacedAmplitude object.

setValues([begin, smooth, timeSpan])

This method modifies the EquallySpacedAmplitude object.
baselineCorrection: BaselineCorrection = <abaqus.Amplitude.BaselineCorrection.BaselineCorrection object>[source]#

A BaselineCorrection object.

begin: float = 0[source]#

A Float specifying the time at which the first amplitude data are given. Possible values are non-negative numbers. The default value is 0.0.

data: tuple[source]#

A sequence of Floats specifying the amplitude values.

fixedInterval: float[source]#

A Float specifying the fixed time interval at which the amplitude data are given. Possible values are positive numbers.

setValues(begin=0, smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]#

This method modifies the EquallySpacedAmplitude object.

Note

Check EquallySpacedAmplitude.setValues on help.3ds.com/0.1..

Parameters:

  • begin (float, default: 0) – A Float specifying the time at which the first amplitude data are given. Possible values are non-negative numbers. The default value is 0.0.

  • smooth (Union[SymbolicConstant, float], default: SOLVER_DEFAULT) – The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are 0 ≤ smoothing ≤ 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Raises:

RangeError –

smooth: Union[SymbolicConstant, float] = SOLVER_DEFAULT[source]#

The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are 0 ≤ smoothing ≤ 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

ModulatedAmplitude#

class ModulatedAmplitude(name, initial, magnitude, start, frequency1, frequency2, timeSpan=abaqusConstants.STEP)[source]#

The ModulatedAmplitude object defines a modulated amplitude curve. The ModulatedAmplitude object is derived from the Amplitude object.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name]
import odbAmplitude
session.odbs[name].amplitudes[name]

The corresponding analysis keywords are:

  • AMPLITUDE

Note

Check ModulatedAmplitude on help.3ds.com/0.1..

Public Data Attributes:

timeSpan

A SymbolicConstant specifying the time span of the amplitude.
Inherited from Amplitude

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

Public Methods:

__init__(name, initial, magnitude, start, ...)

This method creates a ModulatedAmplitude object.

setValues([timeSpan])

This method modifies the ModulatedAmplitude object.
frequency1: float[source]#

A Float specifying the circular frequency 1 (ω1ω1). Possible values are positive numbers.

frequency2: float[source]#

A Float specifying the circular frequency 2 (ω2ω2). Possible values are positive numbers.

initial: float[source]#

A Float specifying the constant A0A0.

magnitude: float[source]#

A Float specifying the coefficient AA.

setValues(timeSpan=abaqusConstants.STEP)[source]#

This method modifies the ModulatedAmplitude object.

Note

Check ModulatedAmplitude.setValues on help.3ds.com/0.1..

Parameters:

timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Raises:

RangeError –

start: float[source]#

A Float specifying the starting time t0t0. Possible values are non-negative numbers.

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

PeriodicAmplitude#

class PeriodicAmplitude(name, frequency, start, a_0, data, timeSpan=abaqusConstants.STEP)[source]#

The PeriodicAmplitude object defines an amplitude curve using a Fourier series. The PeriodicAmplitude object is derived from the Amplitude object.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name]
import odbAmplitude
session.odbs[name].amplitudes[name]

The corresponding analysis keywords are:

  • AMPLITUDE

Note

Check PeriodicAmplitude on help.3ds.com/0.1..

Public Data Attributes:

timeSpan

A SymbolicConstant specifying the time span of the amplitude.
Inherited from Amplitude

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

Public Methods:

__init__(name, frequency, start, a_0, data)

This method creates a PeriodicAmplitude object.

setValues([timeSpan])

This method modifies the PeriodicAmplitude object.
a_0: float[source]#

A Float specifying the constant A0A0.

data: tuple[source]#

A sequence of pairs of Floats specifying AiAi and BiBi pairs.

frequency: float[source]#

A Float specifying the circular frequency ωω. Possible values are positive numbers.

setValues(timeSpan=abaqusConstants.STEP)[source]#

This method modifies the PeriodicAmplitude object.

Note

Check PeriodicAmplitude.setValues on help.3ds.com/0.1..

Parameters:

timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Raises:

RangeError –

start: float[source]#

A Float specifying the starting time t0t0. Possible values are positive numbers.

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

PsdDefinition#

class PsdDefinition(name, data, unitType=abaqusConstants.FORCE, referenceGravityAcceleration=1, referenecePower=0, user=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]#

The PsdDefinition object defines the cross-spectral density frequency function for random response loading. The PsdDefinition object is derived from the Amplitude object.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name]
import odbAmplitude
session.odbs[name].amplitudes[name]

The corresponding analysis keywords are:

  • PSD-DEFINITION

Note

Check PsdDefinition on help.3ds.com/0.1..

Public Data Attributes:

unitType

A SymbolicConstant specifying the type of units for specifying the frequency function.

referenceGravityAcceleration

A Float specifying the reference gravity acceleration.

referenecePower

A Float specifying the reference power value, in load units squared.

user

A Boolean specifying whether the frequency function is defined in user subroutine UPSD.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

amplitude

A String specifying the name of the amplitude that describes the dynamic event used to define the cross-spectral density frequency function.
Inherited from Amplitude

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

Public Methods:

__init__(name, data[, unitType, ...])

This method creates a PsdDefinition object.

setValues([unitType, ...])

This method modifies the PsdDefinition object.
amplitude: str = ''[source]#

A String specifying the name of the amplitude that describes the dynamic event used to define the cross-spectral density frequency function. The default value is an empty string.

data: tuple[source]#

A sequence of sequences of Floats specifying the real part of the frequency function, the imaginary part of the frequency function, and the frequency or frequency band number values, depending on the value of unitType.

referenceGravityAcceleration: float = 1[source]#

A Float specifying the reference gravity acceleration. This argument applies when unitType = BASE. The default value is 1.0.

referenecePower: float = 0[source]#

A Float specifying the reference power value, in load units squared. This argument applies when unitType = DB. The default value is 0.0.

setValues(unitType=abaqusConstants.FORCE, referenceGravityAcceleration=1, referenecePower=0, user=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]#

This method modifies the PsdDefinition object.

Note

Check PsdDefinition.setValues on help.3ds.com/0.1..

Parameters:

  • unitType (SymbolicConstant, default: FORCE) – A SymbolicConstant specifying the type of units for specifying the frequency function. FORCE implies power units. BASE implies gravity used to define base motion. DB implies decibel units. Possible values are FORCE, BASE, and DB. The default value is FORCE.

  • referenceGravityAcceleration (float, default: 1) – A Float specifying the reference gravity acceleration. This argument applies when unitType = BASE. The default value is 1.0.

  • referenecePower (float, default: 0) – A Float specifying the reference power value, in load units squared. This argument applies when unitType = DB. The default value is 0.0.

  • user (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the frequency function is defined in user subroutine UPSD. If specified, then data is not applicable, and the unitType value must not be DB. The default value is OFF.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

  • amplitude (str, default: '') – A String specifying the name of the amplitude that describes the dynamic event used to define the cross-spectral density frequency function. The default value is an empty string.

Raises:

RangeError –

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

unitType: SymbolicConstant = FORCE[source]#

A SymbolicConstant specifying the type of units for specifying the frequency function. FORCE implies power units. BASE implies gravity used to define base motion. DB implies decibel units. Possible values are FORCE, BASE, and DB. The default value is FORCE.

user: Union[AbaqusBoolean, bool] = OFF[source]#

A Boolean specifying whether the frequency function is defined in user subroutine UPSD. If specified, then data is not applicable, and the unitType value must not be DB. The default value is OFF.

SmoothStepAmplitude#

class SmoothStepAmplitude(name, data, timeSpan=abaqusConstants.STEP)[source]#

The SmoothStepAmplitude object defines an amplitude that ramps up or down smoothly from one data point to another. The SmoothStepAmplitude object is derived from the Amplitude object.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name]
import odbAmplitude
session.odbs[name].amplitudes[name]

The corresponding analysis keywords are:

  • AMPLITUDE

Note

Check SmoothStepAmplitude on help.3ds.com/0.1..

Public Data Attributes:

timeSpan

A SymbolicConstant specifying the time span of the amplitude.
Inherited from Amplitude

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

Public Methods:

__init__(name, data[, timeSpan])

This method creates a SmoothStepAmplitude object.

setValues([timeSpan])

This method modifies the SmoothStepAmplitude object.
data: tuple[source]#

A sequence of pairs of Floats specifying time/frequency and amplitude pairs. Possible values for time/frequency are positive numbers.

setValues(timeSpan=abaqusConstants.STEP)[source]#

This method modifies the SmoothStepAmplitude object.

Note

Check SmoothStepAmplitude.setValues on help.3ds.com/0.1..

Parameters:

timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Raises:

RangeError –

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

SolutionDependentAmplitude#

class SolutionDependentAmplitude(name, initial=1, minimum=0, maximum=1000, timeSpan=abaqusConstants.STEP)[source]#

The SolutionDependentAmplitude object defines a solution-dependent amplitude for superplastic forming analysis. The SolutionDependentAmplitude object is derived from the Amplitude object.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name]
import odbAmplitude
session.odbs[name].amplitudes[name]

The corresponding analysis keywords are:

  • AMPLITUDE

Note

Check SolutionDependentAmplitude on help.3ds.com/0.1..

Public Data Attributes:

initial

A Float specifying the initial amplitude value.

minimum

A Float specifying the minimum amplitude value.

maximum

A Float specifying the maximum amplitude value.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.
Inherited from Amplitude

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

Public Methods:

__init__(name[, initial, minimum, maximum, ...])

This method creates a SolutionDependentAmplitude object.

setValues([initial, minimum, maximum, timeSpan])

This method modifies the SolutionDependentAmplitude object.
initial: float = 1[source]#

A Float specifying the initial amplitude value. Possible values are those between minimum and maximum. The default value is 1.0.

maximum: float = 1000[source]#

A Float specifying the maximum amplitude value. Possible values are those larger than minimum and initial. The default value is 1000.0.

minimum: float = 0[source]#

A Float specifying the minimum amplitude value. Possible values are those smaller than maximum and initial. The default value is 0.1.

setValues(initial=1, minimum=0, maximum=1000, timeSpan=abaqusConstants.STEP)[source]#

This method modifies the SolutionDependentAmplitude object.

Note

Check SolutionDependentAmplitude.setValues on help.3ds.com/0.1..

Parameters:

  • initial (float, default: 1) – A Float specifying the initial amplitude value. Possible values are those between minimum and maximum. The default value is 1.0.

  • minimum (float, default: 0) – A Float specifying the minimum amplitude value. Possible values are those smaller than maximum and initial. The default value is 0.1.

  • maximum (float, default: 1000) – A Float specifying the maximum amplitude value. Possible values are those larger than minimum and initial. The default value is 1000.0.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Raises:

RangeError –

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

SpectrumAmplitude#

class SpectrumAmplitude(name, method, data, specificationUnits=abaqusConstants.ACCELERATION, eventUnits=abaqusConstants.EVENT_ACCELERATION, solution=abaqusConstants.ABSOLUTE_VALUE, timeIncrement=0, gravity=1, criticalDamping=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]#

The SpectrumAmplitude object defines the spectrum of responses for displacement, velocity, or acceleration to be used in a response spectrum analysis. The SpectrumAmplitude object is derived from the Amplitude object.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name]
import odbAmplitude
session.odbs[name].amplitudes[name]

The corresponding analysis keywords are:

  • SPECTRUM

Note

Check SpectrumAmplitude on help.3ds.com/0.1..

Public Data Attributes:

specificationUnits

A SymbolicConstant specifying the units used for specifying the spectrum.

eventUnits

A SymbolicConstant specifying the units used to describe the dynamic event in the amplitude used for the calculation.

solution

A SymbolicConstant specifying the solution method for the dynamic equations.

timeIncrement

A Float specifying the implicit time increment used to calculate the spectrum.

gravity

A Float specifying the acceleration due to gravity.

criticalDamping

A Boolean specifying whether to calculate the spectrum for only the specified range of critical damping values or a list of values.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

amplitude

A String specifying the name of the amplitude that describes the dynamic event used to calculate the spectrum.
Inherited from Amplitude

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

Public Methods:

__init__(name, method, data[, ...])

This method creates a SpectrumAmplitude object.

setValues([specificationUnits, eventUnits, ...])

This method modifies the SpectrumAmplitude object.
amplitude: str = ''[source]#

A String specifying the name of the amplitude that describes the dynamic event used to calculate the spectrum. The default value is an empty string.

criticalDamping: Union[AbaqusBoolean, bool] = OFF[source]#

A Boolean specifying whether to calculate the spectrum for only the specified range of critical damping values or a list of values. If criticalDamping = ON, the spectrum is calculated only for the specified range of critical damping values. If criticalDamping = OFF, the spectrum is calculated for a list of damping values. The default value is OFF.

data: tuple[source]#

A sequence of sequences of Floats specifying the magnitude, frequency, and damping values.

eventUnits: SymbolicConstant = EVENT_ACCELERATION[source]#

A SymbolicConstant specifying the units used to describe the dynamic event in the amplitude used for the calculation. Possible values are EVENT_DISPLACEMENT, EVENT_VELOCITY, EVENT_ACCELERATION, and EVENT_GRAVITY. The default value is EVENT_ACCELERATION.

gravity: float = 1[source]#

A Float specifying the acceleration due to gravity. This argument applies only when specificationUnits = GRAVITY or*eventUnits* = GRAVITY. The default value is 1.0.

method: SymbolicConstant[source]#

A SymbolicConstant specifying the method for specifying the spectrum. Possible values are DEFINE and CALCULATE.

setValues(specificationUnits=abaqusConstants.ACCELERATION, eventUnits=abaqusConstants.EVENT_ACCELERATION, solution=abaqusConstants.ABSOLUTE_VALUE, timeIncrement=0, gravity=1, criticalDamping=OFF, timeSpan=abaqusConstants.STEP, amplitude='')[source]#

This method modifies the SpectrumAmplitude object.

Note

Check SpectrumAmplitude.setValues on help.3ds.com/0.1..

Parameters:

  • specificationUnits (SymbolicConstant, default: ACCELERATION) – A SymbolicConstant specifying the units used for specifying the spectrum. Possible values are DISPLACEMENT, VELOCITY, ACCELERATION, and GRAVITY. The default value is ACCELERATION.

  • eventUnits (SymbolicConstant, default: EVENT_ACCELERATION) – A SymbolicConstant specifying the units used to describe the dynamic event in the amplitude used for the calculation. Possible values are EVENT_DISPLACEMENT, EVENT_VELOCITY, EVENT_ACCELERATION, and EVENT_GRAVITY. The default value is EVENT_ACCELERATION.

  • solution (SymbolicConstant, default: ABSOLUTE_VALUE) – A SymbolicConstant specifying the solution method for the dynamic equations. Possible values are ABSOLUTE_VALUE and RELATIVE_VALUE. The default value is ABSOLUTE_VALUE.

  • timeIncrement (float, default: 0) – A Float specifying the implicit time increment used to calculate the spectrum. This argument is required when the method = CALCULATE. The default value is 0.0.

  • gravity (float, default: 1) – A Float specifying the acceleration due to gravity. This argument applies only when specificationUnits = GRAVITY or*eventUnits* = GRAVITY. The default value is 1.0.

  • criticalDamping (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to calculate the spectrum for only the specified range of critical damping values or a list of values. If criticalDamping = ON, the spectrum is calculated only for the specified range of critical damping values. If criticalDamping = OFF, the spectrum is calculated for a list of damping values. The default value is OFF.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

  • amplitude (str, default: '') – A String specifying the name of the amplitude that describes the dynamic event used to calculate the spectrum. The default value is an empty string.

Raises:

RangeError –

solution: SymbolicConstant = ABSOLUTE_VALUE[source]#

A SymbolicConstant specifying the solution method for the dynamic equations. Possible values are ABSOLUTE_VALUE and RELATIVE_VALUE. The default value is ABSOLUTE_VALUE.

specificationUnits: SymbolicConstant = ACCELERATION[source]#

A SymbolicConstant specifying the units used for specifying the spectrum. Possible values are DISPLACEMENT, VELOCITY, ACCELERATION, and GRAVITY. The default value is ACCELERATION.

timeIncrement: float = 0[source]#

A Float specifying the implicit time increment used to calculate the spectrum. This argument is required when the method = CALCULATE. The default value is 0.0.

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

TabularAmplitude#

class TabularAmplitude(name, data, smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]#

The TabularAmplitude object defines an amplitude curve as a table of values at convenient points on the time scale. The TabularAmplitude object is derived from the Amplitude object.

Note

This object can be accessed by:

import amplitude
mdb.models[name].amplitudes[name]
import odbAmplitude
session.odbs[name].amplitudes[name]

The corresponding analysis keywords are:

  • AMPLITUDE

Note

Check TabularAmplitude on help.3ds.com/0.1..

Public Data Attributes:

baselineCorrection

A BaselineCorrection object.

smooth

The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.
Inherited from Amplitude

name

A String specifying the repository key.

timeSpan

A SymbolicConstant specifying the time span of the amplitude.

Public Methods:

__init__(name, data[, smooth, timeSpan])

This method creates a TabularAmplitude object.

setValues([smooth, timeSpan])

This method modifies the TabularAmplitude object.
baselineCorrection: BaselineCorrection = <abaqus.Amplitude.BaselineCorrection.BaselineCorrection object>[source]#

A BaselineCorrection object.

data: tuple[source]#

A sequence of pairs of Floats specifying time/frequency and amplitude pairs. Possible values for time/frequency are positive numbers.

setValues(smooth=abaqusConstants.SOLVER_DEFAULT, timeSpan=abaqusConstants.STEP)[source]#

This method modifies the TabularAmplitude object.

Note

Check TabularAmplitude.setValues on help.3ds.com/0.1..

Parameters:

  • smooth (Union[SymbolicConstant, float], default: SOLVER_DEFAULT) – The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are between 0 and 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

  • timeSpan (SymbolicConstant, default: STEP) – A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.

Raises:

RangeError –

smooth: Union[SymbolicConstant, float] = SOLVER_DEFAULT[source]#

The SymbolicConstant SOLVER_DEFAULT or a Float specifying the degree of smoothing. Possible float values are between 0 and 0.5. If smooth = SOLVER_DEFAULT, the default degree of smoothing will be determined by the solver. The default value is SOLVER_DEFAULT.

timeSpan: SymbolicConstant = STEP[source]#

A SymbolicConstant specifying the time span of the amplitude. Possible values are STEP and TOTAL. The default value is STEP.