PCL Reference Manual > Geometry Functions > Associate Actions
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
Associate Actions
This section is used to describe some of the functions used to implement the “Associate” actions. 
 
sgm_assoc_element_curve_v1
(element_list, geo_list, flag)
Description:
This function will associate finite element mesh beam elements to geometric curves.
Input:
STRING
element_list[]
This value specifies the list of elements to be used for associating to the selected list of curves.
STRING
geo_list[]
This value specifies the list of geometry to which the elements will be associated.
INTEGER
flag
This value specifies the actions the finite element association should accomplish.
Output:
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.
Remarks:
The input value flag can be set to either 8 or 9. A value of 8 indicates that a mesh definition is not created on the curves to which elements must be associated. A value of 9 will create mesh definitions for each of the selected curves that are successfully associated with an element.
Example:
To associate the unassociated nodes and elements in the database within geometric proximity to the selected set of curves 1 through 10 :
sgm_assoc_element_curve_v1( ““, “Curve 1:10”, 9 )
To associate only specific elements (elements 1, 3 and 5 to 10) to curves 2 through 8:
sgm_assoc_element_curve_v1( “Elm 1 3 5:10“, “Curve 2:8”, 9 )
 
sgm_assoc_element_point_v1
(element_list, geo_list, flag)
Description:
This function will associate finite element mesh point elements to geometric points.
Input:
STRING
element_list[]
This value specifies the list of elements to be used for associating to the selected list of points.
STRING
geo_list[]
This value specifies the list of geometry to which the elements will be associated.
INTEGER
flag
This value specifies the actions the finite element association should accomplish.
Output:
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.
Remarks:
If elements are being associated to points the input value flag must be set to 0.
Example:
To associate the unassociated nodes and elements in the database within geometric proximity to the selected set of points 1 through 10 :
sgm_assoc_element_point_v1( ““, “Point 1:10”, 0 )
To associate only specific elements (elements 1, 3 and 5 to 10) to points 2 through 8:
sgm_assoc_element_point_v1( “Elm 1 3 5:10“, “Point 2:8”, 0 )
 
sgm_assoc_element_solid_v1
(element_list, geo_list, flag)
Description:
This function will associate finite element mesh solid elements to geometric solids.
Input:
STRING
element_list[]
This value specifies the list of elements to be used for associating to the selected list of solids.
STRING
geo_list[]
This value specifies the list of geometry to which the elements will be associated.
INTEGER
flag
This value specifies the actions the finite element association should accomplish.
Output:
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.
Remarks:
The input value flag can be set to either 32 or 33. A value of 32 indicates that a mesh definition is not created on the edges of the solid to which elements must be associated. A value of 33 will create mesh definitions for each of the edges of the selected solids that are successfully associated with an element.
Example:
To associate the unassociated nodes and elements in the database within geometric proximity to the selected set of solids 1 through 10 :
sgm_assoc_element_solid_v1( ““, “Solid 1:10”, 32)
To associate only specific elements (elements 1, 3 and 5 to 10) to Solid 2 though 8:
sgm_assoc_element_solid_v1( “Elm 1 3 5:10“, “Solid 2:8”, 32)
 
sgm_assoc_element_surface_v1
(element_list, geo_list, flag)
 
Description:
This function will associate finite element mesh surface elements to geometric surfaces.
Input:
STRING
element_list[]
This value specifies the list of elements to be used for associating to the selected list of surfaces.
STRING
geo_list[]
This value specifies the list of geometry to which the elements will be associated.
INTEGER
flag
This value specifies the actions the finite element association should accomplish.
Output:
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
See the Status Messages for information on any error values returned by this function.
Remarks:
The input value flag can be set to either 16 or 17. A value of 16 indicates that a mesh definition is not created on the surface to which elements must be associated. A value of 17 will create mesh definitions for each of the edges of the selected surfaces that are successfully associated with an element.
Example:
To associate the unassociated nodes and elements in the database within geometric proximity to the selected set of surfaces 1 through 10 :
sgm_assoc_element_surface_v1( ““, “Surface 1:10”, 17 )
To associate only specific elements (elements 1 to 1000) to surface 2 through 8:
sgm_assoc_element_surface_v1( “Elm 1000“, “Surface 2:8”, 17 )
 
sgm_associate_point_curve
(point_list, curve_list, joined_list)
Description:
This function associates a set of points to a set of curves.
Input:
STRING
point_list[]
This value specifies a list of point labels to be associated with curves.
STRING
curve_list[]
This value specifies a list of curve labels to which points will be associated.
Output:
STRING
joined_list[]
This value returns a list of joined entities.
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
1000025
Error attempting to allocate virtual memory.
1000053
No valid geometric entities of type %A% were used as input. Unable to process request.
1000054
An invalid geometric entity type was used as input. The valid entity type to use is %A%. Unable to process request.
38000931
Failed to associate the point(s) or curve(s).
Remarks:
A message of the following form will be written to the history window:
n Point(s): Point {pi, i = 1, n} associated to m Curve(s): Curve {cj, j= 1, m}
The database is modified due to the addition of new entities created by association.
Associated points are marked in the graphics window by a filled blue triangle.
Example:
Please see sgm_associate_point_curve (p. 593) in the PCL Reference Manual Examples.
 
sgm_associate_point_surface
(point_list, surface_list, joined_list)
 
Description:
This function associates a set of points to a set of surfaces.
Input:
STRING
point_list[]
This value specifies a list of point labels to be associated with surfaces.
STRING
surface_list[]
This value specifies a list of surface labels to which points will be associated.
Output:
STRING
joined_list[]
This value returns a list of joined entities.
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
1000025
Error attempting to allocate virtual memory.
1000053
No valid geometric entities of type %A% were used as input. Unable to process request.
1000054
An invalid geometric entity type was used as input. The valid entity type to use is %A%. Unable to process request.
38000931
Failed to associate the point(s) or curve(s).
Remarks:
A message of the following form will be written to the history window:
n Point(s): Point {pi, i = 1, n} associated to m Surface(s): Surface {sj, j= 1, m}
The database is modified due to the addition of new entities created by association.
Associated points are marked in the graphics window by a filled blue triangle.
Example:
Please see sgm_associate_point_surface (p. 594) in the PCL Reference Manual Examples.
 
sgm_associate_curve_curve
(curve_list1, curve_list2, joined_list)
 
Description:
This function associates a set of curves to another set of curves.
Input:
STRING
curve_list1[]
This value specifies a list of curve labels to be associated with curves.
STRING
curve_list2[]
This value specifies a list of curve labels to which curves will be associated.
Output:
STRING
joined_list[]
This value returns a list of joined entities.
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
1000025
Error attempting to allocate virtual memory.
1000053
No valid geometric entities of type %A% were used as input. Unable to process request.
1000054
An invalid geometric entity type was used as input. The valid entity type to use is %A%. Unable to process request.
38000931
Failed to associate the point(s) or curve(s).
Remarks:
A message of the following form will be written to the history window:
n Curve(s): Curve {ci, i = 1, n} associated to m Curve(s): Curve {cj, j= 1, m}
The database is modified due to the addition of new entities created by association. Associated curves are marked in the graphics window by a filled yellow triangle.
Example:
Please see sgm_associate_curve_curve (p. 596) in the PCL Reference Manual Examples.
 
sgm_associate_curve_surface
(curve_list, surface_list, joined_list)
 
Description:
This function associates a set of curves to a set of surfaces.
Input:
STRING
curve_list[]
This value specifies a list of curve labels to be associated with surfaces.
STRING
surface_list[]
This value specifies a list of surface labels to which curves will be associated.
Output:
STRING
joined_list[]
This value returns a list of joined entities.
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Error Conditions:
1000025
Error attempting to allocate virtual memory.
1000053
No valid geometric entities of type %A% were used as input. Unable to process request.
1000054
An invalid geometric entity type was used as input. The valid entity type to use is %A%. Unable to process request.
38000931
Failed to associate the point(s) or curve(s).
Remarks:
A message of the following form will be written to the history window:
n Curve(s): Curve {ci, i = 1, n} associated to m Surface(s): Surface {sj, j= 1, m}
The database is modified due to the addition of new entries created by association.
Associated curves are marked in the graphics window by a filled yellow triangle.
Example:
Please see sgm_associate_curve_surface (p. 597) in the PCL Reference Manual Examples.