ConnectorDamping object

The ConnectorDamping object defines damping behavior for one or more components of a connector's relative motion.

The ConnectorDamping object is derived from the ConnectorBehaviorOption object.

This page discusses:

Access

import section
mdb.models[name].sections[name].behaviorOptions[i]
import odbSection
session.odbs[name].sections[name].behaviorOptions[i]

ConnectorDamping(...)

This method creates a connector damping behavior option for a ConnectorSection object.

Path

          import connectorBehavior
          connectorBehavior.ConnectorDamping
          import odbConnectorBehavior
          odbConnectorBehavior.ConnectorDamping

Required arguments

None.

Optional arguments

type

A SymbolicConstant specifying if the damping type is viscous or structural. Possible values are VISCOUS and STRUCTURAL. The default value is VISCOUS.

behavior

A SymbolicConstant specifying if the damping behavior is linear or nonlinear. If type=VISCOUS, possible values are LINEAR and NONLINEAR. If type=STRUCTURAL, the possible value is LINEAR.

coupling

A SymbolicConstant specifying whether the damping behavior is coupled between the connector's components of relative motion. If behavior=LINEAR, possible values are UNCOUPLED and COUPLED. If behavior=NONLINEAR, possible values are UNCOUPLED, COUPLED_POSITION, and COUPLED_MOTION. Possible values are UNCOUPLED, COUPLED, COUPLED_POSITION, and COUPLED_MOTION. The default value is UNCOUPLED.

dependencies

An Int specifying the number of field variable dependencies. The default value is 0. This argument is applicable only if type=VISCOUS.

temperatureDependency

A Boolean specifying whether the behavior data depend on temperature. The default value is OFF. This argument is applicable only if type=VISCOUS.

frequencyDependency

A Boolean specifying whether the behavior data depend on frequency. This value is applicable only if behavior= LINEAR and coupling=UNCOUPLED. The default value is OFF.

table

A sequence of sequences of Floats specifying damping properties. Items in the table data are described below. The default value is an empty sequence.

independentComponents

A sequence of Ints specifying the list of independent components that are included in the definition of the connector damping data. This argument is applicable only if behavior=NONLINEAR and coupling=COUPLED_POSITION or COUPLED_MOTION. When this argument is applicable, at least one value must be specified. Only available components can be specified. The default value is an empty sequence.

components

A sequence of Ints specifying the components of relative motion for which the behavior is defined. Possible values are 1 ≤ components ≤ 6. Only available components can be specified. The default value is an empty sequence.

Table data

If type=VISCOUS, behavior=LINEAR, and coupling=UNCOUPLED, each sequence of the table data specifies the following:

  • Damping coefficient (force or moment per relative velocity).

  • Frequency (cycles/time), if the data depend on frequency.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

If type=VISCOUS, behavior=NONLINEAR, and coupling=UNCOUPLED, each sequence of the table data specifies the following:

  • Force or moment.

  • Relative displacement or rotation.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

If type=VISCOUS, behavior=LINEAR, and coupling=COUPLED, the table data specify the symmetric portion of the damping matrix for the specified components followed by any temperature data and then any field data. For example, if components 2, 3, and 5 are specified, the table portion of the command is as follows: 

table=( (C22, C23, C25, C33, C35, C55,), )

The following items should be specified as comma-separated data:

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

If type=VISCOUS, behavior=NONLINEAR, and coupling=COUPLED_POSITION or COUPLED_MOTION, each sequence of the table data specifies the following:

  • Force or moment for the directions in the components list.

  • Relative velocity for the directions in the components list.

  • Relative position or angle for the first independentComponents direction if coupling=COUPLED_POSITION. Relative displacement or rotation for the first independentComponents direction if coupling=COUPLED_MOTION.

  • Relative position or angle for the second independentComponents direction if coupling=COUPLED_POSITION. Relative displacement or rotation for the second independentComponents direction if coupling=COUPLED_MOTION.

  • Etc. up to the Nth independentComponents direction.

  • Temperature, if the data depend on temperature.

  • Value of the first field variable, if the data depend on field variables.

  • Value of the second field variable.

  • Etc.

If type=STRUCTURAL, behavior=LINEAR, and coupling=UNCOUPLED, each sequence of the table data specifies the following:

  • Damping coefficient (force or moment per relative velocity).

  • Frequency (cycles/time), if the data depend on frequency.

  • Etc.

If type=STRUCTURAL, behavior=LINEAR, and coupling=COUPLED, the table data specify the symmetric portion of the damping matrix for the specified components. For example, if components 2, 3, and 5 are specified, the table portion of the command is as follows:

table=( (
                     
                        
                           
                              S
                           
                           
                              22
                           
                        
                     
                  , 
                     
                        
                           
                              S
                           
                           
                              23
                           
                        
                     
                  , 
                     
                        
                           
                              S
                           
                           
                              25
                           
                        
                     
                  , 
                     
                        
                           
                              S
                           
                           
                              33
                           
                        
                     
                  , 
                     
                        
                           
                              S
                           
                           
                              35
                           
                        
                     
                  , 
                     
                        
                           
                              S
                           
                           
                              55
                           
                        
                     
                  ,), )

Return value

A ConnectorDamping object.

Exceptions

ValueError and TextError.

setValues(...)

This method modifies the ConnectorDamping object.

Required arguments

None.

Optional arguments

The optional arguments to setValues are the same as the arguments to the ConnectorDamping method.

Return value

None.

Exceptions

ValueError.