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

Inheritance diagram for Surface:

Public Member Functions
	Surface ()

	Surface (const Surface &other)

	Surface (CubitEntity *entity_ptr)

	~Surface ()

double	area ()
	Get area of the Surface. More...

std::array< double, 3 >	closest_point_along_vector (std::array< double, 3 > location, std::array< double, 3 > along_vector)
	Get the nearest point on the Surface to point specified along the specified vector. More...

std::array< double, 3 >	closest_point_trimmed (CubitInterface::Loc location)
	Get the nearest point on the Surface to point specified. More...

std::array< double, 3 >	closest_point_trimmed (std::array< double, 3 > location)
	Get the nearest point on the Surface to point specified. More...

std::array< double, 4 >	color ()
	Get the color of the surface. More...

std::array< double, 2 >	get_param_range_U ()
	Get range of u for the Surface. More...

std::array< double, 2 >	get_param_range_V ()
	Get range of v for the Surface. More...

bool	is_cylindrical ()
	Get whether the Surface is cylindrical or not. More...

bool	is_planar ()
	Get whether the Surface is planar or not. More...

std::array< double, 3 >	normal_at (std::array< double, 3 > location)
	Get the normal at a particular point on the Surface. More...

std::vector< std::vector< Curve > >	ordered_loops ()
	Get the ordered loops of the Surface. More...

int	point_containment (std::array< double, 3 > point_in)
	Get whether a point is on or off of the Surface. More...

std::array< double, 3 >	position_from_u_v (double u, double v)
	Get the Cartesian coordinates from the uv coordinates on the Surface. More...

std::array< double, 2 >	principal_curvatures (std::array< double, 3 > point)
	Get the principal curvatures of the Surface. More...

void	set_color (std::array< double, 4 > value)
	Set the color of the surface. More...

std::array< double, 2 >	u_v_from_position (std::array< double, 3 > location)
	Get the uv coordinates from the supplied Cartesian coordinates on the Surface. More...

Public Member Functions inherited from GeomEntity
std::vector< Body >	bodies ()
	Get the bodies in the GeomEntity. More...

std::vector< Curve >	curves ()
	Get the curves in the GeomEntity. More...

int	dimension ()
	Get the dimensions of the GeomEntity. More...

std::string	entity_name ()
	Return the first name of the GeomEntity. More...

void	entity_name (std::string name)
	Assign a name to the GeomEntity. More...

std::vector< std::string >	entity_names ()
	Return the all the names of the GeomEntity. More...

bool	is_meshed ()
	Return the current mesh state of the GeomEntity. More...

void	mesh ()
	Mesh the GeomEntity. More...

int	num_names ()
	Return the number of names for the GeomEntity. More...

void	remove_entity_name (std::string name)
	Remove a specific name from the list of names assigned to the GeomEntity. More...

void	remove_entity_names ()
	Remove all the names assigned to the GeomEntity. More...

void	remove_mesh ()
	Removes the mesh on the GeomEntity. More...

void	set_entity_name (std::string name)
	Assign a name to the GeomEntity. More...

void	smooth ()
	Smooths the mesh on the GeomEntity. More...

std::vector< Surface >	surfaces ()
	Get the surfaces in the GeomEntity. More...

std::vector< Vertex >	vertices ()
	Get the vertices in the GeomEntity. More...

std::vector< Volume >	volumes ()
	Get the volumes in the GeomEntity. More...

Public Member Functions inherited from Entity
	Entity ()

	Entity (CubitEntity *entity_ptr)

	Entity (Entity const &copy_from)

	~Entity ()

std::array< double, 6 >	bounding_box ()
	Get the bounding box of the Entity. More...

std::array< double, 3 >	center_point ()
	Get the center point of the Entity. More...

void	destroy_cubit_entity ()

CubitEntity *	entity_ptr ()

int	id ()
	Get the id of the Entity. More...

int	is_transparent ()
	Get the tranparency state of the Entity. More...

void	is_transparent (int transparency_flag)
	Set the tranparency state of the Entity. More...

int	is_visible ()
	Get the visibility state of the Entity. More...

void	is_visible (bool visibility_flag)
	Set the visibility state of the Entity. More...

Entity &	operator= (const Entity &rhs)

void	set_transparent (int transparency_flag)
	Set the tranparency state of the Entity. More...

void	set_visible (bool visibility_flag)
	Set the visibility state of the Entity. More...

Additional Inherited Members
Protected Member Functions inherited from GeomEntity
	GeomEntity (const GeomEntity &other)

	GeomEntity (CubitEntity *entity_ptr)

Protected Attributes inherited from Entity
CubObserver *	cubitWatcher

CubitEntity *	mEntityPtr

Detailed Description

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

Constructor & Destructor Documentation

◆ Surface() [1/3]

Surface ( )

inline

◆ ~Surface()

~Surface ( )

inline

◆ Surface() [2/3]

Surface ( const Surface & other )

inline

◆ Surface() [3/3]

Surface ( CubitEntity * entity_ptr )

inline

Member Function Documentation

◆ area()

double area ( )

Get area of the Surface .

doublearea = surface ->area ();

area = surface .area ()

Returns: The area of the Surface

◆ closest_point_along_vector()

std::array<double,3> closest_point_along_vector	(	std::array< double, 3 >	location,
		std::array< double, 3 >	along_vector
	)

Get the nearest point on the Surface to point specified along the specified vector.

                  std::array<double,3> point(3, 0);
               
                  std::array<double,3> along_vector{1,1,1};
               
                  std::array<double,3> nearest = surface
                  ->closest_point_trimmed
                  (point);

nearest = surface .closest_point_along_vector ([0,0,0], [1,1,1])

Parameters

[in] location A vector containing three values that are the coordinates of a point

Returns: A vector (or list) of doubles representing values of nearest point as follows:
0 - x coordinate
1 - y coordinate
2 - z coordinate

◆ closest_point_trimmed() [1/2]

std::array<double,3> closest_point_trimmed ( CubitInterface::Loc location )

Get the nearest point on the Surface to point specified.

std::array<double,3> point(3, 0);

std::array<double,3> nearest = surface ->closest_point_trimmed (point);

nearest = surface .closest_point_trimmed ([0,0,0])

Parameters

[in] location A vector containing three values that are the coordinates of a point

Returns: A vector (or list) of doubles representing values of nearest point as follows:
0 - x coordinate
1 - y coordinate
2 - z coordinate

◆ closest_point_trimmed() [2/2]

std::array<double,3> closest_point_trimmed ( std::array< double, 3 > location )

Get the nearest point on the Surface to point specified.

std::array<double,3> point(3, 0);

std::array<double,3> nearest = surface ->closest_point_trimmed (point);

nearest = surface .closest_point_trimmed ([0,0,0])

Parameters

[in] location A vector containing three values that are the coordinates of a point

Returns: A vector (or list) of doubles representing values of nearest point as follows:
0 - x coordinate
1 - y coordinate
2 - z coordinate

◆ color()

std::array<double, 4> color ( )

Get the color of the surface.

int col = surface ->color ();

col = surface .color ()

Returns: The color value associated with the surface's current color

◆ get_param_range_U()

std::array<double,2> get_param_range_U ( )

Get range of u for the Surface .

std::vector<double> bounds = surface ->get_param_range_U ();

bounds = surface .get_param_range_U ()

Returns: The curvature values:
0 - The lowest value in the u direction
1 - The highest value in the u direction

◆ get_param_range_V()

std::array<double,2> get_param_range_V ( )

Get range of v for the Surface .

std::vector<double> bounds = surface ->get_param_range_V ();

lower_bound, upper_bound = surface .get_param_range_V ()

Returns: The curvature values:
0 - The lowest value in the v direction
1 - The highest value in the v direction

◆ is_cylindrical()

bool is_cylindrical ( )

Get whether the Surface is cylindrical or not.

bool cyl = surface ->is_cylindrical ();

cyl = surface .is_cylindrical ()

Returns: Whether the Surface is cylindrical or not

◆ is_planar()

bool is_planar ( )

Get whether the Surface is planar or not.

bool planar = surface ->is_planar ();

planar = surface .is_planar ()

Returns: Whether the Surface is planar or not

◆ normal_at()

std::array<double,3> normal_at ( std::array< double, 3 > location )

Get the normal at a particular point on the Surface .

std::array<double,3> point(3, 0);

std::array<double,3> norm = surface ->normal_at (point);

norm = surface .normal_at ([0,0,0])

Parameters

[in] location A vector containing three values that are the coordinates of a point

Returns: A vector (or list) of doubles representing values of normal vector as follows:
0 - x value
1 - y value
2 - z value

◆ ordered_loops()

std::vector<std::vector<Curve> > ordered_loops ( )

Get the ordered loops of the Surface .

std::vector<std::vector<Curve> > loops = surface ->ordered_loops ();

loops = surface .ordered_loops ()

Returns: A vector of vectors (or list of lists) of Curves in loops:
0, 0 - loop 1 curve 1
0, 1 - loop 1 curve 2
1, 0 - loop 2 curve 1
etc...

◆ point_containment()

int point_containment ( std::array< double, 3 > point_in )

Get whether a point is on or off of the Surface .

std::array<double,3> point(3, 0);

int on_off = surface ->point_containment (point);

on_off = surface .point_containment ([0,0,0])

Parameters

[in] point_in A vector containing three values that are the coordinates of a point

Returns: A python boolean representing whether the point is off (0) or on (1) the Surface

◆ position_from_u_v()

std::array<double,3> position_from_u_v	(	double	u,
		double	v
	)

Get the Cartesian coordinates from the uv coordinates on the Surface .

std::vector<double> pos = surface ->position_from_u_v (0, 0);

pos = surface .position_from_u_v (0, 0)

Parameters

[in]	u	The u parameter
[in]	v	The v parameter

Returns: The Cartesian coordinates of the supplied uv coordinates as a vector:
0 - x coordinate
1 - y coordinate
2 - z coordinate

◆ principal_curvatures()

std::array<double,2> principal_curvatures ( std::array< double, 3 > point )

Get the principal curvatures of the Surface .

std::vector<double> point(3, 0);

std::vector<double> curvatures = surface ->principal_curvatures (point);

curvatures = surface .principal_curvatures ([0,0,0])

Parameters

[in] point A vector containing three values that are the coordinates of a point

Returns: A list of two floats representing the curvatures
0 - curvature 1
1 - curvature 2

◆ set_color()

void set_color ( std::array< double, 4 > value )

Set the color of the surface.

surface ->set_color (0);

surface .set_color (0)

Parameters

[in] value The color value that the surface will have

◆ u_v_from_position()

std::array<double,2> u_v_from_position ( std::array< double, 3 > location )

Get the uv coordinates from the supplied Cartesian coordinates on the Surface .

std::vector<double> location(3, 0);

std::vector<double> uv = surface ->u_v_from_position (location);

uv = surface .position_from_u_v ([0,0,0])

Parameters

[in] location A vector containing the Cartesian coordinates

Returns: The curvature values:
0 - The u parameter
1 - The v parameter

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Surface() [1/3]

◆ ~Surface()

◆ Surface() [2/3]

◆ Surface() [3/3]

Member Function Documentation

◆ area()

◆ closest_point_along_vector()

◆ closest_point_trimmed() [1/2]

◆ closest_point_trimmed() [2/2]

◆ color()

◆ get_param_range_U()

◆ get_param_range_V()

◆ is_cylindrical()

◆ is_planar()

◆ normal_at()

◆ ordered_loops()

◆ point_containment()

◆ position_from_u_v()

◆ principal_curvatures()

◆ set_color()

◆ u_v_from_position()