Model.EntityPreviewEmpty#

Model.EntityPreviewEmpty(output_collection)#

Searches the entities specified and stores any empty entities in the output collection.

The following elements can be used:

  • Component

Empty when it does not contain any elements, lines, points, surfaces, or attributes.

  • Plot

Empty when there are no curves are in the plot.

  • Outputblock

Empty when it does not contain any entities.

  • Loadstep

Empty when it does not contain any entities.

  • Group

Empty when both the main and secondary sections are empty.

If the main section does not exist for this interface type, then the main section is empty. If the main section does exist and it is set to components, elements, or sets, a check is done to see if it points to any entities. If it does not point to any entities, the main section is empty. Also, if the main section points to any other type (such as box or all), it is assumed that the main is not empty.

The same check is done for the secondary section.

  • LoadCol

Empty when it does not contain any loads.

  • BeamSectCol

Empty when it does not contain any beamsects.

  • SystemCol

Empty when it does not contain any systems.

  • VectorCol

Empty when it does not contain any vectors.

  • Set

Empty when it does not contain any entities.

Parameters:

output_collection (Collection) – The collection containing the entities to check.

Example#

Store all empty components in the collection#
import hm
import hm.entities as ent

model = hm.Model()

comps  = hm.Collection(model, ent.Component)

model.EntityPreviewEmpty(output_collection=comps)