CAM Profile: Difference between revisions
mNo edit summary |
(Marked this version for translation) |
||
(31 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
<translate> |
<translate> |
||
<!--T:1--> |
|||
{{GuiCommand|Name=Path Profile|Workbenches=[[Path Workbench|Path]]|MenuLocation=Path → New Operation → Profile|Shortcut=P,P|SeeAlso=}} |
|||
<!--T:40--> |
|||
{{Docnav |
|||
|[[Path_Engrave|Engrave]] |
|||
|[[Path_Helix|Helix]] |
|||
|[[Path_Workbench|Path]] |
|||
|IconL=Path_Engrave.svg |
|||
|IconC=Workbench_Path.svg |
|||
|IconR=Path_Helix.svg |
|||
}} |
|||
<!--T: |
<!--T:44--> |
||
{{GuiCommand |
|||
This tool creates a profiling operation, to simplify external contour cuts of complex 3D [[Part Module|Part]]-based objects. The entire Job Model serves as the input for the Operation--regardless of whether any Body Geometry is selected when the Profile command is invoked. A Start point can be enabled from the Operation editor, using a location defined in the Property view->Start Points. |
|||
|Name=Path Profile |
|||
|Workbenches=[[Path Workbench|Path]] |
|||
|MenuLocation=Path → Profile |
|||
|Shortcut=None |
|||
|Version=0.19 |
|||
|SeeAlso=[[Path Contour|Path Contour]], [[Path ProfileFace|Path ProfileFace]], [[Path ProfileEdges|Path ProfileEdges]] |
|||
}} |
|||
<!--T: |
==Description== <!--T:45--> |
||
[[Image:Path profile example.jpg]] |
|||
<!--T:46--> |
|||
The {{KEY|[[Image:Path Profile.png|16px]] [[Path Profile|Profile]]}} tool creates a contour operation based on selected features of the model. |
|||
<!--T: |
<!--T:47--> |
||
Although the {{KEY|[[Image:Path Profile.png|16px]] [[Path Profile|Profile]]}} tool is new in 0.19, it is simply a combination of the pre-existing {{KEY|[[Image:Path Contour.png|16px]] [[Path Contour|Contour]]}}, {{KEY|[[Image:Path Profile_Face.png|16px]] [[Path ProfileFace|Profile Face]]}}, and {{KEY|[[Image:Path Profile_Edges.png|16px]] [[Path ProfileEdges|Profile Edges]]}} operations that maintains their pre-existing capabilities. See their documentation for more details. |
|||
# Select a face on a [[Part Module|Part]]-based object. Alternatively, also select a starting edge on that face. |
|||
# Press the {{KEY|[[Image:Path Profile.png|16px]] [[Path Profile|Profile]]}} button |
|||
# Adjust the desired properties |
|||
</translate> |
|||
==Options== <!--T:7--> |
|||
[[Image:Path profile example.jpg|600px]] |
|||
<translate> |
|||
==Usage== <!--T:48--> |
|||
<!--T:49--> |
|||
Initiate a Profile operation by doing the following: |
|||
# Invoke the command several ways: |
|||
#* Press the {{KEY|[[Image:Path Profile.png|16px]] [[Path Profile|Profile]]}} button |
|||
#* Use the {{MenuCommand|Path → Profile}} entry in the Path menu |
|||
# Activate the Base Geometry section by clicking its tab, and select features from the Job model. |
|||
#*If no features are selected, the {{KEY|[[Image:Path Profile.png|16px]] [[Path Profile|Profile]]}} tool defaults to the previous {{KEY|[[Image:Path Contour.png|16px]] [[Path Contour|Contour]]}} operation behavior, contouring the entire model. |
|||
#*If faces are selected, then the previous {{KEY|[[Image:Path Profile_Face.png|16px]] [[Path ProfileFace|Profile Face]]}} behaviors are used. |
|||
#*If edges are selected, then the previous {{KEY|[[Image:Path Profile_Edges.png|16px]] [[Path ProfileEdges|Profile Edges]]}} behaviors are used.<BR />'''NOTE''': The profile edges portion of the {{KEY|[[Image:Path Profile.png|16px]] [[Path Profile|Profile]]}} operation has received improvements to allow functionality on some open-edge (non-loop) selections. See the '''Usage Notes''' section below for additional information on best practice for profiling open-edges. |
|||
# Activate the Operation section by clicking on its tab, and adjust the operation's settings as desired. |
|||
# (''Optional'') Click the '''Apply''' button to preview the operation with the current settings. |
|||
# Click the '''OK''' or '''Cancel''' buttons to create or cancel the operation. |
|||
<!--T:50--> |
|||
A Start point can be enabled from the Operation tab in the Tasks Window editor, using a location defined in the {{MenuCommand|Property View → Data → Start Point}}. |
|||
<!--T:51--> |
|||
Make additional adjustments to the operation by modifying the operation's properties in the Data tab of the Property View. Advanced properties will be located here, if any. |
|||
==Usage Notes== <!--T:68--> |
|||
* To perform a {{KEY|[[Image:Path Profile.png|16px]] [[Path Profile|Profile]]}} operation on open-edges, it is best to select the top edges (highest edges) for the selection, and then manually set the Final Depth for the operation. Selection of bottom edges is unpredictable and will likely return undesirable paths in many situations. |
|||
* When profiling open-edges, the `Side` or `Cut Side` property is disabled internally even though it will likely be visible within the Task editor window and the Properties list within the Data tab. |
|||
* When profiling the entire model, a complete contour of the model, the `Side` or `Cut Side` property is hard coded to `Outside` even though it might be available for user input. |
|||
<!--T:8--> |
|||
* The Path Profile object is made to be part of a [[Path Project]]. To correctly configure the profiling, a tool table must be present in the project's machine object, and a [[Path ToolNumberToLoad|Tool Change]] command must be placed before the profile. |
|||
==Properties== <!--T:9--> |
==Properties== <!--T:9--> |
||
<!--T: |
<!--T:21--> |
||
''' ''Note'' ''': Not all of these Properties are available in the Task Window Editor. Some are only accessible in the Data tab of the Properties View panel for this Operation. |
|||
* {{PropertyData|Active}}: Make False, to prevent operation from generating code |
|||
* {{PropertyData|Use Placements}}: make True, if using the profile operation placement properties to transform toolpath in post processor |
|||
* {{PropertyData|Tool Number}}: The tool number in use |
|||
=== |
====Base==== <!--T:52--> |
||
<!--T: |
<!--T:22--> |
||
Note: It is suggested that you do not edit the Placement property of path operations. Rather, move or rotate the Path Job model as needed. |
|||
<!--T:23--> |
|||
* {{PropertyData|Placement}}: Overall placement[position and rotation] of the object - with respect to the origin (or origin of parent object container) |
|||
** {{PropertyData|Angle}}: Angle in degrees applied to rotation of the object around Axis property value |
|||
** {{PropertyData|Axis}}: Axis(one or multiple) around which to rotate the object, set in sub-properties: x, y, z |
|||
*** {{PropertyData|X}}: x axis value |
|||
*** {{PropertyData|Y}}: y axis value |
|||
*** {{PropertyData|Z}}: z axis value |
|||
** {{PropertyData|Position}}: Position of the object, set in sub-properties: x, y, z - with respect to the origin (or origin of parent object container) |
|||
*** {{PropertyData|X}}: x distance value |
|||
*** {{PropertyData|Y}}: y distance value |
|||
*** {{PropertyData|Z}}: z distance value |
|||
* {{PropertyData|Label}}: User-provided name of the object (UTF-8) |
|||
====Depth==== <!--T:53--> |
|||
<!--T:54--> |
|||
* {{PropertyData|Clearance Height}}: The height needed to clear clamps and obstructions |
* {{PropertyData|Clearance Height}}: The height needed to clear clamps and obstructions |
||
* {{PropertyData|Step Down}}: Incremental Step Down of Tool |
|||
* {{PropertyData|Use Start Depth}}: make True, if manually specifying a Start Start Depth |
|||
* {{PropertyData|Start Depth}}: Starting Depth of Tool- first cut depth in Z |
|||
* {{PropertyData|Final Depth}}: Final Depth of Tool- lowest value in Z |
* {{PropertyData|Final Depth}}: Final Depth of Tool- lowest value in Z |
||
* {{PropertyData| |
* {{PropertyData|Finish Depth}}: Maximum material removed on final pass. The height (thickness) of the last cutting level - ''set for a better finish''. |
||
* {{PropertyData| |
* {{PropertyData|Safe Height}}: The height above which Rapid motions are allowed. (Rapid safety height between locations) |
||
* {{PropertyData|Start Depth}}: Starting depth of Tool - ''first cut depth in Z'' |
|||
* {{PropertyData|Step Down}}: Incremental step down of Tool during operation |
|||
</translate> |
|||
[[File:Path-DepthsAndHeights.gif|300px|center]] |
|||
<translate> |
|||
<!--T:55--> |
|||
{{Caption|Visual reference for Depth properties (settings)}} |
|||
=== |
====Path==== <!--T:56--> |
||
<!--T: |
<!--T:57--> |
||
* {{PropertyData| |
* {{PropertyData|Active}}: make False, to prevent operation from generating code |
||
* {{PropertyData| |
* {{PropertyData|Base}}: The base geometry for this operation |
||
* {{PropertyData|Comment}}: An optional comment for this Operation |
|||
* {{PropertyData|Coolant Mode}}: The coolant mode for this operation. |
|||
* {{PropertyData|Cycle Time}}: The cycle time estimation for this operation. |
|||
* {{PropertyData|Tool Controller}}: Defines the Tool controller used in the Operation |
|||
* {{PropertyData|User Label}}: User assigned label |
|||
=== |
====Profile==== <!--T:19--> |
||
<!--T: |
<!--T:58--> |
||
* {{PropertyData| |
* {{PropertyData|Direction}}: The direction that the tool path should go around the part: Clockwise[CW] or Counterclockwise[CCW] |
||
* {{PropertyData| |
* {{PropertyData|Expand Profile}}: Extend the profile clearing beyond the Extra Offset. |
||
* {{PropertyData| |
* {{PropertyData|Expand Profile Step Over}}: Set the stepover percentage, based on the tool's diameter. |
||
* {{PropertyData| |
* {{PropertyData|Handle Multiple Features}}: Choose how to process multiple Base Geometry features. |
||
* {{PropertyData|OffsetExtra}}: Extra value to stay away from final profile- good for roughing toolpath |
|||
* {{PropertyData|Process Circles}}: Check if you want this Profile Operation to also be applied to cylindrical holes, ''which normally get drilled''. |
|||
* {{PropertyData|Process Holes}}: Check if this Profile Operation should also process holes in the base geometry. '''Note''' that this does not include cylindrical holes. |
|||
* {{PropertyData|Process Perimeter}}: Check if this Profile Operation should also process the outside perimeter of the base geometry shapes |
|||
* {{PropertyData|Side}}: (Cut Side) Side of edge that tool should cut. This only matters if `Use Compensation` is True(checked). |
|||
* {{PropertyData|Use Compensation}}: If checked, the Profile Operation is offset by the tool radius. The offset direction is determined by the Cut Side. |
|||
=== |
====Rotation==== <!--T:28--> |
||
<!--T: |
<!--T:59--> |
||
* {{PropertyData| |
* {{PropertyData|Attempt Inverse Angle}}: Automatically attempt Inverse Angle if initial rotation is incorrect. |
||
* {{PropertyData| |
* {{PropertyData|Enable Rotation}}: Enable rotation to gain access to pockets or areas not normal to Z axis. |
||
* {{PropertyData| |
* {{PropertyData|Inverse Angle}}: Inverse the angle of the rotation. '' '''Example:''' change a rotation from -22.5 to 22.5 degrees.'' |
||
* {{PropertyData|Limit Depth To Face}}: Enforce the Z-depth of the selected face as the lowest value for final depth. Higher user values for final depth will be observed. |
|||
* {{PropertyData|End Point}}: The end point of this path |
|||
* {{PropertyData|Reverse Direction}}: Reverse orientation of Operation by 180 degrees. |
|||
=== |
====Start Point==== <!--T:60--> |
||
<!--T: |
<!--T:61--> |
||
* {{PropertyData| |
* {{PropertyData|Start Point}}: The custom start point for the path of this operation. |
||
** {{PropertyData|X}}: x distance value |
|||
* {{PropertyData|Direction}}: The direction that the toolpath should go around the part ClockWise CW or CounterClockWise CCW |
|||
* {{PropertyData| |
** {{PropertyData|Y}}: y distance value |
||
* {{PropertyData| |
** {{PropertyData|Z}}: z distance value |
||
* {{PropertyData|Use Start Point}}: Make True, if manually specifying a Start Point. Set the start point in the property data Start Point field. |
|||
* {{PropertyData|SegLen}}: Tesselation value for tool paths made from beziers, bsplines, and ellipses |
|||
==Tasks Window Editor Layout== <!--T:62--> |
|||
<!--T:31--> |
|||
''Descriptions for the settings are provided in the Properties list above.'' |
|||
This section is simply a layout map of the settings in the window editor for the Operation. |
|||
====Base Geometry==== <!--T:32--> |
|||
<!--T:33--> |
|||
* '''Add''': adds selected element(s) which should be the base(s) for the path(s) |
|||
* '''Delete''': delete the selected item(s) in the Base Geometry list |
|||
* '''Clear''': clear all items in the Base Geometry list |
|||
====Depths==== <!--T:34--> |
|||
<!--T:35--> |
|||
* {{PropertyData|Start Depth}} |
|||
* {{PropertyData|Final Depth}} |
|||
* {{PropertyData|Step Down}} |
|||
====Heights==== <!--T:36--> |
|||
<!--T:37--> |
|||
* {{PropertyData|Safe Height}} |
|||
* {{PropertyData|Clearance Height}} |
|||
====Operation==== <!--T:38--> |
|||
<!--T:63--> |
|||
* {{PropertyData|Tool Controller}} |
|||
* {{PropertyData|Coolant Mode}} |
|||
* {{PropertyData|Cut Side **}} |
|||
* {{PropertyData|Direction}} |
|||
* {{PropertyData|Extra Offset}} |
|||
* {{PropertyData|Enable Rotation}} |
|||
* {{PropertyData|Use Start Point}} |
|||
* {{PropertyData|Use Compensation}} |
|||
* {{PropertyData|Process Holes **}} |
|||
* {{PropertyData|Process Circles **}} |
|||
* {{PropertyData|Process Perimeter **}} |
|||
'''<nowiki>**</nowiki>''' Availability changes based on selections in Base Geometry section. |
|||
==Scripting== <!--T:64--> |
|||
<!--T:65--> |
|||
{{Emphasis|See also:}} [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]]. |
|||
<!--T:66--> |
|||
Example: |
|||
<!--T:67--> |
|||
{{Code|code=#Place code example here.}} |
|||
<!--T:41--> |
|||
{{Docnav |
|||
|[[Path_Engrave|Engrave]] |
|||
|[[Path_Helix|Helix]] |
|||
|[[Path_Workbench|Path]] |
|||
|IconL=Path_Engrave.svg |
|||
|IconC=Workbench_Path.svg |
|||
|IconR=Path_Helix.svg |
|||
}} |
|||
</translate> |
</translate> |
||
{{Path_Tools_navi{{#translation:}}}} |
|||
{{Userdocnavi{{#translation:}}}} |
|||
{{clear}} |
{{clear}} |
||
<languages/> |
Revision as of 17:46, 15 September 2020
Path Profile |
Menu location |
---|
Path → Profile |
Workbenches |
Path |
Default shortcut |
None |
Introduced in version |
0.19 |
See also |
Path Contour, Path ProfileFace, Path ProfileEdges |
Description
The Profile tool creates a contour operation based on selected features of the model.
Although the Profile tool is new in 0.19, it is simply a combination of the pre-existing File:Path Contour.png Contour, File:Path Profile Face.png Profile Face, and File:Path Profile Edges.png Profile Edges operations that maintains their pre-existing capabilities. See their documentation for more details.
Usage
Initiate a Profile operation by doing the following:
- Invoke the command several ways:
- Press the Profile button
- Use the Path → Profile entry in the Path menu
- Activate the Base Geometry section by clicking its tab, and select features from the Job model.
- If no features are selected, the Profile tool defaults to the previous File:Path Contour.png Contour operation behavior, contouring the entire model.
- If faces are selected, then the previous File:Path Profile Face.png Profile Face behaviors are used.
- If edges are selected, then the previous File:Path Profile Edges.png Profile Edges behaviors are used.
NOTE: The profile edges portion of the Profile operation has received improvements to allow functionality on some open-edge (non-loop) selections. See the Usage Notes section below for additional information on best practice for profiling open-edges.
- Activate the Operation section by clicking on its tab, and adjust the operation's settings as desired.
- (Optional) Click the Apply button to preview the operation with the current settings.
- Click the OK or Cancel buttons to create or cancel the operation.
A Start point can be enabled from the Operation tab in the Tasks Window editor, using a location defined in the Property View → Data → Start Point.
Make additional adjustments to the operation by modifying the operation's properties in the Data tab of the Property View. Advanced properties will be located here, if any.
Usage Notes
- To perform a Profile operation on open-edges, it is best to select the top edges (highest edges) for the selection, and then manually set the Final Depth for the operation. Selection of bottom edges is unpredictable and will likely return undesirable paths in many situations.
- When profiling open-edges, the `Side` or `Cut Side` property is disabled internally even though it will likely be visible within the Task editor window and the Properties list within the Data tab.
- When profiling the entire model, a complete contour of the model, the `Side` or `Cut Side` property is hard coded to `Outside` even though it might be available for user input.
Properties
Note : Not all of these Properties are available in the Task Window Editor. Some are only accessible in the Data tab of the Properties View panel for this Operation.
Base
Note: It is suggested that you do not edit the Placement property of path operations. Rather, move or rotate the Path Job model as needed.
- DataPlacement: Overall placement[position and rotation] of the object - with respect to the origin (or origin of parent object container)
- DataAngle: Angle in degrees applied to rotation of the object around Axis property value
- DataAxis: Axis(one or multiple) around which to rotate the object, set in sub-properties: x, y, z
- DataX: x axis value
- DataY: y axis value
- DataZ: z axis value
- DataPosition: Position of the object, set in sub-properties: x, y, z - with respect to the origin (or origin of parent object container)
- DataX: x distance value
- DataY: y distance value
- DataZ: z distance value
- DataLabel: User-provided name of the object (UTF-8)
Depth
- DataClearance Height: The height needed to clear clamps and obstructions
- DataFinal Depth: Final Depth of Tool- lowest value in Z
- DataFinish Depth: Maximum material removed on final pass. The height (thickness) of the last cutting level - set for a better finish.
- DataSafe Height: The height above which Rapid motions are allowed. (Rapid safety height between locations)
- DataStart Depth: Starting depth of Tool - first cut depth in Z
- DataStep Down: Incremental step down of Tool during operation
Visual reference for Depth properties (settings)
Path
- DataActive: make False, to prevent operation from generating code
- DataBase: The base geometry for this operation
- DataComment: An optional comment for this Operation
- DataCoolant Mode: The coolant mode for this operation.
- DataCycle Time: The cycle time estimation for this operation.
- DataTool Controller: Defines the Tool controller used in the Operation
- DataUser Label: User assigned label
Profile
- DataDirection: The direction that the tool path should go around the part: Clockwise[CW] or Counterclockwise[CCW]
- DataExpand Profile: Extend the profile clearing beyond the Extra Offset.
- DataExpand Profile Step Over: Set the stepover percentage, based on the tool's diameter.
- DataHandle Multiple Features: Choose how to process multiple Base Geometry features.
- DataOffsetExtra: Extra value to stay away from final profile- good for roughing toolpath
- DataProcess Circles: Check if you want this Profile Operation to also be applied to cylindrical holes, which normally get drilled.
- DataProcess Holes: Check if this Profile Operation should also process holes in the base geometry. Note that this does not include cylindrical holes.
- DataProcess Perimeter: Check if this Profile Operation should also process the outside perimeter of the base geometry shapes
- DataSide: (Cut Side) Side of edge that tool should cut. This only matters if `Use Compensation` is True(checked).
- DataUse Compensation: If checked, the Profile Operation is offset by the tool radius. The offset direction is determined by the Cut Side.
Rotation
- DataAttempt Inverse Angle: Automatically attempt Inverse Angle if initial rotation is incorrect.
- DataEnable Rotation: Enable rotation to gain access to pockets or areas not normal to Z axis.
- DataInverse Angle: Inverse the angle of the rotation. Example: change a rotation from -22.5 to 22.5 degrees.
- DataLimit Depth To Face: Enforce the Z-depth of the selected face as the lowest value for final depth. Higher user values for final depth will be observed.
- DataReverse Direction: Reverse orientation of Operation by 180 degrees.
Start Point
- DataStart Point: The custom start point for the path of this operation.
- DataX: x distance value
- DataY: y distance value
- DataZ: z distance value
- DataUse Start Point: Make True, if manually specifying a Start Point. Set the start point in the property data Start Point field.
Tasks Window Editor Layout
Descriptions for the settings are provided in the Properties list above. This section is simply a layout map of the settings in the window editor for the Operation.
Base Geometry
- Add: adds selected element(s) which should be the base(s) for the path(s)
- Delete: delete the selected item(s) in the Base Geometry list
- Clear: clear all items in the Base Geometry list
Depths
- DataStart Depth
- DataFinal Depth
- DataStep Down
Heights
- DataSafe Height
- DataClearance Height
Operation
- DataTool Controller
- DataCoolant Mode
- DataCut Side **
- DataDirection
- DataExtra Offset
- DataEnable Rotation
- DataUse Start Point
- DataUse Compensation
- DataProcess Holes **
- DataProcess Circles **
- DataProcess Perimeter **
** Availability changes based on selections in Base Geometry section.
Scripting
See also: FreeCAD Scripting Basics.
Example:
#Place code example here.
- Project Commands: Job, Post Process, Check the path job for common errors, Export Template
- Tool Commands: Inspect Path Commands, CAM Simulator, Finish Selecting Loop, Toggle the Active State of the Operation, ToolBit Library editor, ToolBit Dock
- Basic Operations: Profile, Pocket Shape, Drilling, Face, Helix, Adaptive, Slot, Engrave, Deburr, Vcarve
- 3D Operations: 3D Pocket, 3D Surface, Waterline
- Path Modification: Copy the operation in the job, Array, Simple Copy
- Specialty Operations: Thread Milling
- Miscellaneous: Area, Area workplane
- ToolBit architecture: Tools, ToolShape, ToolBit, ToolBit Library, ToolController
- Additional: Preferences, Scripting
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub