11.3  Cubit  Interface Namespace Reference
On this page:
11.3.1  op_  type Description Entity1 Entity2 Params
8.5

11.3  CubitInterface Namespace Reference

The CubitInterface provides a Python/C++ interface into Cubit.

Classes

 

class  

Body

 

Defines a body object that mostly parallels Cubit’s Body class. More...

 

class  

CFD_BC_Entity

 

Class to implement cfd bc data retrieval. More...

 

class  

CubitFailureException

 

An exception class to alert the caller when the underlying Cubit function fails. More...

 

class  

Curve

 

Defines a curve object that mostly parallels Cubit’s RefEdge class. More...

 

class  

Dir

 

Defines a direction object. More...

 

class  

Entity

 

The base class of all the geometry and mesh types. More...

 

class  

GeomEntity

 

The base class for specifically the Geometry types (Body, Surface, etc.) More...

 

class  

InvalidEntityException

 

An exception class to alert the caller that an invalid entity was attempted to be used. Likely the user is attempting to use an Entity who’s underlying CubitEntity has been deleted. More...

 

class  

InvalidInputException

 

An exception class to alert the caller of a function that invalid inputs were entered. More...

 

class  

Loc

 

Defines a location object. More...

 

class  

MeshErrorFeedback

 

Class to implement mesh command feedback processing. More...

 

class  

Surface

 

Defines a surface object that mostly parallels Cubit’s RefFace class. More...

 

class  

Vertex

 

Defines a vertex object that mostly parallels Cubit’s RefVertex class. More...

 

class  

Volume

 

Defines a volume object that mostly parallels Cubit’s RefVolume class. More...

 

Functions

System Control and Data

void 

set_progress_handler (CubitProgressHandler *progress)

 

Register a progress-bar callback handler with Cubit. Deletes the current progress handler if it exists. More...

 

CubitProgressHandler * 

replace_progress_handler (CubitProgressHandler *progress)

 

Register a new progress-bar callback handler with Cubit and return the the previous progress-handler without deleting it. More...

 

void 

set_cubit_interrupt (bool interrupt)

 

This sets the global flag in Cubit that stops all interruptable processes. More...

 

void 

set_playback_paused_on_error (bool pause)

 

Sets whether or not playback is paused when an error occurs. More...

 

bool 

is_file_hdf5 (const std::string &filename)

 

Determines whether the given file is HDF5 or not. Note that this will also return false if a file with the given filename does not exist.

 

bool 

is_playback_paused_on_error ()

 

Gets whether or not playback is paused when an error occurs. More...

 

bool 

developer_commands_are_enabled ()

 

This checks to see whether developer commands are enabled. More...

 

CubitBaseInterface * 

get_interface (std::string interface_name)

 

Get the interface of a given name. More...

 

bool 

release_interface (CubitBaseInterface *instance)

 

Release the interface with the given name. More...

 

void 

add_filename_to_recent_file_list (std::string &filename)

 

std::string 

get_version ()

 

Get the Cubit version. More...

 

std::string 

get_revision_date ()

 

Get the Cubit revision date. More...

 

std::string 

get_build_number ()

 

Get the Cubit build number. More...

 

std::string 

get_acis_version ()

 

Get the Acis version number. More...

 

int 

get_acis_version_as_int ()

 

Get the Acis version number as an int. More...

 

std::string 

get_exodus_version ()

 

Get the Exodus version number. More...

 

std::string 

get_meshgems_version ()

 

Get the MeshGems version number. More...

 

double 

get_cubit_digits_setting ()

 

Get the Cubit digits setting. More...

 

std::string 

get_graphics_version ()

 

Get the VTK version number. More...

 

void 

print_cmd_options ()

 

Used to print the command line options.

 

bool 

is_modified ()

 

Get the modified status of the model. More...

 

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. More...

 

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. More...

 

bool 

is_command_echoed ()

 

Check the echo flag in cubit. More...

 

std::string 

get_command_from_history (int command_number)

 

Get a specific command from Cubit’s command history buffer. More...

 

std::string 

get_next_command_from_history ()

 

Get ’next’ command from history buffer. More...

 

std::string 

get_previous_command_from_history ()

 

Get ’previous’ command from history buffer. More...

 

bool 

is_volume_meshable (int volume_id)

 

Check if volume is meshable with current scheme. More...

 

void 

journal_commands (bool state)

 

Set the journaling flag in cubit. More...

 

bool 

is_command_journaled ()

 

Check the journaling flag in cubit. More...

 

void 

write_to_journal (std::string words)

 

Write a string to the active journal. More...

 

void 

override_journal_stream (JournalStreamBase *jnl_stream)

 

Override the Journal Stream in CUBIT. More...

 

std::string 

get_current_journal_file ()

 

Gets the current journal file name. More...

 

std::vector< std::string > 

get_cubfile_journal ()

 

bool 

is_working_dir_set ()

 

Create BCVizInterface for CompSimUI. More...

 

bool 

cmd (const char *input_string)

 

Pass a command string into Cubit. More...

 

bool 

silent_cmd (const char *input_string)

 

Pass a command string into Cubit and have it executed without being verbose at the command prompt. More...

 

bool 

was_last_cmd_undoable ()

 

Report whether the last executed command was undoable. More...

 

std::vector< int > 

parse_cubit_list (const std::string &type, std::string entity_list_string)

 

Parse a Cubit style entity list into a list of integers. More...

 

std::string 

string_from_id_list (std::vector< int > ids)

 

Parse a list of integers into a Cubit style id list. More...

 

void 

print_raw_help (const char *input_line, int order_dependent, int consecutive_dependent)

 

Used to print out help when a ?, & or ! is pressed. More...

 

int 

get_error_count ()

 

Get the number of errors in the current Cubit session. More...

 

void 

complete_filename (std::string &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.) More...

 

Graphics Manipulation and Data

double 

get_view_distance ()

 

Get the distance from the camera to the model (from - at) More...

 

std::array< double, 3 > 

get_view_at ()

 

Get the camera ’at’ point. More...

 

std::array< double, 3 > 

get_view_from ()

 

Get the camera ’from’ point. More...

 

std::array< double, 3 > 

get_view_up ()

 

Get the camera ’up’ direction. More...

 

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.

 

void 

clear_drawing_set (const std::string &set_name)

 

Clear a named drawing set (this is for mesh preview)

 

void 

unselect_entity (const std::string &entity_type, int entity_id)

 

Unselect an entity that is currently selected. More...

 

int 

get_rubberband_shape ()

 

Get the current rubberband select mode. More...

 

bool 

is_perspective_on ()

 

Get the current perspective mode. More...

 

bool 

is_occlusion_on ()

 

Get the current occlusion mode. More...

 

bool 

is_scale_visibility_on ()

 

Get the current scale visibility setting. More...

 

bool 

is_mesh_visibility_on ()

 

Get the current mesh visibility setting. More...

 

bool 

is_geometry_visibility_on ()

 

Get the current geometry visibility setting. More...

 

bool 

is_select_partial_on ()

 

Get the current select partial setting. More...

 

int 

get_rendering_mode ()

 

Get the current rendering mode. More...

 

void 

set_rendering_mode (int mode)

 

Set the current rendering mode. More...

 

void 

clear_highlight ()

 

Clear all entity highlights.

 

void 

clear_preview ()

 

Clear preview graphics without affecting other display settings.

 

void 

highlight (const std::string &entity_type, int entity_id)

 

Highlight the given entity.

 

std::vector< int > 

get_selected_ids ()

 

Get a list of the currently selected ids. More...

 

int 

get_selected_id (int index)

 

Get the selected id based on an index. More...

 

std::string 

get_selected_type (int index)

 

Get the selected type based on an index. More...

 

const char * 

get_pick_type ()

 

Get the current pick type. More...

 

void 

set_pick_type (const std::string &pick_type, bool silent=false)

 

Set the pick type.

 

void 

set_filter_types (int num_types, const std::vector< std::string > filter_types)

 

Set the pick filter types.

 

void 

add_filter_type (const std::string filter_type)

 

Add a filter type.

 

void 

remove_filter_type (const std::string filter_type)

 

Remove a filter type.

 

bool 

is_type_filtered (const std::string filter_type)

 

Determine whether a type is filtered.

 

std::vector< std::string > 

get_pick_filters ()

 

Get a list of the current pick filters.

 

void 

clear_picked_list ()

 

Clear the picked list.

 

void 

step_next_possible_selection ()

 

Step to the next possible selection (selected next dialog)

 

void 

step_previous_possible_selection ()

 

Step to the previous possible selection (selected next dialog)

 

void 

print_current_selections ()

 

Print the current selections.

 

void 

print_currently_selected_entity ()

 

Print the current selection.

 

int 

current_selection_count ()

 

Get the current count of selected items.

 

Mesh Query Support

double 

get_mesh_edge_length (int edge_id)

 

Get the length of a mesh edge. More...

 

double 

estimate_curve_mesh_size (int curve_id, double percent_capture)

 

Return estimated mesh size for a curve such that the sum of edge lengths are within a precentage of the curve length. More...

 

double 

estimate_curves_mesh_size (const std::string &geometry_type, const std::vector< int > &geom_id, double percent_capture)

 

Return estimated mesh size for curves related to an entity such that the sum of edge lengths are within a precentage of the curve length. The smallest size for all curves is returned. More...

 

size_t 

estimate_morph_tet_element_count (const std::vector< int > &volume_ids, double size, bool keep_void)

 

Return estimated tet element count for volumes. More...

 

int 

estimate_morph_num_procs (const std::vector< int > &volume_ids, double size)

 

Return recommended numprocs to run morph on this model at the specified size. More...

 

double 

get_meshed_volume_or_area (const std::string &geometry_type, std::vector< int > entity_ids)

 

Get the total volume/area of a entity’s mesh. More...

 

int 

get_mesh_intervals (const std::string &geometry_type, int entity_id)

 

Get the interval count for a specified entity. More...

 

double 

get_mesh_size (const std::string &geometry_type, int entity_id)

 

Get the mesh size for a specified entity. More...

 

double 

get_requested_mesh_size (const std::string &geometry_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. More...

 

int 

has_valid_size (const std::string &geometry_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.

 

double 

get_default_auto_size ()

 

Get auto size needs for the current set of geometry.

 

int 

get_requested_mesh_intervals (const std::string &geometry_type, int entity_id)

 

Get the interval count for a specified entity as set specifically on that entity. More...

 

double 

get_auto_size (const std::string &geometry_type, std::vector< int > entity_id_list, double 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. More...

 

int 

get_element_budget (const std::string &element_type, std::vector< int > entity_id_list, int auto_factor)

 

Get the element budget based on current size settings for a list of volumes. More...

 

std::string 

get_exodus_sizing_function_variable_name ()

 

Get the exodus sizing function variable name. More...

 

std::string 

get_exodus_sizing_function_file_name ()

 

Get the exodus sizing function file name. More...

 

std::string 

get_sizing_function_name (const std::string &entity_type, int surface_id)

 

Get the sizing function name for a surface or volume. More...

 

bool 

exodus_sizing_function_file_exists ()

 

return whether the exodus sizing funnction file exists More...

 

bool 

get_vol_sphere_params (std::vector< int > sphere_id_list, int &rad_intervals, int &az_intervals, double &bias, double &fract, int &max_smooth_iterations)

 

get the current sphere parameters for a sphere volume More...

 

std::string 

get_curve_bias_type (int curve_id)

 

double 

get_curve_bias_geometric_factor (int curve_id)

 

double 

get_curve_bias_geometric_factor2 (int curve_id)

 

double 

get_curve_bias_first_interval_length (int curve_id)

 

double 

get_curve_bias_first_interval_fraction (int curve_id)

 

double 

get_curve_bias_fine_size (int curve_id)

 

double 

get_curve_bias_coarse_size (int curve_id)

 

double 

get_curve_bias_first_last_ratio1 (int curve_id)

 

double 

get_curve_bias_first_last_ratio2 (int curve_id)

 

double 

get_curve_bias_last_first_ratio1 (int curve_id)

 

double 

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)

 

double 

get_curve_mesh_scheme_curvature (int curve_id)

 

Get the curvature mesh scheme value of a curve. More...

 

bool 

get_curve_mesh_scheme_stretch_values (int curve_id, double &first_size, double &factor, double &last_size, bool &start, int &vertex_id)

 

std::vector< double > 

get_curve_mesh_scheme_pinpoint_locations (int curve_id)

 

void 

get_quality_stats (const std::string &entity_type, std::vector< int > id_list, const std::string &metric_name, double single_threshold, bool use_low_threshold, double low_threshold, double high_threshold, double &min_value, double &max_value, double &mean_value, double &std_value, int &min_element_id, int &max_element_id, std::vector< int > &mesh_list, std::string &element_type, int &bad_group_id, bool make_group=false)

 

Get the quality stats for a specified entity. More...

 

std::vector< double > 

get_elem_quality_stats (const std::string &entity_type, const std::vector< int > id_list, const std::string &metric_name, const double single_threshold, const bool use_low_threshold, const double low_threshold, const double high_threshold, const bool make_group)

 

python callable version of the get_quality_stats without pass by reference arguments. All return values are stuffed into a double array More...

 

std::vector< double > 

get_quality_stats_at_geometry (const std::string &geom_type, const std::string &mesh_type, const std::vector< int > geom_id_list, const int expand_levels, const std::string &metric_name, const double single_threshold, const bool use_low_threshold, const double low_threshold, const double high_threshold, const bool make_group)

 

get element quality at a list of geometry entities. Finds all elements with nodes ON/IN the specified geometry and finds the quality of all elements of the specfied element type that are connected. Same arguments and return values as get_elem_quality_stats except a geometry and element type are used as arguments More...

 

double 

get_quality_value (const std::string &mesh_type, int mesh_id, const std::string &metric_name)

 

Get the metric value for a specified mesh entity. More...

 

std::string 

get_mesh_scheme (const std::string &geometry_type, int entity_id)

 

Get the mesh scheme for the specified entity. More...

 

std::string 

get_mesh_scheme_firmness (const std::string &geometry_type, int entity_id)

 

Get the mesh scheme firmness for the specified entity. More...

 

std::string 

get_mesh_interval_firmness (const std::string &geometry_type, int entity_id)

 

Get the mesh interval firmness for the specified entity. This may include influence from connected mesh intervals on connected geometry. More...

 

std::string 

get_requested_mesh_interval_firmness (const std::string &geometry_type, int entity_id)

 

Get the mesh interval firmness for the specified entity as set specifically on the entity. More...

 

std::string 

get_mesh_size_type (const std::string &geometry_type, int entity_id)

 

Get the mesh size setting type for the specified entity. This may include influence from attached geometry. More...

 

std::string 

get_requested_mesh_size_type (const std::string &geometry_type, int entity_id)

 

Get the mesh size setting type for the specified entity as set specifically on the entity. More...

 

bool 

get_tetmesh_proximity_flag (int volume_id)

 

Get the proximity flag for tet meshing. More...

 

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. More...

 

double 

get_tetmesh_growth_factor (int volume_id)

 

Get the tetmesh growth factor. More...

 

bool 

get_tetmesh_parallel ()

 

Get the parallel flag for tet meshing. Defines whether to use parallel mesher. More...

 

int 

get_tetmesh_num_anisotropic_layers ()

 

Get the number of anisotropic tet layers. Global setting. More...

 

int 

get_tetmesh_optimization_level ()

 

Get the optimization level for tetmeshing. Global setting. More...

 

bool 

get_tetmesh_insert_mid_nodes ()

 

Get the state of the flag to insert midnodes during meshing. Global setting. More...

 

bool 

get_tetmesh_optimize_mid_nodes ()

 

Get the state of the flag to optimize midnodes during meshing. Global setting. More...

 

bool 

get_tetmesh_optimize_overconstrained_tets ()

 

Get the state of the flag to optimize overconstrained tets. Global setting. More...

 

bool 

get_tetmesh_optimize_overconstrained_edges ()

 

Get the state of the flag to optimize overconstrained edges. Global setting. More...

 

bool 

get_tetmesh_minimize_slivers ()

 

Get the state of the flag to minimize sliver tets. Global setting. More...

 

bool 

get_tetmesh_minimize_interior_points ()

 

Get the state of the flag to minimize interior points in tetmesher. Global setting. More...

 

bool 

get_tetmesh_relax_surface_constraints ()

 

Get the state of the flag to relax surface mesh constraints in tetmesher. Global setting. More...

 

double 

get_mesh_geometry_approximation_angle (std::string geometry_type, int entity_id)

 

Get the geometry approximation angle set for tri/tet meshing. More...

 

double 

get_trimesh_surface_gradation ()

 

Get the global surface mesh gradation set for meshing with MeshGems. More...

 

double 

get_trimesh_volume_gradation ()

 

Get the global volume mesh gradation set for meshing with MeshGems. More...

 

double 

get_trimesh_target_min_size (std::string geom_type, int entity_id)

 

Get the trimesh target min size for the entity. local setting for surfaces. More...

 

bool 

get_trimesh_geometry_sizing ()

 

Get the global geometry sizing flag for trimesher. More...

 

int 

get_trimesh_num_anisotropic_layers ()

 

Get the global number of anisotropic layers for trimeshing. More...

 

bool 

get_trimesh_split_overconstrained_edges ()

 

Get the global setting for trimesher split over-constrained edges. More...

 

double 

get_trimesh_tiny_edge_length ()

 

Get the global setting for tiny edge length in trimesher. More...

 

double 

get_trimesh_ridge_angle ()

 

Get the global setting for ridge angle in trimesher. More...

 

bool 

is_meshed (const std::string &geometry_type, int entity_id)

 

Determines whether a specified entity is meshed. More...

 

bool 

is_merged (const std::string &geometry_type, int entity_id)

 

Determines whether a specified entity is merged. More...

 

std::string 

get_smooth_scheme (const std::string &geometry_type, int entity_id)

 

Get the smooth scheme for a specified entity. More...

 

int 

get_hex_count ()

 

Get the count of hexes in the model. More...

 

int 

get_pyramid_count ()

 

Get the count of pyramids in the model. More...

 

int 

get_tet_count ()

 

Get the count of tets in the model. More...

 

int 

get_quad_count ()

 

Get the count of quads in the model. More...

 

int 

get_tri_count ()

 

Get the count of tris in the model. More...

 

int 

get_edge_count ()

 

Get the count of edges in the model. More...

 

int 

get_sphere_count ()

 

Get the count of sphere elements in the model. More...

 

int 

get_node_count ()

 

Get the count of nodes in the model. More...

 

int 

get_element_count ()

 

Get the count of elements in the model. More...

 

int 

get_volume_element_count (int volume_id)

 

Get the count of elements in a volume. More...

 

int 

get_surface_element_count (int surface_id)

 

Get the count of elements in a surface. More...

 

bool 

volume_contains_tets (int volume_id)

 

Determine whether a volume contains tets. More...

 

std::vector< 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. More...

 

std::string 

get_default_element_type ()

 

Get the current default setting for the element type that will be used when meshing. More...

 

Geometry Query Support

bool 

is_visible (const std::string &geometry_type, int entity_id)

 

Query visibility for a specific entity. More...

 

bool 

is_virtual (const std::string &geometry_type, int entity_id)

 

Query virtualality for a specific entity. More...

 

bool 

contains_virtual (const std::string &geometry_type, int entity_id)

 

Query virtualality of an entity’s children. More...

 

std::vector< int > 

get_source_surfaces (int volume_id)

 

Get a list of a volume’s sweep source surfaces. More...

 

std::vector< int > 

get_target_surfaces (int volume_id)

 

Get a list of a volume’s sweep target surfaces. More...

 

int 

get_common_curve_id (int surface_1_id, int surface_2_id)

 

Given 2 surfaces, get the common curve id. More...

 

int 

get_common_vertex_id (int curve_1_id, int curve_2_id)

 

Given 2 curves, get the common vertex id. More...

 

std::vector< std::vector< double > > 

project_unit_square (std::vector< std::vector< double > > pts, int surface_id, int quad_id, int node00_id, int node10_id)

 

Given points in a unit square, map them to the given quad using the orientation info, then project them onto the given surface, and return their projected positions. More...

 

std::string 

get_merge_setting (const std::string &geometry_type, int entity_id)

 

Get the merge setting for a specified entity. More...

 

std::string 

get_curve_type (int curve_id)

 

Get the curve type for a specified curve. More...

 

std::string 

get_surface_type (int surface_id)

 

Get the surface type for a specified surface. More...

 

std::array< double, 3 > 

get_surface_normal (int surface_id)

 

Get the surface normal for a specified surface. More...

 

std::array< double, 3 > 

get_surface_normal_at_coord (int surface_id, std::array< double, 3 >)

 

Get the surface normal for a specified surface at a location. More...

 

std::array< double, 3 > 

get_surface_centroid (int surface_id)

 

Get the surface centroid for a specified surface. More...

 

std::string 

get_surface_sense (int surface_id)

 

Get the surface sense for a specified surface. More...

 

std::vector< std::string > 

get_entity_modeler_engine (const std::string &geometry_type, int entity_id)

 

Get the modeler engine type for a specified entity. More...

 

std::string 

get_default_geometry_engine ()

 

Get the name of the default modeler engine. More...

 

std::array< double, 10 > 

get_bounding_box (const std::string &geometry_type, int entity_id)

 

Get the bounding box for a specified entity. More...

 

std::array< double, 10 > 

get_total_bounding_box (const std::string &geometry_type, std::vector< int > entity_list)

 

Get the bounding box for a list of entities. More...

 

std::array< double, 15 > 

get_tight_bounding_box (const std::string &geometry_type, std::vector< int > entity_list)

 

Get the tight bounding box for a list of entities. More...

 

double 

get_total_volume (std::vector< int > volume_list)

 

Get the total volume for a list of volume ids. More...

 

std::string 

get_entity_name (const std::string &entity_type, int entity_id)

 

Get the name of a specified entity. More...

 

bool 

set_entity_name (const std::string &entity_type, int entity_id, const std::string &new_name)

 

Set the name of a specified entity. More...

 

int 

get_entity_color_index (const std::string &entity_type, int entity_id)

 

Get the color of a specified entity. More...

 

bool 

is_multi_volume (int body_id)

 

Query whether a specified body is a multi volume body. More...

 

bool 

is_sheet_body (int volume_id)

 

Query whether a specified volume is a sheet body. More...

 

bool 

is_interval_count_odd (int surface_id)

 

Query whether a specified surface has an odd loop. More...

 

bool 

is_periodic (const std::string &geometry_type, int entity_id)

 

Query whether a specified surface or curve is periodic. More...

 

bool 

is_surface_planer (int surface_id)

 

Query whether a specified surface is planer. More...

 

bool 

is_surface_planar (int surface_id)

 

void 

get_periodic_data (const std::string &geometry_type, int entity_id, double &returned_interval, std::string &returned_firmness, int &returned_lower_bound, std::string &returned_upper_bound)

 

Get the periodic data for a surface or curve. More...

 

bool 

get_undo_enabled ()

 

int 

number_undo_commands ()

 

std::vector< std::string > 

get_aprepro_vars ()

 

Gets the current aprepro variable names. More...

 

std::string 

get_aprepro_value_as_string (std::string variable_name)

 

Gets the string value of an aprepro variable. More...

 

bool 

get_aprepro_value (std::string variable_name, int &returned_variable_type, double &returned_double_val, std::string &returned_string_val)

 

Get the value of an aprepro variable. More...

 

double 

get_aprepro_numeric_value (std::string variable_name)

 

get the value of the given aprepro variable More...

 

bool 

get_node_constraint ()

 

Query current setting for node constraint (move nodes to geometry) More...

 

int 

get_node_constraint_value ()

 

Query current setting for node constraint (move nodes to geometry) More...

 

double 

get_node_constraint_smart_threshold ()

 

Query current setting for node constraint smart threshold. More...

 

std::string 

get_node_constraint_smart_metric ()

 

Query current setting for node constraint smart metric Currently only for tets. Return either "distortion" of "normalized inradius". More...

 

std::string 

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". More...

 

std::vector< int > 

get_relatives (const std::string &source_geometry_type, int source_id, const std::string &target_geom_type)

 

Get the relatives (parents/children) of a specified entity. More...

 

std::vector< int > 

get_adjacent_surfaces (const std::string &geometry_type, int entity_id)

 

Get a list of adjacent surfaces to a specified entity. More...

 

std::vector< int > 

get_adjacent_volumes (const std::string &geometry_type, int entity_id)

 

Get a list of adjacent volumes to a specified entity. More...

 

std::vector< int > 

get_entities (const std::string &entity_type)

 

Get all entities of a specified type (including geometry, mesh, etc...) More...

 

std::vector< int > 

get_list_of_free_ref_entities (const std::string &geometry_type)

 

Get all free entities of a given geometry type. More...

 

int 

get_owning_body (const std::string &geometry_type, int entity_id)

 

Get the owning body for a specified entity. More...

 

int 

get_owning_volume (const std::string &geometry_type, int entity_id)

 

Get the owning volume for a specified entity. More...

 

int 

get_owning_volume_by_name (const std::string &entity_name)

 

Get the owning volume for a specified entity. More...

 

double 

get_curve_length (int curve_id)

 

Get the length of a specified curve. More...

 

double 

get_arc_length (int curve_id)

 

Get the arc length of a specified curve. More...

 

double 

get_distance_from_curve_start (double x_coordinate, double y_coordinate, double z_coordinate, int curve_id)

 

Get the distance from a point on a curve to the curve’s start point. More...

 

double 

get_curve_radius (int curve_id)

 

Get the radius of a specified arc. More...

 

std::array< double, 3 > 

get_curve_center (int curve_id)

 

Get the center point of the arc. More...

 

double 

get_surface_area (int surface_id)

 

Get the area of a surface. More...

 

std::vector< int > 

get_similar_curves (std::vector< int > curve_ids)

 

Get similar curves with the same length. More...

 

std::vector< int > 

get_similar_surfaces (std::vector< int > surface_ids)

 

Get similar surfaces with the same area and number of curves. More...

 

std::vector< int > 

get_similar_volumes (std::vector< int > volume_ids)

 

Get similar volumes with the same volume and number of faces. More...

 

std::vector< double > 

get_surface_principal_curvatures (int surface_id)

 

Get the principal curvatures of a surface at surface mid_point. More...

 

double 

get_volume_area (int volume_id)

 

Get the area of a volume. More...

 

double 

get_hydraulic_radius_surface_area (int surface_id)

 

Get the area of a hydraulic surface. More...

 

double 

get_hydraulic_radius_volume_area (int volume_id)

 

Get the area of a hydraulic volume. More...

 

std::array< double, 3 > 

get_center_point (const std::string &entity_type, int entity_id)

 

Get the center point of a specified entity. More...

 

int 

get_valence (int vertex_id)

 

Get the valence for a specific vertex. More...

 

double 

get_distance_between (int vertex_id_1, int vertex_id_2)

 

Get the distance between two vertices. More...

 

double 

get_distance_between_entities (std::string geom_type_1, int entity_id_1, std::string geom_type_2, int entity_id_2)

 

Get the distance between two geom entities. More...

 

int 

is_point_contained (const std::string &geometry_type, int entity_id, const std::array< double, 3 > &xyz_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. More...

 

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_block_count ()

 

Get the current number of blocks. More...

 

int 

get_sideset_count ()

 

Get the current number of sidesets. More...

 

int 

get_nodeset_count ()

 

Get the current number of sidesets. More...

 

int 

get_volume_count ()

 

Get the current number of nodesets. More...

 

int 

get_body_count ()

 

Get the current number of bodies. More...

 

int 

get_surface_count ()

 

Get the current number of surfaces. More...

 

int 

get_vertex_count ()

 

Get the current number of vertices. More...

 

int 

get_curve_count ()

 

Get the current number of curves. More...

 

int 

get_curve_count_in_volumes (std::vector< int > target_volume_ids)

 

Get the current number of curves in the passed-in volumes. More...

 

bool 

is_catia_engine_available ()

 

Determine whether catia engine is available. More...

 

bool 

is_acis_engine_available ()

 

bool 

is_opencascade_engine_available ()

 

std::vector< int > 

evaluate_exterior_angle (const std::vector< int > &curve_list, const double 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 df parser "exterior_angle" test. (draw curve with exterior_angle >90) More...

 

double 

evaluate_exterior_angle_at_curve (int curve_id, int volume_id)

 

return exterior angle at a single curve with respect to a volume More...

 

double 

evaluate_surface_angle_at_vertex (int surf_id, int vert_id)

 

return interior angle at a vertex on a specified surface More...

 

double 

get_overlap_max_gap (void)

 

Get the max gap setting for calculating surface overlaps. More...

 

void 

set_overlap_max_gap (const double maximum_gap)

 

Set the max gap setting for calculating surface overlaps. More...

 

double 

get_overlap_min_gap (void)

 

Get the min gap setting for calculating surface overlaps. More...

 

void 

set_overlap_min_gap (const double min_gap)

 

Set the min gap setting for calculating surface overlaps. More...

 

double 

get_overlap_max_angle (void)

 

Get the max angle setting for calculating surface overlaps. More...

 

void 

set_overlap_max_angle (const double maximum_angle)

 

Set the max angle setting for calculating surface overlaps. More...

 

Geometry Repair Support

void 

get_small_surfaces_hydraulic_radius (std::vector< int > target_volume_ids, double mesh_size, std::vector< int > &returned_small_surfaces, std::vector< double > &returned_small_radius)

 

Get the list of small hydraulic radius surfaces for a list of volumes. More...

 

std::vector< int > 

get_small_surfaces_HR (std::vector< int > target_volume_ids, double mesh_size)

 

Python callable version Get the list of small hydraulic radius surfaces for a list of volumes. More...

 

void 

get_small_volumes_hydraulic_radius (std::vector< int > target_volume_ids, double mesh_size, std::vector< int > &returned_small_volumes, std::vector< double > &returned_small_radius)

 

Get the list of small hydraulic radius volumes for a list of volumes. More...

 

std::vector< int > 

get_small_curves (std::vector< int > target_volume_ids, double mesh_size)

 

Get the list of small curves for a list of volumes. More...

 

std::vector< int > 

get_smallest_curves (std::vector< int > target_volume_ids, int number_to_return)

 

Get a list of the smallest curves in the list of volumes. The number returned is specified by ’num_to_return’. More...

 

std::vector< int > 

get_small_surfaces (std::vector< int > target_volume_ids, double mesh_size)

 

Get the list of small surfaces for a list of volumes. More...

 

bool 

is_narrow_surface (int surface_id, double mesh_size)

 

return whether the surface is narrow (has a width smaller than mesh_size) More...

 

std::vector< int > 

get_narrow_surfaces (std::vector< int > target_volume_ids, double mesh_size)

 

Get the list of narrow surfaces for a list of volumes. More...

 

std::vector< int > 

get_small_and_narrow_surfaces (std::vector< int > target_ids, double small_area, double small_curve_size)

 

Get the list of small or narrow surfaces from a list of volumes. More...

 

std::vector< int > 

get_closed_narrow_surfaces (std::vector< int > target_ids, double narrow_size)

 

Get the list of closed, narrow surfaces from a list of volumes. More...

 

std::vector< int > 

get_surfs_with_narrow_regions (std::vector< int > target_ids, double narrow_size)

 

Get the list of surfaces with narrow regions. More...

 

std::vector< int > 

get_narrow_regions (std::vector< int > target_ids, double narrow_size)

 

Get the list of surfaces with narrow regions. More...

 

std::vector< int > 

get_small_volumes (std::vector< int > target_volume_ids, double mesh_size)

 

Get the list of small volumes from a list of volumes. More...

 

bool 

is_cylinder_surface (int surface_id)

 

return whether the surface is a cylinder More...

 

bool 

is_chamfer_surface (int surface_id, double thickness_threshold)

 

return whether the surface is a chamfer More...

 

std::vector< std::vector< double > > 

get_chamfer_surfaces (std::vector< int > target_volume_ids, double thickness_threshold)

 

Get the list of chamfer surfaces for a list of volumes. More...

 

bool 

is_blend_surface (int surface_id)

 

return whether the surface is a blend More...

 

std::vector< int > 

get_blend_surfaces (std::vector< int > target_volume_ids)

 

Get the list of blend surfaces for a list of volumes. More...

 

std::vector< int > 

get_small_radius_blend_surfaces (std::vector< int > target_volume_ids, double max_radius)

 

Get the list of blend surfaces for a list of volumes that have a radius of curvature smaller than max_radius. More...

 

bool 

is_close_loop_surface (int surface_id, double mesh_size)

 

return whether the has one or more close loops More...

 

std::vector< int > 

get_close_loops (std::vector< int > target_volume_ids, double mesh_size)

 

Get the list of close loops (surfaces) for a list of volumes. More...

 

std::vector< std::vector< double > > 

get_close_loops_with_thickness (std::vector< int > target_volume_ids, double mesh_size, int genus)

 

Get the list of close loops (surfaces) for a list of volumes also return the corresponding minimum distances for each surface. More...

 

double 

get_close_loop_thickness (int surface_id)

 

Get the thickness of a close loop surface. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_close_loop (int surface_id, double mesh_size)

 

Get the solution list for a given close loop surface. More...

 

std::vector< int > 

get_tangential_intersections (std::vector< int > target_volume_ids, double upper_bound, double lower_bound)

 

Get the list of bad tangential intersections for a list of volumes. More...

 

std::vector< int > 

get_coincident_vertices (std::vector< int > target_volume_ids, double high_tolerance)

 

std::vector< int > 

get_close_vertex_curve_pairs (std::vector< int > target_volume_ids, double high_tolerance)

 

Get the list of close vertex-curve pairs (python callable) More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_near_coincident_vertices (int vertex_id_1, int vertex_id_2)

 

Get lists of display strings and command strings for near coincident vertices. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_bad_geometry (std::string geom_type, int geom_id)

 

Get lists of display strings and command strings for bad geometry. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_overlapping_volumes (int volume_id_1, int volume_id_2, double maximum_gap_tolerance, double maximum_gap_angle)

 

Get lists of display strings and command strings for overlapping volumes. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_overlapping_surfaces (int surface_id_1, int surface_id_2)

 

Get lists of display strings and command strings for overlapping surfaces. More...

 

std::vector< std::vector< std::string > > 

get_volume_gap_solutions (int surface_id_1, int surface_id_2)

 

std::vector< std::vector< std::string > > 

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. More...

 

std::vector< std::vector< std::string > > 

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. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_imprint_merge (int surface_id1, int surface_id2)

 

Get lists of display strings and command strings for imprint/merge solutions. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_forced_sweepability (int volume_id, std::vector< int > &source_surface_id_list, std::vector< int > &target_surface_id_list, double small_curve_size=-1.0)

 

This function only works from C++ Get lists of display strings and command strings for forced sweepability solutions More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_volumes (int vol_id, double small_curve_size, double mesh_size)

 

Get lists of display, preview and command strings for small volume solutions. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_classified_volume (std::string classification, int vol_id)

 

Get lists of display, preview and command strings for a classified volume. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_small_surfaces (int surface_id, double small_curve_size, double mesh_size)

 

Get lists of display, preview and command strings for small surface solutions. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_small_curves (int curve_id, double small_curve_size, double mesh_size)

 

Get lists of display, preview and command strings for small curve solutions. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_sharp_angle_vertex (int vertex_id, double small_curve_size, double mesh_size)

 

Get lists of display, preview and command strings for sharp angle solutions. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_surfaces_with_narrow_regions (int surface_id, double small_curve_size, double mesh_size)

 

Get lists of display, preview and command strings for surfaces with narrow regions solutions. More...

 

std::vector< std::vector< std::string > > 

get_solutions_for_cone_surface (int surface_id)

 

Get lists of display, preview and command strings for surfaces with defined as cones. More...

 

bool 

get_solutions_for_source_target (int volume_id, std::vector< std::vector< int > > &feasible_source_surface_id_list, std::vector< std::vector< int > > &feasible_target_surface_id_list, std::vector< std::vector< int > > &infeasible_source_surface_id_list, std::vector< std::vector< int > > &infeasible_target_surface_id_list)

 

Get a list of suggested sources and target surface ids given a specified volume.

 

void 

get_sharp_surface_angles (std::vector< int > target_volume_ids, std::vector< int > &returned_large_surface_angles, std::vector< int > &returned_small_surface_angles, std::vector< double > &returned_large_angles, std::vector< double > &returned_small_angles, double upper_bound, double lower_bound)

 

Get the list of sharp surface angles for a list of volumes. More...

 

void 

get_sharp_curve_angles (std::vector< int > target_volume_ids, std::vector< int > &returned_large_curve_angles, std::vector< int > &returned_small_curve_angles, std::vector< double > &returned_large_angles, std::vector< double > &returned_small_angles, double upper_bound, double lower_bound)

 

Get the list of sharp curve angles for a list of volumes. More...

 

std::vector< std::vector< double > > 

get_sharp_angle_vertices (std::vector< int > target_volume_ids, double upper_bound, double lower_bound)

 

Get the list of vertices at sharp curve angles for a list of volumes returns two parallel arrays. First array are the vertex ids and second are the associated angles at the vertices. More...

 

bool 

is_cone_surface (int surface_id)

 

return whether the surface is a cone More...

 

std::vector< int > 

get_cone_surfaces (std::vector< int > target_volume_ids)

 

return a list of surfaces that are cones defined by a conic surface and a hard point More...

 

void 

get_bad_geometry (std::vector< int > target_volume_ids, std::vector< int > &returned_body_list, std::vector< int > &returned_volume_list, std::vector< int > &returned_surface_list, std::vector< int > &returned_curve_list)

 

This function only works from C++ Get the list of bad geometry for a list of volumes More...

 

std::vector< std::vector< double > > 

get_ML_operation_features (std::vector< int > op_types, std::vector< int > entity1_ids, std::vector< int > entity2_ids, std::vector< std::vector< double >> params, double mesh_size)

 

returns a vector of vectors defining surface overlaps The first surface (id) in each vector overlaps with all subsequent surfaces in the vector. More...

 

std::vector< std::string > 

get_ML_operation_feature_types (const int op_type)

 

for the given operation type described by get_ML_operation_features, return a vector of strings indicating the type of data for each feature in the vector. Will return one of the following for each index: More...

 

std::vector< std::string > 

get_ML_operation_feature_names (const int op_type)

 

for the given operation type described by get_ML_operation_features, return a vector of strings indicating the name of data for each feature in the vector. More...

 

int 

get_ML_operation_feature_size (const int op_type)

 

for the given operation type described by get_ML_operation_features, return the expected size of the feature vector More...

 

std::string 

get_ML_operation_name (const int op_type)

 

get an ML operation name according from its index More...

 

std::vector< std::string > 

get_ML_operation (const int op_type, const int entity_id1, const int entity_id2, const std::vector< double > params, const double small_curve_size, const double mesh_size)

 

get the command, display and preview strings for a given operation type More...

 

Blocks, Sidesets, and Nodesets

std::string 

get_exodus_entity_name (const std::string entity_type, int entity_id)

 

Get the current number of nodesets. More...

 

std::string 

get_exodus_entity_type (std::string entity_type, int entity_id)

 

Get the type of an exodus entity. More...

 

std::string 

get_exodus_entity_description (std::string entity_type, int entity_id)

 

Get the description associated with an exodus entity. More...

 

std::vector< double > 

get_all_exodus_times (const std::string &filename)

 

Open an exodus file and get a vector of all stored time stamps. More...

 

std::vector< std::string > 

get_all_exodus_variable_names (const std::string &filename, const std::string &variable_type)

 

Open an exodus file and get a list of all stored variable names. More...

 

int 

get_block_id (std::string entity_type, int entity_id)

 

Get the associated block id for a specific curve, surface, or volume. More...

 

std::vector< int > 

get_block_ids (const std::string &mesh_geometry_file_name)

 

Get list of block ids from a mesh geometry file. More...

 

std::vector< int > 

get_block_id_list ()

 

Get a list of all blocks. More...

 

std::vector< int > 

get_nodeset_id_list ()

 

Get a list of all nodesets. More...

 

std::vector< int > 

get_sideset_id_list ()

 

Get a list of all sidesets. More...

 

std::vector< int > 

get_bc_id_list (CI_BCTypes bc_type_enum)

 

Get a list of all bcs of a specified type. More...

 

std::string 

get_bc_name (CI_BCTypes bc_type_enum, int bc_id)

 

Get the name for the specified bc. More...

 

std::vector< int > 

get_nodeset_id_list_for_bc (CI_BCTypes bc_type_enum, int bc_id)

 

Get a list of all nodesets the specified bc is applied to. More...

 

std::vector< int > 

get_sideset_id_list_for_bc (CI_BCTypes bc_type_enum, int bc_id)

 

Get a list of all sidesets the specified bc is applied to. More...

 

int 

get_next_sideset_id ()

 

Get a next available sideset id. More...

 

int 

get_next_nodeset_id ()

 

Get a next available nodeset id. More...

 

int 

get_next_block_id ()

 

Get a next available block id. More...

 

std::string 

get_copy_nodeset_on_geometry_copy_setting ()

 

Get the copy nodeset on geometry copy setting. More...

 

std::string 

get_copy_sideset_on_geometry_copy_setting ()

 

Get the copy nodeset on geometry copy setting. More...

 

std::string 

get_copy_block_on_geometry_copy_setting ()

 

Get the copy nodeset on geometry copy setting. More...

 

bool 

set_copy_nodeset_on_geometry_copy_setting (std::string val)

 

Set the copy nodeset on geometry copy setting "ON", "USE_ORIGINAL", or "OFF". More...

 

bool 

set_copy_sideset_on_geometry_copy_setting (std::string val)

 

Set the copy sideset on geometry copy setting "ON", "USE_ORIGINAL", or "OFF". More...

 

bool 

set_copy_block_on_geometry_copy_setting (std::string val)

 

Set the copy block on geometry copy setting "ON", "USE_ORIGINAL", or "OFF". More...

 

void 

get_block_children (int block_id, std::vector< int > &returned_group_list, std::vector< int > &returned_node_list, std::vector< int > &returned_sphere_list, std::vector< int > &returned_edge_list, std::vector< int > &returned_tri_list, std::vector< int > &returned_face_list, std::vector< int > &returned_pyramid_list, std::vector< int > &returned_tet_list, std::vector< int > &returned_hex_list, std::vector< int > &returned_wedge_list, std::vector< int > &returned_volume_list, std::vector< int > &returned_surface_list, std::vector< int > &returned_curve_list, std::vector< int > &returned_vertex_list)

 

Get lists of any and all possible children of a block. More...

 

void 

get_nodeset_children (int nodeset_id, std::vector< int > &returned_node_list, std::vector< int > &returned_volume_list, std::vector< int > &returned_surface_list, std::vector< int > &returned_curve_list, std::vector< int > &returned_vertex_list)

 

get lists of any and all possible children of a nodeset More...

 

void 

get_sideset_children (int sideset_id, std::vector< int > &returned_face_list, std::vector< int > &returned_surface_list, std::vector< int > &returned_curve_list)

 

get lists of any and all possible children of a sideset More...

 

std::vector< int > 

get_block_volumes (int block_id)

 

Get a list of volume ids associated with a specific block. More...

 

std::vector< int > 

get_block_surfaces (int block_id)

 

Get a list of surface associated with a specific block. More...

 

std::vector< int > 

get_block_curves (int block_id)

 

Get a list of curve associated with a specific block. More...

 

std::vector< int > 

get_block_vertices (int block_id)

 

Get a list of vertices associated with a specific block. More...

 

bool 

get_block_elements_and_nodes (int block_id, std::vector< int > &returned_node_list, std::vector< int > &returned_sphere_list, std::vector< int > &returned_edge_list, std::vector< int > &returned_tri_list, std::vector< int > &returned_face_list, std::vector< int > &returned_pyramid_list, std::vector< int > &returned_wedge_list, std::vector< int > &returned_tet_list, std::vector< int > &returned_hex_list)

 

Get lists of the nodes and different element types associated with this block. This function is recursive, meaning that if the block was created pointing to a piece of geometry, it will traverse down and get the mesh entities associated to that geometry. More...

 

std::vector< int > 

get_block_nodes (int block_id)

 

Get a list of nodes associated with a specific block. More...

 

std::vector< int > 

get_block_edges (int block_id)

 

Get a list of edges associated with a specific block. More...

 

std::vector< int > 

get_block_tris (int block_id)

 

Get a list of tris associated with a specific block. More...

 

std::vector< int > 

get_block_faces (int block_id)

 

Get a list of faces associated with a specific block. More...

 

std::vector< int > 

get_block_pyramids (int block_id)

 

Get a list of pyramids associated with a specific block. More...

 

std::vector< int > 

get_block_wedges (int block_id)

 

Get a list of wedges associated with a specific block. More...

 

std::vector< int > 

get_block_tets (int block_id)

 

Get a list of tets associated with a specific block. More...

 

std::vector< int > 

get_block_hexes (int block_id)

 

Get a list of hexes associated with a specific block. More...

 

std::vector< int > 

get_volume_hexes (int volume_id)

 

get the list of any hex elements in a given volume More...

 

std::vector< int > 

get_volume_tets (int volume_id)

 

get the list of any tet elements in a given volume More...

 

std::vector< int > 

get_volume_wedges (int volume_id)

 

get the list of any wedge elements in a given volume More...

 

std::vector< int > 

get_volume_pyramids (int volume_id)

 

get the list of any pyramid elements in a given volume More...

 

std::vector< int > 

get_nodeset_volumes (int nodeset_id)

 

Get a list of volume ids associated with a specific nodeset. More...

 

std::vector< int > 

get_nodeset_surfaces (int nodeset_id)

 

Get a list of surface ids associated with a specific nodeset. More...

 

std::vector< int > 

get_nodeset_curves (int nodeset_id)

 

Get a list of curve ids associated with a specific nodeset. More...

 

std::vector< int > 

get_nodeset_vertices (int nodeset_id)

 

Get a list of vertex ids associated with a specific nodeset. More...

 

std::vector< 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. More...

 

std::vector< 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. More...

 

std::vector< int > 

get_sideset_curves (int sideset_id)

 

Get a list of curve ids associated with a specific sideset. More...

 

std::vector< int > 

get_sideset_edges (int sideset_id)

 

Get a list of any quads in a sideset. More...

 

std::vector< int > 

get_curve_edges (int curve_id)

 

get the list of any edge elements on a given curve More...

 

std::vector< int > 

get_sideset_surfaces (int sideset_id)

 

Get a list of any surfaces in a sideset. More...

 

std::vector< int > 

get_sideset_quads (int sideset_id)

 

Get a list of any quads in a sideset. More...

 

std::vector< int > 

get_surface_quads (int surface_id)

 

get the list of any quad elements on a given surface More...

 

std::vector< int > 

get_surface_tris (int surface_id)

 

get the list of any tri elements on a given surface More...

 

int 

get_surface_num_loops (int surface_id)

 

get the number of loops on the surface More...

 

std::vector< std::vector< int > > 

get_surface_loop_nodes (int surface_id)

 

get the ordered list of nodes on the loops of this surface More...

 

std::string 

get_entity_sense (std::string source_type, int source_id, int sideset_id)

 

Get the sense of a sideset item. More...

 

std::string 

get_wrt_entity (std::string source_type, int source_id, int sideset_id)

 

Get the with-respect-to entity. More...

 

std::vector< std::string > 

get_geometric_owner (std::string mesh_entity_type, std::string mesh_entity_list)

 

Get a list of geometric owners given a list of mesh entities. More...

 

std::vector< std::string > 

get_all_geometric_owners (std::string mesh_entity_type, std::string mesh_entity_list)

 

Get a list of geometric owners given a list of mesh entities. returns geometric owners of entity as well as all of its child mesh entities. More...

 

Geometry-Mesh Entity Support

std::vector< int > 

get_volume_nodes (int volume_id)

 

Get list of node ids owned by a volume.
Excludes nodes owned by bounding surfs, curves and verts. More...

 

std::vector< int > 

get_surface_nodes (int surface_id)

 

Get list of node ids owned by a surface.
Excludes nodes owned by bounding curves and verts. More...

 

std::vector< int > 

get_curve_nodes (int curve_id)

 

Get list of node ids owned by a curve.
Excludes nodes owned by bounding vertices. More...

 

int 

get_vertex_node (int vertex_id)

 

Get the node owned by a vertex.
More...

 

Group Support

int 

get_id_from_name (const std::string &name)

 

Get id for a named entity. More...

 

void 

get_group_children (int group_id, std::vector< int > &returned_group_list, std::vector< int > &returned_body_list, std::vector< int > &returned_volume_list, std::vector< int > &returned_surface_list, std::vector< int > &returned_curve_list, std::vector< int > &returned_vertex_list, int &returned_node_count, int &returned_edge_count, int &returned_hex_count, int &returned_quad_count, int &returned_tet_count, int &returned_tri_count, int &returned_wedge_count, int &returned_pyramid_count, int &returned_sphere_count)

 

Get group children. More...

 

std::vector< int > 

get_group_groups (int group_id)

 

Get group groups (groups that are children of another group) More...

 

std::vector< int > 

get_group_volumes (int group_id)

 

Get group volumes (volumes that are children of a group) More...

 

std::vector< int > 

get_group_bodies (int group_id)

 

Get group bodies (bodies that are children of a group) More...

 

std::vector< int > 

get_group_surfaces (int group_id)

 

Get group surfaces (surfaces that are children of a group) More...

 

std::vector< int > 

get_group_curves (int group_id)

 

Get group curves (curves that are children of a group) More...

 

std::vector< int > 

get_group_vertices (int group_id)

 

Get group vertices (vertices that are children of a group) More...

 

std::vector< int > 

get_group_nodes (int group_id)

 

Get group nodes (nodes that are children of a group) More...

 

std::vector< int > 

get_group_edges (int group_id)

 

Get group edges (edges that are children of a group) More...

 

std::vector< int > 

get_group_quads (int group_id)

 

Get group quads (quads that are children of a group) More...

 

std::vector< int > 

get_group_tris (int group_id)

 

Get group tris (tris that are children of a group) More...

 

std::vector< int > 

get_group_tets (int group_id)

 

Get group tets (tets that are children of a group) More...

 

std::vector< int > 

get_group_wedges (int group_id)

 

Get group wedges (wedges that are children of a group) More...

 

std::vector< int > 

get_group_pyramids (int group_id)

 

Get group pyramids (pyramids that are children of a group) More...

 

std::vector< int > 

get_group_spheres (int group_id)

 

std::vector< 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. More...

 

void 

set_max_group_id (int maximum_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. More...

 

int 

create_new_group ()

 

Create a new group. More...

 

void 

remove_entity_from_group (int group_id, int entity_id, const std::string &entity_type)

 

Remove a specific entity from a specific group. More...

 

void 

add_entity_to_group (int group_id, int entity_id, const std::string &entity_type)

 

Add a specific entity to a specific group. More...

 

void 

add_entities_to_group (int group_id, const std::vector< int > &entity_id, const std::string &entity_type)

 

Add a list of entities to a specific group. More...

 

void 

group_list (std::vector< std::string > &name_list, std::vector< int > &returned_id_list)

 

Get the names and ids of all the groups (excluding the pick group) that are defined by the current cubit session. More...

 

std::vector< std::pair< std::string, int > > 

group_names_ids ()

 

Get the names and ids of all the groups returned in a name/id structure that are defined by the current cubit session. More...

 

std::vector< int > 

get_mesh_group_parent_ids (const std::string &element_type, int element_id)

 

Get the group ids which are parents to the indicated mesh element. More...

 

bool 

is_mesh_element_in_group (const std::string &element_type, int element_id)

 

Indicates whether a mesh element is in a group. More...

 

General Purpose Utility

bool 

is_part_of_list (int target_id, std::vector< int > id_list)

 

Routine to check for the presence of an id in a list of ids. More...

 

int 

get_last_id (const std::string &entity_type)

 

Get the id of the last created entity of the given type. More...

 

bool 

entity_exists (const std::string &entity_type, int id)

 

return whether an entity of specified ID exists More...

 

std::string 

get_idless_signature (std::string entity_type, int entity_id)

 

get the idless signature of a geometric or mesh entity More...

 

std::string 

get_idless_signatures (std::string entity_type, const std::vector< int > &entity_id_list)

 

get the idless signatures of a range of geometric or mesh entities More...

 

Metadata Support

std::string 

get_assembly_classification_level ()

 

Get Classification Level for metadata. More...

 

std::string 

get_assembly_classification_category ()

 

Get Classification Category for metadata. More...

 

std::string 

get_assembly_weapons_category ()

 

Get Weapons Category for metadata. More...

 

std::string 

get_assembly_metadata (int volume_id, int data_type)

 

Get metadata for a specified volume id. More...

 

bool 

is_assembly_metadata_attached (int volume_id)

 

Determine whether metadata is attached to a specified volume. More...

 

std::string 

get_assembly_name (int assembly_id)

 

Get the stored name of an assembly node. More...

 

std::string 

get_assembly_path (int assembly_id)

 

Get the stored path of an assembly node. More...

 

std::string 

get_assembly_type (int assembly_id)

 

Get the stored type of an assembly node. More...

 

std::string 

get_parent_assembly_path (int assembly_id)

 

Get the stored path of an assembly node’ parent. More...

 

int 

get_assembly_level (int assembly_id)

 

Get the stored level of an assembly node. More...

 

std::string 

get_assembly_description (int assembly_id)

 

Get the stored description of an assembly node. More...

 

int 

get_assembly_instance (int assembly_id)

 

Get the stored instance number of an assembly node. More...

 

int 

get_parent_assembly_instance (int assembly_id)

 

Get the stored instance number of an assembly node’s instance. More...

 

std::string 

get_assembly_file_format (int assembly_id)

 

Get the stored file format of an assembly node. More...

 

std::string 

get_assembly_units (int assembly_id)

 

Get the stored units measure of an assembly node. More...

 

std::string 

get_assembly_material_description (int assembly_id)

 

Get the stored material description of an assembly part. More...

 

std::string 

get_assembly_material_specification (int assembly_id)

 

Get the stored material specification of an assembly part. More...

 

Mesh Element Queries

int 

get_exodus_id (const std::string &entity_type, int entity_id)

 

Get the exodus/genesis id for this element. More...

 

std::string 

get_geometry_owner (const std::string &entity_type, int entity_id)

 

Get the geometric owner of this mesh element. More...

 

std::vector< int > 

get_connectivity (const std::string &entity_type, int entity_id)

 

Get the list of node ids contained within a mesh entity. More...

 

std::vector< int > 

get_expanded_connectivity (const std::string &entity_type, int entity_id)

 

Get the list of node ids contained within a mesh entity, including interior nodes. More...

 

std::vector< int > 

get_sub_elements (const std::string &entity_type, int entity_id, int dimension)

 

Get the lower dimesion entities associated with a higher dimension entities. For example get the faces associated with a hex or the edges associated with a tri. More...

 

bool 

get_node_exists (int node_id)

 

Check the existance of a node. More...

 

bool 

get_element_exists (int element_id)

 

Check the existance of an element. More...

 

std::string 

get_element_type (int element_id)

 

return the type of a given element More...

 

int 

get_element_type_id (int element_id)

 

return the type id of a given element More...

 

int 

get_element_block (int element_id)

 

return the block that a given element is in. More...

 

int 

get_global_element_id (const std::string &element_type, int id)

 

Given a hex, tet, etc. id, return the global element id. More...

 

int 

get_hex_global_element_id (int hex_id)

 

Given a hex id, return the global element id. More...

 

int 

get_tet_global_element_id (int tet_id)

 

Given a tet id, return the global element id. More...

 

int 

get_wedge_global_element_id (int wedge_id)

 

Given a wedge id, return the global element id. More...

 

int 

get_pyramid_global_element_id (int pyramid_id)

 

Given a pyramid id, return the global element id. More...

 

int 

get_tri_global_element_id (int tri_id)

 

Given a tri id, return the global element id. More...

 

int 

get_quad_global_element_id (int quad_id)

 

Given a quad id, return the global element id. More...

 

int 

get_edge_global_element_id (int edge_id)

 

Given a edge id, return the global element id. More...

 

int 

get_sphere_global_element_id (int edge_id)

 

Given a sphere id, return the global element id. More...

 

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. More...

 

int 

get_closest_node (double x_coordinate, double y_coordinate, double z_coordinate)

 

Get the node closest to the given coordinates. More...

 

std::array< double, 3 > 

get_nodal_coordinates (int node_id)

 

Get the nodal coordinates for a given node id. More...

 

std::vector< int > 

get_node_faces (int node_id)

 

Get the face/quad ids that share a node. More...

 

std::vector< int > 

get_node_tris (int node_id)

 

Get the tri ids that share a node. More...

 

std::vector< int > 

get_node_edges (int node_id)

 

Get the edge ids that share a node. More...

 

bool 

get_node_position_fixed (int node_id)

 

Query "fixedness" state of node. A fixed node is not affecting by smoothing. More...

 

std::vector< std::pair< 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. More...

 

std::string 

get_sideset_element_type (int sideset_id)

 

Get the element type of a sideset. More...

 

std::string 

get_block_element_type (int block_id)

 

Get the element type of a block. More...

 

int 

get_exodus_element_count (int entity_id, std::string entity_type)

 

Get the number of elements in a exodus entity. More...

 

int 

get_block_attribute_count (int block_id)

 

Get the number of attributes in a block. More...

 

int 

get_block_element_attribute_count (int block_id)

 

Get the number of attributes in a block element. More...

 

double 

get_block_attribute_value (int block_id, int attribute_index)

 

Get a specific block attribute value. More...

 

std::string 

get_block_attribute_name (int block_id, int attribute_index)

 

Get a specific block attribute name. More...

 

std::vector< std::string > 

get_block_element_attribute_names (int block_id)

 

Get a specific block element attribute name. More...

 

std::vector< std::string > 

get_valid_block_element_types (int block_id)

 

Get a list of potential element types for a block. More...

 

int 

get_block_material (int block_id)

 

Get the id of the material assigned to the specified block. More...

 

std::vector< std::vector< int > > 

get_blocks_with_materials ()

 

Get the block ids and ids of the respective materials assigned to each block. More...

 

int 

get_exodus_variable_count (std::string container_type, int container_id)

 

Get the number of exodus variables in a nodeset, sideset, or block. More...

 

std::vector< std::string > 

get_exodus_variable_names (std::string container_type, int container_id)

 

Get the names of exodus variables in a nodeset, sideset, or block. More...

 

int 

get_nodeset_node_count (int nodeset_id)

 

Get the number of nodes in a nodeset. More...

 

int 

get_geometry_node_count (const std::string &entity_type, int entity_id)

 

void 

get_owning_volume_ids (const std::string &entity_type, std::vector< int > &entity_list, std::vector< int > &volume_ids)

 

Gets the id’s of the volumes that are owners of one of the specified entities. More...

 

std::string 

get_mesh_element_type (const std::string &entity_type, int entity_id)

 

Get the mesh element type contained in the specified geometry. More...

 

std::vector< std::string > 

get_mesh_error_solutions (int error_code)

 

Get the paired list of mesh error solutions and help context cues. More...

 

Boundary Condition Support

bool 

is_on_thin_shell (CI_BCTypes bc_type_enum, int entity_id)

 

Determine whether a BC is on a thin shell. Valid for temperature, convection and heatflux. More...

 

bool 

temperature_is_on_solid (CI_BCTypes bc_type_enum, int entity_id)

 

Determine whether a BC temperature is on a solid. Valid for convection and temperature. More...

 

bool 

convection_is_on_solid (int entity_id)

 

Determine whether a BC convection is on a solid. Valid for convection. More...

 

bool 

convection_is_on_shell_area (int entity_id, CI_BCEntityTypesshell_area_enum)

 

Determine whether a BC convection is on a shell top or bottom. Valid for convection. More...

 

double 

get_convection_coefficient (int entity_id, CI_BCEntityTypesbc_type_enum)

 

Get the convection coefficient. More...

 

double 

get_bc_temperature (CI_BCTypes bc_type_enum, int entity_id, CI_BCEntityTypestemp_type_enum)

 

Get the temperature. Valid for convection, temperature. More...

 

bool 

temperature_is_on_shell_area (CI_BCTypes bc_type_enum, CI_BCEntityTypesbc_area_enum, 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. More...

 

bool 

heatflux_is_on_shell_area (CI_BCEntityTypesbc_area_enum, int entity_id)

 

Determine whether a BC heatflux is on a shell area. More...

 

double 

get_heatflux_on_area (CI_BCEntityTypesbc_area_enum, int entity_id)

 

Get the heatflux on a specified area. More...

 

int 

get_cfd_type (int entity_id)

 

Get the cfd subtype for a specified cfd BC. More...

 

double 

get_contact_pair_friction_value (int entity_id)

 

Get the contact pair’s friction value. More...

 

double 

get_contact_pair_tolerance_value (int entity_id)

 

Get the contact pair’s upper bound tolerance value. More...

 

double 

get_contact_pair_tol_lower_value (int entity_id)

 

Get the contact pair’s lower bound tolerance value. More...

 

bool 

get_contact_pair_tied_state (int entity_id)

 

Get the contact pair’s tied state. More...

 

bool 

get_contact_pair_general_state (int entity_id)

 

Get the contact pair’s general state. More...

 

bool 

get_contact_pair_exterior_state (int entity_id)

 

Get the contact pair’s exterior state. More...

 

int 

get_displacement_coord_system (int entity_id)

 

Get the displacement’s coordinate system id. More...

 

const double * 

get_displacement_dof_values (int entity_id)

 

This function only available from C++ Get the displacement’s dof values More...

 

const int * 

get_displacement_dof_signs (int entity_id)

 

This function only available from C++ Get the displacement’s dof signs More...

 

const double * 

get_velocity_dof_values (int entity_id)

 

This function only available from C++ Get the velocity’s dof values More...

 

const int * 

get_velocity_dof_signs (int entity_id)

 

This function only available from C++ Get the velocity’s dof signs More...

 

std::string 

get_velocity_combine_type (int entity_id)

 

Get the velocity’s combine type which is "Overwrite", "Average", "SmallestCombine", or "LargestCombine". More...

 

const double * 

get_acceleration_dof_values (int entity_id)

 

This function only available from C++ Get the acceleration’s dof values More...

 

const int * 

get_acceleration_dof_signs (int entity_id)

 

This function only available from C++ Get the acceleration’s dof signs More...

 

std::string 

get_acceleration_combine_type (int entity_id)

 

Get the acceleration’s combine type which is "Overwrite", "Average", "SmallestCombine", or "LargestCombine". More...

 

std::string 

get_displacement_combine_type (int entity_id)

 

Get the displacement’s combine type which is "Overwrite", "Average", "SmallestCombine", or "LargestCombine". More...

 

double 

get_pressure_value (int entity_id)

 

Get the pressure value. More...

 

std::string 

get_pressure_function (int entity_id)

 

Get the pressure function. More...

 

double 

get_force_magnitude (int entity_id)

 

Get the force magnitude from a force. More...

 

double 

get_moment_magnitude (int entity_id)

 

Get the moment magnitude from a force. More...

 

std::array< double, 3 > 

get_force_direction_vector (int entity_id)

 

Get the direction vector from a force. More...

 

std::array< double, 3 > 

get_force_moment_vector (int entity_id)

 

Get the moment vector from a force. More...

 

std::string 

get_constraint_type (int constraint_id)

 

Get the type of a specified constraint. More...

 

std::string 

get_constraint_reference_point (int constraint_id)

 

Get the reference point of a specified constraint. More...

 

std::string 

get_constraint_dependent_entity_point (int constraint_id)

 

Get the dependent entity of a specified constraint. More...

 

double 

get_material_property (CI_MaterialProperty material_property_enum, int entity_id)

 

int 

get_media_property (int entity_id)

 

std::vector< std::string > 

get_material_name_list ()

 

std::vector< std::string > 

get_media_name_list ()

 

std::string 

get_material_name (int material_id)

 

Get the name of the material (or cfd media) with the given id. More...

 

double 

calculate_timestep_estimate (std::string entity_type, std::vector< int > entity_ids)

 

double 

calculate_timestep_estimate_with_props (std::string entity_type, std::vector< int > entity_id_list, double density, double youngs_modulus, double poissons_ratio)

 

std::vector< double > 

snap_locations_to_geometry (std::vector< double > locations, std::string entity_type, int entity_id, double tol)

 

std::vector< double > 

measure_between_entities (std::string entity_type1, int entity_id1, std::string entity_type2, int entity_id2)

 

void 

remove_overconstrained_tets (std::vector< int > tet_ids)

 

int 

collapse_edges (std::vector< int > edge_ids, std::string quality_name="Scaled Jacobian")

 

std::vector< int > 

gather_surfaces_by_orientation (std::vector< int > seed_surf_ids, std::vector< int > all_surf_ids)

 

void 

set_label_type (const char *entity_type, int label_flag)

 

int 

get_label_type (const char *entity_type)

 

std::vector< int > 

get_coordinate_systems_id_list ()

 

void 

compare_geometry_and_mesh (std::vector< int > volume_ids, std::vector< int > block_ids, std::vector< int > hex_ids, std::vector< int > tet_ids, double tolerance, int &returned_unmatched_volumes_count, int &returned_unmatched_elements_count, std::vector< int > &returned_full_matches_group_ids_list, std::vector< int > &returned_partial_matches_group_ids_list, int &returned_volume_curves_group_id)

 

double 

get_dbl_sculpt_default (const char *variable)

 

int 

get_int_sculpt_default (const char *variable)

 

bool 

get_bool_sculpt_default (const char *variable)

 

std::string 

get_string_sculpt_default (const char *variable)

 

double 

get_blunt_tangency_default_depth (int vert_id, double angle, bool add_material)

 

Boundary Layer Support

int 

get_next_boundary_layer_id ()

 

bool 

is_boundary_layer_id_available (int boundary_layer_id)

 

std::string 

get_boundary_layer_algorithm (int boundary_layer_id)

 

std::vector< int > 

get_boundary_layers_by_base (const std::string &base_type, int base_id)

 

std::vector< int > 

get_boundary_layers_by_pair (const std::string &base_type, int base_id, int parent_id)

 

bool 

get_boundary_layer_uniform_parameters (int boundary_layer_id, double &returned_first_row_height, double &returned_growth_factor, int &returned_number_rows)

 

bool 

get_boundary_layer_aspect_first_parameters (int boundary_layer_id, double &returned_first_row_aspect, double &returned_growth_factor, int &returned_number_rows)

 

bool 

get_boundary_layer_aspect_last_parameters (int boundary_layer_id, double &returned_first_row_height, int &returned_number_rows, double &returned_last_row_aspect)

 

bool 

get_boundary_layer_curve_surface_pairs (int boundary_layer_id, std::vector< int > &returned_curve_list, std::vector< int > &returned_surface_list)

 

bool 

get_boundary_layer_surface_volume_pairs (int boundary_layer_id, std::vector< int > &returned_surface_list, std::vector< int > &returned_volume_list)

 

bool 

get_boundary_layer_vertex_intersection_types (std::vector< int > &returned_vertex_list, std::vector< int > &returned_surface_list, std::vector< std::string > &returned_types)

 

bool 

get_boundary_layer_curve_intersection_types (std::vector< int > &returned_curve_list, std::vector< int > &returned_volume_list, std::vector< std::string > &returned_types)

 

bool 

get_boundary_layer_continuity (int boundary_layer_id)

 

std::vector< int > 

get_boundary_layer_id_list ()

 

std::vector< int > 

sizing_source_ids ()

 

Functions to support sizing source sizing function.

 

int 

next_sizing_source_id ()

 

bool 

is_sizing_source_id_available (int id)

 

double 

sizing_source_min_size ()

 

double 

sizing_source_max_size ()

 

std::array< double, 3 > 

sizing_source_scale (int id)

 

std::array< double, 3 > 

sizing_source_rotation_vector (int id)

 

double 

sizing_source_rotation_angle (int id)

 

std::array< double, 3 > 

sizing_source_origin (int id)

 

double 

sizing_source_size (int id)

 

double 

sizing_source_growth_factor (int id)

 

bool 

list_volumes_with_sizing_source (std::vector< int > &vols_with, std::vector< int > &vols_without)

 

void 

set_capture_color (bool is_captured, std::array< double, 4 > color)

 

void 

draw_curve_capture (const std::string &geometry_type, const std::vector< int > &ids, bool is_captured)

 

void 

draw_curve_capture_from_size (const std::string &geometry_type, const std::vector< int > &ids, double percent_captured, double mesh_size)

 

std::vector< CFD_BC_Entity

get_all_cfd_bcs ()

 

std::vector< AssemblyItem > 

get_assembly_items ()

 

std::vector< AssemblyItem > 

get_top_level_assembly_items ()

 

std::vector< AssemblyItem > 

get_assembly_children (int assembly_id)

 

std::vector< int > 

get_volumes_for_node (std::string node_name, int node_instance)

 

std::vector< MeshErrorFeedback * > 

get_mesh_errors ()

 

int 

get_mesh_error_count ()

 

Geometry from ids

CubitInterface::Body 

body (int id_in)

 

Gets the body object from an ID. More...

 

CubitInterface::Volume 

volume (int id_in)

 

Gets the volume object from an ID. More...

 

CubitInterface::Surface 

surface (int id_in)

 

Gets the surface object from an ID. More...

 

CubitInterface::Curve 

curve (int id_in)

 

Gets the curve object from an ID. More...

 

CubitInterface::Vertex 

vertex (int id_in)

 

Gets the vertex object from an ID. More...

 

void 

reset ()

 

Executes a reset within cubit.

 

Geometry Creation Functions

Body 

brick (double width, double depth=-1, double height=-1)

 

Creates a brick of specified width, depth, and height. More...

 

Body 

sphere (double radius, int x_cut=0, int y_cut=0, int z_cut=0, double inner_radius=0)

 

Creates all or part of a sphere. More...

 

Body 

prism (double height, int sides, double major, double minor)

 

Creates a prism of the specified dimensions. More...

 

Body 

pyramid (double height, int sides, double major, double minor, double top=0.0)

 

Creates a pyramid of the specified dimensions. More...

 

Body 

cylinder (double height, double x_radius, double y_radius, double top_radius)

 

creates a cylinder of the specified dimensions More...

 

Body 

torus (double center_radius, double swept_radius)

 

creates a torus of the specified dimensions More...

 

Vertex 

create_vertex (double x=0, double y=0, double z=0)

 

Creates a vertex at a x,y,z. More...

 

Curve 

create_curve (Vertex v0, Vertex v1)

 

Creates a curve between two vertices. More...

 

Curve 

create_arc_curve (Vertex v0, Vertex v1, std::array< double, 3 > intermediate_point)

 

Creates a arc curve using end vertices and an intermediate point. More...

 

Curve 

create_spline (std::vector< std::array< double, 3 > > points, int surface_id)

 

create spline through the given 3d points More...

 

Body 

create_surface (std::vector< Curve > curves)

 

Creates a surface from boundary curves. More...

 

std::vector< Body

sweep_curve (std::vector< Curve > curves, std::vector< Curve > along_curves, double draft_angle=0, int draft_type=0, bool rigid=false)

 

Create a Body or a set of Bodies from a swept curve. More...

 

Body 

copy_body (Body init_body)

 

Creates a copy of the input Body. More...

 

int 

create_nurbs_curve (int degree, const std::vector< double > &ctrl_pts, const std::vector< double > &weights, const std::vector< double > &knot_vec)

 

Creates a NURBS curve. More...

 

int 

create_bspline_surface (int degree_u, bool rational_u, int form_u, int pole_u, int num_ctrlpts_u, int degree_v, bool rational_v, int form_v, int pole_v, int num_ctrlpts_v, std::vector< double > ctrlpts, std::vector< double > weights, double point_tol, std::vector< double > knots_u, std::vector< double > knots_v, double knot_tol)

 

Creates a bspline surface. More...

 

Geometry Manipulation Functions

std::vector< Body

tweak_surface_offset (std::vector< Surface > surfaces, std::vector< double > distances)

 

Performs a tweak surface offset command. More...

 

std::vector< CubitInterface::Body

tweak_surface_remove (std::vector< Surface > surfaces, bool extend_ajoining=true, bool keep_old=false, bool preview=false)

 

Removes a surface from a body and extends the surrounding surfaces if extend_ajoining is true. More...

 

std::vector< CubitInterface::Body

tweak_curve_remove (std::vector< Curve > curves, bool keep_old=false, bool preview=false)

 

Removes a curve from a body and extends the surrounding surface to fill the gap. More...

 

std::vector< Body

tweak_curve_offset (std::vector< Curve > curves, std::vector< double > distances, bool keep_old=false, bool preview=false)

 

Performs a tweak curve offset command. More...

 

std::vector< Body

tweak_vertex_fillet (std::vector< Vertex > verts, double radius, bool keep_old=false, bool preview=false)

 

Performs a tweak vertex fillet command. More...

 

std::vector< Body

subtract (std::vector< CubitInterface::Body > tool_in, std::vector< CubitInterface::Body > from_in, bool imprint_in=false, bool keep_old_in=false)

 

Performs a boolean subtract operation. More...

 

std::vector< Body

unite (std::vector< CubitInterface::Body > body_in, bool keep_old_in=false)

 

Performs a boolean unite operation. More...

 

void 

move (Entity entity, std::array< double, 3 > vector, bool preview=false)

 

Moves the Entity the specified vector. More...

 

void 

scale (Entity entity, double factor, bool preview=false)

 

Scales the Entity according to the specified factor. More...

 

void 

reflect (Entity entity, std::array< double, 3 > axis, bool preview=false)

 

Reflect the Entity about the specified axis. More...

 

CubitInterface Control

const int 

CI_ERROR = -1

 

void 

init (const std::vector< std::string > &argv)

 

Use init to initialize Cubit. Using a blank list as the input parameter is acceptable. More...

 

void 

destroy ()

 

Closes the current journal file.

 

void 

process_input_files ()

 

C++ only

 

void 

set_playback_handler (ExternalPlaybackHandler *hdlr)

 

C++ only More...

 

ExternalPlaybackHandler * 

get_playback_handler ()

 

void 

enable_signal_handling (bool on)

 

initialize/uninitialize signal handling C++ only More...

 

void 

set_cubit_message_handler (CubitMessageHandler *hdlr)

 

redirect the output from cubit. More...

 

CubitMessageHandler * 

get_cubit_message_handler ()

 

get the default message handler More...

 

void 

set_ext_plugin_paths (const std::string &paths)

 

set the directory for user loaded components/plugins More...

 

void 

set_license (const char *license_str)

 

Provide a license. More...

 

void 

set_exit_handler (ExternalExitHandler *hdlr)

 

Set the exit handler. More...

 

Detailed Description

The CubitInterface provides a Python/C++ interface into Cubit.

It provides an object oriented structure that allows a developer to manipulate objects familiar to Cubit such as bodies, volumes, surfaces, etc. It also allows developers to create and manipulate as well as query geometry. Function Documentation
add_entities_to_group()

 void CubitInterface::add_entities_to_group ( int  group_id, const std::vector< int > &  entity_id, const std::string &  entity_type  )

Add a list of entities to a specific group.

cubit.add_entities_to_group(3, list, "surface")

Parameters:

group_id

ID of group to which the entity will be added

list

a vector of IDs of the entities to be added to the group

entity_type

Type of the entity to be added to the group. Note that this function is valid only for geometric entities


add_entity_to_group()

 void CubitInterface::add_entity_to_group ( int  group_id, int  entity_id, const std::string &  entity_type  )

Add a specific entity to a specific group.

cubit.add_entity_to_group(3, 22, "surface")

Parameters:

group_id

ID of group to which the entity will be added

entity_id

ID of the entity to be added to the group

entity_type

Type of the entity to be added to the group. Note that this function is valid only for geometric entities


add_filename_to_recent_file_list()

 void CubitInterface::add_filename_to_recent_file_list ( std::string &  filename)

/brief Adds the filename to the recent file list. /param filename to be added to the recent file list.
body()

 CubitInterface::Body CubitInterface::body ( int  id_in)

Gets the body object from an ID.

Parameters:

id_in

The ID of the body

Returns:
The body object
brick()

 Body CubitInterface::brick ( double  width, double  depth = -1, double  height = -1  )

Creates a brick of specified width, depth, and height.

Parameters:

[in]

width

The width of the brick being created

[in]

depth

The depth of the brick being created

[in]

height

The height of the brick being created

Returns:
A Body object of the newly created brick
calculate_timestep_estimate()

 double CubitInterface::calculate_timestep_estimate ( std::string  entity_type, std::vector< int >  entity_ids  )

/brief Calculates time step estimate on elements of/in entity type: "Tet" or "Hex" or "Volume" or "Block" or "Group" The hexes or tets must belong to a single block and that block must have a material assigned to it. That material must have elastic_modulus, poisson_ratio, and density defined.

double cubit.calculate_timestep_estimate("volume", vol_list)

Parameters:

entity_type

Specifies the entity type (hex, tet, volume, block, group)

ids

Specifies the ids of the entity type

Returns:
time step estimate (smallest time step)
calculate_timestep_estimate_with_props()

 double CubitInterface::calculate_timestep_estimate_with_props ( std::string  entity_type, std::vector< int >  entity_id_list, double  density, double  youngs_modulus, double  poissons_ratio  )

/brief Calculates time step estimate on elements of/in entity type: "Tet" or "Hex" or "Volume" or "Block" or "Group"

double cubit.calculate_timestep_estimate_with_props("volume", vol_list, 2.7, 70, 0.35 )

Parameters:

entity_type

Specifies the entity type (hex, tet, volume, block, group)

ids

Specifies the ids of the entity type

density

Specifies the density

youngs_modulus

Specifies the Young’s modulus

poissons_ratio

Specifies the Poisson’s ratio

Returns:
time step estimate (smallest time step)

cmd()

 bool CubitInterface::cmd ( const char *  input_string)

Pass a command string into Cubit.

Passing a command into Cubit using this method will result in an immediate execution of the command. The command is passed directly to Cubit without any validation or other checking.

CubitInterface::cmd("create brick x 10");

cubit.cmd("brick x 10")

Parameters:

input_string

Pointer to a string containing a complete Cubit command


collapse_edges()

 int CubitInterface::collapse_edges ( std::vector< int >  edge_ids, std::string  quality_name = "Scaled Jacobian"  )

/brief Collapses the specified edges by merging its nodes. If the collapse operation degrades the quality of surrounding triangles to worse than it was before, no collapse is performed. Calls the ’collapse edge <id>’ command. On free mesh, it tries to collapse nodes on a flatter part of the mesh, thereby preserving freatures on the skin of the free mesh.
returns the number of tris collapsed. Specifing a quality metric is optional. Supported ones are: "Scaled Jacobian" "Aspect Ratio" "Shape"
Default is "Scaled Jacobian".

edges_to_collapse = [ 15, 19, 24, 88 ]

cubit.collapse_edges( edges_to_collapse, "Shape" )


compare_geometry_and_mesh()

 void CubitInterface::compare_geometry_and_mesh ( std::vector< int >  volume_ids, std::vector< int >  block_ids, std::vector< int >  hex_ids, std::vector< int >  tet_ids, double  tolerance, int &  returned_unmatched_volumes_count, int &  returned_unmatched_elements_count, std::vector< int > &  returned_full_matches_group_ids_list, std::vector< int > &  returned_partial_matches_group_ids_list, int &  returned_volume_curves_group_id  )

/brief Compare the geometry and mesh
complete_filename()

 void CubitInterface::complete_filename ( std::string &  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.)

Parameters:

line

[in/out] the line to be completed and the completed line num_chars [out] the number of characters added to the input line. If 0 there are multiple completions found_quote [out] if the end of quote was found


contains_virtual()

 bool CubitInterface::contains_virtual ( const std::string &  geometry_type, int  entity_id  )

Query virtualality of an entity’s children.

if (CubitInterface::contains_virtual("surface", 134)) . . .

if cubit.contains_virtual("surface", 134)):

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity


convection_is_on_shell_area()

 bool CubitInterface::convection_is_on_shell_area ( int  entity_id, CI_BCEntityTypes  shell_area_enum  )

Determine whether a BC convection is on a shell top or bottom. Valid for convection.

/param entity_id Id of the BC convection /param shell_area enum of BCEntityTypes. Use 7 to check if on top, 8 to check if on bottom /return true if convection is on the shell area, otherwise false
convection_is_on_solid()

 bool CubitInterface::convection_is_on_solid ( int  entity_id)

Determine whether a BC convection is on a solid. Valid for convection.

/param entity_id Id of the BC convection /return true if convection is on a solid, otherwise false
copy_body()

 Body CubitInterface::copy_body ( Body  init_body)

Creates a copy of the input Body.

Parameters:

[in]

init_body

The Body to be copied

Returns:
A Body identical to the input Body
create_arc_curve()

 Curve CubitInterface::create_arc_curve ( Vertex  v0, Vertex  v1, std::array< double, 3 >  intermediate_point  )

Creates a arc curve using end vertices and an intermediate point.

Parameters:

[in]

v0

The start vertex

[in]

v1

The end vertex

[in]

intermediate_point

intermideate coord

Returns:
A Curve object
create_bspline_surface()

 int CubitInterface::create_bspline_surface ( int  degree_u, bool  rational_u, int  form_u, int  pole_u, int  num_ctrlpts_u, int  degree_v, bool  rational_v, int  form_v, int  pole_v, int  num_ctrlpts_v, std::vector< double >  ctrlpts, std::vector< double >  weights, double  point_tol, std::vector< double >  knots_u, std::vector< double >  knots_v, double  knot_tol  )

Creates a bspline surface.

// Create a degree 2 bspline surface

std::vector<double> pts = { 0.0, 0.0, 0.0,

5.0, 2.0, 0.0,

10.0, 0.0, 0.0,

0.0, 0.0, 5.0,

5.0, -2.0, 5.0,

10.0, 0.0, 5.0,

0.0, 0.0, 10.0,

5.0, 2.0, 10.0,

10.0, 0.0, 10.0 };

 

std::vector<double> weights = {1.0, 0.5, 1.0, 1.0, 1.0, 0.5, 0.2, 1.0, 0.1};

std::vector<double> knots_u = {0.0, 0.0, 0.0, 1.0, 1.0, 1.0};

std::vector<double> knots_v = {0.0, 0.0, 0.0, 1.0, 1.0, 1.0};

int degree_u = 2;

int degree_v = 2;

bool rational_u = true;

bool rational_v = true;

int form_u = 0;

int form_v = 0;

int pole_u = 0;

int pole_v = 0;

int num_ctrl_pts_u = 3;

int num_ctrl_pts_v = 3;

int point_tol = 0.01;

int knot_tol = 0.01;

 

int surf_id = CubitInterface::create_bspline_surface(

degree_u, rational_u, form_u, pole_u, num_ctrl_pts_u,

degree_v, rational_v, form_v, pole_v, num_ctrl_pts_v,

pts, weights, point_tol, knots_u, knots_v, knot_tol );

# Create a degree 2 bspline surface

pts = []

pts.extend([0.0, 0.0, 0.0])

pts.extend([5.0, 2.0, 0.0])

pts.extend([10.0, 0.0, 0.0])

pts.extend([0.0, 0.0, 5.0])

pts.extend([5.0, -2.0, 5.0])

pts.extend([10.0, 0.0, 5.0])

pts.extend([0.0, 0.0, 10.0])

pts.extend([5.0, 2.0, 10.0])

pts.extend([10.0, 0.0, 10.0])

 

weights = [1.0, 0.5, 1.0, 1.0, 1.0, 0.5, 0.2, 1.0, 0.1]

knots_u = [0.0, 0.0, 0.0, 1.0, 1.0, 1.0]

knots_v = [0.0, 0.0, 0.0, 1.0, 1.0, 1.0]

degree_u = 2

degree_v = 2

rational_u = True

rational_v = True

form_u = 0

form_v = 0

pole_u = 0

pole_v = 0

num_ctl_pts_u = 3

num_ctl_pts_v = 3

point_tol = 0.01

knot_tol = 0.01

 

surf_id = cubit.create_bspline_surface(degree_u, rational_u, form_u, pole_u, num_ctl_pts_u, \

degree_v, rational_u, form_u, pole_u, num_ctl_pts_v, pts, weights, point_tol, knots_u, knots_v, knot_tol)

Parameters:

[in]

degree_u/v

The degree of the bspline surface in the u/v-direction.

[in]

rational_u/v

True if surface is rational in the u/v-direction.

[in]

form_u/v

Specifies whether the surface is open (0), closed (1), or periodic (2) in the u/ direction.

[in]

pole_u/v

Indicates whether or not the surface has a singularity at the u-minimum or u-maximum parameter boundaries according to the following: 0 = > no singularity at u/v - minimum or u - maximum boundary 1 = > has a singularity at the u/v - minimum boundary 2 = > has a singularity at the u/v - maximum boundary 3 = > has a singularity at both boundaries

[in]

ctrl_pts

and weights The control points are contained in the array ctrlpts. The v index varies first. That is, a row of v control points for the first u value is found first. Then, the row of v control points for the next u value. If the surface is rational in either parameter, it is considered a rational surface and the associated weights are in the array weights. Each of the control points should be unique, except possibly the start and end points. The weight values must be positive.

[in]

point_tol

Determines when two control points are identical, and knot_tol performs the same function for the knot values.

[in]

knots_u/v

The knot sequence in u(and v) should form a non - negative, non - decreasing sequence with any knot value appearing at most degree_u(degree_v) times. In ACIS all B - spline surfaces interpolate their boundary control points. To achieve this, the end knot multiplicities are either(a) equal to the degree, or (b)equal to the degree plus one. If the end knot multiplicities are equal to the degree, then the number of knots should be equal to the number of control points plus the degree minus one num_knots = num_crtlpts + degree - 1. If the end knot multiplicities are equal to the degree plus one, then the number of knots should be equal to the number of control points plus the degree plus one num_knots = num_crtlpts + degree + 1. No assumption is made about the relationship between parameter values and object space distances; however, it is advantageous for the parameterization to be as homogeneous as possible. (That is, it is advantageous for the parameterization to be somewhat proportional to arclength.) In addition, it is advantageous for the parameterization in the two directions be of similar scale.ACIS also prefers that surfaces be G2 continuous; therefore, it may be advantageous to limit the knot multiplicities of interior knots to being less than degree - 2. The ID of the newly created surface. If surface creation was unsuccessful, returns -1.


create_curve()

 Curve CubitInterface::create_curve ( Vertex  v0, Vertex  v1  )

Creates a curve between two vertices.

Parameters:

[in]

v0

The start vertex

[in]

v1

The end vertex

Returns:
A Curve object
create_new_group()

 int CubitInterface::create_new_group ( )

Create a new group.

Returns:
group_id ID of new group
create_nurbs_curve()

 int CubitInterface::create_nurbs_curve ( int  degree, const std::vector< double > &  ctrl_pts, const std::vector< double > &  weights, const std::vector< double > &  knot_vec  )

Creates a NURBS curve.

// Create a degree 2 NURBS curve

std::vector<double> pts = { 0.0, 2.0, 0.0,

1.0, 1.0, 0.0,

-1.0, 0.0, 0.0,

0.0, -1.0, 0.0};

 

std::vector<double> weights = {1.0, 0.5, 1.0, 1.0};

std::vector<double> knot_vec = {0.0, 0.0, 0.5, 1.0, 1.0};

 

int curve_id = CubitInterface::create_nurbs_curve(2, pts, weights, knot_vec);

# Create a degree 2 NURBS curve

pts = []

pts.extend([ 0.0, 2.0, 0.0])

pts.extend([ 1.0, 1.0, 0.0])

pts.extend([-1.0, 0.0, 0.0])

pts.extend([ 0.0, -1.0, 0.0])

 

weights = [1.0, 0.5, 1.0, 1.0]

knot_vec = [0.0, 0.0, 0.5, 1.0, 1.0]

 

curve_id = cubit.create_nurbs_curve(2, pts, weights, knot_vec)

Parameters:

[in]

degree

The degree of the NURBS curve.

[in]

ctrl_pts

A list of x, y, z coordinates representing the control points. The list should be of the form [x0, y0, z0, x1, y1, z1, ... , xn, yn, zn]. The minimum size of this list must be degree + 1.

[in]

weights

A list of weights for each control point. The size of this list should be equal to the number of control points.

[in]

knot_vec

The knot vector for the curve. This size of this list should be (num_ctrl_pts + degree - 1) or (num_ctrl_pts + degree + 1). If the former, end knot multiplicity should be the same as degree. If the latter, end knot multiplicity should be degree + 1.

Returns:
The ID of the newly created curve. If curve creation was unsuccessful, returns -1.
create_spline()

 Curve CubitInterface::create_spline ( std::vector< std::array< double, 3 > >  points, int  surface_id  )

create spline through the given 3d points

Parameters:

[in]

coordinates

of points on the spline, in order

[in]

id

of the surface on which to create the spline

Returns:
the created curve object
create_surface()

 Body CubitInterface::create_surface ( std::vector< Curve >  curves)

Creates a surface from boundary curves.

Parameters:

[in]

curves

A list of curve objects from which to make the surface

Returns:
A Body object of the newly created Surface
create_vertex()

 Vertex CubitInterface::create_vertex ( double  x = 0, double  y = 0, double  z = 0  )

Creates a vertex at a x,y,z.

Parameters:

[in]

x

The x location of the vertex (default to 0)

[in]

y

The y location of the vertex (default to 0)

[in]

z

The z location of the vertex (default to 0)

Returns:
A Vertex object
curve()

 CubitInterface::Curve CubitInterface::curve ( int  id_in)

Gets the curve object from an ID.

Parameters:

id_in

The ID of the curve

Returns:
The curve object
cylinder()

 Body CubitInterface::cylinder ( double  height, double  x_radius, double  y_radius, double  top_radius  )

creates a cylinder of the specified dimensions

Parameters:

[in]

hi

the height of the cylinder

[in]

r1

radius in the x direction

[in]

r2

radius in the y direction

[in]

r3

used to adjust the top. If set to 0, will produce a cone. If set to the larger of r1 or r2 it will create a straight cylinder.

Returns:
A body object of the newly created cylinder
delete_group()

 void CubitInterface::delete_group ( int  group_id)

Delete a specific group.

Parameters:

group_id

ID of group to delete


developer_commands_are_enabled()

 bool CubitInterface::developer_commands_are_enabled ( )

This checks to see whether developer commands are enabled.

Returns:
True if developer commands are enabled, otherwise False
enable_signal_handling()

 void CubitInterface::enable_signal_handling ( bool  on)

initialize/uninitialize signal handling C++ only

Parameters:

on

Set to true to initialize signal handling, false to uninitialize.


entity_exists()

 bool CubitInterface::entity_exists ( const std::string &  entity_type, int  id  )

return whether an entity of specified ID exists

bool exists = CubitInterface::entity_exists("surface", 12);

Parameters:

entity_type

Type of the entity being queried

id

ID of entity

Returns:
true of false whether entity exists
estimate_curve_mesh_size()

 double CubitInterface::estimate_curve_mesh_size ( int  curve_id, double  percent_capture  )

Return estimated mesh size for a curve such that the sum of edge lengths are within a precentage of the curve length.

Parameters:

curve_id

The Curve to estimate mesh size percent_capture The requested percentage of capture for a curve

Returns:
The length of one mesh edge, or -1 on error.
estimate_curves_mesh_size()

 double CubitInterface::estimate_curves_mesh_size ( const std::string &  geometry_type, const std::vector< int > &  geom_id, double  percent_capture  )

Return estimated mesh size for curves related to an entity such that the sum of edge lengths are within a precentage of the curve length. The smallest size for all curves is returned.

Parameters:

geometry_type

The type of geometry entity to esitmate mesh size geom_id The Id of the geometry entity to estimate mesh size percent_capture The requested percentage of capture for a curve

Returns:
The length of one mesh edge, or -1 on error.
estimate_morph_num_procs()

 int CubitInterface::estimate_morph_num_procs ( const std::vector< int > &  volume_ids, double  size  )

Return recommended numprocs to run morph on this model at the specified size.

Parameters:

volume_ids

The Id of the volumes that will be meshed with morph size The overlay grid size

Returns:
The recommended number of procs to use for morph
estimate_morph_tet_element_count()

 size_t CubitInterface::estimate_morph_tet_element_count ( const std::vector< int > &  volume_ids, double  size, bool  keep_void  )

Return estimated tet element count for volumes.

Parameters:

volume_ids

The Id of the volumes to estimate element count size The overlay grid size keep_void Mesh the void space (e.g. air, enclosures, etc.)

Returns:
The estimated number of tet elements morph will generate
evaluate_exterior_angle()

 std::vector<int> CubitInterface::evaluate_exterior_angle ( const std::vector< int > &  curve_list, const double  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 df parser "exterior_angle" test. (draw curve with exterior_angle >90)

Parameters:

curve_list

a list of curve ids (integers)

test_angle

the value (in degrees) that will be used in testing the exterior angle

Returns:
A list (python tuple) of curve ids that meet the angle test.

evaluate_exterior_angle_at_curve()

 double CubitInterface::evaluate_exterior_angle_at_curve ( int  curve_id, int  volume_id  )

return exterior angle at a single curve with respect to a volume

Parameters:

curve

id (integer) volume id (integer)

Returns:
angle in degrees
evaluate_surface_angle_at_vertex()

 double CubitInterface::evaluate_surface_angle_at_vertex ( int  surf_id, int  vert_id  )

return interior angle at a vertex on a specified surface

Parameters:

surf

id (integer) vert id (integer)

Returns:
angle in degrees
exodus_sizing_function_file_exists()

 bool CubitInterface::exodus_sizing_function_file_exists ( )

return whether the exodus sizing funnction file exists

Returns:
whether the exodus sizing function file exists
gather_surfaces_by_orientation()

 std::vector<int> CubitInterface::gather_surfaces_by_orientation ( std::vector< int >  seed_surf_ids, std::vector< int >  all_surf_ids  )

/brief Collapses each specified triangle by finding the best two nodes to merge. If the collapse operation degrades the quality of surrounding elements to worse than it was before, no collapse is performed. Calls the ’collapse tri <id>’ command. On free mesh, it tries to collapse nodes on a flatter part of the mesh, thereby preserving freatures on the skin of the free mesh.
returns the number of tris collapsed. Specifing a quality metric is optional. Supported ones are: "Scaled Jacobian" "Aspect Ratio" "Shape"
Default is "Scaled Jacobian".

 tris_to_collapse = [ 15, 19, 24, 88 ]

cubit.collapse_tris( tris_to_collapse, "Shape" )

 

int collapse_tris(std::vector<int> tri_ids, std::string quality_name = "Scaled Jacobian");

 

/brief

Collapses each specified tet by finding the best two nodes to merge. If

the collapse operation degrades the quality of surrounding elements to worse

than it was before, no collapse is performed. Calls the 'collapse tet <id>' command.

On free mesh, it tries to collapse nodes on a flatter part of the mesh, thereby

preserving freatures on the skin of the free mesh.

returns the number of tet collapsed.

Specifing a quality metric is optional. Supported ones are:

"Altitude"

"Aspect Ratio"

"Aspect Ratio Gam"

"Distortion"

"Jacobian"

"Normalized Inradius"

"Scaled Jacobian"

"Shape"

"Timestep"

Default is "Scaled Jacobian".

\code

tets_to_collapse = [ 15, 19, 24, 88 ]

cubit.collapse_tets( tets_to_collapse, "Shape" )

 

int collapse_tets(std::vector<int> tet_ids, std::string quality_name = "Scaled Jacobian");

 

 

/brief

Gathers connected surfaces to those in 'seed_surf_ids' that

use common curves in an opposite sense. For example, if a surface A

in 'seed_surf_ids' uses a curve in the FORWARD sense and it can find

surface, B, that uses that same curve in a REVERSED sense, it adds B

to the list. The search continues with all of surface B's curves.

All the surfaces in 'seed_surf_ids' will be returned. If the user

wants to limit the scope of possible surfaces that are searched,

'all_surf_ids' can be populated. If 'all_surf_ids' is empty, all

surfaces are candidates.

This function can be helpful in finding enclosures when you have a set

of non-manifold surfaces.

\code

seed_surf_ids = [ 15, 19, 24, 88 ]

all_surf_ids = [ 15, 19, 24, 88, 26, 104, 44, 23, 95, 342, 533, 23, ... ]

orientation_surfs = cubit.gather_surfaces_by_orientation( seed_surf_ids, all_surf_ids )


get_acceleration_combine_type()

 std::string CubitInterface::get_acceleration_combine_type ( int  entity_id)

Get the acceleration’s combine type which is "Overwrite", "Average", "SmallestCombine", or "LargestCombine".

/param entity_id Id of the acceleration /return The combine type for the given acceleration
get_acceleration_dof_signs()

 const int* CubitInterface::get_acceleration_dof_signs ( int  entity_id)

This function only available from C++ Get the acceleration’s dof signs

/param entity_id Id of the acceleration /return An array of ints which are the dof signs
get_acceleration_dof_values()

 const double* CubitInterface::get_acceleration_dof_values ( int  entity_id)

This function only available from C++ Get the acceleration’s dof values

/param entity_id Id of the acceleration /return An array of doubles which are the dof values
get_acis_version()

 std::string CubitInterface::get_acis_version ( )

Get the Acis version number.

Returns:
A string containing the Acis version number
get_acis_version_as_int()

 int CubitInterface::get_acis_version_as_int ( )

Get the Acis version number as an int.

Returns:
An integer containing the Acis version number
get_adjacent_surfaces()

 std::vector<int> CubitInterface::get_adjacent_surfaces ( const std::string &  geometry_type, int  entity_id  )

Get a list of adjacent surfaces to a specified entity.

For a specified entity, find all surfaces that own the entity and surfaces that touch the surface that owns this entity.

std::vector<int> surface_id_list;

surface_id_list = CubitInterface::get_adjacent_surfaces("curve", 22);

surface_id_list = cubit.get_adjacent_surfaces("curve", 22)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
A list (python tuple) of surfaces ids
get_adjacent_volumes()

 std::vector<int> CubitInterface::get_adjacent_volumes ( const std::string &  geometry_type, int  entity_id  )

Get a list of adjacent volumes to a specified entity.

For a specified entity, find all volumes that own the entity and volumes that touch the volume that owns this entity.

std::vector<int> volume_id_list;

volume_id_list = CubitInterface::get_adjacent_volumes("curve", 22);

volume_id_list = cubit.get_adjacent_volumes("curve", 22)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
A list (python tuple) of volume ids
get_all_exodus_times()

 std::vector<double> CubitInterface::get_all_exodus_times ( const std::string &  filename)

Open an exodus file and get a vector of all stored time stamps.

Parameters:

filename

Fully qualified exodus file name

Returns:
List (python tuple) of time stamps in the exodus file
get_all_exodus_variable_names()

 std::vector<std::string> CubitInterface::get_all_exodus_variable_names ( const std::string &  filename, const std::string &  variable_type  )

Open an exodus file and get a list of all stored variable names.

Parameters:

filename

Fully qualified exodus file name

type

Variable type - ’g’, ’n’, or ’e’

Returns:
List (python tuple) of variable names in the exodus file
get_all_geometric_owners()

 std::vector<std::string> CubitInterface::get_all_geometric_owners ( std::string  mesh_entity_type, std::string  mesh_entity_list  )

Get a list of geometric owners given a list of mesh entities. returns geometric owners of entity as well as all of its child mesh entities.

std::vector<std::string> owner_list;

owner_list = CubitInterface::get_all_geometric_owners("quad", id_list);

owner_list = cubit.get_all_geometric_owners("quad", id_list)

Parameters:

mesh_entity_type

The type of mesh entity. Works for ’quad, ’face’, ’tri’, ’hex’, ’tet’, ’edge’, ’node’

mesh_entity_list

A string containing space delimited ids, Cubit command form (i.e. ’all’, ’1 to 8’, ’1 2 3’, etc)

Returns:
A list (python tuple) of geometry owners in the form of ’surface x’, ’curve y’, etc.
get_aprepro_numeric_value()

 double CubitInterface::get_aprepro_numeric_value ( std::string  variable_name)

get the value of the given aprepro variable

Returns:
value as double on failure returns CUBIT_DBL_MAX
get_aprepro_value()

 bool CubitInterface::get_aprepro_value ( std::string  variable_name, int &  returned_variable_type, double &  returned_double_val, std::string &  returned_string_val  )

Get the value of an aprepro variable.

Parameters:

var_name

aprepro variable name

var_type

return 0, 1 or 3 where 0=undefined 1=double/int 2=string

dval

return integer or double value if var_type=1

sval

return string if var_type=2

Returns:
1 = success, 0 = failure (no such variable name)
get_aprepro_value_as_string()

 std::string CubitInterface::get_aprepro_value_as_string ( std::string  variable_name)

Gets the string value of an aprepro variable.

/param var_name aprepro variable name /return The string value of the aprepro variable name
get_aprepro_vars()

 std::vector<std::string> CubitInterface::get_aprepro_vars ( )

Gets the current aprepro variable names.

/return A list (python tuple) of the current aprepro variable names
get_arc_length()

 double CubitInterface::get_arc_length ( int  curve_id)

Get the arc length of a specified curve.

Parameters:

curve_id

ID of the curve

Returns:
Arc length of the curve
get_assembly_classification_category()

 std::string CubitInterface::get_assembly_classification_category ( )

Get Classification Category for metadata.

Returns:
Requested data
get_assembly_classification_level()

 std::string CubitInterface::get_assembly_classification_level ( )

Get Classification Level for metadata.

Returns:
Requested data
get_assembly_description()

 std::string CubitInterface::get_assembly_description ( int  assembly_id)

Get the stored description of an assembly node.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
Description of the assembly node
get_assembly_file_format()

 std::string CubitInterface::get_assembly_file_format ( int  assembly_id)

Get the stored file format of an assembly node.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
File Format of the assembly node
get_assembly_instance()

 int CubitInterface::get_assembly_instance ( int  assembly_id)

Get the stored instance number of an assembly node.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
Instance of the assembly node
get_assembly_level()

 int CubitInterface::get_assembly_level ( int  assembly_id)

Get the stored level of an assembly node.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
Level of the assembly node - Level == 0 == Root
get_assembly_material_description()

 std::string CubitInterface::get_assembly_material_description ( int  assembly_id)

Get the stored material description of an assembly part.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
Material Description of the assembly part
get_assembly_material_specification()

 std::string CubitInterface::get_assembly_material_specification ( int  assembly_id)

Get the stored material specification of an assembly part.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
Material Specification of the assembly part
get_assembly_metadata()

 std::string CubitInterface::get_assembly_metadata ( int  volume_id, int  data_type  )

Get metadata for a specified volume id.

Parameters:

volume_id

ID of the volume

data_type

Magic number representing the type of assembly information to return. 1 = Part Number, 2 = Description, 3 = Material Description 4 = Material Specification, 5 = Assembly Path, 6 = Original File

Returns:
Requested data
get_assembly_name()

 std::string CubitInterface::get_assembly_name ( int  assembly_id)

Get the stored name of an assembly node.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
Name of the assembly node
get_assembly_path()

 std::string CubitInterface::get_assembly_path ( int  assembly_id)

Get the stored path of an assembly node.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
Path of the assembly node
get_assembly_type()

 std::string CubitInterface::get_assembly_type ( int  assembly_id)

Get the stored type of an assembly node.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
Type of the assembly node – ’part’ or ’assembly’
get_assembly_units()

 std::string CubitInterface::get_assembly_units ( int  assembly_id)

Get the stored units measure of an assembly node.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
Units of the assembly node
get_assembly_weapons_category()

 std::string CubitInterface::get_assembly_weapons_category ( )

Get Weapons Category for metadata.

Returns:
Requested data
get_auto_size()

 double CubitInterface::get_auto_size ( const std::string &  geometry_type, std::vector< int >  entity_id_list, double  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.

Parameters:

entity_type

Specifies the geometry type of the entity

enitty_id_list

List (vector) of entity ids

size

The auto factor for the AutoSizeTool

Returns:
The interval size from the AutoSizeTool
get_bad_geometry()

 void CubitInterface::get_bad_geometry ( std::vector< int >  target_volume_ids, std::vector< int > &  returned_body_list, std::vector< int > &  returned_volume_list, std::vector< int > &  returned_surface_list, std::vector< int > &  returned_curve_list  )

This function only works from C++ Get the list of bad geometry for a list of volumes

Bad geometry can be any number of problems associated with poorly defined ACIS geometry.

Parameters:

target_volume_ids

List of volume ids to examine.

body_list

User specified list where ids of bad bodies will be returned

volume_list

User specified list where ids of bad volumes will be returned

surface_list

User specified list where ids of bad surfaces will be returned

curve_list

User specified list where ids of bad curves will be returned


get_bc_id_list()

 std::vector<int> CubitInterface::get_bc_id_list ( CI_BCTypes  bc_type_enum)

Get a list of all bcs of a specified type.

Parameters:

bc_type_in

as an enum defined by CI_BCTypes. 1-9 is FEA, 10-30 is CFD

Returns:
List (python tuple) of all active bc ids
get_bc_name()

 std::string CubitInterface::get_bc_name ( CI_BCTypes  bc_type_enum, int  bc_id  )

Get the name for the specified bc.

Parameters:

bc_type_in

type of bc, as defined by enum CI_BCTypes. 1-9 is FEA, 10-30 is CFD

bc_id

ID of the desired bc.

Returns:
The bc name
get_bc_temperature()

 double CubitInterface::get_bc_temperature ( CI_BCTypes  bc_type_enum, int  entity_id, CI_BCEntityTypes  temp_type_enum  )

Get the temperature. Valid for convection, temperature.

/param bc_type enum of CI_BCTypes. temperature = 4, convection = 7 /param entity_id Id of the BC convection /param temp_type enum of CI_BCEntityTypes (normal, shell top, shell bottom). For convection, 2 if on solid, 7 if on top, 8 if on bottom. For temperature, 3 if on solid, 7 for top, 8 for bottom, 9 for gradient, 10 for middle /return The value of the specified BC temperature
get_blend_surfaces()

 std::vector<int> CubitInterface::get_blend_surfaces ( std::vector< int >  target_volume_ids)

Get the list of blend surfaces for a list of volumes.

Parameters:

target_volume_ids

List of volume ids to examine.

Returns:
List (python tuple) of blend surface ids
get_block_attribute_count()

 int CubitInterface::get_block_attribute_count ( int  block_id)

Get the number of attributes in a block.

Parameters:

block_id

The block id

Returns:
Number of attributes in the block
get_block_attribute_name()

 std::string CubitInterface::get_block_attribute_name ( int  block_id, int  attribute_index  )

Get a specific block attribute name.

Parameters:

block_id

The block id

index

The index of the attribute

Returns:
Attribute name as a std::string
get_block_attribute_value()

 double CubitInterface::get_block_attribute_value ( int  block_id, int  attribute_index  )

Get a specific block attribute value.

Parameters:

block_id

The block id

index

The index of the attribute

Returns:
List of attributes
get_block_children()

 void CubitInterface::get_block_children ( int  block_id, std::vector< int > &  returned_group_list, std::vector< int > &  returned_node_list, std::vector< int > &  returned_sphere_list, std::vector< int > &  returned_edge_list, std::vector< int > &  returned_tri_list, std::vector< int > &  returned_face_list, std::vector< int > &  returned_pyramid_list, std::vector< int > &  returned_tet_list, std::vector< int > &  returned_hex_list, std::vector< int > &  returned_wedge_list, std::vector< int > &  returned_volume_list, std::vector< int > &  returned_surface_list, std::vector< int > &  returned_curve_list, std::vector< int > &  returned_vertex_list  )

Get lists of any and all possible children of a block.

A block can contain a variety of entity types. This routine will return all contents of a specified block.

Parameters:

block_id

ID of block to examine

group_list

User specified list where groups associated with this block are returned

node_list

User specified list where nodes associated with this block are returned

edge_list

User specified list where edges associated with this block are returned

tri_list

User specified list where tris associated with this block are returned

face_list

User specified list where faces associated with this block are returned

pyramid_list

User specified list where pyramids associated with this block are returned

tet_list

User specified list where tets associated with this block are returned

hex_list

User specified list where hexes associated with this block are returned

volume_list

User specified list where volumes associated with this block are returned

surface_list

User specified list where surfaces associated with this block are returned

curve_list

User specified list where curves associated with this block are returned

vertex_list

User specified list where vertices associated with this block are returned


get_block_count()

 int get_block_count ( )

Get the current number of blocks.

Returns:
The number of blocks in the current model, if any
get_block_curves()

 std::vector<int> CubitInterface::get_block_curves ( int  block_id)

Get a list of curve associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of curve ids contained in the block
get_block_edges()

 std::vector<int> CubitInterface::get_block_edges ( int  block_id)

Get a list of edges associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of edge ids contained in the block
get_block_element_attribute_count()

 int CubitInterface::get_block_element_attribute_count ( int  block_id)

Get the number of attributes in a block element.

Parameters:

block_id

The block id

Returns:
Number of attributes in the block element
get_block_element_attribute_names()

 std::vector< std::string > CubitInterface::get_block_element_attribute_names ( int  block_id)

Get a specific block element attribute name.

Parameters:

block_id

The block id

index

The index of the attribute

Returns:
Attribute name as a std::string
get_block_element_type()

 std::string CubitInterface::get_block_element_type ( int  block_id)

Get the element type of a block.

Parameters:

block_id

The block id

Returns:
Element type
get_block_elements_and_nodes()

 bool CubitInterface::get_block_elements_and_nodes ( int  block_id, std::vector< int > &  returned_node_list, std::vector< int > &  returned_sphere_list, std::vector< int > &  returned_edge_list, std::vector< int > &  returned_tri_list, std::vector< int > &  returned_face_list, std::vector< int > &  returned_pyramid_list, std::vector< int > &  returned_wedge_list, std::vector< int > &  returned_tet_list, std::vector< int > &  returned_hex_list  )

Get lists of the nodes and different element types associated with this block. This function is recursive, meaning that if the block was created pointing to a piece of geometry, it will traverse down and get the mesh entities associated to that geometry.

Parameters:

block_id

User specified id of the desired block A list (python tuple) of node ids contained in the block A list (python tuple) of edge ids contained in the block A list (python tuple) of tri ids contained in the block A list (python tuple) of quad ids contained in the block A list (python tuple) of pyramid ids contained in the block A list (python tuple) of wedge ids contained in the block A list (python tuple) of tet ids contained in the block A list (python tuple) of hex ids contained in the block

Returns:
true for success, otherwise false
get_block_faces()

 std::vector<int> CubitInterface::get_block_faces ( int  block_id)

Get a list of faces associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of face ids contained in the block
get_block_hexes()

 std::vector<int> CubitInterface::get_block_hexes ( int  block_id)

Get a list of hexes associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of hex ids contained in the block
get_block_id()

 int CubitInterface::get_block_id ( std::string  entity_type, int  entity_id  )

Get the associated block id for a specific curve, surface, or volume.

int block_id = CubitInterface::get_block_id("surface", 33);

block_id = cubit.get_block_id("surface", 33)

Parameters:

entity_type

Type of entity

entity_id

Id of entity in question

Returns:
Block id associated with this entity or zero (0) if none
get_block_id_list()

 std::vector<int> CubitInterface::get_block_id_list ( )

Get a list of all blocks.

Returns:
List (python tuple) of all active block ids
get_block_ids()

 std::vector<int> CubitInterface::get_block_ids ( const std::string &  mesh_geometry_file_name)

Get list of block ids from a mesh geometry file.

Parameters:

mesh_geom_file_name

Fully qualified name of a mesh geometry file

Returns:
List of block ids in the mesh geometry file
get_block_material()

 int CubitInterface::get_block_material ( int  block_id)

Get the id of the material assigned to the specified block.

Returns:
The material id. If no material has been assigned to the block, returns 0.
get_block_nodes()

 std::vector<int> CubitInterface::get_block_nodes ( int  block_id)

Get a list of nodes associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of node ids contained in the block
get_block_pyramids()

 std::vector<int> CubitInterface::get_block_pyramids ( int  block_id)

Get a list of pyramids associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of pyramid ids contained in the block
get_block_surfaces()

 std::vector<int> CubitInterface::get_block_surfaces ( int  block_id)

Get a list of surface associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of surface ids contained in the block
get_block_tets()

 std::vector<int> CubitInterface::get_block_tets ( int  block_id)

Get a list of tets associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of tet ids contained in the block
get_block_tris()

 std::vector<int> CubitInterface::get_block_tris ( int  block_id)

Get a list of tris associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of tri ids contained in the block
get_block_vertices()

 std::vector<int> CubitInterface::get_block_vertices ( int  block_id)

Get a list of vertices associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of vertex ids contained in the block
get_block_volumes()

 std::vector<int> CubitInterface::get_block_volumes ( int  block_id)

Get a list of volume ids associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of volume ids contained in the block
get_block_wedges()

 std::vector<int> CubitInterface::get_block_wedges ( int  block_id)

Get a list of wedges associated with a specific block.

Parameters:

block_id

User specified id of the desired block

Returns:
A list (python tuple) of wedges ids contained in the block
get_blocks_with_materials()

 std::vector<std::vector<int> > CubitInterface::get_blocks_with_materials ( )

Get the block ids and ids of the respective materials assigned to each block.

Returns:
List of tuples ([block_1_id, material_1_id], [block_2_id, material_2_id], ...) for each block, whether or not it has a material. If no material has been assigned to the block, returns 0.
get_blunt_tangency_default_depth()

 double CubitInterface::get_blunt_tangency_default_depth ( int  vert_id, double  angle, bool  add_material  )

/brief get default depth value for blunt tangency operation /return depth
get_body_count()

 int CubitInterface::get_body_count ( )

Get the current number of bodies.

Returns:
The number of bodies in the current model, if any
get_bounding_box()

 std::array<double, 10> CubitInterface::get_bounding_box ( const std::string &  geometry_type, int  entity_id  )

Get the bounding box for a specified entity.

std::array<double, 10> vector_list;

vector_list = CubitInterface::get_bounding_box("surface", 22);

vector_list = cubit.get_bounding_box("surface", 22)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
A vector (python tuple) of coordinates describing the entity’s bounding box. Ten (10) values will be: [0] = minx [1] = maxx [2] = boxx range [3] = miny [4] = maxy [5] = boxy range [6] = minz [7] = maxz [8] = boxz range [9] = box diagonal length
get_build_number()

 std::string CubitInterface::get_build_number ( )

Get the Cubit build number.

Returns:
A string containing the current Cubit build number
get_center_point()

 std::array<double,3> CubitInterface::get_center_point ( const std::string &  entity_type, int  entity_id  )

Get the center point of a specified entity.

std::array<double,3> center_point;

center_point = CubitInterface::get_center_point("surface", 22);

center_point = cubit.get_center_point("surface", 22)

Parameters:

entity_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
Vector (python tuple) of doubles representing x y z
get_cfd_type()

 int CubitInterface::get_cfd_type ( int  entity_id)

Get the cfd subtype for a specified cfd BC.

Parameters:

entity_id

ID of the cfd BC

Returns:
Integer corresponding to the type of cfd, as defined by CI_BCTypes
get_chamfer_surfaces()

 std::vector<std::vector<double> > CubitInterface::get_chamfer_surfaces ( std::vector< int >  target_volume_ids, double  thickness_threshold  )

Get the list of chamfer surfaces for a list of volumes.

Parameters:

target_volume_ids

List of volume ids to examine.

thickness_threshold

max thickness criteria for chamfer

Returns:
List (python tuple) of chamfer surface ids (as doubles) and their thicknesses
get_close_loop_thickness()

 double CubitInterface::get_close_loop_thickness ( int  surface_id)

Get the thickness of a close loop surface.

Parameters:

surafce

id

Returns:
List (python tuple) of close loop (surface) ids
get_close_loops()

 std::vector<int> CubitInterface::get_close_loops ( std::vector< int >  target_volume_ids, double  mesh_size  )

Get the list of close loops (surfaces) for a list of volumes.

’Small’ or ’Close’ is a function of the mesh_size passed into the routine. The mesh_size parameter will act as the threshold for determining what ’small’ is. A small entity is one that has an edge length smaller than mesh_size.

Parameters:

target_volume_ids

List of volume ids to examine.

mesh_size

Indicate the mesh size used as the threshold

Returns:
List (python tuple) of close loop (surface) ids
get_close_loops_with_thickness()

 std::vector<std::vector<double> > CubitInterface::get_close_loops_with_thickness ( std::vector< int >  target_volume_ids, double  mesh_size, int  genus  )

Get the list of close loops (surfaces) for a list of volumes also return the corresponding minimum distances for each surface.

’Small’ or ’Close’ is a function of the mesh_size passed into the routine. The mesh_size parameter will act as the threshold for determining what ’small’ is. A small entity is one that has an edge length smaller than mesh_size.

Parameters:

target_volume_ids

List of volume ids to examine.

mesh_size

Indicate the mesh size used as the threshold

genus

Indicate the genus of the surfaces requested. Genus is defined as the number of loops on the surface minus 1. To return any genus surface in the volume(s), use genus < 0

Returns:
List (python tuple) of close loop (surface) ids
get_close_vertex_curve_pairs()

 std::vector<int> CubitInterface::get_close_vertex_curve_pairs ( std::vector< int >  target_volume_ids, double  high_tolerance  )

Get the list of close vertex-curve pairs (python callable)

Parameters:

target_volume_list

List of volumes ids to examine.

Returns:
Paired list (python tuple) of vertex and curve ids considered coincident
get_closed_narrow_surfaces()

 std::vector<int> CubitInterface::get_closed_narrow_surfaces ( std::vector< int >  target_ids, double  narrow_size  )

Get the list of closed, narrow surfaces from a list of volumes.

Parameters:

target_volume_ids

List of volume ids to examine.

narrow_size

Indicate the narrow size threshold

Returns:
List (python tuple) of close, narrow surface ids
get_closest_node()

 int CubitInterface::get_closest_node ( double  x_coordinate, double  y_coordinate, double  z_coordinate  )

Get the node closest to the given coordinates.

Parameters:

x

coordinate

y

coordinate

z

coordinate

Returns:
id of closest node, 0 if none found
get_coincident_vertices()

 std::vector<int> CubitInterface::get_coincident_vertices ( std::vector< int >  target_volume_ids, double  high_tolerance  )

Get the list of coincident vertex pairs

Parameters:

target_volume_list

List of volumes ids to examine.

Returns:
Paired list (python tuple) of vertex ids considered coincident
get_command_from_history()

 std::string CubitInterface::get_command_from_history ( int  command_number)

Get a specific command from Cubit’s command history buffer.

Returns:
A string which is the command at the given index
get_common_curve_id()

 int CubitInterface::get_common_curve_id ( int  surface_1_id, int  surface_2_id  )

Given 2 surfaces, get the common curve id.

Parameters:

surface_1_id

The id of one of the surfaces

surface_2_id

The id of the other surface

Returns:
The id of the curve common to the two surfaces
get_common_vertex_id()

 int CubitInterface::get_common_vertex_id ( int  curve_1_id, int  curve_2_id  )

Given 2 curves, get the common vertex id.

Parameters:

curve_1_id

The id of one of the curves

curve_2_id

The id of the other curves

Returns:
The id of the vertex common to the two curves, 0 if there is none
get_cone_surfaces()

 std::vector<int> CubitInterface::get_cone_surfaces ( std::vector< int >  target_volume_ids)

return a list of surfaces that are cones defined by a conic surface and a hard point

Parameters:

target_volume_ids

List of volume ids to examine.


get_connectivity()

 std::vector<int> CubitInterface::get_connectivity ( const std::string &  entity_type, int  entity_id  )

Get the list of node ids contained within a mesh entity.

std::vector<int> node_id_list;

node_id_list = CubitInterface::get_connectivity("hex", 221);

node_id_list = cubit.get_connectivity("hex", 221)

Parameters:

entity_type

The mesh element type

entity_id

The mesh element id

Returns:
List (python tuple) of node ids
get_constraint_dependent_entity_point()

 std::string CubitInterface::get_constraint_dependent_entity_point ( int  constraint_id)

Get the dependent entity of a specified constraint.

Parameters:

constraint_id

ID of the constraint

Returns:
A std::string indicating the dependent entity
get_constraint_reference_point()

 std::string CubitInterface::get_constraint_reference_point ( int  constraint_id)

Get the reference point of a specified constraint.

Parameters:

constraint_id

ID of the constraint

Returns:
A std::string indicating the reference point
get_constraint_type()

 std::string CubitInterface::get_constraint_type ( int  constraint_id)

Get the type of a specified constraint.

Parameters:

constraint_id

ID of the constraint

Returns:
A std::string indicating the type – Kinematic, Distributing, Rigidbody
get_contact_pair_exterior_state()

 bool CubitInterface::get_contact_pair_exterior_state ( int  entity_id)

Get the contact pair’s exterior state.

/param entity_id Id of the contact pair /return The exterior state of the contact pair
get_contact_pair_friction_value()

 double CubitInterface::get_contact_pair_friction_value ( int  entity_id)

Get the contact pair’s friction value.

/param entity_id Id of the contact pair /return The friction value of the contact pair
get_contact_pair_general_state()

 bool CubitInterface::get_contact_pair_general_state ( int  entity_id)

Get the contact pair’s general state.

/param entity_id Id of the contact pair /return The general state of the contact pair
get_contact_pair_tied_state()

 bool CubitInterface::get_contact_pair_tied_state ( int  entity_id)

Get the contact pair’s tied state.

/param entity_id Id of the contact pair /return The tied state of the contact pair
get_contact_pair_tol_lower_value()

 double CubitInterface::get_contact_pair_tol_lower_value ( int  entity_id)

Get the contact pair’s lower bound tolerance value.

/param entity_id Id of the contact pair /return The tolerance value of the contact pair
get_contact_pair_tolerance_value()

 double CubitInterface::get_contact_pair_tolerance_value ( int  entity_id)

Get the contact pair’s upper bound tolerance value.

/param entity_id Id of the contact pair /return The tolerance value of the contact pair
get_convection_coefficient()

 double CubitInterface::get_convection_coefficient ( int  entity_id, CI_BCEntityTypes  bc_type_enum  )

Get the convection coefficient.

/param entity_id Id of the BC convection /param cc_type enum of CI_BCEntityTypes (1-normal, 5-shell top, 6-shell bottom) /return The value of the convection coefficient
get_coordinate_systems_id_list()

 std::vector<int> CubitInterface::get_coordinate_systems_id_list ( )

/brief get a list of coordinate system ids

/return List (python tuple) of ids
get_copy_block_on_geometry_copy_setting()

 std::string CubitInterface::get_copy_block_on_geometry_copy_setting ( )

Get the copy nodeset on geometry copy setting.

Returns:
copy nodeset setting
get_copy_nodeset_on_geometry_copy_setting()

 std::string CubitInterface::get_copy_nodeset_on_geometry_copy_setting ( )

Get the copy nodeset on geometry copy setting.

Returns:
copy nodeset setting
get_copy_sideset_on_geometry_copy_setting()

 std::string CubitInterface::get_copy_sideset_on_geometry_copy_setting ( )

Get the copy nodeset on geometry copy setting.

Returns:
copy nodeset setting
get_cubfile_journal()

 std::vector<std::string> CubitInterface::get_cubfile_journal ( )

Gets the journal embeded in the last cubit file loaded.

Returns:
The journal embeded in the last cubit file loaded.
get_cubit_digits_setting()

 double CubitInterface::get_cubit_digits_setting ( )

Get the Cubit digits setting.

Returns:
A double containing the digits. -1 if no digits are set
get_cubit_message_handler()

 CubitMessageHandler* CubitInterface::get_cubit_message_handler ( )

get the default message handler

Parameters:


get_current_journal_file()

 std::string CubitInterface::get_current_journal_file ( )

Gets the current journal file name.

Returns:
The current journal file name.
get_curve_bias_coarse_size()

 double CubitInterface::get_curve_bias_coarse_size ( int  curve_id)

Get the bias coarse size of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias coarse size of the curve.
get_curve_bias_fine_size()

 double CubitInterface::get_curve_bias_fine_size ( int  curve_id)

Get the bias fine size of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias fine size of the curve.
get_curve_bias_first_interval_fraction()

 double CubitInterface::get_curve_bias_first_interval_fraction ( int  curve_id)

Get the bias first interval fraction of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias first interval fraction of the curve.
get_curve_bias_first_interval_length()

 double CubitInterface::get_curve_bias_first_interval_length ( int  curve_id)

Get the bias first interval length of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias first interval length of the curve.
get_curve_bias_first_last_ratio1()

 double CubitInterface::get_curve_bias_first_last_ratio1 ( int  curve_id)

Get the bias first/last ratio at start of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias coarse size of the curve.
get_curve_bias_first_last_ratio2()

 double CubitInterface::get_curve_bias_first_last_ratio2 ( int  curve_id)

Get the bias first/last ratio at end of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias coarse size of the curve.
get_curve_bias_from_start()

 bool CubitInterface::get_curve_bias_from_start ( int  curve_id, bool &  value  )

Get whether the bias is from the start of a curve

Parameters:

curve_id

Specifies the id of the curve

value

Returns whether the bias is from the start of the curve.

Returns:
True/False A curve with the curve_id exists.
get_curve_bias_from_start_set()

 bool CubitInterface::get_curve_bias_from_start_set ( int  curve_id)

Get whether the bias from the start of a curve settings has been set

Parameters:

curve_id

Specifies the id of the curve

value

Returns whether the bias from the start of the curve settings has been set.

Returns:
True/False A curve with the curve_id exists.
get_curve_bias_geometric_factor()

 double CubitInterface::get_curve_bias_geometric_factor ( int  curve_id)

Get the first bias geometric factor of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias geometric factor of the curve.
get_curve_bias_geometric_factor2()

 double CubitInterface::get_curve_bias_geometric_factor2 ( int  curve_id)

Get the second bias geometric factor of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias geometric factor of the curve.
get_curve_bias_last_first_ratio1()

 double CubitInterface::get_curve_bias_last_first_ratio1 ( int  curve_id)

Get the bias last/first ratio at start of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias coarse size of the curve.
get_curve_bias_last_first_ratio2()

 double CubitInterface::get_curve_bias_last_first_ratio2 ( int  curve_id)

Get the bias last/first ratio at end of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias coarse size of the curve.
get_curve_bias_start_vertex_id()

 int CubitInterface::get_curve_bias_start_vertex_id ( int  curve_id)

Get the bias start vertex id of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias start vertex id of a curve.
get_curve_bias_type()

 std::string CubitInterface::get_curve_bias_type ( int  curve_id)

Get the bias type of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The bias type of the curve.
get_curve_center()

 std::array<double,3> CubitInterface::get_curve_center ( int  curve_id)

Get the center point of the arc.

Parameters:

curve_id

ID of the curve

Returns:
x, y, z center point of the curve in a vector (python tuple)
get_curve_count()

 int CubitInterface::get_curve_count ( )

Get the current number of curves.

Returns:
The number of curves in the current model, if any
get_curve_count_in_volumes()

 int CubitInterface::get_curve_count_in_volumes ( std::vector< int >  target_volume_ids)

Get the current number of curves in the passed-in volumes.

Returns:
The number of curves in the volumes
get_curve_edges()

 std::vector<int> CubitInterface::get_curve_edges ( int  curve_id)

get the list of any edge elements on a given curve

Parameters:

curve_id

User specified id of the desired curve

Returns:
A list (python tuple) of the edge element ids on the curve
get_curve_length()

 double CubitInterface::get_curve_length ( int  curve_id)

Get the length of a specified curve.

Parameters:

curve_id

ID of the curve

Returns:
Length of the curve
get_curve_mesh_scheme_curvature()

 double CubitInterface::get_curve_mesh_scheme_curvature ( int  curve_id)

Get the curvature mesh scheme value of a curve.

Parameters:

curve_id

Specifies the id of the curve

Returns:
The curvature mesh scheme value of a curve.
get_curve_mesh_scheme_pinpoint_locations()

 std::vector<double> CubitInterface::get_curve_mesh_scheme_pinpoint_locations ( int  curve_id)

Get the pinpoint mesh scheme locations of a curve

Parameters:

curve_id

Specifies the id of the curve

Returns:
The pinpoint mesh scheme locations for a curve.
get_curve_mesh_scheme_stretch_values()

 bool CubitInterface::get_curve_mesh_scheme_stretch_values ( int  curve_id, double &  first_size, double &  factor, double &  last_size, bool &  start, int &  vertex_id  )

Get the stretch mesh scheme values of a curve

Parameters:

curve_id

Specifies the id of the curve

first_size

Returns the first_size

factor

Returns the factor

last_size

Returns the last_size

start

Returns whether the scheme is from the start of the curve.

vertex_id

Returns the vertex id used for the start of the scheme.

Returns:
True/False A curve with the curve_id exists.
get_curve_nodes()

 std::vector<int> CubitInterface::get_curve_nodes ( int  curve_id)

Get list of node ids owned by a curve.
Excludes nodes owned by bounding vertices.

int curv_id = 12;

vector<int> curve_nodes = CubitInterface::get_curve_nodes(curv_id);

Parameters:

curv_id

id of curve

Returns:
List (python tuple) of IDs of nodes owned by the curve

get_curve_radius()

 double CubitInterface::get_curve_radius ( int  curve_id)

Get the radius of a specified arc.

Parameters:

curve_id

ID of the curve

Returns:
Radius of the curve
get_curve_type()

 std::string CubitInterface::get_curve_type ( int  curve_id)

Get the curve type for a specified curve.

Parameters:

curve_id

ID of the curve

Returns:
Type of curve
get_dbl_sculpt_default()

 double CubitInterface::get_dbl_sculpt_default ( const char *  variable)

/brief return sculpt default value
get_default_element_type()

 std::string CubitInterface::get_default_element_type ( )

Get the current default setting for the element type that will be used when meshing.

Returns:
A string indicating the default mesh type:
  • "tri" indicates a tri/tet mesh default

  • "hex" indicates a quad/hex mesh default

  • "none" indicates no default has been assigned


get_default_geometry_engine()

 std::string CubitInterface::get_default_geometry_engine ( )

Get the name of the default modeler engine.

std::string engine;

engine = CubitInterface::get_default_geometry_engine();

engine = cubit.get_default_geometry_engine()

Returns:
The name of the default modeler engine in the form ACIS, CATIA, OCC, facet
get_displacement_combine_type()

 std::string CubitInterface::get_displacement_combine_type ( int  entity_id)

Get the displacement’s combine type which is "Overwrite", "Average", "SmallestCombine", or "LargestCombine".

/param entity_id Id of the displacement /return The combine type for the given displacement
get_displacement_coord_system()

 int CubitInterface::get_displacement_coord_system ( int  entity_id)

Get the displacement’s coordinate system id.

/param entity_id Id of the displacement /return The Id of the displacement’s coordinate system
get_displacement_dof_signs()

 const int* CubitInterface::get_displacement_dof_signs ( int  entity_id)

This function only available from C++ Get the displacement’s dof signs

/param entity_id Id of the displacement /return
get_displacement_dof_values()

 const double* CubitInterface::get_displacement_dof_values ( int  entity_id)

This function only available from C++ Get the displacement’s dof values

/param entity_id Id of the displacement /return
get_distance_between()

 double CubitInterface::get_distance_between ( int  vertex_id_1, int  vertex_id_2  )

Get the distance between two vertices.

Parameters:

vertex_id_1

ID of vertex 1 vertex_id_2 ID of vertex 2

Returns:
distance
get_distance_between_entities()

 double CubitInterface::get_distance_between_entities ( std::string  geom_type_1, int  entity_id_1, std::string  geom_type_2, int  entity_id_2  )

Get the distance between two geom entities.

Parameters:

geom_type_1

geometry type of entity 1: "vertex", "curve", "surface", "volume" entity_id_1 ID of entity 1 geom_type_2 geometry type of entity 2: "vertex", "curve", "surface", "volume" entity_id_2 ID of entity 2

Returns:
distance
get_distance_from_curve_start()

 double CubitInterface::get_distance_from_curve_start ( double  x_coordinate, double  y_coordinate, double  z_coordinate, int  curve_id  )

Get the distance from a point on a curve to the curve’s start point.

Parameters:

x

value of the point to measure

y

value of the point to measure

z

value of the point to measure

curve_id

ID of the curve

Returns:
Distance from the xyz to the curve start
get_edge_count()

 int CubitInterface::get_edge_count ( )

Get the count of edges in the model.

Returns:
The number of edges in the model
get_edge_global_element_id()

 int CubitInterface::get_edge_global_element_id ( int  edge_id)

Given a edge id, return the global element id.

Parameters:

edge_id

Specifies the id of the edge

Returns:
The corresponding element id
get_elem_quality_stats()

 std::vector<double> CubitInterface::get_elem_quality_stats ( const std::string & entity_type, const std::vector< int > id_list, const std::string & metric_name, const double single_threshold, const bool use_low_threshold, const double low_threshold, const double high_threshold, const bool make_group )

python callable version of the get_quality_stats without pass by reference arguments. All return values are stuffed into a double array

std::vector<int> id_list = {223, 226, 256};

double single_threshold = 0.2;

bool use_low_threshold = false;

double low_threshold = 0.0;

double high_threshold = 0.0;

bool make_group = true;

 

std::vector<double>

quality_data = CubitInterface::get_elem_quality_stats("hex", id_list, "scaled jacobian",

single_threshold, use_low_threshold,

low_threshold, high_threshold,

make_group);

double min_value = quality_data[0];

double max_value = quality_data[1];

double mean_value = quality_data[2];

double std_value = quality_data[3];

int min_element_id = (int)quality_data[4];

int max_element_id = (int)quality_data[5];

int element_type = (int)quality_data[6];

int bad_group_id = (int)quality_data[7];

int num_elems = (int)quality_data[8];

std::vector<int> elem_ids(num_elems);

for (int i=9, j=0; i<quality_data.size(); i++, j++)

elem_ids[j] = (int)quality_data[i];

Parameters:

entity_type

Specifies the geometry type of the entity

id_list

Specifies a list of ids to work on

metric_name

Specify the metric used to determine the quality

single_threshold

Quality threshold value

use_low_threshold

use threshold as lower or upper bound

low_threshold

Quality threshold when using a lower and upper range

high_threshold

Quality threshold when using a lower and upper range

Returns:
[0] min_value [1] max_value [2] mean_value [3] std_value [4] min_element_id [5] max_element_id [6] element_type 0 = edge, 1 = tri, 2 = quad, 3 = tet, 4 = hex [7] bad_group_id [8] size of mesh_list [9]...[n-1] mesh_list
get_element_block()

 int CubitInterface::get_element_block ( int  element_id)

return the block that a given element is in.

Parameters:

element_id

The element id (i.e. the global element export id)

Returns:
block_id, the id of the containing block
get_element_budget()

 int CubitInterface::get_element_budget ( const std::string &  element_type, std::vector< int >  entity_id_list, int  auto_factor  )

Get the element budget based on current size settings for a list of volumes.

Parameters:

element_type

"hex" or "tet"

entity_id_list

List (vector) of volume ids

auto_factor

The current auto size factor value

Returns:
The approximate number of elements that will be generated
get_element_count()

 int CubitInterface::get_element_count ( )

Get the count of elements in the model.

Returns:
The number of quad, hex, tet, tri, wedge, edge, spheres, etc. which have been assigned to a block, given a global element id, and will be exported.
get_element_exists()

 bool CubitInterface::get_element_exists ( int  element_id)

Check the existance of an element.

Parameters:

element_id

The element id (i.e. the global element export id)

Returns:
true or false
get_element_type()

 std::string CubitInterface::get_element_type ( int  element_id)

return the type of a given element

Parameters:

element_id

The element id (i.e. the global element export id)

Returns:
The type
get_element_type_id()

 int CubitInterface::get_element_type_id ( int  element_id)

return the type id of a given element

Parameters:

element_id

The element id (i.e. the global element export id)

Returns:
type_id The hex, tet, wedge, etc. id is returned.
get_entities()

 std::vector<int> CubitInterface::get_entities ( const std::string &  entity_type)

Get all entities of a specified type (including geometry, mesh, etc...)

std::vector<int> entity_id_list;

entity_id_list = CubitInterface::get_entities("volume");

entity_id_list = cubit.get_entities("volume")

Parameters:

entity_type

Specifies the type of the entity

Returns:
A list (python tuple) of ids of the specified geometry type
get_entity_color_index()

 int CubitInterface::get_entity_color_index ( const std::string &  entity_type, int  entity_id  )

Get the color of a specified entity.

int color_index = CubitInterface::get_entity_color_index("curve", 33);

color_index = cubit.get_entity_color_index("curve", 33)

Parameters:

entity_type

Specifies the type of the entity

entity_id

Specifies the id of the entity

Returns:
The color of the entity
get_entity_modeler_engine()

 std::vector<std::string> CubitInterface::get_entity_modeler_engine ( const std::string &  geometry_type, int  entity_id  )

Get the modeler engine type for a specified entity.

std::vector<std::string> engine_list;

engine_list = CubitInterface::get_entity_modeler_engine("surface", 47);

engine_list = cubit.get_entity_modeler_engine("surface", 47)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
A vector (python tuple) of modeler engines associated with this entity
get_entity_name()

 std::string CubitInterface::get_entity_name ( const std::string &  entity_type, int  entity_id  )

Get the name of a specified entity.

Names returned are of two types: 1) user defined names which are actually stored in Cubit when the name is defined, and 2) ’default’ names supplied by Cubit at run-time which are not stored in Cubit. The second variety of name cannot be used to query Cubit.

std::string name = CubitInterface::get_entity_name("vertex", 22);

name = cubit.get_entity_name("vertex", 22)

Parameters:

entity_type

Specifies the type of the entity

entity_id

Specifies the id of the entity

Returns:
The name of the entity
get_entity_sense()

 std::string CubitInterface::get_entity_sense ( std::string  source_type, int  source_id, int  sideset_id  )

Get the sense of a sideset item.

std::string sense;

sense = CubitInterface::get_entity_sense("face", 332, 2);

sense = cubit.get_entity_sense("face", 332, 2)

Parameters:

source_type

Item type - could be ’face’, ’quad’ or ’tri’

source_id

ID of entity

sideset_id

ID of the sideset

Returns:
Sense of the source_type/source_id in specified sideset
get_error_count()

 int CubitInterface::get_error_count ( )

Get the number of errors in the current Cubit session.

Returns:
The number of errors in the Cubit session.
get_exodus_element_count()

 int CubitInterface::get_exodus_element_count ( int  entity_id, std::string  entity_type  )

Get the number of elements in a exodus entity.

int element_count = CubitInterface::get_exodus_element_count(2, "sideset");

element_count = cubit.get_exodus_element_count(2, "sideset")

Parameters:

entity_id

The id of the entity

entity_type

The type of the entity

Returns:
Number of Elements
get_exodus_entity_description()

 std::string CubitInterface::get_exodus_entity_description ( std::string  entity_type, int  entity_id  )

Get the description associated with an exodus entity.

std::string entity_description;

entity_description = CubitInterface::get_exodus_entity_description("sideset", 33);

entity_description = cubit.get_exodus_entity_description("sideset", 33)

Parameters:

entity_type

"block", "sideset", nodeset"

entity_id

Id of the entity in question

Returns:
Description of the entity or "" if none
get_exodus_entity_name()

 std::string CubitInterface::get_exodus_entity_name ( const std::string  entity_type, int  entity_id  )

Get the current number of nodesets.

Returns:
The number of nodesets in the current model, if any

Get the name associated with an exodus entity

std::string entity_name;

entity_name = CubitInterface::get_exodus_entity_name("sideset", 33);

entity_name = cubit.get_exodus_entity_name("sideset", 33)

Parameters:

entity_type

"block", "sideset", nodeset"

entity_id

Id of the entity in question

Returns:
Name of the entity or "" if none
get_exodus_entity_type()

 std::string CubitInterface::get_exodus_entity_type ( std::string  entity_type, int  entity_id  )

Get the type of an exodus entity.

std::string entity_description;

entity_description = CubitInterface::get_exodus_entity_description("sideset", 33);

entity_description = cubit.get_exodus_entity_type("sideset", 33)

Parameters:

entity_type

"block", "sideset", nodeset"

entity_id

Id of the entity in question

Returns:
Type of the entity or "" if none. Returns "lite" or ""
get_exodus_id()

 int CubitInterface::get_exodus_id ( const std::string &  entity_type, int  entity_id  )

Get the exodus/genesis id for this element.

int exodus_id = CubitInterface::get_exodus_id("hex", 221);

exodus_id = cubit.get_exodus_id("hex", 221)

Parameters:

entity_type

The mesh element type

entity_id

The mesh element id

Returns:
Exodus id of the element if element has been written out, otherwise 0
get_exodus_sizing_function_file_name()

 std::string CubitInterface::get_exodus_sizing_function_file_name ( )

Get the exodus sizing function file name.

Returns:
The sizing function file name
get_exodus_sizing_function_variable_name()

 std::string CubitInterface::get_exodus_sizing_function_variable_name ( )

Get the exodus sizing function variable name.

Returns:
The sizing function variable name
get_exodus_variable_count()

 int CubitInterface::get_exodus_variable_count ( std::string  container_type, int  container_id  )

Get the number of exodus variables in a nodeset, sideset, or block.

Parameters:

entity_type

: nodeset, sideset, or block block_id The block id

Returns:
Number of exodus variables
get_exodus_variable_names()

 std::vector< std::string > CubitInterface::get_exodus_variable_names ( std::string  container_type, int  container_id  )

Get the names of exodus variables in a nodeset, sideset, or block.

Parameters:

entity_type

: nodeset, sideset, or block block_id The block id

Returns:
Names of exodus variables
get_exodus_version()

 std::string CubitInterface::get_exodus_version ( )

Get the Exodus version number.

Returns:
A string containing the Exodus version number
get_expanded_connectivity()

 std::vector<int> CubitInterface::get_expanded_connectivity ( const std::string &  entity_type, int  entity_id  )

Get the list of node ids contained within a mesh entity, including interior nodes.

std::vector<int> node_id_list;

node_id_list = CubitInterface::get__expanded_connectivity("hex", 221);

node_id_list = cubit.get__expanded_connectivity("hex", 221)

Parameters:

entity_type

The mesh element type

entity_id

The mesh element id

Returns:
List (python tuple) of all node ids associated with the element, including interior nodes
get_force_direction_vector()

 std::array<double,3> CubitInterface::get_force_direction_vector ( int  entity_id)

Get the direction vector from a force.

/param entity_id Id of the force /return A vector (python tuple) [x,y,z] of the direction the given force is acting
get_force_magnitude()

 double CubitInterface::get_force_magnitude ( int  entity_id)

Get the force magnitude from a force.

/param entity_id Id of the force /return Magnitude of the given force
get_force_moment_vector()

 std::array<double,3> CubitInterface::get_force_moment_vector ( int  entity_id)

Get the moment vector from a force.

/param entity_id Id of the force /return A vector (python tuple) [x,y,z] of the direction of the moment for the given force
get_geometric_owner()

 std::vector<std::string> CubitInterface::get_geometric_owner ( std::string  mesh_entity_type, std::string  mesh_entity_list  )

Get a list of geometric owners given a list of mesh entities.

std::vector<std::string> owner_list;

owner_list = CubitInterface::get_geometric_owner("quad", id_list);

owner_list = cubit.get_geometric_owner("quad", id_list)

Parameters:

mesh_entity_type

The type of mesh entity. Works for ’quad, ’face’, ’tri’, ’hex’, ’tet’, ’edge’, ’node’

mesh_entity_list

A string containing space delimited ids, Cubit command form (i.e. ’all’, ’1 to 8’, ’1 2 3’, etc)

Returns:
A list (python tuple) of geometry owners in the form of ’surface x’, ’curve y’, etc.
get_geometry_node_count()

 int CubitInterface::get_geometry_node_count ( const std::string &  entity_type, int  entity_id  )

/brief Get the node count for a specific geometric entity

/param entity_type The geometry type ("surface", "curve", etc) /param entity_id The entity id /return Number of nodes in the geometry
get_geometry_owner()

 std::string CubitInterface::get_geometry_owner ( const std::string &  entity_type, int  entity_id  )

Get the geometric owner of this mesh element.

std::string geom_owner = CubitInterface::get_geometry_owner("hex", 221);

geom_owner = cubit.get_geometry_owner("hex", 221)

Parameters:

entity_type

The mesh element type

entity_id

The mesh element id

Returns:
Name of owner
get_global_element_id()

 int CubitInterface::get_global_element_id ( const std::string &  element_type, int  id  )

Given a hex, tet, etc. id, return the global element id.

Parameters:

id

Specifies the id of the hex, tet, etc. elem_type the type of the entity ("hex", "tet", "wedge", "pyramid", "tri", "face", "quad", "edge", or "sphere")

Returns:
The corresponding element id
get_graphics_version()

 std::string CubitInterface::get_graphics_version ( )

Get the VTK version number.

Returns:
A string containing the VTK version number
get_group_bodies()

 std::vector<int> CubitInterface::get_group_bodies ( int  group_id)

Get group bodies (bodies that are children of a group)

This routine returns a list of bodies that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of bodies ids contained in the specified group


get_group_children()

 void CubitInterface::get_group_children ( int  group_id, std::vector< int > &  returned_group_list, std::vector< int > &  returned_body_list, std::vector< int > &  returned_volume_list, std::vector< int > &  returned_surface_list, std::vector< int > &  returned_curve_list, std::vector< int > &  returned_vertex_list, int &  returned_node_count, int &  returned_edge_count, int &  returned_hex_count, int &  returned_quad_count, int &  returned_tet_count, int &  returned_tri_count, int &  returned_wedge_count, int &  returned_pyramid_count, int &  returned_sphere_count  )

Get group children.

This routine returns a list for each geometry entity type in the group. Since groups may contain both geometry and mesh entities, this routine also returns the count of any mesh entity contained in the group. For groups contained in the group, the group_list will only contain one generation. In other words, if this routine is examining Group ABC, and Group ABC contains Group XYZ and Group XYZ happens to contain other groups (which in turn may contain other groups) this routine will only return the id of Group XYZ.

Parameters:

group_id

ID of the group to examine

group_list

User specified list where group ids will be returned

body_list

User specified list where body ids will be returned

volume_list

User specified list where volume ids will be returned

surface_list

User specified list where surface ids will be returned

curve_list

User specified list where curve ids will be returned

vertex_list

User specified list where vertex ids will be returned

node_count

User specified variable where the number of nodes will be returned

edge_count

User specified variable where the number of edges will be returned

hex_count

User specified variable where the number of hexes will be returned

quad_count

User specified variable where the number of quads will be returned

tet_count

User specified variable where the number of tets will be returned

tri_count

User specified variable where the number of tris will be returned


get_group_curves()

 std::vector<int> CubitInterface::get_group_curves ( int  group_id)

Get group curves (curves that are children of a group)

This routine returns a list of curves that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of curve ids contained in the specified group


get_group_edges()

 std::vector<int> CubitInterface::get_group_edges ( int  group_id)

Get group edges (edges that are children of a group)

This routine returns a list of edges that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of edge ids contained in the specified group


get_group_groups()

 std::vector<int> CubitInterface::get_group_groups ( int  group_id)

Get group groups (groups that are children of another group)

This routine returns a list a groups that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of group ids contained in the specified group


get_group_hexes()

 std::vector<int> CubitInterface::get_group_hexes ( int  group_id)

Get group hexes (hexes that are children of a group)

This routine returns a list of hexes that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of hex ids contained in the specified group


get_group_nodes()

 std::vector<int> CubitInterface::get_group_nodes ( int  group_id)

Get group nodes (nodes that are children of a group)

This routine returns a list of nodes that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of node ids contained in the specified group


get_group_pyramids()

 std::vector<int> CubitInterface::get_group_pyramids ( int  group_id)

Get group pyramids (pyramids that are children of a group)

This routine returns a list of pyramids that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of pyramid ids contained in the specified group


get_group_quads()

 std::vector<int> CubitInterface::get_group_quads ( int  group_id)

Get group quads (quads that are children of a group)

This routine returns a list of quads that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of quad ids contained in the specified group


get_group_spheres()

 std::vector<int> CubitInterface::get_group_spheres ( int  group_id)

Get group spheres (sphere elements that are children of a group)

This routine returns a list of spheres that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of sphere ids contained in the specified group


get_group_surfaces()

 std::vector<int> CubitInterface::get_group_surfaces ( int  group_id)

Get group surfaces (surfaces that are children of a group)

This routine returns a list of surfaces that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of surface ids contained in the specified group


get_group_tets()

 std::vector<int> CubitInterface::get_group_tets ( int  group_id)

Get group tets (tets that are children of a group)

This routine returns a list of tets that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of tet ids contained in the specified group


get_group_tris()

 std::vector<int> CubitInterface::get_group_tris ( int  group_id)

Get group tris (tris that are children of a group)

This routine returns a list of tris that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of tri ids contained in the specified group


get_group_vertices()

 std::vector<int> CubitInterface::get_group_vertices ( int  group_id)

Get group vertices (vertices that are children of a group)

This routine returns a list of vertices that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of vertex ids contained in the specified group


get_group_volumes()

 std::vector<int> CubitInterface::get_group_volumes ( int  group_id)

Get group volumes (volumes that are children of a group)

This routine returns a list of volumes that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of volume ids contained in the specified group


get_group_wedges()

 std::vector<int> CubitInterface::get_group_wedges ( int  group_id)

Get group wedges (wedges that are children of a group)

This routine returns a list of wedges that are contained in a specified group.

Parameters:

group_id

ID of the group to examine return List (python tuple) of wedge ids contained in the specified group


get_heatflux_on_area()

 double CubitInterface::get_heatflux_on_area ( CI_BCEntityTypes  bc_area_enum, int  entity_id  )

Get the heatflux on a specified area.

/param bc_area enum of CI_BCEntityTypes. If on solid, use 4. If on thin shell, use 7 for top, 8 for bottom /param entity_id ID of the heatflux /return The value or magnitude of the specified heatflux
get_hex_count()

 int CubitInterface::get_hex_count ( )

Get the count of hexes in the model.

Returns:
The number of hexes in the model
get_hex_global_element_id()

 int CubitInterface::get_hex_global_element_id ( int  hex_id)

Given a hex id, return the global element id.

Parameters:

hex_id

Specifies the id of the hex

Returns:
The corresponding element id
get_hex_sheet()

 std::vector<int> CubitInterface::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.

Returns:
A list (python tuple) of hex ids in the hex sheet
get_hydraulic_radius_surface_area()

 double CubitInterface::get_hydraulic_radius_surface_area ( int  surface_id)

Get the area of a hydraulic surface.

Parameters:

surface_id

ID of the surface

Returns:
Hydraulic area of the surface
get_hydraulic_radius_volume_area()

 double CubitInterface::get_hydraulic_radius_volume_area ( int  volume_id)

Get the area of a hydraulic volume.

Parameters:

volume_id

ID of the volume

Returns:
Hydraulic area of the volume
get_id_from_name()

 int CubitInterface::get_id_from_name ( const std::string &  name)

Get id for a named entity.

This routine returns an integer id for the entity whose name is passed in.

int entity_id = CubitInterface::get_id_from_name("member_2");

entity_id = cubit.get_id_from_name("member_2")

Parameters:

name

Name of the entity to examine return Integer representing the entity


get_idless_signature()

 std::string CubitInterface::get_idless_signature ( std::string  entity_type, int  entity_id  )

get the idless signature of a geometric or mesh entity

Parameters:

type

the type of the requested entity

id

the id of the requested entity

Returns:
the idless signature i.e. curve at (1 1 0 ordinal 2)
get_idless_signatures()

 std::string CubitInterface::get_idless_signatures ( std::string  entity_type, const std::vector< int > &  entity_id_list  )

get the idless signatures of a range of geometric or mesh entities

Parameters:

type

the type of the requested entity

idlist

a list of ids

Returns:
the idless signature i.e. curve at (1 1 0 ordinal 2) curve at (0 0 1 ordinal 1) ...
get_interface()

 CubitBaseInterface* CubitInterface::get_interface ( std::string  interface_name)

Get the interface of a given name.

Parameters:

interface_name

the name of interface


get_label_type()

 int CubitInterface::get_label_type ( const char *  entity_type)

/brief make calls to SVDrawTool::get_label_type

/return label type currently associated with entity_type
get_last_id()

 int CubitInterface::get_last_id ( const std::string &  entity_type)

Get the id of the last created entity of the given type.

int last_id = CubitInterface::get_last_id("surface");

last_id = cubit.get_last_id("surface")

Parameters:

entity_type

Type of the entity being queried

Returns:
Integer id of last created entity
get_list_of_free_ref_entities()

 std::vector<int> CubitInterface::get_list_of_free_ref_entities ( const std::string &  geometry_type)

Get all free entities of a given geometry type.

std::vector<int> free_curve_id_list;

free_curve_id_list = CubitInterface::get_list_of_free_ref_entities("curve");

free_curve_id_list = cubit.get_list_of_free_ref_entities("curve")

Parameters:

geom_type

Specifies the geometry type of the free entity

Returns:
A list (python tuple) of ids of the specified geometry type
get_material_name()

 std::string CubitInterface::get_material_name ( int  material_id)

Get the name of the material (or cfd media) with the given id.

Returns:
A std::string with the material’s name.
get_material_name_list()

 std::vector<std::string> CubitInterface::get_material_name_list ( )

/brief Get a list of all defined material names

/return List (python tuple) of all the material names.
get_material_property()

 double CubitInterface::get_material_property ( CI_MaterialProperty  material_property_enum, int  entity_id  )

/brief Get the specified material property value

/param mp enum of CI_MaterialProperty. 0-Elastic Modulus, 1-Shear Modulus, 2-Poisson Ratio, 3-Density, 4-Specific Heat, 5-Conductivity /param entity_id Id of the material /return Value of the specified property for that material
get_media_name_list()

 std::vector<std::string> CubitInterface::get_media_name_list ( )

/brief Get a list of all defined material names

/return List (python tuple) of all the material names.
get_media_property()

 int CubitInterface::get_media_property ( int  entity_id)

/brief Get the media property value

/param entity_id Id of the media /return Value of the media property, 0 == FLUID, 1 == POROUS, 2 == SOLID
get_merge_setting()

 std::string CubitInterface::get_merge_setting ( const std::string &  geometry_type, int  entity_id  )

Get the merge setting for a specified entity.

std::string merge_setting = CubitInterface::get_merge_setting("surface", 33);

merge_setting = cubit.get_merge_setting("surface", 33)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
A text string that indicates the merge setting for the entity
get_mesh_edge_length()

 double CubitInterface::get_mesh_edge_length ( int  edge_id)

Get the length of a mesh edge.

Parameters:

edge_id

Specifies the id of the edge

Returns:
The length of the mesh edge
get_mesh_element_type()

 std::string CubitInterface::get_mesh_element_type ( const std::string &  entity_type, int  entity_id  )

Get the mesh element type contained in the specified geometry.

std::string element_type = CubitInterface::get_mesh_element_type("surface", 2);

element_type = cubit.get_mesh_element_type("surface", 2)

Parameters:

entity_type

The type of entity

entity_id

The id of the entity

Returns:
Mesh element type for that entity
get_mesh_error_solutions()

 std::vector<std::string> CubitInterface::get_mesh_error_solutions ( int  error_code)

Get the paired list of mesh error solutions and help context cues.

Parameters:

error_code

The error code associated with the error solution

Returns:
List (python tuple) of ’married’ strings. First string is solution text. Second string is help context cue. Third string is command_panel cue.
get_mesh_geometry_approximation_angle()

 double CubitInterface::get_mesh_geometry_approximation_angle ( std::string  geometry_type, int  entity_id  )

Get the geometry approximation angle set for tri/tet meshing.

Parameters:

geom_type

either "surface" or "volume"

entity_id

the entity id

Returns:
boolean value as to whether or not the proximity flag is set
get_mesh_group_parent_ids()

 std::vector<int> CubitInterface::get_mesh_group_parent_ids ( const std::string &  element_type, int  element_id  )

Get the group ids which are parents to the indicated mesh element.

std::vector<int> parent_id_list;

parent_id_list = CubitInterface::get_mesh_group_parent_ids("tri", 332);

parent_id_list = cubit.get_mesh_group_parent_ids("tri", 332)

Parameters:

element_type

Mesh type of the element

element_id

ID of the mesh element return List (python tuple) of group ids that contain this mesh element


get_mesh_interval_firmness()

 std::string CubitInterface::get_mesh_interval_firmness ( const std::string &  geometry_type, int  entity_id  )

Get the mesh interval firmness for the specified entity. This may include influence from connected mesh intervals on connected geometry.

std::string firmness;

CubitInterface::get_mesh_interval_firmness("surface", 12);

firmness = cubit.get_mesh_interval_firmness("surface", 12)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
The entity’s meshing firmness (HARD, SOFT, LIMP) HARD = set directly SOFT = computed LIMP = not set
get_mesh_intervals()

 int CubitInterface::get_mesh_intervals ( const std::string &  geometry_type, int  entity_id  )

Get the interval count for a specified entity.

int intervals = CubitInterface::get_mesh_intervals("surface", 12);

intervals = cubit.get_mesh_intervals("surface", 12)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
The entity’s interval count
get_mesh_scheme()

 std::string CubitInterface::get_mesh_scheme ( const std::string &  geometry_type, int  entity_id  )

Get the mesh scheme for the specified entity.

std::string scheme;

CubitInterface::get_mesh_scheme("surface", 12, scheme);

scheme = cubit.get_mesh_scheme("surface", 12)

Parameters:

geometry_type

Specifies the entity type

entity_id

Specifies the id of the entity

Returns:
The entity’s meshing scheme
get_mesh_scheme_firmness()

 std::string CubitInterface::get_mesh_scheme_firmness ( const std::string &  geometry_type, int  entity_id  )

Get the mesh scheme firmness for the specified entity.

std::string firmness;

CubitInterface::get_mesh_firmness("surface", 12);

firmness = cubit.get_mesh_firmness("surface", 12)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
The entity’s meshing firmness (HARD, LIMP, SOFT)
get_mesh_size()

 double CubitInterface::get_mesh_size ( const std::string &  geometry_type, int  entity_id  )

Get the mesh size for a specified entity.

double mesh_size = CubitInterface::get_mesh_size("volume", 2);

mesh_size = cubit.get_mesh_size("volume", 2)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
The entity’s mesh size
get_mesh_size_type()

 std::string CubitInterface::get_mesh_size_type ( const std::string &  geometry_type, int  entity_id  )

Get the mesh size setting type for the specified entity. This may include influence from attached geometry.

std::string firmness;

CubitInterface::get_mesh_size_setting_type("surface", 12);

firmness = cubit.get_mesh_size_setting_type("surface", 12)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
The entity’s mesh size type (USER_SET, CALCULATED, NOT_SET)
get_meshed_volume_or_area()

 double CubitInterface::get_meshed_volume_or_area ( const std::string &  geometry_type, std::vector< int >  entity_ids  )

Get the total volume/area of a entity’s mesh.

double area = CubitInterface::get_meshed_volume_or_area("volume", 1);

area = cubit.get_meshed_volume_or_area("volume", 1)

Parameters:

geom_type

Specifies the type of entity - volume, surface, hex, tet, tri, quad

entity_ids

A list of ids for the entity type

Returns:
The entity’s meshed volume or area
get_meshgems_version()

 std::string CubitInterface::get_meshgems_version ( )

Get the MeshGems version number.

Returns:
A string containing the MeshGems version number
get_ML_operation()

 std::vector<std::string> CubitInterface::get_ML_operation ( const int  op_type, const int  entity_id1, const int  entity_id2, const std::vector< double >  params, const double  small_curve_size, const double  mesh_size  )

get the command, display and preview strings for a given operation type

Parameters:

op_type

operation type (see get_ML_operation_features)

entity1_id

first entity associated with operation (see table)

entity2_id

second entity associated with operation (see table)

params

optional parameters for operation


get_ML_operation_feature_names()

 std::vector<std::string> CubitInterface::get_ML_operation_feature_names ( const int  op_type)

for the given operation type described by get_ML_operation_features, return a vector of strings indicating the name of data for each feature in the vector.

Parameters:

op_type

cubit operation id from table in get_ML_operation_features


get_ML_operation_feature_size()

 int CubitInterface::get_ML_operation_feature_size ( const int  op_type)

for the given operation type described by get_ML_operation_features, return the expected size of the feature vector

Parameters:

op_type

cubit operation id from table in get_ML_operation_features


get_ML_operation_feature_types()

 std::vector<std::string> CubitInterface::get_ML_operation_feature_types ( const int  op_type)

for the given operation type described by get_ML_operation_features, return a vector of strings indicating the type of data for each feature in the vector. Will return one of the following for each index:
  1. boolean 1 or 0

  2. categorical usually positive integer representing a unique

continuous could be double or integer describing a continuous range (i.e. number of adjacent curves, area of a surface, etc..)

Parameters:

op_types

cubit operation id from table in get_ML_operation_features


get_ML_operation_features()

 std::vector<std::vector<double> > CubitInterface::get_ML_operation_features ( std::vector< int >  op_types, std::vector< int >  entity1_ids, std::vector< int >  entity2_ids, std::vector< std::vector< double >>  params, double  mesh_size  )

returns a vector of vectors defining surface overlaps The first surface (id) in each vector overlaps with all subsequent surfaces in the vector.

Parameters:

body_ids

List of bodies to search for surface overlaps

filter_sliver

Optional parameter that removes false positives from the output omitting overlapping pairs sharing a merged curve sharing merged curves.

 bodies = [ 15, 19, 24, 88 ]

my_overlaps = cubit.get_overlapping_surfaces_in_bodies( bodies )

std::vector< std::vector<int> > get_overlapping_surfaces_in_bodies(

std::vector<int> body_ids, bool filter_slivers = false );

 

\brief

**This function only works from C++** Get the list of overlapping surfaces for a list of volumes

 

For every occurance of two overlapping surfaces, two surfaces ids are returned.

Those ids are returned in the indicated lists and are aligned. In other words

the first id in surf_list_1 overlaps with the first id in surf_list_2. The

second id in surf_list_1 overlaps with the second id in surf_list-2, and so on.

 

\param

target_volume_ids List of volume ids to examine.

\param

surf_list_1 User specified list where the ids of overlapping surfaces will

be returned

\param

surf_list_2 User specified list where the ids of overlapping surfaces will

be returned

\param

returned_distance_list Corresponding user specified list where distances between

surfaces will be returned

\param

returned_overlap_area_list Corresponding user specified list where overlap areas between

surfaces will be returned

\param

filter_slivers whether to return filter slivers

\param

filter_volume_overlaps whether to return surfaces on the same volume

\param

cache_overlaps speed up overlaps by caching and using previously computed

results. Default 0 = no caching. 1 = clear out old values first.

2 = use and add to existing cache

void get_overlapping_surfaces_in_volumes(std::vector<int> target_volume_ids,

std::vector<int> &returned_surface_list_1,

std::vector<int> &returned_surface_list_2,

std::vector<double> &returned_distance_list,

std::vector<double> &returned_overlap_area_list,

bool filter_slivers = false,

bool filter_volume_overlaps = false,

int cache_overlaps = 0);

 

\brief

**This function only works from C++** Get the list of overlapping surfaces for a list of surfaces

 

For every occurance of two overlapping surfaces, two surfaces ids are returned.

Those ids are returned in the indicated lists and are aligned. In other words

the first id in surf_list_1 overlaps with the first id in surf_list_2. The

second id in surf_list_1 overlaps with the second id in surf_list-2, and so on.

 

\param

target_surface_ids List of surface ids to examine.

\param

returned_surface_list_1 User specified list where the ids of overlapping surfaces will

be returned

\param

returned_surface_list_2 User specified list where the ids of overlapping surfaces will

be returned

\param

returned_distance_list Corresponding user specified list where distances between

surfaces will be returned

\param

returned_overlap_area_list Corresponding user specified list where overlap areas between

surfaces will be returned

\param

filter_slivers whether to return filter slivers

\param

filter_volume_overlaps whether to return surfaces on the same volume

\param

cache_overlaps speed up overlaps by caching and using previously computed

results. Default 0 = no caching. 1 = clear out old values first.

2 = use and add to existing cache

void get_overlapping_surfaces(std::vector<int> target_surface_ids,

std::vector<int> &returned_surface_list_1,

std::vector<int> &returned_surface_list_2,

std::vector<double> &returned_distance_list,

std::vector<double> &returned_overlap_area_list,

bool filter_slivers = false,

bool filter_volume_overlaps = false,

int cache_overlaps = 0);

 

 

For every occurance of two overlapping curves, two curve ids are returned.

Those ids are returned in the indicated lists and are aligned. In other words

the first id in curv_list_1 overlaps with the first id in curv_list_2. The

second id in curv_list_1 overlaps with the second id in curv_list-2, and so on.

 

\param

target_surface_ids List of surface ids to examine.

\param

min_gap minimum overlap distance between curves to return

\param

max_gap maximum overlap distance between curves to return

\param

returned_curve_list_1 User specified list where the ids of overlapping curves will

be returned

\param

returned_curve_list_2 User specified list where the ids of overlapping curves will

be returned

\param

returned_distance_list Corresponding user specified list where distances between

curves will be returned

void get_overlapping_curves(std::vector<int> target_surface_ids,

double min_gap, double max_gap,

std::vector<int> &returned_curve_list_1,

std::vector<int> &returned_curve_list_2,

std::vector<double> &returned_distance_list);

 

\brief

**This function only works from C++** Get the list of gaps for a list of volumes

 

For every occurance of a gap, two surfaces ids are returned.

Those ids are returned in the indicated lists and are aligned. In other words

the first id in surf_list_1 overlaps with the first id in surf_list_2. The

second id in surf_list_1 overlaps with the second id in surf_list-2, and so on.

 

\param

target_volume_ids List of volume ids to examine.

\param

surf_list_1 User specified list where the ids of the gap surfaces will

be returned

\param

surf_list_2 User specified list where the ids of the gap surfaces will

be returned

\param

distance_list User specified list where the distance between the gap surface will

be returned

\param

max_gap_tolerance User specified tolerance used to find the gaps.

\param

cache_overlaps speed up overlaps by caching and using previously computed

results. Default 0 = no caching. 1 = clear out old values first.

2 = use and add to existing cache

void get_volume_gaps(std::vector<int> target_volume_ids,

std::vector<int> &returned_surface_list_1,

std::vector<int> &returned_surface_list_2,

std::vector<double> &returned_distance_list,

std::vector<double> &returned_overlap_area_list,

double maximum_gap_tolerance,

double maximum_gap_angle,

int cache_overlaps = 0);

 

\brief

Get the list of overlapping volumes for a list of volumes

 

For every occurance of two overlapping volumes, two volume ids are returned

in volume_list. Modulus 2 of the volume_list should always be 0 (the list

should contain an even number of volume ids). The first volume id in the

returned list overlaps with the second volume id. The third volume id

overlaps with the fourth volume id, and so on.

 

\param

target_volume_ids List of volume ids to examine.

\return

List (python tuple) of overlapping volumes ids

 

std::vector<int> get_overlapping_volumes(std::vector<int> target_volume_ids);

 

\brief

Get the list of overlapping volumes from the model for a single volume

 

\param

volume_id volume to check.

\param

volumes to check against. If empty, will check against all volumes in model

\return

list of volumes that overlap volume_id from compare_volumes list

 

std::vector<int> get_overlapping_volumes_at_volume(int volume_id, std::vector<int> compare_volumes);

 

\brief

Get the list of overlapping surfaces from the model for a single surface

 

\param

surface_id surface to check.

\param

compare_volumes volumes to check against. If empty, will check against

all volumes in model

\return

list of surfaces that overlap surface_id from compare_volumes list

std::vector<int> get_overlapping_surfaces_at_surface(int surface_id, std::vector<int> compare_volumes, int cache_overlaps = 0);

 

\brief

Get the list of nearby volumes from the model for a single volume

 

\param

volume_id volume to check.

\param

volumes to check against. If empty, will check against all volumes in model

\param

maximum distance betwen volumes. Optional. Use -1 to compute default tolerance

\return

list of volumes that are nearby to volume_id from compare_volumes list

 

std::vector<int> get_nearby_volumes_at_volume(int volume_id, std::vector<int> compare_volumes, double distance);

 

\brief

**This function only works from C++** Get the list of mergeable entities from a list of volumes

 

Given a list of volume ids, this will return 3 lists of potential merge

candidates. The returned lists include lists of the merge partners.

 

\param

target_volume_ids List of volume ids to examine.

\param

surface_list User specified list where mergeable surfaces will be stored

\param

curve_list User specified list where mergeable curves will be stored

\param

vertex_list User specified list where mergeable vertices will be stored

\param

merge_tol merge tolerance to determine mergable (optional).

Uses the default merge_tolerance if not specified

void get_mergeable_entities(std::vector<int> target_volume_ids,

std::vector<std::vector<int> > &returned_surface_list,

std::vector<std::vector<int> > &returned_curve_list,

std::vector<std::vector<int> > &returned_vertex_list,

double merge_tol = -1);

 

\brief

Get the list of mergeable vertices from a list of volumes/bodies

 

Given a list of volume ids, this will return a list of potentially mergeable

vertices. The returned lists include lists of the merge partners.

 

\param

target_volume_ids List of volume ids to examine.

\return

list of lists of mergeable vertices (potentially more than a pair)

Note: If using python, lists will be python tuples.

std::vector<std::vector<int> >

get_mergeable_vertices(std::vector<int> target_volume_ids);

 

\brief

Get the list of mergeable curves from a list of volumes/bodies

 

Given a list of volume ids, this will return a list of potentially mergeable

curves. The returned lists include lists of the merge partners.

 

\param

target_volume_ids List of volume ids to examine.

\return

list of lists of mergeable curves (potentially more than a pair)

Note: If using python, lists will be python tuples.

std::vector<std::vector<int> >

get_mergeable_curves(std::vector<int> target_volume_ids);

 

\brief

Get the list of mergeable surfaces from a list of volumes/bodies

 

Given a list of volume ids, this will return a list of potentially mergeable

surfaces. The returned lists include lists of the merge partners.

 

\param

target_volume_ids List of volume ids to examine.

\return

list of lists of mergeable surfaces (potentially more than a pair)

Note: If using python, lists will be python tuples.

std::vector<std::vector<int> >

get_mergeable_surfaces(std::vector<int> target_volume_ids);

 

 

 

 

\brief

Find the n closest vertex pairs in the model.

 

Given a list of volumes find the n closest vertex curve pairs. The checks will be

done on a surface by surface basis so that only curve-vertex pairs within a given

surface will be returned. This function is for finding the smallest features within

the surfaces of the model.

 

\param

target_ids List of volumes ids to examine.

\param

num_to_return Number of vertex curve pairs to return.

\param

vert_ids Ids of returned vertices.

\param

curve_ids Ids of returned curves.

\param

distances Vertex-curve pair distances.

void get_closest_vertex_curve_pairs(std::vector<int> target_ids,

int &returned_number_to_return,

std::vector<int> &returned_vertex_ids,

std::vector<int> &returned_curve_ids,

std::vector<double> &returned_distances);

 

\brief

Finds all of the smallest features.

 

\param

target_ids The entities to query

\param

num_to_return number of small features to return

\param

type1_list

\param

type2_list

\param

id1_list

\param

id2_list

\param

distance_list

void get_smallest_features(std::vector<int> target_ids,

int &returned_number_to_return,

std::vector<int> &returned_type_1_list,

std::vector<int> &returned_type_2_list,

std::vector<int> &returned_id_1_list,

std::vector<int> &returned_id_2_list,

std::vector<double> &returned_distance_list);

 

\brief

Estimate a good merge tolerance for the passed-in volumes.

 

Given a list of volumes try to estimate a good merge tolerance.

 

\param

target_volume_ids List of volumes ids to examine.

\param

accurate_in Flag specifying whether to do a lengthier, more accurate calculation.

\param

report_in Flag specifying whether to report results to the command line.

\param

lo_val_in Low value of range to search for merge tolerance.

\param

hi_val_in High value of range to search for merge tolerance.

\param

num_calculations_in Number of intervals to split search range up into.

\param

return_calculations_in Flag specifying whether to return the number of proximities at each step.

\param

merge_tols List containing merge tolerance at each step of calculation.

\param

num_proximities List containing number of proximities at each step of calculation.

double estimate_merge_tolerance(std::vector<int> target_volume_ids,

bool accurate_in = false,

bool report_in = false,

double low_value_in = -1.0,

double high_value_in = -1.0,

int number_calculations_in = 10,

bool return_calculations_in = false,

std::vector<double> *merge_tolerance_list = NULL,

std::vector<int> *number_of_proximities_list = NULL);

\brief

Get the list of volumes with no merged children

 

Given a list of volumes find all of the volumes that are not attached to any other

entity through a merge.

 

\param

target_volume_ids List of volumes ids to examine.

\param

volume_list User specified list where the ids of floating volumes are returned

void find_floating_volumes(std::vector<int> target_volume_ids,

std::vector<int> &returned_floating_id_list);

 

\brief

Get the list of nonmanifold curves in the volume list

 

Given a list of volumes find all of the nonmanifold curves. This is found by seeing if

there is at least one merged face attached to any merged curve. If there exist merged

curves that don't belong to merged faces it represents a nonmanifold case.

 

\param

target_volume_ids List of volumes ids to examine.

\param

curve_list User specified list where the ids of nonmanifold curves are returned

void find_nonmanifold_curves(std::vector<int> target_volume_ids,

std::vector<int> &returned_curve_list);

 

\brief

Get the list of nonmanifold vertices in the volume list

 

Given a list of volumes find all of the nonmanifold vertices. This is found by seeing if

there is at least one merged curve attached to any merged vertex. If there exist merged

vertices that don't belong to merged curves it represents a nonmanifold case.

 

\param

target_volume_ids List of volumes ids to examine.

\param

vertex_list User specified list where the ids of nonmanifold vertices are returned

void find_nonmanifold_vertices(std::vector<int> target_volume_ids,

std::vector<int> &returned_vertex_list);

 

\brief

Get the list of coincident vertex-vertex, vertex-curve, and vertex-surface pairs and distances

from a list of volumes

 

Given a list of volumes get lists of coincident vertex-vertex, vertex-curve, and

vertex-surface pairs and their distances based on the passed-in thresholds. The returned

lists will be exactly double the size of the distance lists. For each distance, 2 entities will be

associated at the same relative place in the list.

 

\param

target_volume_ids List of volumes ids to examine.

\param

do_vertex_vertex Parameter specifying whether to do vertex-vertex check.

\param

do_vertex_curve Parameter specifying whether to do vertex-curve check.

\param

do_vertex_surf Parameter specifying whether to do vertex-surface check.

\param

v_v_vertex_list User specified list where the ids of coincident vertex pairs are

returned

\param

v_c_vertex_list User specified list where the ids of the vertices of coincident vertex-curve pairs

are returned

\param

v_c_curve_list User specified list where the ids of the curves of coincident vertex-curve pairs

are returned

\param

v_s_vertex_list User specified list where the ids of the vertices of coincident vertex-surface pairs

are returned

\param

v_s_surf_list User specified list where the ids of the surfaces of coincident vertex-surface pairs

are returned

\param

vertex_distance_list User specified list where the vertex-vertex distance values will

be returned

\param

curve_distance_list User specified list where the vertex-curve distance values will

be returned

\param

surf_distance_list User specified list where the vertex-surface distance values will

be returned

\param

low_value User specified low threshold value

\param

hi_value User specified high threshold value

\param

filter_same_volume_cases Parameter specifying whether to weed out entity pairs that

are in the same volume.

void get_coincident_entity_pairs(std::vector<int> target_volume_ids,

std::vector<int> &returned_v_v_vertex_list,

std::vector<int> &returned_v_c_vertex_list,

std::vector<int> &returned_v_c_curve_list,

std::vector<int> &returned_v_s_vertex_list,

std::vector<int> &returned_v_s_surf_list,

std::vector<double> &returned_vertex_distance_list,

std::vector<double> &returned_curve_distance_list,

std::vector<double> &returned_surf_distance_list,

double low_value,

double high_value,

bool do_vertex_vertex = true,

bool do_vertex_curve = true,

bool do_vertex_surf = true,

bool filter_same_volume_cases = false);

 

 

\brief

Get the list of coincident vertex pairs and distances from a list of volumes

 

Given a list of volumes get a list of coincident vertex pairs and their distances

based on the current merge tolerance value and a threshold. The returned vertex list will be exactly

double the size of the distance list. For each distance, 2 vertices will be

associated at the same relative place in the list.

 

\param

target_volume_ids List of volumes ids to examine.

\param

vertex_pair_list User specified list where the ids of coincident vertex pairs

be returned

\param

distance_list User specified list where the distance values will

be returned

\param

threshold_value User specified threshold value

void get_coincident_vertex_vertex_pairs(std::vector<int> target_volume_ids,

std::vector<int> &returned_vertex_pair_list,

std::vector<double> &returned_distance_list,

double low_value,

double threshold_value,

bool filter_same_volume_cases = false);

 

\brief

Get the list of coincident vertex/curve pairs and distances from a list of volumes

 

Given a list of volumes get a list of coincident vertex/curve pairs and their distances

based on the current merge tolerance value and a threshold value. The returned lists will

be of equal length and matched by order.

 

\param

target_volume_ids List of vertices ids to examine.

\param

vertex_list User specified list for the ids of coincident vertices

\param

curve_list User specified list for the ids of coincident curves

\param

distance_list User specified list where the distance values will

be returned

\param

threshold_value User specified threshold value

void get_coincident_vertex_curve_pairs(std::vector<int> target_volume_ids,

std::vector<int> &returned_vertex_list,

std::vector<int> &returned_curve_list,

std::vector<double> &returned_distance_list,

double low_value,

double threshold_value,

bool filter_same_volume_cases = false);

 

\brief

Get the list of coincident vertex/surface pairs and distances from a list of volumes

 

Given a list of volumes get a list of coincident vertex/pairs pairs and their distances

based on the current merge tolerance value and a threshold value. The returned lists will

be of equal length and matched by order.

 

\param

target_volume_ids List of vertices ids to examine.

\param

vertex_list User specified list for the ids of coincident vertices

\param

surface_list User specified list for the ids of coincident surfaces

\param

distance_list User specified list where the distance values will

be returned

\param

threshold_value User specified threshold value

void get_coincident_vertex_surface_pairs(std::vector<int> target_volume_ids,

std::vector<int> &returned_vertex_list,

std::vector<int> &returned_surface_list,

std::vector<double> &returned_distance_list,

double low_value,

double threshold_value,

bool filter_same_volume_cases = false);

 

 

\brief

Get the list of possible decompositions

 

\param

volume_list List of volumes to query

\param

exterior_angle Threshold value for the exterior angle

\param

do_imprint_merge Set to true (1) if you want the imprint and merge to be done

\param

tol_imprint Set to true (1) if you want to do a tolerant imprint

std::vector<std::string> get_solutions_for_decomposition(const std::vector<int>& volume_list,

double exterior_angle,

bool do_imprint_merge,

bool tolerant_imprint);

\brief

Get the solution list for a given blend surface

 

\param

surface_id the surface being queried

\param

max_radius the maximum radius of curvature for which solutions will be returned

max_radius=-1 will return solutions for any blend

\return

Vector of three string vectors. Vector 1 will contain display strings to

be shown to users. Vector 2 will contain Cubit command strings.

Vector 3 will contain Cubit preview strings.

Note: If using python, vectors will be python tuples.

std::vector<std::vector<std::string> > get_solutions_for_blends(int surface_id);

 

\brief

Returns the blend chains for a surface

 

\param

surface_id surface to retrieve the blend chains from

\return

A list of lists of id's in each blend chain.

Note: If using python, lists will be python tuples.

std::vector< std::vector<int> > get_blend_chains(int surface_id);

 

\brief

Returns the chamfer chains for a surface

 

\param

surface_id surface to retrieve the chamfer chains from

\return

A list of lists of id's in each chamfer chain.

Note: If using python, lists will be python tuples.

std::vector< std::vector<int> > get_chamfer_chains(int surface_id);

 

\brief

return whether two or more surfaces share at least one manifold curve

(common curve is part of exactly two surfaces)

 

\param

surface_id IDs of surfaces to query

\return

whether the surface are adjacent

bool are_adjacent_surfaces(std::vector<int> surface_ids);

 

\brief

return whether the surface has any adjacent surfaces that are continuous

(exterior angle is 180 degrees +- angle_tol)

 

\param

surface_id ID ofsurface

\param

angle_tol angle tolerance for continuity

\return

whether the surface has adjacent continuous surfaces

bool is_continuous_surface(int surface_id, double angle_tol);

 

\brief

Returns the adjacent surfaces that are continuous

(exterior angle is 180 degrees +- angle_tol)

 

\param

surface_id that is part of the cavity

\param

angle_tol angle tolerance for continuity

\return

A list of surface id's in the continuous set (including surface_id).

std::vector<int> get_continuous_surfaces(int surface_id, double angle_tol);

 

\brief

return whether the surface is part of a cavity

 

\param

surface_id ID ofsurface

\return

whether the surface is part of a cavity

bool is_cavity_surface(int surface_id);

 

\brief

Returns the adjacent surfaces in a cavity for a surface

 

\param

surface_id that is part of the cavity

\return

A list of surface id's in the cavity (including surface_id).

std::vector<int> get_cavity_surfaces(int surface_id);

 

\brief

Returns the collections of surfaces that comprise holes or cavities in the

specified volumes. Filter by hydarulic radius and area of the cavity

 

\param

volume_list List of volumes to query

\param

hr_threshold return cavities with computed hydraulic radius less than hr_threshold.

Where hr = 4*Area/Perimeter. Use hr_threshold < 0.0 to return all cavities

\param

area_threshold return cavities with computed surface area less than area_threshold.

Use area_threshold < 0.0 to return all cavities

\param

return a vector of cavity areas corresponding to the return cavity id lists

\return

A list of lists of surface id's grouped by their individual cavity or hole

std::vector<std::vector<int>> get_surface_cavity_collections(const std::vector<int>& volume_list,

double hr_threshold,

double area_threshold,

std::vector<double> &return_cavity_hrs,

std::vector<double> &return_cavity_areas);

 

\brief

Returns the collections of surfaces that comprise blend chains in the

specified volumes. Filter by radius threshold

 

\param

volume_list List of volumes to query

\param

radius_threshold resturn only blend chains less than radius_threshold

\param

return_radii

return a vector of blend chain radii corresponding to the return blend chains lists

\return

A list of lists of surface id's grouped by their individual blend chain

std::vector<std::vector<int>> get_blend_chain_collections(const std::vector<int>& volume_list,

double radius_threshold,

std::vector<double> &return_radii);

 

\brief

Returns the collections of surfaces that comprise chamfers in the

specified volumes. Filter by thickness of chamfer

 

\param

volume_list List of volumes to query

\param

radius_threshold resturn only chamfer chains less than thickness_threshold

\param

return_radii

return a vector of chamfer chain radii corresponding to the return chamfer chains lists

\return

A list of lists of surface id's grouped by their individual chamfer_chain

std::vector<std::vector<int>> get_chamfer_chain_collections(const std::vector<int>& volume_list,

double thickness_threshold,

std::vector<double> &return_thicknesses);

 

\brief

Get the solution list for a given cavity surface

 

\param

surface_id the surface being queries

\return

Vector of three string vectors. Vector 1 will contain display strings to

be shown to users. Vector 2 will contain Cubit command strings.

Vector 3 will contain Cubit preview strings.

Note: If using python, vectors will be python tuples.

std::vector<std::vector<std::string> > get_solutions_for_cavity_surface(int surface_id);

 

\brief

Get the current merge tolerance value

 

\return

The value of the current merge tolerance

double get_merge_tolerance();

 

 

\name Machine Learning Support

 

\brief

get machine learning features for a list of cubit operations

 

\code

std::vector<int> op_types = {3, 3}; // 2 surface_no_op queries

std::vector<int> entity1_ids = {20, 25}; // surface IDs

std::vector<int> entity2_ids = {0, 0}; // none for surface_no_op

std::vector<std::vector<double>> params = {{-1, -1, -1}, {-1, -1, -1}}; // dummy for surface no_op

double mesh_size = 1.5924; // target mesh size

std::vector<std::vector<double>>

features = CubitInterface::get_ML_operation_features(op_types,

entity1_ids, entity2_ids,

params, mesh_size);


op_types = [3, 3] # 2 surface_no_op queries

entity1_ids = [20, 25] # surface IDs

entity2_ids = [0, 0] # none for surface_no_op

params = [[-1, -1, -1], [-1, -1, -1]] # dummy for surface no_op

mesh_size = 1.5924 # target mesh size

features = cubit.get_ML_operation_features(op_types,

entity1_ids, entity2_ids,

params, mesh_size)

Parameters:

op_types

list of cubit operation types. One of the following IDs:

11.3.1  op_type Description Entity1 Entity2 Params

0 Unknown none none 1 Vertex No Operation vertex none 2 Curve No Operation curve none 3 Surface No Operation surface none 4 Volume No Operation volume none 5 Remove Surface surface none 6 Tweak Replace Surface surface surface 7 Composite Surfaces surface surface 8 Collapse Curve curve vertex 9 Tweak Remove Topology Curve curve none 10 Virtual Collapse Curve curve vertex 11 Tweak Remove Topology Surface surface none 12 Blunt Tangency vertex none remove_mat, angle, depth 13 Remove Cone Surface surface none 14 Collapse Angle vertex none real_split, angle, composite_vertex 15 Remove Blend surface none 16 Remove Cavity surface none

Parameters:

entity1_ids

list of first entity ids associated with operation (see above table)

entity2_ids

list of second entity associated with operation (see above table)

params

array of parameters the operation needs to execute (see above table)

mesh_size

target mesh size for operation


get_ML_operation_name()

 std::string CubitInterface::get_ML_operation_name ( const int  op_type)

get an ML operation name according from its index

Parameters:

op_type

cubit operation id from table in get_ML_operation_features


get_moment_magnitude()

 double CubitInterface::get_moment_magnitude ( int  entity_id)

Get the moment magnitude from a force.

/param entity_id Id of the force /return magnitude of the moment on the given force
get_narrow_regions()

 std::vector<int> CubitInterface::get_narrow_regions ( std::vector< int >  target_ids, double  narrow_size  )

Get the list of surfaces with narrow regions.

Parameters:

target_volume_ids

List of volume ids to examine.

narrow_size

Indicate the size that defines ’narrowness’

Returns:
List (python tuple) of surface ids
get_narrow_surfaces()

 std::vector<int> CubitInterface::get_narrow_surfaces ( std::vector< int >  target_volume_ids, double  mesh_size  )

Get the list of narrow surfaces for a list of volumes.

’Narrow’ is a function of the mesh_size passed into the routine. The mesh_size parameter will act as the threshold for determining what ’narrow’ is.

Parameters:

target_volume_ids

List of volume ids to examine.

mesh_size

Indicate the mesh size used as the threshold

Returns:
List (python tuple) of small surface ids
get_next_block_id()

 int CubitInterface::get_next_block_id ( )

Get a next available block id.

Returns:
Next available block id
get_next_command_from_history()

 std::string CubitInterface::get_next_command_from_history ( )

Get ’next’ command from history buffer.

Returns:
A string which is the command
get_next_nodeset_id()

 int CubitInterface::get_next_nodeset_id ( )

Get a next available nodeset id.

Returns:
Next available nodeset id
get_next_sideset_id()

 int CubitInterface::get_next_sideset_id ( )

Get a next available sideset id.

Returns:
Next available sideset id
get_nodal_coordinates()

 std::array<double,3> CubitInterface::get_nodal_coordinates ( int  node_id)

Get the nodal coordinates for a given node id.

Parameters:

node_id

The node id

Returns:
a triple (python tuple) containing the x, y, and z coordinates
get_node_constraint()

 bool CubitInterface::get_node_constraint ( )

Query current setting for node constraint (move nodes to geometry)

Returns:
True if constrained, otherwise false
get_node_constraint_smart_metric()

 std::string CubitInterface::get_node_constraint_smart_metric ( )

Query current setting for node constraint smart metric Currently only for tets. Return either "distortion" of "normalized inradius".

Returns:
Returns quality metric name for projecting mid-nodes
get_node_constraint_smart_threshold()

 double CubitInterface::get_node_constraint_smart_threshold ( )

Query current setting for node constraint smart threshold.

Returns:
Returns quality threshold for projecting mid-nodes
get_node_constraint_value()

 int CubitInterface::get_node_constraint_value ( )

Query current setting for node constraint (move nodes to geometry)

Returns:
Returns 0 (off), 1(on), 2(smart)
get_node_count()

 int CubitInterface::get_node_count ( )

Get the count of nodes in the model.

Returns:
The number of nodes in the model
get_node_edges()

 std::vector<int> CubitInterface::get_node_edges ( int  node_id)

Get the edge ids that share a node.

Parameters:

node_id

The node id

Returns:
List (python tuple) of edge ids adjacent to the node
get_node_exists()

 bool CubitInterface::get_node_exists ( int  node_id)

Check the existance of a node.

Parameters:

node_id

The node id

Returns:
true or false
get_node_faces()

 std::vector<int> CubitInterface::get_node_faces ( int  node_id)

Get the face/quad ids that share a node.

Parameters:

node_id

The node id

Returns:
List (python tuple) of face/quad ids adjacent to the node
get_node_global_id()

 int CubitInterface::get_node_global_id ( int  node_id)

Given a node id, return the global element id that is assigned when the mesh is exported.

Parameters:

node_id

Specifies the id of the sphere

Returns:
The corresponding global node id
get_node_position_fixed()

 bool CubitInterface::get_node_position_fixed ( int  node_id)

Query "fixedness" state of node. A fixed node is not affecting by smoothing.

Parameters:

node_id

The node id

Returns:
True if constrained, otherwise false
get_node_tris()

 std::vector<int> CubitInterface::get_node_tris ( int  node_id)

Get the tri ids that share a node.

Parameters:

node_id

The node id

Returns:
List (python tuple) of tri ids adjacent to the node
get_nodeset_children()

 void CubitInterface::get_nodeset_children ( int  nodeset_id, std::vector< int > &  returned_node_list, std::vector< int > &  returned_volume_list, std::vector< int > &  returned_surface_list, std::vector< int > &  returned_curve_list, std::vector< int > &  returned_vertex_list  )

get lists of any and all possible children of a nodeset

A nodeset can contain a variety of entity types. This routine will return all contents of a specified nodeset.

Parameters:

nodeset_id

User specified id of the desired nodeset

node_list

User specified list where nodes associated with this nodeset are returned

volume_list

User specified list where volumes associated with this nodeset are returned

surface_list

User specified list where surfaces associated with this nodeset are returned

curve_list

User specified list where curves associated with this nodeset are returned

vertex_list

User specified list where vertices associated with this nodeset are returned


get_nodeset_count()

 int get_nodeset_count ( )

Get the current number of sidesets.

Returns:
The number of sidesets in the current model, if any
get_nodeset_curves()

 std::vector<int> CubitInterface::get_nodeset_curves ( int  nodeset_id)

Get a list of curve ids associated with a specific nodeset.

Parameters:

nodeset_id

User specified id of the desired nodeset

Returns:
A list (python tuple) of curve ids contained in the nodeset
get_nodeset_id_list()

 std::vector<int> CubitInterface::get_nodeset_id_list ( )

Get a list of all nodesets.

Returns:
List (python tuple) of all active nodeset ids
get_nodeset_id_list_for_bc()

 std::vector<int> CubitInterface::get_nodeset_id_list_for_bc ( CI_BCTypes  bc_type_enum, int  bc_id  )

Get a list of all nodesets the specified bc is applied to.

Parameters:

bc_type_in

Type of bc to query, as defined by enum CI_BCTypes. 1-9 is FEA, 10-30 is CFD

bc_id

ID of the bc to query

Returns:
A list (python tuple) of nodeset ID’s associated with that bc
get_nodeset_node_count()

 int CubitInterface::get_nodeset_node_count ( int  nodeset_id)

Get the number of nodes in a nodeset.

Parameters:

nodeset_id

The nodeset id

Returns:
Number of nodes in the nodeset
get_nodeset_nodes()

 std::vector<int> CubitInterface::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.

Parameters:

nodeset_id

User specified id of the desired nodeset

Returns:
A list (python tuple) of node ids contained in the nodeset
get_nodeset_nodes_inclusive()

 std::vector<int> CubitInterface::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.

Parameters:

nodeset_id

User specified id of the desired nodeset

Returns:
A list (python tuple) of node ids contained in the nodeset
get_nodeset_surfaces()

 std::vector<int> CubitInterface::get_nodeset_surfaces ( int  nodeset_id)

Get a list of surface ids associated with a specific nodeset.

Parameters:

nodeset_id

User specified id of the desired nodeset

Returns:
A list (python tuple) of surface ids contained in the nodeset
get_nodeset_vertices()

 std::vector<int> CubitInterface::get_nodeset_vertices ( int  nodeset_id)

Get a list of vertex ids associated with a specific nodeset.

Parameters:

nodeset_id

User specified id of the desired nodeset

Returns:
A list (python tuple) of vertex ids contained in the nodeset
get_nodeset_volumes()

 std::vector<int> CubitInterface::get_nodeset_volumes ( int  nodeset_id)

Get a list of volume ids associated with a specific nodeset.

Parameters:

nodeset_id

User specified id of the desired nodeset

Returns:
A list (python tuple) of volume ids contained in the nodeset
get_overlap_max_angle()

 double CubitInterface::get_overlap_max_angle ( void  )

Get the max angle setting for calculating surface overlaps.

Returns:
The max angle setting
get_overlap_max_gap()

 double CubitInterface::get_overlap_max_gap ( void  )

Get the max gap setting for calculating surface overlaps.

Returns:
The max gap setting
get_overlap_min_gap()

 double CubitInterface::get_overlap_min_gap ( void  )

Get the min gap setting for calculating surface overlaps.

Returns:
The min gap setting
get_owning_body()

 int CubitInterface::get_owning_body ( const std::string &  geometry_type, int  entity_id  )

Get the owning body for a specified entity.

int body_id = CubitInterface::get_owning_body("curve", 12);

body_id = cubit.get_owning_body("curve", 12)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
ID of the specified entity’s owning body
get_owning_volume()

 int CubitInterface::get_owning_volume ( const std::string &  geometry_type, int  entity_id  )

Get the owning volume for a specified entity.

int volume_id = CubitInterface::get_owning_volume("curve", 12);

volume_id = cubit.get_owning_volume("curve", 12)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
ID of the specified entity’s owning volume
get_owning_volume_by_name()

 int CubitInterface::get_owning_volume_by_name ( const std::string &  entity_name)

Get the owning volume for a specified entity.

int volume_id = CubitInterface::get_owning_volume_by_name("TipSurface");

volume_id = cubit.get_owning_volume_by_name("TipSurface")

Parameters:

entity_name

Specifies the name (supplied by Cubit) of the entity

Returns:
ID of the specified entity’s owning volume or 0 if name is unknown
get_owning_volume_ids()

 void CubitInterface::get_owning_volume_ids ( const std::string &  entity_type, std::vector< int > &  entity_list, std::vector< int > &  volume_ids  )

Gets the id’s of the volumes that are owners of one of the specified entities.

Parameters:

entity_type

entity_list

vol_ids


get_parent_assembly_instance()

 int CubitInterface::get_parent_assembly_instance ( int  assembly_id)

Get the stored instance number of an assembly node’s instance.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
Instance of the assembly node’ instance
get_parent_assembly_path()

 std::string CubitInterface::get_parent_assembly_path ( int  assembly_id)

Get the stored path of an assembly node’ parent.

Parameters:

assembly_id

Id that identifies the assembly node

Returns:
Path of the assembly node’ parent
get_periodic_data()

 void CubitInterface::get_periodic_data ( const std::string &  geometry_type, int  entity_id, double &  returned_interval, std::string &  returned_firmness, int &  returned_lower_bound, std::string &  returned_upper_bound  )

Get the periodic data for a surface or curve.

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

interval

User specified variable where interval count for the specified entity is returned

firmness

User specified variable where a firmness of ’hard’, ’soft’, or ’default’ is returned

lower_bound

User specified variable where the lower bound value is returned

upper_bound

User specified variable where the upper bound value is returned


get_pick_type()

 const char* CubitInterface::get_pick_type ( )

Get the current pick type.

Returns:
The current pick type of the graphics system
get_pressure_function()

 std::string CubitInterface::get_pressure_function ( int  entity_id)

Get the pressure function.

/param entity_id Id of the pressure /return The pressure function
get_pressure_value()

 double CubitInterface::get_pressure_value ( int  entity_id)

Get the pressure value.

/param entity_id Id of the pressure /return The value or magnitude of the given pressure
get_previous_command_from_history()

 std::string CubitInterface::get_previous_command_from_history ( )

Get ’previous’ command from history buffer.

Returns:
A string which is the command
get_pyramid_count()

 int CubitInterface::get_pyramid_count ( )

Get the count of pyramids in the model.

Returns:
The number of pyramids in the model
get_pyramid_global_element_id()

 int CubitInterface::get_pyramid_global_element_id ( int  pyramid_id)

Given a pyramid id, return the global element id.

Parameters:

pyramid_id

Specifies the id of the pyramid

Returns:
The corresponding element id
get_quad_count()

 int CubitInterface::get_quad_count ( )

Get the count of quads in the model.

Returns:
The number of quads in the model
get_quad_global_element_id()

 int CubitInterface::get_quad_global_element_id ( int  quad_id)

Given a quad id, return the global element id.

Parameters:

quad_id

Specifies the id of the quad

Returns:
The corresponding element id
get_quality_stats()

 void CubitInterface::get_quality_stats ( const std::string &  entity_type, std::vector< int >  id_list, const std::string &  metric_name, double  single_threshold, bool  use_low_threshold, double  low_threshold, double  high_threshold, double &  min_value, double &  max_value, double &  mean_value, double &  std_value, int &  min_element_id, int &  max_element_id, std::vector< int > &  mesh_list, std::string &  element_type, int &  bad_group_id, bool  make_group = false  )

Get the quality stats for a specified entity.

Parameters:

entity_type

Specifies the geometry type of the entity

id_list

Specifies a list of ids to work on

metric_name

Specify the metric used to determine the quality

single_threshold

Quality threshold value

use_low_threshold

use threshold as lower or upper bound

low_threshold

Quality threshold when using a lower and upper range

high_threshold

Quality threshold when using a lower and upper range

min_value

Quality value of the worst element

max_value

Quality value of the best element

mean_value

Average quality value of all elements

std_value

Std deviationvalue of all elements

min_element_id

ID of the worst element

max_element_id

ID of the best element

mesh_list

list of failed elements

element_type

type of failed elements (does not support mixed element types)

make_group

whether to create a group or not

bad_group_id

ID of the created group

min_value

User specified variable where the minimum quality value will be returned

max_value

User specified variable where the maximum quality value will be returned

mean_value

User specified variable where the mean quality value will be returned

std_value

User specified variable where the standard deviation quality value will be returned


get_quality_stats_at_geometry()

 std::vector<double> CubitInterface::get_quality_stats_at_geometry ( const std::string &  geom_type, const std::string &  mesh_type, const std::vector< int >  geom_id_list, const int  expand_levels, const std::string &  metric_name, const double  single_threshold, const bool  use_low_threshold, const double  low_threshold, const double  high_threshold, const bool  make_group  )

get element quality at a list of geometry entities. Finds all elements with nodes ON/IN the specified geometry and finds the quality of all elements of the specfied element type that are connected. Same arguments and return values as get_elem_quality_stats except a geometry and element type are used as arguments

std::vector<int> geom_ids = {4, 5};

expand_levels = 2

double single_threshold = 0.2;

bool use_low_threshold = false;

double low_threshold = 0.0;

double high_threshold = 0.0;

bool make_group = true;

 

std::vector<double>

quality_data = CubitInterface::get_quality_stats_at_geometry("surface", "tet",

geom_ids, expand_levels, "scaled jacobian",

single_threshold, use_low_threshold,

low_threshold, high_threshold,

make_group);

double min_value = quality_data[0];

double max_value = quality_data[1];

double mean_value = quality_data[2];

double std_value = quality_data[3];

int min_element_id = (int)quality_data[4];

int max_element_id = (int)quality_data[5];

int element_type = (int)quality_data[6];

int bad_group_id = (int)quality_data[7];

int num_elems = (int)quality_data[8];

std::vector<int> elem_ids(num_elems);

for (int i=9, j=0; i<quality_data.size(); i++, j++)

elem_ids[j] = (int)quality_data[i];

Parameters:

geom_type

Specifies the geometry type of the entities

mesh_type

Specifies the element type to find quality at geom entities

id_list

Specifies a list of geometry entity ids to work on

expand_levels

Number of element levels from target geometry to expand

metric_name

Specify the metric used to determine the quality

single_threshold

Quality threshold value

use_low_threshold

use threshold as lower or upper bound

low_threshold

Quality threshold when using a lower and upper range

high_threshold

Quality threshold when using a lower and upper range

Returns:
[0] min_value [1] max_value [2] mean_value [3] std_value [4] min_element_id [5] max_element_id [6] element_type 0 = edge, 1 = tri, 2 = quad, 3 = tet, 4 = hex [7] bad_group_id [8] size of mesh_list [9]...[n-1] mesh_list
get_quality_value()

 double CubitInterface::get_quality_value ( const std::string &  mesh_type, int  mesh_id, const std::string &  metric_name  )

Get the metric value for a specified mesh entity.

Parameters:

mesh_type

Specifies the mesh entity type (hex, tet, tri, quad)

mesh_id

Specifies the id of the mesh entity

metric_name

Specifies the name of the metric (skew, taper, jacobian, etc)

Returns:
The value of the quality metric
get_relatives()

 std::vector<int> CubitInterface::get_relatives ( const std::string &  source_geometry_type, int  source_id, const std::string &  target_geom_type  )

Get the relatives (parents/children) of a specified entity.

This can be used to get either ancestors or predecessors for a specific entity. Only one specified entity type is returned with one use of the routine. For example, to get all surface parents associated with Curve 1, ’curve’ is the source_geometry_type, ’1’ is the source_id, and ’surface’ is the target_geom_type.

std::vector<int> relative_list;

curve_list = CubitInterface::get_relatives("surface", 12, "curve");

curve_list = cubit.get_relatives("surface", 12, "curve")

Parameters:

source_geom_type

The entity type of the source entity

source_id

The id of the source entity

target_geom_type

The target geometry type

Returns:
A list (python tuple) of ids of the target geometry type
get_rendering_mode()

 int CubitInterface::get_rendering_mode ( )

Get the current rendering mode.

Returns:
The current rendering mode of the graphics subsystem
get_requested_mesh_interval_firmness()

 std::string CubitInterface::get_requested_mesh_interval_firmness ( const std::string &  geometry_type, int  entity_id  )

Get the mesh interval firmness for the specified entity as set specifically on the entity.

std::string firmness;

CubitInterface::get_requested_mesh_interval_firmness("surface", 12);

firmness = cubit.get_requested_mesh_interval_firmness("surface", 12)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
The entity’s meshing firmness (HARD, SOFT, LIMP) HARD = set directly SOFT = computed LIMP = not set
get_requested_mesh_intervals()

 int CubitInterface::get_requested_mesh_intervals ( const std::string &  geometry_type, int  entity_id  )

Get the interval count for a specified entity as set specifically on that entity.

int intervals = CubitInterface::get_meshed_intervals("surface", 12);

intervals = cubit.get_meshed_intervals("surface", 12)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
The entity’s interval count
get_requested_mesh_size()

 double CubitInterface::get_requested_mesh_size ( const std::string &  geometry_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.

double mesh_size = CubitInterface::get_requested_meshed_size("volume", 2);

mesh_size = cubit.get_mesh_size("volume", 2)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
The entity’s requested mesh size
get_requested_mesh_size_type()

 std::string CubitInterface::get_requested_mesh_size_type ( const std::string &  geometry_type, int  entity_id  )

Get the mesh size setting type for the specified entity as set specifically on the entity.

std::string firmness;

CubitInterface::get_requested_mesh_size_setting_type("surface", 12);

firmness = cubit.get_requested_mesh_size_setting_type("surface", 12)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
The entity’s mesh size type (USER_SET, CALCULATED, NOT_SET)
get_revision_date()

 std::string CubitInterface::get_revision_date ( )

Get the Cubit revision date.

Returns:
A string containing Cubit’s last date of revision
get_rubberband_shape()

 int CubitInterface::get_rubberband_shape ( )

Get the current rubberband select mode.

Returns:
0 for box, 1, for polygon, 2 for circle
get_selected_id()

 int CubitInterface::get_selected_id ( int  index)

Get the selected id based on an index.

Returns:
An id based on the passed in index
get_selected_ids()

 std::vector<int> CubitInterface::get_selected_ids ( )

Get a list of the currently selected ids.

Returns:
A list of the currently selected ids
get_selected_type()

 std::string CubitInterface::get_selected_type ( int  index)

Get the selected type based on an index.

Returns:
A type based on the passed in index
get_sharp_angle_vertices()

 std::vector<std::vector<double> > CubitInterface::get_sharp_angle_vertices ( std::vector< int >  target_volume_ids, double  upper_bound, double  lower_bound  )

Get the list of vertices at sharp curve angles for a list of volumes returns two parallel arrays. First array are the vertex ids and second are the associated angles at the vertices.

’Sharp’ is a function of the upper_bound and lower_bound threshold parameters. The id of vertices is returned. Similar to get_sharp_curve_angles except only vertices are returned with angles above upper_bound and below lower_bound

Parameters:

target_volume_ids

List of volume ids to examine.

upper_bound

Upper threshold angle

lower_bound

Lower threshold angle


get_sharp_curve_angles()

 void CubitInterface::get_sharp_curve_angles ( std::vector< int >  target_volume_ids, std::vector< int > &  returned_large_curve_angles, std::vector< int > &  returned_small_curve_angles, std::vector< double > &  returned_large_angles, std::vector< double > &  returned_small_angles, double  upper_bound, double  lower_bound  )

Get the list of sharp curve angles for a list of volumes.

’Sharp’ is a function of the upper_bound and lower_bound threshold parameters. The id of curves are returned when any angle associated with a curve is less than the lower_bound or greater than the upper_bound.

Parameters:

target_volume_ids

List of volume ids to examine.

large_curve_angles

User specified list where the ids of curves with curve angles will be returned

small_curve_angles

User specified list where the ids of curves with small angles will be returned

large_angles

User specified list where the angles associated with large_curve_angles will be returned. Angles returned are in the same order as the ids returned in large_curve_angles.

small_angles

User specified list where the angles associated with small_curve_angles will be returned. Angles returned are in the same order as the ids returned in small_curve_angles.

upper_bound

Upper threshold angle

lower_bound

Lower threshold angle


get_sharp_surface_angles()

 void CubitInterface::get_sharp_surface_angles ( std::vector< int >  target_volume_ids, std::vector< int > &  returned_large_surface_angles, std::vector< int > &  returned_small_surface_angles, std::vector< double > &  returned_large_angles, std::vector< double > &  returned_small_angles, double  upper_bound, double  lower_bound  )

Get the list of sharp surface angles for a list of volumes.

’Sharp’ is a function of the upper_bound and lower_bound threshold parameters. The id of surfaces are returned when any angle associated with a surface is less than the lower_bound or greater than the upper_bound.

Parameters:

target_volume_ids

List of volume ids to examine.

large_surface_angles

User specified list where the ids of surfaces with large angles will be returned

small_surface_angles

User specified list where the ids of surfaces with small angles will be returned

large_angles

User specified list where the angles associated with large_surface_angles will be returned. Angles returned are in the same order as the ids returned in large_surface_angles.

small_angles

User specified list where the angles associated with small_surface_angles will be returned. Angles returned are in the same order as the ids returned in small_surface_angles.

upper_bound

Upper threshold angle

lower_bound

Lower threshold angle


get_sideset_children()

 void CubitInterface::get_sideset_children ( int  sideset_id, std::vector< int > &  returned_face_list, std::vector< int > &  returned_surface_list, std::vector< int > &  returned_curve_list  )

get lists of any and all possible children of a sideset

A nodeset can contain a variety of entity types. This routine will return all contents of a specified sideset.

Parameters:

sideset_id

User specified id of the desired sideset

face_list

User specified list where faces associated with this sideset are returned

surface_list

User specified list where surfaces associated with this sideset are returned

curve_list

User specified list where curves associated with this sideset are returned


get_sideset_count()

 int get_sideset_count ( )

Get the current number of sidesets.

Returns:
The number of sidesets in the current model, if any
get_sideset_curves()

 std::vector<int> CubitInterface::get_sideset_curves ( int  sideset_id)

Get a list of curve ids associated with a specific sideset.

Parameters:

sideset_id

User specified id of the desired sideset

Returns:
A list (python tuple) of curve ids contained in the sideset
get_sideset_edges()

 std::vector<int> CubitInterface::get_sideset_edges ( int  sideset_id)

Get a list of any quads in a sideset.

A sideset can contain edge elements. This function will return those edge elements if they exist. An empty list will be returned if there are no edges in the sideset.

Parameters:

sideset_id

User specified id of the desired sideset

Returns:
A list (python tuple) of the edges in the sideset
get_sideset_element_type()

 std::string CubitInterface::get_sideset_element_type ( int  sideset_id)

Get the element type of a sideset.

Parameters:

sideset_id

The id of the sideset to be queried

Returns:
Element type
get_sideset_id_list()

 std::vector<int> CubitInterface::get_sideset_id_list ( )

Get a list of all sidesets.

Returns:
List (python tuple) of all active sideset ids
get_sideset_id_list_for_bc()

 std::vector<int> CubitInterface::get_sideset_id_list_for_bc ( CI_BCTypes  bc_type_enum, int  bc_id  )

Get a list of all sidesets the specified bc is applied to.

Parameters:

bc_type_in

Type of bc to query, as defined by enum CI_BCTypes. 1-9 is FEA, 10-30 is CFD

bc_id

ID of the bc to query

Returns:
A list (python tuple) of sideset ID’s associated with that bc
get_sideset_quads()

 std::vector<int> CubitInterface::get_sideset_quads ( int  sideset_id)

Get a list of any quads in a sideset.

A sideset can contain quadrilateral elements.
This function will return those quad elements if they exist. An empty list will be returned if there are no quads in the sideset.

Parameters:

sideset_id

User specified id of the desired sideset

Returns:
A list (python tuple) of the quads in the sideset
get_sideset_surfaces()

 std::vector<int> CubitInterface::get_sideset_surfaces ( int  sideset_id)

Get a list of any surfaces in a sideset.

A sideset can contain surfaces. This function will return those surfaces if they exist. An empty list will be returned if there are no surfaces in the sideset.

Parameters:

sideset_id

User specified id of the desired sideset

Returns:
A list (python tuple) of the surfaces defining the sideset
get_similar_curves()

 std::vector<int> CubitInterface::get_similar_curves ( std::vector< int >  curve_ids)

Get similar curves with the same length.

Parameters:

curve_ids

IDs of curve to compare against

Returns:
list of IDs of similar surfaces
get_similar_surfaces()

 std::vector<int> CubitInterface::get_similar_surfaces ( std::vector< int >  surface_ids)

Get similar surfaces with the same area and number of curves.

Parameters:

surface_ids

IDs of surface to compare against

Returns:
list of IDs of similar surfaces
get_similar_volumes()

 std::vector<int> CubitInterface::get_similar_volumes ( std::vector< int >  volume_ids)

Get similar volumes with the same volume and number of faces.

Parameters:

volume_ids

IDs of volume(s) to compare against

Returns:
list of IDs of similar volumes
get_sizing_function_name()

 std::string get_sizing_function_name ( const std::string &  entity_type, int  surface_id  )

Get the sizing function name for a surface or volume.

Parameters:

entity_type

Type (volume or surface)

entity_id

Id of the entity

Returns:
The sizing function name (constant, curvature, interval, inverse, linear, super, test, exodus, none)
get_small_and_narrow_surfaces()

 std::vector<int> CubitInterface::get_small_and_narrow_surfaces ( std::vector< int >  target_ids, double  small_area, double  small_curve_size  )

Get the list of small or narrow surfaces from a list of volumes.

Parameters:

target_volume_ids

List of volume ids to examine.

small_area

Indicate the area threshold

small_curve_size

Indicate size for ’narrowness’

Returns:
List (python tuple) of small or narrow surface ids
get_small_curves()

 std::vector<int> CubitInterface::get_small_curves ( std::vector< int >  target_volume_ids, double  mesh_size  )

Get the list of small curves for a list of volumes.

’Small’ is a function of the mesh_size passed into the routine. The mesh_size parameter will act as the threshold for determining what ’small’ is. A small entity is one that has an edge length smaller than mesh_size.

Parameters:

target_volume_ids

List of volume ids to examine. in Cubit is valid as input here.

mesh_size

Indicate the mesh size used as the threshold

Returns:
List (python tuple) of small curve ids
get_small_radius_blend_surfaces()

 std::vector<int> CubitInterface::get_small_radius_blend_surfaces ( std::vector< int >  target_volume_ids, double  max_radius  )

Get the list of blend surfaces for a list of volumes that have a radius of curvature smaller than max_radius.

Parameters:

target_volume_ids

List of volume ids to examine. max_radius maximum radius of curvature for which blend surfaces will be returned if max_radius = 0, then all blend surfaces will be returned.

Returns:
List (python tuple) of blend surface ids
get_small_surfaces()

 std::vector<int> CubitInterface::get_small_surfaces ( std::vector< int >  target_volume_ids, double  mesh_size  )

Get the list of small surfaces for a list of volumes.

’Small’ is a function of the mesh_size passed into the routine. The mesh_size parameter will act as the threshold for determining what ’small’ is. A small entity is one that has an edge length smaller than mesh_size.

Parameters:

target_volume_ids

List of volume ids to examine.

mesh_size

Indicate the mesh size used as the threshold

Returns:
List (python tuple) of small surface ids
get_small_surfaces_HR()

 std::vector<int> CubitInterface::get_small_surfaces_HR ( std::vector< int >  target_volume_ids, double  mesh_size  )

Python callable version Get the list of small hydraulic radius surfaces for a list of volumes.

’Small’ is a function of the mesh_size passed into the routine. The mesh_size parameter will act as the threshold for determining what ’small’ is. A small entity is one that has an edge length smaller than mesh_size.

Parameters:

target_volume_ids

List of volume ids to examine.

mesh_size

Indicate the mesh size used as the threshold

Returns:
return the list of small hydraulic radius surfaces (same as returned_small_surfaces)
get_small_surfaces_hydraulic_radius()

 void CubitInterface::get_small_surfaces_hydraulic_radius ( std::vector< int >  target_volume_ids, double  mesh_size, std::vector< int > &  returned_small_surfaces, std::vector< double > &  returned_small_radius  )

Get the list of small hydraulic radius surfaces for a list of volumes.

’Small’ is a function of the mesh_size passed into the routine. The mesh_size parameter will act as the threshold for determining what ’small’ is. A small entity is one that has an edge length smaller than mesh_size.

Parameters:

target_volume_ids

List of volume ids to examine.

mesh_size

Indicate the mesh size used as the threshold

returned_small_surfaces

ids of small hydraulic radius surfaces will be returned

returned_small_radius

User The hydrualic radius of each small surface will be returned. The order of the radius values is the same as the order of the returned ids.

Returns:
return the list of small hydraulic radius surfaces (same as returned_small_surfaces)
get_small_volumes()

 std::vector<int> CubitInterface::get_small_volumes ( std::vector< int >  target_volume_ids, double  mesh_size  )

Get the list of small volumes from a list of volumes.

’Small’ is a function of the mesh_size passed into the routine. The mesh_size parameter will act as the threshold for determining what ’small’ is. volumes with volume < 10*mesh_size^3 will be returned.

Parameters:

target_volume_ids

List of volume ids to examine.

mesh_size

Indicate the mesh size used as the threshold

Returns:
List (python tuple) of small volume ids
get_small_volumes_hydraulic_radius()

 void CubitInterface::get_small_volumes_hydraulic_radius ( std::vector< int >  target_volume_ids, double  mesh_size, std::vector< int > &  returned_small_volumes, std::vector< double > &  returned_small_radius  )

Get the list of small hydraulic radius volumes for a list of volumes.

’Small’ is a function of the mesh_size passed into the routine. The mesh_size parameter will act as the threshold for determining what ’small’ is. A small entity is one that has an edge length smaller than mesh_size.

Parameters:

target_volume_ids

List of volume ids to examine.

mesh_size

Indicate the mesh size used as the threshold

small_volumes

User specified list where the ids of small volumes will be returned

small_radius

User specified list where the radius of each small volume will be returned. The order of the radius values is the same as the order of the returned ids.


get_smallest_curves()

 std::vector<int> CubitInterface::get_smallest_curves ( std::vector< int >  target_volume_ids, int  number_to_return  )

Get a list of the smallest curves in the list of volumes. The number returned is specified by ’num_to_return’.

Parameters:

target_volume_ids

List of volume ids to examine. in Cubit is valid as input here.

num_to_return

Indicate the number of curves to return

Returns:
List (python tuple) of smallest curve ids
get_smooth_scheme()

 std::string CubitInterface::get_smooth_scheme ( const std::string &  geometry_type, int  entity_id  )

Get the smooth scheme for a specified entity.

std::string smooth_scheme;

CubitInterface::get_smooth_scheme("curve", 122, smooth_scheme);

smooth_scheme = cubit.get_smooth_scheme("curve", 122)

Parameters:

geom_type

Specifies the geometry type of the entity

entity_id

Specifies the id of the entity

Returns:
The smooth scheme associated with the entity
get_solutions_for_bad_geometry()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_bad_geometry ( std::string  geom_type, int  geom_id  )

Get lists of display strings and command strings for bad geometry.

Parameters:

geom_type

"curve", "surface", "volume" or "body"

geom_id

ID of geometry entity

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. This second set of strings may contain concatenated strings delimited by ’&&&’. In other words, one instance of command string may in fact contain multiple commands separated by the ’&&&’ sequence. Vector 3 will contain Cubit preview strings. Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_classified_volume()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_classified_volume ( std::string  classification, int  vol_id  )

Get lists of display, preview and command strings for a classified volume.

Parameters:

classification

string defining the classification type: "bolt", "nut", "washer", "spring", "ball", "race", "pin", "gear", "other"

vol_id

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. Vector 3 will contain Cubit preview strings. Vector 4 will contain operation strings for machine learning Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_close_loop()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_close_loop ( int  surface_id, double  mesh_size  )

Get the solution list for a given close loop surface.

Parameters:

surface_id

the surface being queried

mesh_size

Indicate size for ’narrowness’

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. Vector 3 will contain Cubit preview strings. Note: If using python, vectors will be python tuples.
get_solutions_for_cone_surface()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_cone_surface ( int  surface_id)

Get lists of display, preview and command strings for surfaces with defined as cones.

Parameters:

surface_id

cone surface


get_solutions_for_forced_sweepability()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_forced_sweepability ( int  volume_id, std::vector< int > &  source_surface_id_list, std::vector< int > &  target_surface_id_list, double  small_curve_size = -1.0  )

This function only works from C++ Get lists of display strings and command strings for forced sweepability solutions

Parameters:

volume_id

id of volume source_surface_id_list list of source surface ids target_surface_id_list list of target surface ids small_curve_size optional paramtere to specify small curve size

Returns:
Vector of two string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. Vector 3 will contain Cubit preview strings. Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_imprint_merge()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_imprint_merge ( int  surface_id1, int  surface_id2  )

Get lists of display strings and command strings for imprint/merge solutions.

Parameters:

surface_id1

overlapping surface 1 surface_id2 overlapping surface 2

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. This second set of strings may contain concatenated strings delimited by ’&&&’. In other words, one instance of command string may in fact contain multiple commands separated by the ’&&&’ sequence. Vector 3 will contain Cubit preview strings. Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_near_coincident_vertex_and_curve()

 std::vector<std::vector<std::string> > CubitInterface::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.

Parameters:

vertex_id

ID of the vertex

curve_id

ID of the curve

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. This second set of strings may contain concatenated strings delimited by ’&&&’. In other words, one instance of command string may in fact contain multiple commands separated by the ’&&&’ sequence. Vector 3 will contain Cubit preview strings. Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_near_coincident_vertex_and_surface()

 std::vector<std::vector<std::string> > CubitInterface::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.

Parameters:

vertex_id

ID of the vertex

surface_id

ID of the surface

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. This second set of strings may contain concatenated strings delimited by ’&&&’. In other words, one instance of command string may in fact contain multiple commands separated by the ’&&&’ sequence. Vector 3 will contain Cubit preview strings. Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_near_coincident_vertices()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_near_coincident_vertices ( int  vertex_id_1, int  vertex_id_2  )

Get lists of display strings and command strings for near coincident vertices.

Parameters:

target_vertex_ids

Vertex list

high_tolerance

The upper threshold tolerance value

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. This second set of strings may contain concatenated strings delimited by ’&&&’. In other words, one instance of command string may in fact contain multiple commands separated by the ’&&&’ sequence. Vector 3 will contain Cubit preview strings. Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_overlapping_surfaces()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_overlapping_surfaces ( int  surface_id_1, int  surface_id_2  )

Get lists of display strings and command strings for overlapping surfaces.

Parameters:

id

of surface 1

id

of surface 2

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. This second set of strings may contain concatenated strings delimited by ’&&&’. In other words, one instance of command string may in fact contain multiple commands separated by the ’&&&’ sequence. Vector 3 will contain Cubit preview strings. Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_overlapping_volumes()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_overlapping_volumes ( int  volume_id_1, int  volume_id_2, double  maximum_gap_tolerance, double  maximum_gap_angle  )

Get lists of display strings and command strings for overlapping volumes.

Parameters:

id

of volume 1

id

of volume 2

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. This second set of strings may contain concatenated strings delimited by ’&&&’. In other words, one instance of command string may in fact contain multiple commands separated by the ’&&&’ sequence. Vector 3 will contain Cubit preview strings. Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_sharp_angle_vertex()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_sharp_angle_vertex ( int  vertex_id, double  small_curve_size, double  mesh_size  )

Get lists of display, preview and command strings for sharp angle solutions.

Parameters:

vertex_id

vertex with sharp angle

small_curve_size

Threshold value used to determine what ’small’ is

mesh_size

Element size of the model

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. Vector 3 will contain Cubit preview strings. Vector 4 will contain operation strings for machine learning Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_small_curves()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_small_curves ( int  curve_id, double  small_curve_size, double  mesh_size  )

Get lists of display, preview and command strings for small curve solutions.

Parameters:

curve_id

Small curve

small_curve_size

Threshold value used to determine what ’small’ is

mesh_size

Element size of the model

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. Vector 3 will contain Cubit preview strings. Vector 4 will contain operation strings for machine learning Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_small_surfaces()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_small_surfaces ( int  surface_id, double  small_curve_size, double  mesh_size  )

Get lists of display, preview and command strings for small surface solutions.

Parameters:

surface_id

Small surface

small_curve_size

Threshold value used to determine what ’small’ is

mesh_size

Element size of the model

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. Vector 3 will contain Cubit preview strings. Vector 4 will contain operation strings for machine learning Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_surfaces_with_narrow_regions()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_surfaces_with_narrow_regions ( int  surface_id, double  small_curve_size, double  mesh_size  )

Get lists of display, preview and command strings for surfaces with narrow regions solutions.

Parameters:

surface_id

Small surface

small_curve_size

Threshold value used to determine what ’small’ is

mesh_size

Element size of the model

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. Vector 3 will contain Cubit preview strings. Note: If using this function in python, returned vectors will be python tuples.
get_solutions_for_volumes()

 std::vector<std::vector<std::string> > CubitInterface::get_solutions_for_volumes ( int  vol_id, double  small_curve_size, double  mesh_size  )

Get lists of display, preview and command strings for small volume solutions.

Parameters:

vol_id

small_curve_size

Threshold value used to determine what ’small’ is

mesh_size

Element size of the model

Returns:
Vector of three string vectors. Vector 1 will contain display strings to be shown to users. Vector 2 will contain Cubit command strings. Vector 3 will contain Cubit preview strings. Vector 4 will contain operation strings for machine learning Note: If using this function in python, returned vectors will be python tuples.
get_source_surfaces()

 std::vector<int> CubitInterface::get_source_surfaces ( int  volume_id)

Get a list of a volume’s sweep source surfaces.

Parameters:

volume_id

Specifies the volume id

Returns:
List (python tuple) of surface ids
get_sphere_count()

 int CubitInterface::get_sphere_count ( )

Get the count of sphere elements in the model.

Returns:
The number of spheres in the model
get_sphere_global_element_id()

 int CubitInterface::get_sphere_global_element_id ( int  edge_id)

Given a sphere id, return the global element id.

Parameters:

sphere_id

Specifies the id of the sphere

Returns:
The corresponding element id
get_sub_elements()

 std::vector<int> CubitInterface::get_sub_elements ( const std::string &  entity_type, int  entity_id, int  dimension  )

Get the lower dimesion entities associated with a higher dimension entities. For example get the faces associated with a hex or the edges associated with a tri.

std::vector<int> face_id_list;

face_id_list = CubitInterface::get_sub_elements("hex", 221, 2);

face_id_list = cubit.get_sub_elements("hex", 221, 2)

Parameters:

entity_type

The mesh element type of the higher dimension entity

entity_id

The mesh element id

dimension

The dimension of the desired sub entities

Returns:
List (python tuple) of ids of the desired dimension
get_submap_corner_types()

 std::vector<std::pair<int, int> > CubitInterface::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.

Parameters:

the

id of the surface

Returns:
a vector of pairs of <id, corner_type> The corner_types are defined as follows

UNSET_TYPE = -1, END_TYPE = 1, SIDE_TYPE, CORNER_TYPE, REVERSAL_TYPE, TRIANGLE_TYPE, NON_TRIANGLE_TYPE ; }
get_surface_area()

 double CubitInterface::get_surface_area ( int  surface_id)

Get the area of a surface.

Parameters:

surface_id

ID of the surface

Returns:
Area of the surface
get_surface_centroid()

 std::array<double,3> CubitInterface::get_surface_centroid ( int  surface_id)

Get the surface centroid for a specified surface.

Parameters:

surface_id

ID of the surface

Returns:
surface centroid
get_surface_count()

 int CubitInterface::get_surface_count ( )

Get the current number of surfaces.

Returns:
The number of surfaces in the current model, if any
get_surface_element_count()

 int CubitInterface::get_surface_element_count ( int  surface_id)

Get the count of elements in a surface.

Returns:
The number of quads, and triangles in a surface. NOTE: This count does not distinguish between elements which have been put into a block or not.
get_surface_loop_nodes()

 std::vector<std::vector<int> > CubitInterface::get_surface_loop_nodes ( int  surface_id)

get the ordered list of nodes on the loops of this surface

Parameters:

surface_id

User specified id of the desired surface

Returns:
A list of lists (python tuple of tuples) one list per loop first loop is the external
get_surface_nodes()

 std::vector<int> CubitInterface::get_surface_nodes ( int  surface_id)

Get list of node ids owned by a surface.
Excludes nodes owned by bounding curves and verts.

 int surf_id = 5;

vector<int> surface_nodes = CubitInterface::get_surface_nodes(surface_id);

Parameters:

surf_id

id of surface

Returns:
List (python tuple) of IDs of nodes owned by the surface

get_surface_normal()

 std::array<double,3> CubitInterface::get_surface_normal ( int  surface_id)

Get the surface normal for a specified surface.

Parameters:

surface_id

ID of the surface

Returns:
surface normal at the center
get_surface_normal_at_coord()

 std::array<double,3> CubitInterface::get_surface_normal_at_coord ( int  surface_id, std::array< double, 3 >    )

Get the surface normal for a specified surface at a location.

Parameters:

surface_id

ID of the surface

coord

array of x,y,z location on surface

Returns:
surface normal at coord
get_surface_num_loops()

 int CubitInterface::get_surface_num_loops ( int  surface_id)

get the number of loops on the surface

Parameters:

surface_id

User specified id of the desired surface

Returns:
number of loops on the surface
get_surface_principal_curvatures()

 std::vector<double> CubitInterface::get_surface_principal_curvatures ( int  surface_id)

Get the principal curvatures of a surface at surface mid_point.

Parameters:

surface_id

ID of the surface

Returns:
two scalars that are the principal curvatures at midpoint
get_surface_quads()

 std::vector<int> CubitInterface::get_surface_quads ( int  surface_id)

get the list of any quad elements on a given surface

Parameters:

surface_id

User specified id of the desired surface

Returns:
A list (python tuple) of the quad ids on the surface
get_surface_sense()

 std::string CubitInterface::get_surface_sense ( int  surface_id)

Get the surface sense for a specified surface.

Parameters:

surface_id

ID of the surface

Returns:
surface sense as "Reversed" or "Forward" or "Both"
get_surface_tris()

 std::vector<int> CubitInterface::get_surface_tris ( int  surface_id)

get the list of any tri elements on a given surface

Parameters:

surface_id

User specified id of the desired surface

Returns:
A list (python tuple) of the tri ids on the surface
get_surface_type()

 std::string CubitInterface::get_surface_type ( int  surface_id)

Get the surface type for a specified surface.

Parameters:

surface_id

ID of the surface

Returns:
Type of surface
get_surfs_with_narrow_regions()

 std::vector<int> CubitInterface::get_surfs_with_narrow_regions ( std::vector< int >  target_ids, double  narrow_size  )

Get the list of surfaces with narrow regions.

Parameters:

target_volume_ids

List of volume ids to examine.

narrow_size

Indicate the size that defines ’narrowness’

Returns:
List (python tuple) of surface ids
get_tangential_intersections()

 std::vector<int> CubitInterface::get_tangential_intersections ( std::vector< int >  target_volume_ids, double  upper_bound, double  lower_bound  )

Get the list of bad tangential intersections for a list of volumes.

’Bad’ is a function of the upper_bound and lower_bound threshold parameters. The id of surfaces are returned when any tangential angle associated with a surface is less than the lower_bound or greater than the upper_bound.

Parameters:

target_volume_ids

List of volume ids to examine.

upper_bound

Upper threshold angle

lower_bound

Lower threshold angle

Returns:
List (python tuple) of surface ids associated with bad tangential angles
get_target_surfaces()

 std::vector<int> CubitInterface::get_target_surfaces ( int  volume_id)

Get a list of a volume’s sweep target surfaces.

Parameters:

volume_id

Specifies the volume id

Returns:
List (python tuple) of surface ids
get_tet_count()

&nbs