7.2 CellArray object

The CellArray is a sequence of Cell objects.

Access
import part
mdb.models[name].parts[name].allInternalSets[name].cells
mdb.models[name].parts[name].allSets[name].cells
mdb.models[name].parts[name].cells
mdb.models[name].parts[name].sets[name].cells
import assembly
mdb.models[name].rootAssembly.allinstances.cells
mdb.models[name].rootAssembly.allinstances.sets[name].cells
mdb.models[name].rootAssembly.allInternalSets[name].cells
mdb.models[name].rootAssembly.allSets[name].cells
mdb.models[name].rootAssembly.instances[name].cells
mdb.models[name].rootAssembly.instances[name].sets[name].cells
mdb.models[name].rootAssembly.modelInstances[i].sets[name].cells
mdb.models[name].rootAssembly.sets[name].cells


7.2.1 CellArray(...)

This method creates a CellArray object.

Path
part.CellArray

Required argument

cells

A list of Cell objects.

Optional arguments

None.

Return value

A CellArray object.

Exceptions

None.


7.2.2 findAt(...)

This method returns the object or objects in the CellArray located at the given coordinates. findAt initially uses the ACIS tolerance of 1E-6. As a result, findAt returns any entity that is at the arbitrary point specified or at a distance of less than 1E-6 from the arbitrary point. If nothing is found, findAt uses the tolerance for imprecise geometry (applicable only for imprecise geometric entities). The arbitrary point must not be shared by a second cell. If two cells intersect or coincide at the arbitrary point, findAt chooses the first cell that it encounters, and you should not rely on the return value being consistent.

findAt will always try to find objects among all the cells in the part or assembly instance and will not restrict itself to a subset even if the CellArray represents such subset.

Required argument

coordinates

A sequence of Floats specifying the X-, Y-, and Z-coordinates of the object to find.

findAt returns either a Cell object or a sequence of Cell objects based on the type of input. If coordinates is a sequence of Floats, findAt returns the Cell object at that point. If coordinates is a sequence of sequence of Floats, findAt returns a sequence of Cell objects at the given locations. The sequence of sequence of Floats must be a sequence of sequence of point and normal data, not a sequence of point data. For example,

cells1 = myCrackedBlockInstance.cells.findAt(
                            ((5.5, -8.3, 294.2),),
                            ((12.1, -8.3, 287.8),),
                            ((14.4, -10.4, 285.5),),)

Optional argument

printWarning

A Boolean specifying whether a message is to be printed to the CLI if no entity is found at the specified location. The default value is True.

Return value

A Cell object.

Exceptions

None.


7.2.3 getSequenceFromMask(...)

This method returns the object or objects in the CellArray identified using the specified mask. This command is generated when the JournalOptions are set to COMPRESSEDINDEX. When large number of objects are involved, this method is highly efficient.

Required argument

mask

A String specifying the object or objects.

Optional arguments

None.

Return value

A Cell object or a sequence of Cell objects.

Exceptions

An exception occurs if the resulting sequence is empty.

Error: The mask results in an empty sequence


7.2.4 getMask()

This method returns a string specifying the object or objects.

Arguments

None.

Return value

A String specifying the object or objects.

Exceptions

None.


7.2.5 getByBoundingBox(...)

This method returns an array of cell objects that lie within the specified bounding box.

Required arguments

None.

Optional arguments

xMin

A float specifying the minimum X-boundary of the bounding box.

yMin

A float specifying the minimum Y-boundary of the bounding box.

zMin

A float specifying the minimum Z-boundary of the bounding box.

xMax

A float specifying the maximum X-boundary of the bounding box.

yMax

A float specifying the maximum Y-boundary of the bounding box.

zMax

A float specifying the maximum Z-boundary of the bounding box.

Return value

A CellArray object, which is a sequence of Cell objects.

Exceptions

None.


7.2.6 getByBoundingCylinder(...)

This method returns an array of cell objects that lie within the specified bounding cylinder.

Required arguments

center1

A tuple of the X-, Y-, and Z-coordinates of the center of the first end of the cylinder.

center2

A tuple of the X-, Y-, and Z-coordinates of the center of the second end of the cylinder.

radius

A float specifying the radius of the cylinder.

Optional arguments

None.

Return value

A CellArray object, which is a sequence of Cell objects.

Exceptions

None.


7.2.7 getByBoundingSphere(...)

This method returns an array of cell objects that lie within the specified bounding sphere.

Required arguments

center

A tuple of the X-, Y-, and Z-coordinates of the center of the sphere.

radius

A float specifying the radius of the sphere.

Optional arguments

None.

Return value

A CellArray object, which is a sequence of Cell objects.

Exceptions

None.


7.2.8 getBoundingBox()

This method returns a dictionary of two tuples representing minimum and maximum boundary values of the bounding box of the minimum size containing the cell sequence.

Arguments

None.

Return value

A Dictionary object with the following items:

low: a tuple of three floats representing the minimum X-, Y-, and Z-boundary values of the bounding box.

high: a tuple of three floats representing the maximum X-, Y-, and Z-boundary values of the bounding box.

Exceptions

None.


7.2.9  Members

The CellArray object has no members.