ModelInstance object

A ModelInstance object is an instance of a Model.

This page discusses:

Access

import assembly
mdb.models[name].rootAssembly.modelInstances[i]

Instance(...)

This method creates a ModelInstance object and puts it into the instances repository.

Path

mdb.models[name].rootAssembly.Instance

Required arguments

name

The repository key. The name must be a valid Abaqus object name.

model

A Model object to be instanced. If the model does not exist, no ModelInstance object is created.

Optional arguments

autoOffset

A Boolean specifying whether to apply an auto offset to the new instance that will offset it from existing instances. The default value is OFF.

Return value

A ModelInstance object.

Exceptions

None.

ConvertConstraints()

This method converts the position constraints of an instance to absolute positions. The method deletes the constraint features on the instance but preserves the position in space.

Arguments

None.

Return value

None.

Exceptions

None.

getPosition()

This method prints the sum of the translations and rotations applied to the ModelInstance object.

Arguments

None.

Return value

None.

Exceptions

None.

replace(...)

This method replaces one instance with an instance of another model.

Required arguments

instanceOf

A Model object to be instanced. If the model does not exist, no ModelInstance object is created.

Optional arguments

applyConstraints

A Boolean specifying whether to apply existing constraints on the new instance or to position the new instance in the same place as the original instance. The default value is True. A value of False indicates that constraints applies to the instance are deleted will be deleted from the feature list.

Return value

None.

Exceptions

None.

translate(...)

This method translates an instance by the specified amount.

Required arguments

vector

A sequence of three Floats specifying a translation vector.

Optional arguments

None.

Return value

None.

Exceptions

None.

Members

The ModelInstance object can have the following members:

sets

A repository of Set objects specifying the sets created on the assembly. For more information, see Region commands.

surfaces

A repository of Surface objects specifying the surfaces created on the assembly. For more information, see Region commands.

vertices

A VertexArray object.

edges

An EdgeArray object.

elements

A MeshElementArray object.

nodes

A MeshNodeArray object.

datums

A repository of Datum objects.

referencePoints

A repository of ReferencePoint objects.