result:split on facet indices

Version: 0.0.0

Description

Splits each Field in a FieldsContainer defined on the skin elements of a mesh according to the local facets indices of its corresponding solid element. The output FieldsContainer retains the original labels and adds a 'facet' label, which indicates at which facet of the solid mesh was the original skin element located. The facet ids are according to MAPDL convention. The scoping of the output Fields reflects the element indices in the solid mesh.

Inputs

This table lists the input pins for this operator. Input pins define the data that the operator requires to perform its operation. Some inputs are required, while others are optional and provide additional configuration. Each parameter is detailed in the sections that follow the table.

fields_container (Pin 0)

• Required: Yes
• Expected type(s): fields_container

Fields container to split, with generic number of labels (e.g. time, zone, complex...), and the Fields of the FieldsContainer will have location Elemental and the Scoping Ids will be the Element Ids on the skin mesh.

property_field_new_elements_to_old (Pin 1)

• Required: Yes
• Expected type(s): property_field

This property field provides, for each new face element ID (in the scoping), the corresponding 3D volume element index (in the data) it has been extracted from. The 3D volume element ID can be found with the element scoping of the input mesh.

facet_indices (Pin 2)

• Required: Yes
• Expected type(s): property_field

This property field gives, for each new face element ID (in the scoping), the corresponding face index on the source 3D volume element. The 3D volume element can be extracted from the previous output.

volume_mesh (Pin 3)

• Required: Yes
• Expected type(s): abstract_meshed_region

The solid support.

degenerated_tets (Pin 185)

• Required: No
• Expected type(s): scoping

Elemental scoping of tet elements. If connected, the tets in the scoping are treated as degenerated tets (SOLID185), and the rest as non-degenerated tets (SOLID285). Pins 185 and 285 are mutually exclusionary (they cannot be connected at the same time), and if none of them is connected, all tets are treated as non-degenerated (SOLID285).

non_degenerated_tets (Pin 285)

• Required: No
• Expected type(s): scoping

Elemental scoping of tet elements. If connected, the tets in the scoping are treated as non-degenerated tets (SOLID285), and the rest as degenerated tets (SOLID185). Pins 185 and 285 are mutually exclusionary (they cannot be connected at the same time), and if none of them is connected, all tets are treated as non-degenerated (SOLID285).

Outputs

This table lists the output pins for this operator. Output pins provide the results of the operator's computation and can be connected to inputs of other operators or retrieved for further processing. Each output is detailed in the sections that follow the table.

fields_container (Pin 0)

• Expected type(s): fields_container

Output splitted fields containter

Configurations

This operator supports configuration options that modify its behavior.

mutex

• Expected type(s): bool
• Default value: false

If this option is set to true, the shared memory is prevented from being simultaneously accessed by multiple threads.

Scripting

This operator can be accessed through scripting interfaces using these identifiers.

Category: result

Plugin: mapdl

Scripting name: mapdl_split_on_facet_indices

Full name: result.mapdl_split_on_facet_indices

Internal name: mapdl::split_on_facet_indices

License: None

Examples

These examples demonstrate how to use this operator in different programming environments. Each example shows how to instantiate the operator, connect the required inputs, and retrieve the output.

#include "dpf_api.h"

ansys::dpf::Operator op("mapdl::split_on_facet_indices"); // operator instantiation
op.connect(0, my_fields_container);
op.connect(1, my_property_field_new_elements_to_old);
op.connect(2, my_facet_indices);
op.connect(3, my_volume_mesh);
op.connect(185, my_degenerated_tets);
op.connect(285, my_non_degenerated_tets);
ansys::dpf::FieldsContainer my_fields_container = op.getOutput<ansys::dpf::FieldsContainer>(0);

import ansys.dpf.core as dpf

op = dpf.operators.result.mapdl_split_on_facet_indices() # operator instantiation
op.inputs.fields_container.connect(my_fields_container)
op.inputs.property_field_new_elements_to_old.connect(my_property_field_new_elements_to_old)
op.inputs.facet_indices.connect(my_facet_indices)
op.inputs.volume_mesh.connect(my_volume_mesh)
op.inputs.degenerated_tets.connect(my_degenerated_tets)
op.inputs.non_degenerated_tets.connect(my_non_degenerated_tets)
my_fields_container = op.outputs.fields_container()

import mech_dpf
import Ans.DataProcessing as dpf

op = dpf.operators.result.mapdl_split_on_facet_indices() # operator instantiation
op.inputs.fields_container.Connect(my_fields_container)
op.inputs.property_field_new_elements_to_old.Connect(my_property_field_new_elements_to_old)
op.inputs.facet_indices.Connect(my_facet_indices)
op.inputs.volume_mesh.Connect(my_volume_mesh)
op.inputs.degenerated_tets.Connect(my_degenerated_tets)
op.inputs.non_degenerated_tets.Connect(my_non_degenerated_tets)
my_fields_container = op.outputs.fields_container.GetData()

Changelog

• Version 0.0.0: Initial release.