Cubit 15.7 User Documentation
The following options of the Tweak Surface command are available. Command syntax and examples follow below.
Tweak Surface <id_list> Offset <val> [Surface <id_list> Offset <val>] [Surface <id_list> Offset <val> ...] [Keep] [Preview]
The Tweak Offset form of the command offsets an existing set of surfaces and extends the attached surfaces to meet them. A positive offset value will offset the surface in the positive surface normal direction while a negative value will go the other way. Different offsets may be specified for each surface. Figure 1 shows a simple example of offsetting. Note that you can also offset whole groups of surfaces at once. The keep option will retain the original surfaces and curves.
Figure 1. Tweak Offset
The Tweak move form of the command simply moves the given surfaces along a vector direction. The direction can be specified either absolutely or relative to other geometry entities in the model (from entity centroid to location). Note that when moving a surface for tweak, the surface is moved and the surface and the adjoining surfaces are extended or trimmed to match up again. So, for example, moving a vertically oriented planar surface in the vertical direction will have no effect. In this example, if you move the surface 10 in the x and 5 in the y the effect will be to move it simply 10 in the x. You can also use this form of the command to move a protrusion around - just be sure to specify all of the surfaces on the protrusion for moving. The last form of the command can be used to move a surface along another surface's normal.
Tweak Surface <id_range> Move {Vertex|Curve|Surface|Volume|Body} <id> Location {Vertex|Curve|Surface|Volume|Body} <id> [Except [X][Y][Z]] [Keep] [Preview]
Tweak Surface <id_range> Move {Vertex|Curve|Surface|Volume|Body} <id> Location <x_val> <y_val> <z_val> [Except [X][Y][Z]] [Keep][Preview]
Tweak Surface <id_range> Move <dx_val> <dy_val> <dz_val> [Keep] [Preview]
Tweak Surface <id_range> Move Direction <options> Distance <val> [Keep] [Preview]
Tweak Surface <id_range> Move Normal To Surface <id> Distance <val> [Except [X][Y][Z]] [Keep][Preview]
The Tweak target form of the command actually replaces the given surfaces with a copy of the new surfaces, then extends and trims surfaces to match up. This can be useful for closing gaps between components or performing more complicated modifications to models. The command syntax is:
Tweak {Curve|Surface} <id_list> Target {Surface <id_list> [Limit Plane (options)] [EXTEND|noextend] | Plane (options)} [keep] [preview]
Tweak Surface <id_list> Replace [With] Surface <id_list> [Keep] [Preview]
The plane option allows a plane to be specified instead of target surface(s). If a target surface is supplied, the user can also use a limit plane if he wishes. A limit plane is a plane that the tweak will stop at if the tweaked surface does not completely intersect the target surface. The limit plane must be used with the extend option. See the help for Specifying a Plane for the options available to define a plane.
Single target surfaces are automatically extended so that the tweaked body will fully intersect the target. Unfortunately, extending multiple target surfaces can sometimes result in an invalid target, so the option is given to tweak to unextended targets with the noextend option. In this case, the tweaked body must fully intersect the existing targets for success. If you experience a failure when tweaking to multiple targets or the results are unexpected, it is recommended to try the noextend option (NOTE: Tweaking to multiple targets is only implemented in the ACIS geometry engine). It is recommended to always preview before using the tweak target commands.
Figure 2 shows a simple example.
Figure 2. Tweak Surface Target (Viewed directly from the side)
The Tweak remove command allows you to remove surfaces from a model by extending the adjacent surfaces to fill in the resulting gaps. It is identical to the Remove Surface command. See Removing Surfaces for a description of the command options.
Tweak Surface <id_list> Remove [Blend_Chain] [Cavity] [EXTEND|Noextend] [Keepsurface] [Keep] [Preview]
The Tweak cone form of the command is used to replace a conical projection with a flat circular surface. This command is useful for simplifying bolt holes. The command syntax is.
Tweak Surface <id_range> Cone [Preview]
The following is a simple example illustrating the use of the tweak surface cone command.
Figure 3. Conical bolt hole before and after tweaking
The Tweak Doubler form of the command takes a specified surface and creates drop-down surfaces either normal to the doubler surface or by a user specified vector to a target surface. This can be helpful in creating surfaces for weld elements between midsurfaced geometry. The resulting surfaces do not create a bounding volume, and do not imprint themselves onto the target surface. The command syntax is:
Tweak Surface <id_list> Doubler Surface <id_list> {[Limit Plane (options)] [EXTEND|noextend]} [Internal] [Direction (options)] [Thickness] [Preview]
The plane option allows a plane to be specified instead of target surface(s). If a target surface is supplied, the user can also use a limit plane if he wishes. A limit plane is a plane that the tweak will stop at if the tweaked surface does not completely intersect the target surface. The limit plane must be used with the extend option. See the help for Specifying a Plane for the options available to define a plane.
Single target surfaces are automatically extended so that the tweaked body will fully intersect the target. Unfortunately, extending multiple target surfaces can sometimes result in an invalid target, so the option is given to tweak to unextended targets with the noextend option. In this case, the tweaked body must fully intersect the existing targets for success. If you experience a failure when tweaking to multiple targets or the results are unexpected, trying the noextend option is recommended.
If the doubler surface has a thickness property value, you can propagate that thickness value to the newly created drop-down surfaces by using the thickness flag.
It is recommended to always preview before using the tweak doubler commands.
NOTE: This function only works for ACIS geometry.
![]() |
![]() |
Geometry |
Output |
Figure 3. Extending a doubler surface to target
The internal option will also include internal curves when the surface is extended (see Figure 4c). The direction option will create a skewed surface along the given direction (see Figure 4d).
Figure 4. Explanation of tweak doubler options (a) Original surfaces (b) No option flags used (c) Internal option used - notice internal curves dropped down (d) Direction flag - notice skew
The Tweak Hole/Slot Idealize command takes a specified sheet body(s) and searches for either holes or slots (or both) which meet the user's input parameters. This can be helpful in removing small holes or slots quickly and efficiently from midsurfaced bodies where such level of detail isn't required. The command syntax is:
Tweak Surface <id_list> Idealize {[Hole Radius <val>] [Slot Radius <val> Length <val>]} [Exclude Curve <id_list>] [Preview]
Below is a diagram showing the different parameters available for input by the user.
Figure 5. Input parameters for tweak surface idealize command
#Hole Removal Example
tweak surface 13 idealize hole radius 6
Figure 6. Example of hole removal using tweak surface idealize command
The exclude option allows the user to specify individual curves that should not be deleted, even if they meet the search criteria for removal. Figure 7 shows another hole removal example where several curves were excluded.
Figure 7. Example of hole removal using exclude option
Note: This feature is for ACIS geometry
It is recommended to always preview before using the tweak command. Preview will highlight all curves slated to be removed if the command is executed.
The Tweak Fillet Idealize command takes a specified sheet body(s) and searches for either internal or external fillets (or both) which meet the users' radius parameter. This can be helpful in removing fillets quickly and efficiently from midsurfaced bodies where such level of detail isn't required. The command syntax is:
Tweak Surface <id_list> Idealize Fillet Radius <val> {[Internal] [External]} [Exclude Curve <id_list>] [Preview]
#Fillet Removal Example
tweak surface 13 idealize fillet radius 6 internal
Figure 8. Example of fillet removal using tweak surface idealize command
Note: This feature is for ACIS geometry
It is recommended to always preview before using the tweak command. Preview will show the result if the command is executed.
Figure 9. Preview of the tweak surface idealize command