Model.acousticmeshinterface_2#

Model.acousticmeshinterface_2(collection_cavity, collection_structural, wetted_node_output_collection, interface_node_output_collection, wetted_element_output_collection, interface_element_output_collection, wetted_component_output_collection, acmodl_normal, acmodl_intol, acmodl_dskneps, reserved1, reserved2)#

Used to query the results of an acoustic cavity mesh operation. This function must be run after Model.acousticmeshcreate(). It specifically utilizes a bounding box defined by the acmodl_normal, acmodl_intol, and acmodl_dskneps input parameters to identify:

  • The wetted nodes on the body - nodes on elements on the interface with the fluid that satisfy the bounding box criteria.

  • The interface nodes of the fluid - the nodes on the fluid faces that are on faces that have at least one body node within their bounding box.

  • The wetted element faces of the body - the elements on the body that contain at least one node within a bounding box.

  • The interface faces of the fluid - the fluid faces that have at least one body node within their bounding box.

  • The wetted body components - the components that contain at least one element on the body that has a node on the wetted interface.

It should be noted that the body is composed of the structural and the seat components.

Parameters:

  • collection_cavity (Collection) – The collection containing the 3D cavity component entities.

  • collection_structural (Collection) – The collection containing the entities.

  • wetted_node_output_collection (Collection) – The collection containing the found wetted node entities. If an empty collection is provided, the values are not returned.

  • interface_node_output_collection (Collection) – The collection containing the found fluid interface node entities. If an empty collection is provided, the values are not returned.

  • wetted_element_output_collection (Collection) – The collection containing the found element entities with wetted body faces. Only valid when createcavityfaces option is enabled for Model.acousticmeshcreate(). If an empty collection is provided then, the values are not returned.

  • interface_element_output_collection (Collection) – The collection containing the found element entities with fluid interface faces. Only valid when createcavityfaces option is enabled for Model.acousticmeshcreate(). If an empty collection is provided, the values are not returned.

  • wetted_component_output_collection (Collection) – The collection containing the found wetted body component entities. If an empty collection is provided, the values are not returned.

  • acmodl_normal (double) – Used to define the (positive) height of bounding box for particular fluid faces. This height is equal to the largest side of the face multiplied by this value, and is in the outward direction.

  • acmodl_intol (double) – Used to define the (negative) height of the bounding box for particular fluid faces. This height is equal to the largest side of the face multiplied by this value, and is in the inward direction.

  • acmodl_dskneps (double) – Used to define the in-plane extension of the bounding box for particular fluid faces. This extension is measured relative to the distance from the center of the face to each corner. This value is the ratio by which the face is extended at each corner.

  • reserved1 (int) – Reserved for future use. Must be specified as 0.

  • reserved2 (double) – Reserved for future use. Must be specified as 0.

Example#

Calculate, and then highlight, the wetted nodes, wetted elements and wetted components for two structural and seat cavities#
import hm
import hm.entities as ent

model = hm.Model()

# Collection containing elements of component ID 813
mainElCol = hm.Collection(
    model, ent.Element, hm.Collection(model, ent.Component, [813])
)

# Collection containing elements of component ID 816
secElCol = hm.Collection(
    model, ent.Element, hm.Collection(model, ent.Component, [816])
)

# Collection containing component ID 812
patchElComp = hm.Collection(
    model, ent.Component, [812]
)

model.acm_create_mpc(
    main_collection=mainElCol,
    secondary_collection=secElCol,
    interface_collection=patchElComp,
    tolerance=50.0,
    behavior=2,
)

# Create component cavity and structural collection by name
cavity_col = hm.Collection(
    model,
    ent.Component,
    "Name=AC_Structural.1 OR Name=AC_Seat.1 OR Name=AC_Seat.2 OR Name=AC_Structural.2",
)
struct_col = hm.Collection(model, ent.Component, "Name=input_for_acm")

# Initialize the Output collections for wetted nodes,elements and components found.
wetOutNode_col = hm.Collection(model, ent.Node, populate=False)
wetOutElement_col = hm.Collection(model, ent.Element, populate=False)
wetOutComponent_col = hm.Collection(model, ent.Component, populate=False)

model.acousticmeshinterface_2(
    collection_cavity=cavity_col,
    collection_structural=struct_col
    wetted_node_output_collection=wetOutNode_col,
    interface_node_output_collection=hm.Collection(
        model, ent.Node, populate=False
    ),
    wetted_element_output_collection=wetOutElement_col,
    interface_element_output_collection=hm.Collection(
        model, ent.Element, populate=False
    ),
    wetted_component_output_collection=wetOutComponent_col,
    acmodl_normal=0.2,
    acmodl_intol=0.2,
    acmodl_dskneps=0.2,
    reserved1=0,
    reserved2=0,
)

model.hm_highlightmark(wetOutNode_col, "h")
model.hm_highlightmark(wetOutNode_col, "n")
model.hm_highlightmark(wetOutElement_col, "h")
model.hm_highlightmark(wetOutElement_col, "n")
model.hm_highlightmark(wetOutComponent_col, "h")
model.hm_highlightmark(wetOutComponent_col, "n")