Cubit Python API  15.8
Public Member Functions
Surface

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

Inheritance diagram for Surface:
GeomEntity Entity

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...
 
int  color ()
  Get the color of the surface. More...
 
void  color (int value)
  Set 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 (int 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...
 

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.

double 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() [1/2]

int 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

◆ color() [2/2]

void color ( int  value )  

Set the color of the surface.

surface->color(0);
Parameters
[in] value The color value that the surface will have

◆ 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();
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();
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();
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);
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 ( int  value )  

Set the color of the surface.

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