CubitInterface Namespace Reference

A Software Developer Kit (SDK) is available, at no cost, for any interested user. Simply request the SDK from support and the download package will be placed into the user's account. The SDK includes more functions, including those for exporting meshes and managing materials. Access to the Cube-it application framework is available, enabling users to extend menus, command panels, commands, and so forth. Following is a quick reference for the most commonly used functions. The SDK includes many more functions and more detailed explanations and examples. In addition, the SDK is always current and shows current syntax.

This section of the documentation will be removed in the near future. Please refer to the SDK.

System Control and Data

 

void  set_progress_tool (ProgressTool *progress)
  Register a progress-bar callback handler with Cubit.
void  set_cubit_interrupt (bool interrupt)
  This sets the global flag in Cubit that stops all interruptible processes.
void  set_playback_paused_on_error (bool pause)
  Sets whether or not playback is paused when an error occurs.
bool  is_playback_paused_on_error ()
  Gets whether or not playback is paused when an error occurs.
bool  developer_commands_are_enabled ()
  This checks to see whether developer commands are enabled.
bool  release_interface (CubitBaseInterface *instance)
  Release the interface with the given name.
void  add_filename_to_recent_file_list (str &filename)
str  get_version ()
  Get the Cubit version.
str  get_revision_date ()
  Get the Cubit revision date.
str  get_build_number ()
  Get the Cubit build number.
str  get_acis_version ()
  Get the Acis version number.
int  get_acis_version_as_int ()
  Get the Acis version number as an int.
str  get_exodus_version ()
  Get the Exodus version number.
str  get_meshgems_version ()
  Get the MeshGems version number.
float  get_cubit_digits_setting ()
  Get the Cubit digits setting.
str  get_graphics_version ()
  Get the VTK version number.
void  print_cmd_options ()
  Used to print the command line options.
bool  is_modified ()
  Get the modified status of the model.
void  set_modified ()
  Set the status of the model (is_modified() is now false). If you modify the model after you set this flag, it will register true.
bool  is_undo_save_needed ()
  Get the status of the model relative to undo checkpointing.
void  set_undo_saved ()
  Set the status of the model relative to undo checkpointin.
bool  is_performing_undo ()
  Check if an undo command is currently being performed.
bool  is_command_echoed ()
  Check the echo flag in cubit.
str  get_command_from_history (int command_number)
  Get a specific command from Cubit's command history buffer.
str  get_next_command_from_history ()
  Get 'next' command from history buffer.
str  get_previous_command_from_history ()
  Get 'previous' command from history buffer.
bool  is_volume_meshable (int volume_id)
  Check if volume is meshable with current scheme.
void  journal_commands (bool state)
  Set the journaling flag in cubit.
bool  is_command_journaled ()
  Check the journaling flag in cubit.
void  override_journal_stream (JournalStreamBase *jnl_stream)
  Override the Journal Stream in CUBIT.
str  get_current_journal_file ()
  Gets the current journal file name.
[str] get_cubfile_journal ()
bool  is_working_dir_set ()
  Create BCVizInterface for CompSimUI.
bool  cmd (const char *input_string)
  Pass a command string into Cubit.
bool  silent_cmd (const char *input_string)
  Pass a command string into Cubit and have it executed without being verbose at the command prompt.
bool  was_last_cmd_undoable ()
  Report whether the last executed command was undoable.
[int]  parse_cubit_list (const str &type, str int_list, bool include_sheet_bodies=false)
  Parse a Cubit style entity list into a list of integers.
void  print_raw_help (const char *input_line, int order_dependent, int consecutive_dependent)
  Used to print out help when a ?, & or ! is pressed.
int  get_error_count ()
  Get the number of errors in the current Cubit session.
void  complete_filename (str &line, int &num_chars, bool &found_quote)
  Get the file completion inside a quote based on files in the current directory. This handles completion of directories as well as filtering on specific types (.jou, .g, .sat, etc.).

Graphics Manipulation and Data

 

float  get_view_distance ()
  Get the distance from the camera to the model (from - at).
[float]  get_view_at ()
  Get the camera 'at' point.
[float]  get_view_from ()
  Get the camera 'from' point.
[float]  get_view_up ()
  Get the camera 'up' direction.
void  reset_camera ()
  reset the camera in all open windows this includes resetting the view, closing the histogram and color windows and clearing the scalar bar, highlight, and picked entities.
void  flush_graphics ()
  Flush the graphics.
int  get_rubberband_shape ()
  Get the current rubberband select mode.
bool  is_perspective_on ()
  Get the current perspective mode.
bool  is_occlusion_on ()
  Get the current occlusion mode.
bool  is_scale_visibility_on ()
  Get the current scale visibility setting.
bool  is_mesh_visibility_on ()
  Get the current mesh visibility setting.
bool  is_geometry_visibility_on ()
  Get the current geometry visibility setting.
bool  is_select_partial_on ()
  Get the current select partial setting.
int  get_rendering_mode ()
  Get the current rendering mode.
void  set_rendering_mode (int mode)
  Set the current rendering mode.
void  clear_preview ()
  Clear preview graphics without affecting other display settings.
str get_pick_type ()
  Get the current pick type.
[int]  get_selected_ids ()
  Get a list of the currently selected ids.

Mesh Query Support

 

float  get_mesh_edge_length (int edge_id)
  Get the length of a mesh edge.
float  get_meshed_volume_or_area (str geom_type, [int] entity_ids)
  Get the total volume/area of a entity's mesh.
int  get_mesh_intervals (str geom_type, int entity_id)
  Get the interval count for a specified entity.
float  get_mesh_size (str geom_type, int entity_id)
  Get the mesh size for a specified entity.
float  get_requested_mesh_size (str geom_type, int id)
  Get the requested mesh size for a specified entity. This returns a size that has been set specifically on the entity and not averaged from parents.
int  has_valid_size (str geom_type, int entity_id)
  Get whether an entity has a size. All entities have a size unless the auto sizing is off. If the auto sizing is off, an entity has a size only if it has been set.
bool  auto_size_needs_to_be_calculated ()
  Get whether the auto size needs to be calculated. Calculating the auto size may be expensive on complex models. The auto size may be outdated if the model has changed.
float  get_default_auto_size ()
  Get auto size needs for the current set of geometry.
int  get_requested_mesh_intervals (str geom_type, int entity_id)
  Get the interval count for a specified entity as set specifically on that entity.
float  get_auto_size (str geom_type, [int] entity_id_list, float size)
  Get the auto size for a given set of enitities. Note, this does not actually set the interval size on the volumes. It simply returns the size that would be set if an 'size auto factor n' command were issued.
int  get_element_budget (str element_type, [int] entity_id_list, int auto_factor)
  Get the element budget based on current size settings for a list of volumes.
str  get_exodus_sizing_function_variable_name ()
  Get the exodus sizing function variable name.
str  get_exodus_sizing_function_file_name ()
  Get the exodus sizing function file name.
bool  exodus_sizing_function_file_exists ()
  return whether the exodus sizing funnction file exists
  get the current sphere parameters for a sphere volume
str  get_curve_bias_type (int curve_id)
float  get_curve_bias_geometric_factor (int curve_id)
float  get_curve_bias_geometric_factor2 (int curve_id)
float  get_curve_bias_first_interval_length (int curve_id)
float  get_curve_bias_first_interval_fraction (int curve_id)
float  get_curve_bias_fine_size (int curve_id)
float  get_curve_bias_coarse_size (int curve_id)
float  get_curve_bias_first_last_ratio1 (int curve_id)
float  get_curve_bias_first_last_ratio2 (int curve_id)
float  get_curve_bias_last_first_ratio1 (int curve_id)
float  get_curve_bias_last_first_ratio2 (int curve_id)
bool  get_curve_bias_from_start (int curve_id, bool &value)
bool  get_curve_bias_from_start_set (int curve_id)
int  get_curve_bias_start_vertex_id (int curve_id)
float  get_curve_mesh_scheme_curvature (int curve_id)
  Get the curvature mesh scheme value of a curve.
[float]  get_curve_mesh_scheme_pinpoint_locations (int curve_id)
float  get_quality_value (str mesh_type, int mesh_id, str metric_name)
  Get the metric value for a specified mesh entity.
str  get_mesh_scheme (str geom_type, int entity_id)
  Get the mesh scheme for the specified entity.
str  get_mesh_scheme_firmness (str geom_type, int entity_id)
  Get the mesh scheme firmness for the specified entity.
str  get_mesh_interval_firmness (str geom_type, int entity_id)
  Get the mesh interval firmness for the specified entity. This may include influence from connected mesh intervals on connected geometry.
str  get_requested_mesh_interval_firmness (str&geom_type, int entity_id)
  Get the mesh interval firmness for the specified entity as set specifically on the entity.
str  get_mesh_size_type (str geom_type, int entity_id)
  Get the mesh size setting type for the specified entity. This may include influence from attached geometry.
str  get_requested_mesh_size_type (str geom_type, int entity_id)
  Get the mesh size setting type for the specified entity as set specifically on the entity.
bool  get_tetmesh_proximity_flag (int volume_id)
  Get the proximity flag for tet meshing.
int  get_tetmesh_proximity_layers (int volume_id)
  Get the number of proximity layers for tet meshing. This is the number of layers between close surfaces.
float  get_mesh_geometry_approximation_angle (str geom_type, int entity_id)
  Get the geometry approximation angle set for tri/tet meshing.
float  get_trimesh_surface_gradation ()
  Get the global surface mesh gradation set for meshing with MeshGems.
float  get_trimesh_volume_gradation ()
  Get the global volume mesh gradation set for meshing with MeshGems.
float  get_tetmesh_growth_factor (int volume_id)
  Get the tetmesh growth factor.
bool  is_meshed (str geom_type, int entity_id)
  Determines whether a specified entity is meshed.
bool  is_merged (str geom_type, int entity_id)
  Determines whether a specified entity is merged.
str  get_smooth_scheme (str geom_type, int entity_id)
  Get the smooth scheme for a specified entity.
int  get_hex_count ()
  Get the count of hexes in the model.
int  get_pyramid_count ()
  Get the count of pyramids in the model.
int  get_tet_count ()
  Get the count of tets in the model.
int  get_quad_count ()
  Get the count of quads in the model.
int  get_tri_count ()
  Get the count of tris in the model.
int  get_edge_count ()
  Get the count of edges in the model.
int  get_sphere_count ()
  Get the count of sphere elements in the model.
int  get_node_count ()
  Get the count of nodes in the model.
int  get_element_count ()
  Get the count of elements in the model.
int  get_volume_element_count (int volume_id)
  Get the count of elements in a volume.
int  get_surface_element_count (int surface_id)
  Get the count of elements in a surface.
bool  volume_contains_tets (int volume_id)
  Determine whether a volume contains tets.
[int]  get_hex_sheet (int node_id_1, int node_id_2)
  Get the list of hex elements forming a hex sheet through the given two node ids. The nodes must be adjacent in the connectivity of the hex i.e. they form an edge of the hex.
str  get_default_element_type ()
  Get the current default setting for the element type that will be used when meshing.

Geometry Query Support

 

bool  is_visible (str geom_type, int entity_id)
  Query visibility for a specific entity.
bool  is_virtual (str geom_type, int entity_id)
  Query virtualality for a specific entity.
bool  contains_virtual (str geom_type, int entity_id)
  Query virtualality of an entity's children.
[int]  get_source_surfaces (int volume_id)
  Get a list of a volume's sweep source surfaces.
[int]  get_target_surfaces (int volume_id)
  Get a list of a volume's sweep target surfaces.
int  get_common_curve_id (int surface_1_id, int surface_2_id)
  Given 2 surfaces, get the common curve id.
int  get_common_vertex_id (int curve_1_id, int curve_2_id)
  Given 2 curves, get the common vertex id.
str  get_merge_setting (str geom_type, int entity_id)
  Get the merge setting for a specified entity.
str  get_curve_type (int curve_id)
  Get the curve type for a specified curve.
str  get_surface_type (int surface_id)
  Get the surface type for a specified surface.
[float]  get_surface_normal (int surface_id)
  Get the surface normal for a specified surface.
[float]  get_surface_centroid (int surface_id)
  Get the surface centroid for a specified surface.
str  get_surface_sense (int surface_id)
  Get the surface sense for a specified surface.
[str] get_entity_modeler_engine (str geom_type, int entity_id)
  Get the modeler engine type for a specified entity.
str  get_default_geometry_engine ()
  Get the name of the default modeler engine.
[float]  get_bounding_box (str geom_type, int entity_id)
  Get the bounding box for a specified entity.
[float]  get_total_bounding_box (str geom_type, [int] entity_list)
  Get the bounding box for a list of entities.
[float]  get_tight_bounding_box (str&geom_type, [int] entity_list)
  Get the tight bounding box for a list of entities.
float  get_total_volume ([int] volume_list)
  Get the total volume for a list of volume ids.
str  get_entity_name (str entity_type, int entity_id)
  Get the name of a specified entity.
bool  set_entity_name (str entity_type, int entity_id, str new_name)
  Set the name of a specified entity.
int  get_entity_color_index (str entity_type, int entity_id)
  Get the color of a specified entity.
bool  is_multi_volume (int body_id)
  Query whether a specified body is a multi volume body.
bool  is_sheet_body (int volume_id)
  Query whether a specified volume is a sheet body.
bool  is_interval_count_odd (int surface_id)
  Query whether a specified surface has an odd loop.
bool  is_periodic (str geom_type, int entity_id)
  Query whether a specified surface or curve is periodic.
bool  is_surface_planer (int surface_id)
  Query whether a specified surface is planer.
bool  is_surface_planar (int surface_id)
bool  get_undo_enabled ()
int  number_undo_commands ()
[str] get_aprepro_vars ()
  Gets the current aprepro variable names.
float  get_aprepro_numeric_value (str var_name)
  get the value of the given aprepro variable
bool  get_node_constraint ()
  Query current setting for node constraint (move nodes to geometry).
int  get_node_constraint_value ()
  Query current setting for node constraint (move nodes to geometry).
str  get_vertex_type (int surface_id, int vertex_id)
  Get the Vertex Types for a specified vertex on a specified surface. Vertex types include "side", "end", "reverse", "unknown".
[int]  get_relatives (str source_geom_type, int source_id, str target_geom_type)
  Get the relatives (parents/children) of a specified entity.
[int]  get_adjacent_surfaces (str geom_type, int entity_id)
  Get a list of adjacent surfaces to a specified entity.
[int]  get_adjacent_volumes (str geom_type, int entity_id)
  Get a list of adjacent volumes to a specified entity.
[int]  get_entities (str geom_type, bool include_sheet_bodies=false)
  Get all geometry entities of a specified type.
[int]  get_list_of_free_ref_entities (str geom_type)
  Get all free entities of a given geometry type.
int  get_owning_body (str geom_type, int entity_id)
  Get the owning body for a specified entity.
int  get_owning_volume (str geom_type, int entity_id)
  Get the owning volume for a specified entity.
int  get_owning_volume_by_name (str entity_name)
  Get the owning volume for a specified entity.
float  get_curve_length (int curve_id)
  Get the length of a specified curve.
float  get_arc_length (int curve_id)
  Get the arc length of a specified curve.
float  get_distance_from_curve_start (float x, float y, float z, int curve_id)
  Get the distance from a point on a curve to the curve's start point.
float  get_curve_radius (int curve_id)
  Get the radius of a specified arc.
[float]  get_curve_center (int curve_id)
  Get the center point of the arc.
float  get_surface_area (int surface_id)
  Get the area of a surface.
float  get_volume_area (int volume_id)
  Get the area of a volume.
float  get_hydraulic_radius_surface_area (int surface_id)
  Get the area of a hydraulic surface.
float  get_hydraulic_radius_volume_area (int volume_id)
  Get the area of a hydraulic volume.
[float]  get_center_point (str entity_type, int entity_id)
  Get the center point of a specified entity.
int  get_valence (int vertex_id)
  Get the valence for a specific vertex.
float  get_distance_between (int vertex_id_1, int vertex_id_2)
  Get the distance between two vertices.
int  is_point_contained (str geom_type, int id, [float] point)
  Determine if given point is inside, outside, on or unknown the given entity. note that this is typically used for volumes or sheet bodies.
void  print_surface_summary_stats ()
  Print the surface summary stats to the console.
void  print_volume_summary_stats ()
  Print the volume summary stats to the console.
int  get_volume_count ()
int  get_body_count ()
  Get the current number of bodies.
int  get_surface_count ()
  Get the current number of surfaces.
int  get_vertex_count ()
  Get the current number of vertices.
int  get_curve_count ()
  Get the current number of curves.
int  get_curve_count ([int] target_volume_ids)
  Get the current number of curves in the passed-in volumes.
bool  is_catia_engine_available ()
  Determine whether Catia engine is available.
bool  is_acis_engine_available ()
bool  is_opencascade_engine_available ()
[int]  evaluate_exterior_angle ([int] curve_list, float test_angle)
  find all curves in the given list with an exterior angle (the angle between surfaces) less than the test angle. This is equivalent to the parser "exterior_angle" test. (draw curve with exterior_angle >90)
float  get_overlap_max_gap (void)
  Get the max gap setting for calculating surface overlaps.
void  set_overlap_max_gap (float max_gap)
  Set the max gap setting for calculating surface overlaps.
float  get_overlap_max_angle (void)
  Get the max angle setting for calculating surface overlaps.
void  set_overlap_max_angle (float max_angle)
  Set the max angle setting for calculating surface overlaps.

Geometry Repair Support

 

[int]  get_small_curves ([int] target_volume_ids, float mesh_size)
  Get the list of small curves for a list of volumes.
[int]  get_smallest_curves ([int] target_volume_ids, int num_to_return)
  Get a list of the smallest curves in the list of volumes. The number returned is specified by 'num_to_return'.
[int]  get_small_surfaces ([int] target_volume_ids, float mesh_size)
  Get the list of small surfaces for a list of volumes.
[int]  get_narrow_surfaces ([int] target_volume_ids, float mesh_size)
  Get the list of narrow surfaces for a list of volumes.
[int]  get_small_and_narrow_surfaces ([int] target_ids, float small_area, float small_curve_size)
  Get the list of small or narrow surfaces from a list of volumes.
[int]  get_closed_narrow_surfaces ([int] target_ids, float narrow_size)
  Get the list of closed, narrow surfaces from a list of volumes.
[int]  get_surfs_with_narrow_regions ([int] target_ids, float narrow_size)
  Get the list of surfaces with narrow regions.
[int]  get_narrow_regions ([int] target_ids, float narrow_size)
  Get the list of surfaces with narrow regions.
[int]  get_small_volumes ([int] target_volume_ids, float mesh_size)
  Get the list of small volumes from a list of volumes.
[int]  get_blend_surfaces ([int] target_volume_ids)
  Get the list of blend surfaces for a list of volumes.
[int]  get_small_loops ([int] target_volume_ids, float mesh_size)
  Get the list of close loops (surfaces) for a list of volumes.
[int]  get_tangential_intersections ([int] target_volume_ids, float upper_bound, float lower_bound)
  Get the list of bad tangential intersections for a list of volumes.
[int]  get_coincident_vertices ([int] target_volume_ids, float high_tolerance)
[str] get_solutions_for_near_coincident_vertices (int vertex_id1, int vertex_id2)
  Get lists of display strings and command strings for near coincident vertices.
[str] get_solutions_for_overlapping_volumes (int vol_id_1, int vol_id_2, float max_gap_tolerance, float max_gap_angle)
  Get lists of display strings and command strings for overlapping volumes.
[str] get_volume_gap_solutions (int surface_id_1, int surface_id_2)
[str] get_solutions_for_near_coincident_vertex_and_curve (int vertex_id, int curve_id)
  Get lists of display strings and command strings for near coincident vertices and curves.
[str] get_solutions_for_near_coincident_vertex_and_surface (int vertex_id, int surface_id)
  Get lists of display strings and command strings for near coincident vertices and surfaces.
[str] get_solutions_for_imprint_merge (int surface_id1, int surface_id2)
  Get lists of display strings and command strings for imprint/merge solutions.
[str] get_solutions_for_small_surfaces (int surface_id, float small_curve_size, float mesh_size)
  Get lists of display, preview and command strings for small surface solutions.
[str] get_solutions_for_small_curves (int curve_id, float small_curve_size, float mesh_size)
  Get lists of display, preview and command strings for small curve solutions.
[str] get_solutions_for_surfaces_with_narrow_regions (int surface_id, float small_curve_size, float mesh_size)
  Get lists of display, preview and command strings for surfaces with narrow regions solutions.
[int]  get_overlapping_volumes ([int] target_volume_ids)
  Get the list of overlapping volumes for a list of volumes.
[int] get_mergeable_vertices ([int] target_volume_ids)
  Get the list of mergeable vertices from a list of volumes/bodies.
[int] get_mergeable_curves ([int] target_volume_ids)
  Get the list of mergeable curves from a list of volumes/bodies.
[int] get_mergeable_surfaces ([int] target_volume_ids)
  Get the list of mergeable surfaces from a list of volumes/bodies.
[str] get_solutions_for_decomposition ([int] volume_list, float exterior_angle, bool do_imprint_merge, bool tol_imprint)
  Get the list of possible decompositions.
[str] get_solutions_for_blends (int surface_id)
  Get the solution list for a given blend surface.
[int] get_blend_chains (int surface_id)
  Queries the blend chains for a surface.
float  get_merge_tolerance ()
  Get the current merge tolerance value.

Blocks, Sidesets, and Nodesets

 

int  get_block_count ()
  Get the current number of blocks.
int  get_sideset_count ()
  Get the current number of sidesets.
int  get_nodeset_count ()
  Get the current number of sidesets.
str  get_exodus_entity_name (str entity_type, int entity_id)
  Get the current number of nodesets.
str  get_exodus_entity_description (str entity_type, int entity_id)
  Get the description associated with an exodus entity.
[float]  get_all_exodus_times (str filename)
  Open an exodus file and get a vector of all stored time stamps.
[str] get_all_exodus_variable_names (str filename, str type)
  Open an exodus file and get a list of all stored variable names.
int  get_block_id (str entity_type, int entity_id)
  Get the associated block id for a specific curve, surface, or volume.
[int]  get_block_ids (str mesh_geom_file_name)
  Get list of block ids from a mesh geometry file.
[int]  get_block_id_list ()
  Get a list of all blocks.
[int]  get_nodeset_id_list ()
  Get a list of all nodesets.
[int]  get_sideset_id_list ()
  Get a list of all sidesets.
[int]  get_bc_id_list (CI_BCTypes bc_type_in)
  Get a list of all bcs of a specified type.
str  get_bc_name (CI_BCTypes bc_type_in, int bc_id)
  Get the name for the specified bc.
[int]  get_nodeset_id_list_for_bc (CI_BCTypes bc_type_in, int bc_id)
  Get a list of all nodesets the specified bc is applied to.
[int]  get_sideset_id_list_for_bc (CI_BCTypes bc_type_in, int bc_id)
  Get a list of all sidesets the specified bc is applied to.
int  get_next_sideset_id ()
  Get a next available sideset id.
int  get_next_nodeset_id ()
  Get a next available nodeset id.
int  get_next_block_id ()
  Get a next available block id.
str  get_copy_nodeset_on_geometry_copy_setting ()
  Get the copy nodeset on geometry copy setting.
str  get_copy_sideset_on_geometry_copy_setting ()
  Get the copy nodeset on geometry copy setting.
str  get_copy_block_on_geometry_copy_setting ()
  Get the copy nodeset on geometry copy setting.
[int]  get_block_volumes (int block_id)
  Get a list of volume ids associated with a specific block.
[int]  get_block_surfaces (int block_id)
  Get a list of surface associated with a specific block.
[int]  get_block_curves (int block_id)
  Get a list of curve associated with a specific block.
[int]  get_block_vertices (int block_id)
  Get a list of vertices associated with a specific block.
[int]  get_block_nodes (int block_id)
  Get a list of nodes associated with a specific block.
[int]  get_block_edges (int block_id)
  Get a list of edges associated with a specific block.
[int]  get_block_tris (int block_id)
  Get a list of tris associated with a specific block.
[int]  get_block_faces (int block_id)
  Get a list of faces associated with a specific block.
[int]  get_block_pyramids (int block_id)
  Get a list of pyramids associated with a specific block.
[int]  get_block_wedges (int block_id)
  Get a list of wedges associated with a specific block.
[int]  get_block_tets (int block_id)
  Get a list of tets associated with a specific block.
[int]  get_block_hexes (int block_id)
  Get a list of hexes associated with a specific block.
[int]  get_volume_hexes (int volume_id)
  get the list of any hex elements in a given volume
[int]  get_volume_tets (int volume_id)
  get the list of any tet elements in a given volume
[int]  get_nodeset_volumes (int nodeset_id)
  Get a list of volume ids associated with a specific nodeset.
[int]  get_nodeset_surfaces (int nodeset_id)
  Get a list of surface ids associated with a specific nodeset.
[int]  get_nodeset_curves (int nodeset_id)
  Get a list of curve ids associated with a specific nodeset.
[int]  get_nodeset_vertices (int nodeset_id)
  Get a list of vertex ids associated with a specific nodeset.
[int]  get_nodeset_nodes (int nodeset_id)
  Get a list of node ids associated with a specific nodeset. This only returns the nodes that were specifically assigned to this nodeset. If the nodeset was created as a piece of geometry, get_nodeset_nodes will not return the nodes on that geometry See also get_nodeset_nodes_inclusive.
[int]  get_nodeset_nodes_inclusive (int nodeset_id)
  Get a list of node ids associated with a specific nodeset. This includes all nodes specifically assigned to the nodeset, as well as nodes associated to a piece of geometry which was used to define the nodeset.
[int]  get_sideset_curves (int sideset_id)
  Get a list of curve ids associated with a specific sideset.
[int]  get_curve_edges (int curve_id)
  get the list of any edge elements on a given curve
[int]  get_sideset_surfaces (int sideset_id)
  Get a list of any surfaces in a sideset.
[int]  get_sideset_quads (int sideset_id)
  Get a list of any quads in a sideset.
[int]  get_surface_quads (int surface_id)
  get the list of any quad elements on a given surface
[int]  get_surface_tris (int surface_id)
  get the list of any tri elements on a given surface
str  get_entity_sense (str source_type, int source_id, int sideset_id)
  Get the sense of a sideset item.
str  get_wrt_entity (str source_type, int source_id, int sideset_id)
  Get the with-respect-to entity.
[str] get_geometric_owner (str mesh_entity_type, str mesh_entity_list)
  Get a list of geometric owners given a list of mesh entities.

Geometry-Mesh Entity Support

 

[int]  get_volume_nodes (int vol_id)
  Get list of node ids owned by a volume. Excludes nodes owned by bounding surfs, curves and verts.
[int]  get_surface_nodes (int surf_id)
  Get list of node ids owned by a surface. Excludes nodes owned by bounding curves and verts.
[int]  get_curve_nodes (int curv_id)
  Get list of node ids owned by a curve. Excludes nodes owned by bounding vertices.
int  get_vertex_node (int vert_id)
  Get the node owned by a vertex.

Group Support

 

int  get_id_from_name (str name)
  Get id for a named entity.
[int]  get_group_groups (int group_id)
  Get group groups (groups that are children of another group).
[int]  get_group_volumes (int group_id)
  Get group volumes (volumes that are children of a group).
[int]  get_group_bodies (int group_id)
  Get group bodies (bodies that are children of a group).
[int]  get_group_surfaces (int group_id)
  Get group surfaces (surfaces that are children of a group).
[int]  get_group_curves (int group_id)
  Get group curves (curves that are children of a group).
[int]  get_group_vertices (int group_id)
  Get group vertices (vertices that are children of a group).
[int]  get_group_nodes (int group_id)
  Get group nodes (nodes that are children of a group).
[int]  get_group_edges (int group_id)
  Get group edges (edges that are children of a group).
[int]  get_group_quads (int group_id)
  Get group quads (quads that are children of a group).
[int]  get_group_tris (int group_id)
  Get group tris (tris that are children of a group).
[int]  get_group_tets (int group_id)
  Get group tets (tets that are children of a group).
[int]  get_group_wedges (int group_id)
  Get group wedges (wedges that are children of a group).
[int]  get_group_pyramids (int group_id)
  Get group pyramids (pyramids that are children of a group).
[int]  get_group_spheres (int group_id)
[int]  get_group_hexes (int group_id)
int  get_next_group_id ()
  Get the next available group id from Cubit.
void  delete_all_groups ()
  Delete all groups.
void  delete_group (int group_id)
  Delete a specific group.
void  set_max_group_id (int max_group_id)
  Reset Cubit's max group id This is really dangerous to use and exists only to overcome a limitation with Cubit. Cubit keeps track of the next group id to assign. But those ids just keep incrementing in Cubit. Some of the power tools in the Cubit GUI make groups 'under the covers' for various operations. The groups are immediately deleted. But, creating those groups will cause Cubit's group id to increase and downstream journal files may be messed up because those journal files are expecting a certain ID to be available.
int  create_new_group ()
  Create a new group.
void  remove_entity_from_group (int group_id, int entity_id, str entity_type)
  Remove a specific entity from a specific group.
void  add_entity_to_group (int group_id, int entities, str entity_type)
  Add a specific entity to a specific group.
void  add_entities_to_group (int group_id, [int] entity_id, str entity_type)
  Add a list of entities to a specific group.
void  group_list ([str] name_list, [int] id_list)
  Get the names and ids of all the groups (excluding the pick group) that are defined by the current cubit session.
[int]  get_mesh_group_parent_ids (str element_type, int element_id)
  Get the group ids which are parents to the indicated mesh element.
bool  is_mesh_element_in_group (str element_type, int element_id)
  Indicates whether a mesh element is in a group.

General Purpose Utility

 

bool  is_part_of_list (int target_id, [int] id_list)
  Routine to check for the presence of an id in a list of ids.
int  get_last_id (str entity_type)
  Get the id of the last created entity of the given type.
str  get_idless_signature (str type, int id)
  get the idless signature of a geometric or mesh entity
str  get_idless_signatures (str type, [int] idlist)
  get the idless signatures of a range of geometric or mesh entities

Mesh Element Queries

 

int  get_exodus_id (str entity_type, int entity_id)
  Get the exodus/genesis id for this element.
str  get_geometry_owner (str entity_type, int entity_id)
  Get the geometric owner of this mesh element.
[int]  get_connectivity (str entity_type, int entity_id)
  Get the list of node ids contained within a mesh entity.
[int]  get_expanded_connectivity (str entity_type, int entity_id)
  Get the list of node ids contained within a mesh entity, including interior nodes.
[int]  get_sub_elements (str entity_type, int entity_id, int dimension)
  Get the lower dimension entities associated with a higher dimension entities. For example get the faces associated with a hex or the edges associated with a tri.
bool  get_node_exists (int node_id)
  Check the existence of a node.
bool  get_element_exists (int element_id)
  Check the existence of an element.
str  get_element_type (int element_id)
  return the type of a given element
int  get_element_type_id (int element_id)
  return the type id of a given element
int  get_element_block (int element_id)
  return the block that a given element is in.
int  get_global_element_id (str elem_type, int id)
  Given a hex, tet, etc. id, return the global element id.
int  get_hex_global_element_id (int hex_id)
  Given a hex id, return the global element id.
int  get_tet_global_element_id (int tet_id)
  Given a tet id, return the global element id.
int  get_wedge_global_element_id (int wedge_id)
  Given a wedge id, return the global element id.
int  get_pyramid_global_element_id (int pyramid_id)
  Given a pyramid id, return the global element id.
int  get_tri_global_element_id (int tri_id)
  Given a tri id, return the global element id.
int  get_quad_global_element_id (int quad_id)
  Given a quad id, return the global element id.
int  get_edge_global_element_id (int edge_id)
  Given a edge id, return the global element id.
int  get_sphere_global_element_id (int edge_id)
  Given a sphere id, return the global element id.
int  get_node_global_id (int node_id)
  Given a node id, return the global element id that is assigned when the mesh is exported.
int  get_closest_node (float x, float y, float z)
  Get the node closest to the given coordinates.
[float]  get_nodal_coordinates (int node_id)
  Get the nodal coordinates for a given node id.
[int]  get_node_faces (int node_id)
[int]  get_node_tris (int node_id)
bool  get_node_position_fixed (int node_id)
  Query "fixedness" state of node. A fixed node is not affecting by smoothing.
[[int][int]]; get_submap_corner_types (int surface_id)
  Get a list of vertex ids and the corresponding corner vertex types if the surface were defined as submap surface. There are no side affects. This does not actually assign corner types or change the underlying mesh scheme of the surface.
str  get_sideset_element_type (int sideset_id)
  Get the element type of a sideset.
str  get_block_element_type (int block_id)
  Get the element type of a block.
int  get_exodus_element_count (int entity_id, str entity_type)
  Get the number of elements in a exodus entity.
int  get_block_attribute_count (int block_id)
  Get the number of attributes in a block.
float  get_block_attribute_value (int block_id, int index)
  Get a specific block attribute value.
str  get_block_attribute_name (int block_id, int index)
  Get a specific block attribute name.
[str] get_valid_block_element_types (int block_id)
  Get a list of potential element types for a block.
int  get_nodeset_node_count (int nodeset_id)
  Get the number of nodes in a nodeset.
int  get_geometry_node_count (str entity_type, int entity_id)
str  get_mesh_element_type (str entity_type, int entity_id)
  Get the mesh element type contained in the specified geometry.
[str] get_mesh_error_solutions (int error_code)
  Get the paired list of mesh error solutions and help context cues.

Boundary Condition Support

 

bool  is_on_thin_shell (CI_BCTypes bc_type_in, int entity_id)
  Determine whether a BC is on a thin shell. Valid for temperature, convection and heatflux.
bool  temperature_is_on_solid (CI_BCTypes bc_type_in, int entity_id)
  Determine whether a BC temperature is on a solid. Valid for convection and temperature.
bool  convection_is_on_solid (int entity_id)
  Determine whether a BC convection is on a solid. Valid for convection.
bool  convection_is_on_shell_area (int entity_id, CI_BCEntityTypes shell_area)
  Determine whether a BC convection is on a shell top or bottom. Valid for convection.
float  get_convection_coefficient (int entity_id, CI_BCEntityTypes cc_type)
  Get the convection coefficient.
float  get_bc_temperature (CI_BCTypes bc_type, int entity_id, CI_BCEntityTypes temp_type)
  Get the temperature. Valid for convection, temperature.
bool  temperature_is_on_shell_area (CI_BCTypes bc_type, CI_BCEntityTypes bc_area, int entity_id)
  Determine whether a BC temperature is on a shell area. Valid for convection and temperature and on top, bottom, gradient, and middle.
bool  heatflux_is_on_shell_area (CI_BCEntityTypes bc_area, int entity_id)
  Determine whether a BC heatflux is on a shell area.
float  get_heatflux_on_area (CI_BCEntityTypes bc_area, int entity_id)
  Get the heatflux on a specified area.
int  get_cfd_type (int entity_id)
  Get the cfd subtype for a specified cfd BC.
float  get_contact_pair_friction_value (int entity_id)
  Get the contact pair's friction value.
float  get_contact_pair_tolerance_value (int entity_id)
  Get the contact pair's upper bound tolerance value.
float  get_contact_pair_tol_lower_value (int entity_id)
  Get the contact pair's lower bound tolerance value.
bool  get_contact_pair_tied_state (int entity_id)
  Get the contact pair's tied state.
bool  get_contact_pair_general_state (int entity_id)
  Get the contact pair's general state.
bool  get_contact_pair_exterior_state (int entity_id)
  Get the contact pair's exterior state.
int  get_displacement_coord_system (int entity_id)
  Get the displacement's coordinate system id.
str  get_acceleration_combine_type (int entity_id)
  Get the acceleration's combine type which is "Overwrite", "Average", "SmallestCombine", or "LargestCombine".
str  get_displacement_combine_type (int entity_id)
  Get the displacement's combine type which is "Overwrite", "Average", "SmallestCombine", or "LargestCombine".
float  get_pressure_value (int entity_id)
  Get the pressure value.
str  get_pressure_function (int entity_id)
  Get the pressure function.
float  get_force_magnitude (int entity_id)
  Get the force magnitude from a force.
float  get_moment_magnitude (int entity_id)
  Get the moment magnitude from a force.
[float]  get_force_direction_vector (int entity_id)
  Get the direction vector from a force.
[float]  get_force_moment_vector (int entity_id)
  Get the moment vector from a force.
str  get_constraint_type (int constraint_id)
  Get the type of a specified constraint.
str  get_constraint_reference_point (int constraint_id)
  Get the reference point of a specified constraint.
str  get_constraint_dependent_entity_point (int constraint_id)
  Get the dependent entity of a specified constraint.
float  get_material_property (CI_MaterialProperty mp, int entity_id)
int  get_media_property (int entity_id)
[str] get_material_name_list ()
[str] get_media_name_list ()
void  set_label_type (str entity_type, int label_flag)
int  get_label_type (str entity_type)
[int]  get_coordinate_systems_id_list ()