Component:Remove Faces
From DocR21
The Remove Component (component SPArem), supports the removal of faces from solid and sheet bodies, the removal of an open gap in a sheet body and the removal of edges from wire bodies. In all cases, the body is healed by extending the remaining topology to fill the gap. If this is not possible due to geometrical limitations (for example, the removal of one face off a block), the model is left unchanged and an error is raised. The body's shells and lumps are corrected at the end of the operation if they have been split.
| Operation | Description |
|---|---|
| Remove Face | Removal of one or more faces from a body and the "healing" of the gap by extending the neighboring surfaces. |
| Remove Open Gap | Removal of an open gap in a sheet body by extending the neighboring surfaces. |
| Remove Wire Edges | Removal of one or more edges from a wire body and the "healing" of the gap by extending the neighboring curves. |
Options
The main Remove APIs take options to control the behavior and/or the shape of local operations. The options are passed in via the class lop_options.
Important: For historical reasons, there are some global options that also affect the behavior of Remove Faces operations. See Remove Faces global options.
Remove Face(s)
The API function api_remove_faces is used to perform this operation. The API can take one or more faces that all belong to the same sheet or solid body. The body which owns the faces given as input is modified directly, no copy is made.
outcome api_remove_faces(number of faces, face list, bounding box for intersection, options)
- See also: Remove Face#Remove Face(s) Interface
Remove Open Gap
The API function api_remove_open_gap is used to close an open gap in a sheet body by extending the neighboring faces.
outcome api_remove_open_gap(edge(s), bounding box for intersection, options)
Remove Wire Edges
The API function api_remove_wire_edges is used to perform this operation.
outcome api_remove_wire_edges(number of edges, edge list, bounding box for intersection, options)
Versioning and Journaling
Versioning and Journaling are available for remove through the standard ACIS options.
Error Information Handling
- Main article: Remove - Error Information Handling
REM can be used frequently to remove blend sequences. ACIS returns as much information as possible, such as the bad face or edge that caused the failure, in the outcome of the api_remove_faces. The outcome contains an object called error information; you can cast error information as follows...
Functional Options
The Local Operations APIs all accept a lop_options object. Several of these options existed as Global Options (below) in previous releases but now are invoked through functional options. Refer to the Global Options documentation for complete coverage.
Global Options
The main Local Operations APIs take options to control their behavior.
Important: For historical reasons, some global options also affect the behavior of Local Operations. Refer to Local Operations global options.
