Skip to main content

ACP in-app scripting API 2026 R1

get_element_labels

Last update: 16.07.2026

ScalarFieldData.get_element_labels(visible=None, selected=None)

Get element labels (element numbers as read from / written to mesh files) of plot.

Parameters

  • visible: One or more objects defining visible scope
  • selected: Selected one or more objects for ply-wise evaluations.

Returns

Resulting array with element labels from the intersection of

  • data_scope of plot
  • visible_scope defined by visible
  • selection_scope defined by selected

Labels are returned independent of update status of plot, but only if results for the current plot configuration are available, else an empty array is returned.

Examples

: Get element labels for current plot with visible scope set to element set “All_Elements” and with ply1 and ply2 selected:

>>> eis = my_plot.get_element_labels(visible=db.active_model.element_sets['All_Elements'], selected=[ply1, ply2])

Get element labels for current plot with visible scope equal to all objects visible in current scene:: : ```pycon >>> eis = my_plot.get_element_labels(visible=db.active_model.active_scene.active_set.entities) ```

Connect with Ansys