ConcentratedMass (hwx.inspire.core)¶

ConcentratedMass creates a mass only object either on a part or at a point in space.

Concentrated Masses are useful when you need to account for the mass of a part but you do not want the complexity of the geometry to slow down the run. An example would be when running an optimization using frequency constraints or when analyzing for normal modes. When gravity is applied during optimization or analysis, the mass will impart a load on the structure.

Attributes¶

active: Bool

associatedFeatures: Attribute

autoCalcMotionContactResolution: Bool

autoCalculateCG: Bool

autoCalculateMass: Bool

autoCalculateMeshSize: Bool

autoCalculateMoment: Bool

autoCalculateThickness: Bool

cg: Location

color: Color

connectionRadius: Double

designSpace: Bool

detectCollisions: Bool

flexible: Bool

ground: Bool

ignoreFlexibility: Bool

ip: Inertia

mass: Double

material: Attribute

maxFreq: Double

maxMeshSize: Double

maxThickness: Double

minGap: Double

minMeshSize: Double

minThickness: Double

modeType: Enum

modifiable: Bool

morphable: Bool

motionContactResolution: Enum

movable: Bool

name: Attribute

numModes: Int

orderType: Enum

position: Attribute

rigidGroup: Attribute

sheetThickness: Double

strainCalculation: Bool

stressCalculation: Bool

transparency: Double

visible: Bool

volume: Double

Public Methods¶

classmethod getClass (cls, className)

addAssociatedFeatures (self, features)

destroy (self)

findMinimumSeparation (self, other)

getAllChildren (self, type=None, **kwds)

getChild (self, name=None, recursive=False, **kwds)

getChildren (self, type=None, recursive=False, sorted=False, **kwds)

getDependents (self, recursive=False, **kwds)

getFeature (self, name=None)

getFeatures (self, type=None, rep=’BestRep’, **kwds)

getReferences (self, recursive=False, **kwds)

identifyShape (self)

intersects (self, other)

isa (self, type=None, filter=None, name=None, wildcard=None, **kwds)

modelPositions (self)

removeAssociatedFeatures (self, features)

save (self, file)

Attribute Details¶

active : Bool¶

Returns or sets the object activeness.

Setting this on or off sets all children. Setting to True sets all the parents active too.

associatedFeatures : Attribute¶

autoCalcMotionContactResolution : Bool¶

Returns or sets the motion contact fidelity properties from the part.

autoCalculateCG : Bool¶

Determines whether the center of gravity is auto calculated.

autoCalculateMass : Bool¶

Determines whether the mass value is automatically calculated based upon volume and material density.

autoCalculateMeshSize : Bool¶

Indicates whether the minimum and average element sizes used for the solution are automatically calculated.

Set to False to enter these values manually.

Decreasing the minimum element size will increase the detail of your results in areas that use a number of small elements. The average element size controls the overall detail of your results.

autoCalculateMoment : Bool¶

Determines whether the mass moment of inertia is automatically calculated.

autoCalculateThickness : Bool¶

Determines whether the minimum and maximum thickness values are automatically calculated.

All parts are taken into account during the calculation.

cg : Location (units=”length”)¶

Returns the object’s global center of gravity as a point.

color : Color¶

Determines the color assigned to the object when it is displayed in the modeling window.

The default color for parts is gray, but a different color can be assigned.

connectionRadius : Double (units=”length”)¶

The search radius for the Concentrated Mass.

designSpace : Bool¶

Determines whether the part is a design space.

A part must be designated as a design space if we intend to optimize it.

detectCollisions : Bool¶

Determines whether to detect collision.

It prevents parts in the model from overlapping and has been enabled by default.

flexible : Bool¶

Makes the part flexible, if set to True.

ground : Bool¶

Returns or sets the object to be ground or immovable.

ignoreFlexibility : Bool¶

Allows the part to ignore flexibility.

ip : Inertia (units=”massMI”)¶

Specifies the inertial properties of this object.

Resistance to change in motion (ixx, iyy, izz, ixy, izy, ixz).

mass : Double (units=”m”)¶

The mass of the object.

material : Attribute¶

The material of the object.

Every part in the model has a material assigned to it. The default material is steel, but a different material can be assigned.

maxFreq : Double (units=”frequency”)¶

Upper bound frequency for the eigenvalue analysis of the flexible part.

maxMeshSize : Double (units=”length”)¶

Returns or sets the maximum mesh size of the part.

maxThickness : Double (units=”length”)¶

The maximum thickness value.

minGap : Double (units=”length”)¶

minMeshSize : Double (units=”length”)¶

Returns or sets the minimum mesh size of the part.

minThickness : Double (units=”length”)¶

The minimum thickness value.

modeType : Enum¶

How normal modes are defined.

modifiable : Bool¶

Determines whether the selected object can be edited.

morphable : Bool¶

Determines whether the selected object shape can be changed.

motionContactResolution : Enum (verylow, low, medium, high, veryhigh)¶

The resolution of the motion contact. It can be:

“verylow”
“low”
“medium”
“high”
“veryhigh”

movable : Bool¶

Determines whether the selected object can be translated in the modeling window or has been locked in place.

name : Attribute¶

Returns or sets the name of the object.

It can be any text string, including spaces, although it’s best to avoid using the following characters: ” ‘ * ? and $.

While these characters are allowed, they could create difficulties when you export the model to other applications.

numModes : Int¶

Specifies the number of modes of the part.

orderType : Enum¶

Order of elements for flexbody mesh.

position : Attribute¶

Specifies the global transform as a Matrix44.

rigidGroup : Attribute¶

The rigid group this object belongs to.

sheetThickness : Double (units=”length”)¶

Thickness of the 2D part used in volume calculation.

strainCalculation : Bool¶

Determines whether to calculate the strain or not.

stressCalculation : Bool¶

Determines whether to calculate stress or not.

transparency : Double¶

Specifies the transparency of the object.

Allows you to change the transparency, according to a percentage. By default, objects are 0% transparent(opaque).

visible : Bool¶

Determines whether the object is visible in the graphics window.

Setting this on or off sets all children. Setting to True sets all the parents visible too.

volume : Double (units=”volume”)¶

The volume of the object in the assembly.

Method Details¶

classmethod getClass(cls, className)¶

Returns the class of the object.

It can be simple or qualified (with namespace). If the name is simple, we prepend the cls.namespace.

param className: The class name.
type className: Union[Part, Occurrence, Named..]
returns: The class for the specified className.
rtype: Union[Part, Occurrence, Named..]

addAssociatedFeatures(self, features)¶

Add the association with provided features.

param features: Part features to associate with concentrated mass.
type features: list[Feature]

destroy(self)¶

Destroys occurrences from the model.

findMinimumSeparation(self, other)¶

Find closest points between two parts

param other: The 2nd part.
type other: Part
returns: namedtuple(“ClosestPoints”, “point1 point2 distance feature1 feature2”)

getAllChildren(self, type=None, **kwds)¶

Returns a list of all children that matches the specified type.

param type: Filter to use to get the children based on object type.
type type: list[Named]
param **kwds: Additional keyword arguments to match other attributes of the object.
returns: The list of children that satisfy the supplied filters.
rtype: list[Union[Part, Motor, BoundaryCondition, …]]

getChild(self, name=None, recursive=False, **kwds)¶

Returns the child of the object which matches the specified unique name.

param name: The name of the child object.
type name: str
param recursive: Search all descendents.
type recursive: bool
param **kwds: Additional keyword arguments to match attributes of the object.
returns: The child object which satisfies the specified filters.
rtype: Named

getChildren(self, type=None, recursive=False, sorted=False, **kwds)¶

Returns a list of children that is of the specified type.

param type: Filter objects by class.
type type: Type[Named]
param recursive: True to get all descendent Parts and Assemblies.
type recursive: bool
param sorted: Sort the children base on id.
type sorted: bool
returns: list[Named]

getDependents(self, recursive=False, **kwds)¶

Get objects that reference this object through a Reference attribute.

param recursive
type recursive: bool
param **kwds: Filter objects using isa.
returns: set[Named]

getFeature(self, name=None)¶

Returns the feature based on its name.

getFeatures(self, type=None, rep='BestRep', **kwds)¶

“Returns a list of features based on specified filters.

param type

Filters the features based on type.

type type

FeaturePoint, FeatureArea, FeatureCylindrical..etc)

param rep

Feature representation. See part.representations for options

type rep

str

param **kwds

Additional attributes to consider while filtering.

returns

List of: features that satisfies all the filter criteria.

rtype

list [FeaturePoint, FeatureArea, FeatureCylindrical..etc)]

getReferences(self, recursive=False, **kwds)¶

Get objects this object references through a Reference attribute.

param recursive
type recursive: bool
param **kwds: Filter objects using isa.
returns: set[Named]

identifyShape(self)¶

Attempts to identify the part geometry as a known shape.

The shapes can be:

Box

Ellipsoid

Sphere

Cylinder

frustum

axi-symmetric gear

rack

returns: The identified shape.
rtype: Box,Ellipsoid,Sphere..

intersects(self, other)¶

Finds whether the two parts intersect.

param other: The 2nd part.
type other: Part
returns: True if they intersect, False otherwise.
rtype: bool

isa(self, type=None, filter=None, name=None, wildcard=None, **kwds)¶

Determines if the object matches the specified settings or not.

param type: The type of the object.
type type: Union[Part, Assembly, Contact..]
param filter: Return value of specified callback method.
type filter: method
param name: Name that matches exactly with object name.
type name: str
param wildcard: A pattern to match exactly with the object name.
type wildcard: str
param **kwds: Additional keyword arguments to match other attributes.
returns: True, if a match is found, otherwise False.
rtype: bool

modelPositions(self)¶

Forces all objects to return the original model positions instead of the current analysis positions.

Useful when defining draw methods on GeneralObjects where behaviour is different while animating.

removeAssociatedFeatures(self, features)¶

Remove the association with provided features.

param features: Associated features with concentrated mass.
type features: list[Feature]

save(self, file)¶

Save the Part in the specified file.

param file: File name and path, where the file needs to be saved. Valid file extensions are:

‘.x_b’, ‘.x_t’, ‘.xmt_bin’, ‘.xmt_txt’, ‘.sat’, ‘.sab’, ‘.iges’, ‘.igs’, ‘.stl’, ‘.step’, ‘.stp’, ‘.obj’, ‘.vrml’, ‘.vrl’.
type file: str