Subtract

The subtract operation subtracts one body or set of bodies from another body or set of bodies. The order of subtraction is significant - the body or bodies specified before the From keyword is/are subtracted from bodies specified after From. The new body retains the original body's id. If any additional bodies are created, they will be given the next highest available ids.

The keep option simply retains all of the original bodies. Alternatively, the keep_tool option retains only the new body and the "tool" body -- i.e., the body specified before the From keyword.

The imprint option imprints the subtracted bodies onto the resultant body.

The command syntax is:

Subtract [Volume|BODY] <range> From [Volume|BODY] <range> [Imprint] [Keep|Keep_Tool]

In the Cubit GUI, users can perform subtract operations via the Command Panel by selecting Geometry > Volume > Boolean operations on volumes, then choosing Subtract from the dropdown list and specifying the desired "A" and "B" volume IDs, as shown below. Clicking "Apply" then executes the equivalent of the command subtract volume B from volume A". To specify which bodies are retained, users can check the "Keep Originals" checkbox and choose either "Keep B" (which corresponds to the keep_tool command option) or "Keep both (A and B)" (which corresponds to keep command option).

Figure 1. The Command Panel interface for boolean subtract operations on bodies.

Remove Overlap

The Remove Overlap command is a simplified form of the subtract operation above. This command takes exactly two volumes as arguments and uses the modify argument to define the volume where material is to be removed.

Remove Overlap Volume <id1> <id2> modify [Volume <id> | Smaller | Larger]

The Smaller and Larger options are an alternate method of specifying which volume from <id1> or <id2> where material will be removed. When these argument are used, the geometric volume is measured for both volumes and the smaller or larger volume repectively is used as the modify entity. When both volumes have exactly the same volume, the smaller or larger entity ID is used.