CAM Pocket 3D: Difference between revisions

From FreeCAD Documentation
No edit summary
(Fixed Path_Surface link.)
(48 intermediate revisions by 10 users not shown)
Line 1: Line 1:
<languages/>
{{UnfinishedDocu}}
<translate>
<translate>

<!--T:7-->
{{Docnav
|[[Path_Vcarve|Vcarve]]
|[[Path_Surface|Surface]]
|[[Path_Workbench|Path]]
|IconL=Path_Vcarve.svg
|IconR=Path_Surface.svg
|IconC=Workbench_Path.svg
}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand|Name=Path 3DPocket|Workbenches=[[Path Workbench|Path]]|MenuLocation=Path → 3D Pocket|Shortcut=|SeeAlso=}}
|Name=Path Pocket 3D
|MenuLocation=Path → 3D Pocket
|Workbenches=[[Path_Workbench|Path]]
}}


==Description== <!--T:2-->
==Description== <!--T:2-->


<!--T:3-->
<!--T:3-->
This command inserts a path [[Image:Path_3DPocket.svg|24px]] [[Path_Pocket_3D|3D Pocket]] object into the Job. This operation takes into account the bottom surface of the pocket, as well as selected walls that are not vertical. In its current state, this operation is used to rough out a pocket with non-vertical walls and/or non-horizontal bottom. A common finishing technique is to use a ball end mill with the experimental [[Image:Path_Surface.svg|24px]] [[Path_Surface|3D Surface]] operation.
This tool creates a new 3D Pocket Operation. A 3D pocket takes into account the bottom surface of the pocket
[[Image:Path_3D_Pocket_Sample.png|600px|center|Sample image of 3D Pocket operation used to clear cylindrical battery holder.]]


==Usage== <!--T:4-->
==Usage== <!--T:4-->


<!--T:5-->
===Creating a 3D Pocket=== <!--T:5-->
# Select the bottom of the pocket you want to mill
# Select the tool controller you want to use
# Press the {{KEY|[[Image:Path-3DPocket.png|16px]] [[Path 3DPocket|3D Pocket]]}} button
# Adjust the desired properties
# Apply


==Properties== <!--T:6-->
<!--T:11-->
#From within a Job, select one or more Faces from the Job Model to include as the Base Geometry.
#Invoke the {{KEY|[[Image:Path_3DPocket.svg|16px]] [[Path_Pocket_3D|Pocket 3D]]}} or select {{KEY| Path}} → {{KEY|[[Image:Path_3DPocket.svg|16px]] [[Path_Pocket_3D|Pocket 3D]]}} command from the top menu.
#Choose a Tool controller from the pop up selection dialogue window.
#Add or subtract Base Geometry elements as needed to configure the Operation.
#Check the Depths tab to ensure the Start Depth, Finish Depth, and Step Down percentage are correct. The Final Depth is determined by the Body Geometry selection and is not modifiable.
#Check the Heights tab to ensure the Safe and Clearance Heights are appropriate.
#Check the Operation tab where the Tool controller can be re-selected, the Cut mode can be configured for Climb or Conventional milling, the Pattern can be set, the Step Over percentage can be adjusted, and Pass Extension can be applied.
#Click {{Button|Apply}} to observe the milling path for the passes of the Operation. Adjust parameters until satisfied with the Operation.
#Click {{Button|OK}} to save the Operation.


<!--T:7-->
==Notes== <!--T:12-->

*{{PropertyData|Offset}}: The spacing between the array copies
<!--T:13-->
*{{PropertyData|Copies}}: The number of copies
*All paths generated from this operation are based on a standard end mill using the diameter of the tool you selected for this 3D Pocket operation.
*Ball end mills and other shapes are not respected for path generation even if selected as the tool for this operation.

==Options== <!--T:14-->

<!--T:20-->
* Use the {{PropertyData|Adaptive Pocket Finish}} property to attempt to minimize air milling below a 3D Pocket in cases where the pocket is a hole through the model.
* Use the {{PropertyData|Adaptive Pocket Start}} property to attempt to minimize air milling upon entry to the pocket. For example, look at the sample image above in the [[Path_Pocket_3D#Description|Description]] section of this page. In order to reduce the air milling above that 3D Pocket, toggle this property to True and the paths will begin closer to the pocket, much nearer to where the pocket actually begins. See the following image and note the difference in the path start height. The air milling is reduced.
[[Image:3D_Pocket_Sample_Adaptive_Start.png|600px|center|Sample image of 3D Pocket operation used to clear cylindrical battery holder with the Adaptive Pocket Start enabled in order to reduce air milling upon entry.]]
* If you wish to process the entire model and stock as a whole, use the {{PropertyData|Process Stock Area}} property set to True with no Base Geometry selected.

==Properties== <!--T:15-->

===Data=== <!--T:34-->

<!--T:35-->
{{TitleProperty|Base}}

<!--T:21-->
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:22-->
* {{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)

<!--T:23-->
{{TitleProperty|Depth}}

<!--T:24-->
* {{PropertyData|Clearance Height}}: The height needed to clear clamps and obstructions
* {{PropertyData|Final Depth}}: Final Depth of Tool- lowest value in Z
* {{PropertyData|Finish Depth}}: Maximum material removed on final pass.
* {{PropertyData|Safe Height}}: The above which Rapid motions are allowed.
* {{PropertyData|Start Depth}}: Starting Depth of Tool- first cut depth in Z
* {{PropertyData|Step Down}}: Incremental Step Down of Tool

<!--T:25-->
{{TitleProperty|Face}}

<!--T:26-->
* {{PropertyData|Offset Pattern}}: Clearing pattern to use. (Select in which manner the horizontal movements should be done.)

<!--T:27-->
{{TitleProperty|Path}}

<!--T:28-->
* {{PropertyData|Active}}: make False, to prevent operation from generating code
* {{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

<!--T:29-->
{{TitleProperty|Pocket}}

<!--T:30-->
* {{PropertyData|Adaptive Pocket Finish}}: Use adaptive algorithm to eliminate excessive air milling below planar pocket bottom.
* {{PropertyData|Adaptive Pocket Start}}: Use adaptive algorithm to eliminate excessive air milling above planar pocket top.
* {{PropertyData|Cut Mode}}: The direction that the toolpath should go around the part ClockWise (CW) or CounterClockWise (CCW)
* {{PropertyData|Extra Offset}}: Extra offset to apply to the operation. Direction is operation dependent.
* {{PropertyData|Handle Multiple Features}}: Choose how to process multiple Base Geometry features.
* {{PropertyData|Keep Tool Down}}: Attempts to avoid unnecessary retractions.
* {{PropertyData|Min Travel}}: Use 3D Sorting of Path
* {{PropertyData|Process Stock Area}}: Process the model and stock in an operation with no Base Geometry selected.
* {{PropertyData|Start At}}: Start pocketing at center or boundary
* {{PropertyData|Step Over}}: Percent of cutter diameter to step over on each pass
* {{PropertyData|Zig Zag Angle}}: Angle of the zigzag pattern

<!--T:36-->
{{TitleProperty|Rotation}}

<!--T:31-->
Note: Rotation is not available for 3D Pocket as of 0.19.

<!--T:37-->
* {{PropertyData|Enable Rotation}}: Enable rotation to gain access to pockets or areas not normal to Z axis.

<!--T:32-->
{{TitleProperty|Start Point}}

<!--T:33-->
* {{PropertyData|Start Point}}: The custom start point for the path of this operation.
** {{PropertyData|X}}: x distance value
** {{PropertyData|Y}}: y distance value
** {{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.

===View=== <!--T:17-->

<!--T:38-->
Empty

==Scripting== <!--T:39-->

<!--T:18-->
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].

<!--T:19-->
Example:


</translate>
</translate>
{{Code|code=
{{clear}}
#Place code example here.
<languages/>
}}
<translate>


<!--T:8-->
{{Docnav
|[[Path_Vcarve|Vcarve]]
|[[Path_Surface|Surface]]
|[[Path_Workbench|Path]]
|IconL=Path_Vcarve.svg
|IconR=Path_Surface.svg
|IconC=Workbench_Path.svg
}}

</translate>
{{Path_Tools_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Revision as of 20:31, 13 November 2021

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Path Pocket 3D

Menu location
Path → 3D Pocket
Workbenches
Path
Default shortcut
None
Introduced in version
-
See also
None

Description

This command inserts a path 3D Pocket object into the Job. This operation takes into account the bottom surface of the pocket, as well as selected walls that are not vertical. In its current state, this operation is used to rough out a pocket with non-vertical walls and/or non-horizontal bottom. A common finishing technique is to use a ball end mill with the experimental 3D Surface operation.

Sample image of 3D Pocket operation used to clear cylindrical battery holder.
Sample image of 3D Pocket operation used to clear cylindrical battery holder.

Usage

Creating a 3D Pocket

  1. From within a Job, select one or more Faces from the Job Model to include as the Base Geometry.
  2. Invoke the Pocket 3D or select Path Pocket 3D command from the top menu.
  3. Choose a Tool controller from the pop up selection dialogue window.
  4. Add or subtract Base Geometry elements as needed to configure the Operation.
  5. Check the Depths tab to ensure the Start Depth, Finish Depth, and Step Down percentage are correct. The Final Depth is determined by the Body Geometry selection and is not modifiable.
  6. Check the Heights tab to ensure the Safe and Clearance Heights are appropriate.
  7. Check the Operation tab where the Tool controller can be re-selected, the Cut mode can be configured for Climb or Conventional milling, the Pattern can be set, the Step Over percentage can be adjusted, and Pass Extension can be applied.
  8. Click Apply to observe the milling path for the passes of the Operation. Adjust parameters until satisfied with the Operation.
  9. Click OK to save the Operation.

Notes

  • All paths generated from this operation are based on a standard end mill using the diameter of the tool you selected for this 3D Pocket operation.
  • Ball end mills and other shapes are not respected for path generation even if selected as the tool for this operation.

Options

  • Use the DataAdaptive Pocket Finish property to attempt to minimize air milling below a 3D Pocket in cases where the pocket is a hole through the model.
  • Use the DataAdaptive Pocket Start property to attempt to minimize air milling upon entry to the pocket. For example, look at the sample image above in the Description section of this page. In order to reduce the air milling above that 3D Pocket, toggle this property to True and the paths will begin closer to the pocket, much nearer to where the pocket actually begins. See the following image and note the difference in the path start height. The air milling is reduced.
Sample image of 3D Pocket operation used to clear cylindrical battery holder with the Adaptive Pocket Start enabled in order to reduce air milling upon entry.
Sample image of 3D Pocket operation used to clear cylindrical battery holder with the Adaptive Pocket Start enabled in order to reduce air milling upon entry.
  • If you wish to process the entire model and stock as a whole, use the DataProcess Stock Area property set to True with no Base Geometry selected.

Properties

Data

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.
  • DataSafe Height: The above which Rapid motions are allowed.
  • DataStart Depth: Starting Depth of Tool- first cut depth in Z
  • DataStep Down: Incremental Step Down of Tool

Face

  • DataOffset Pattern: Clearing pattern to use. (Select in which manner the horizontal movements should be done.)

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

Pocket

  • DataAdaptive Pocket Finish: Use adaptive algorithm to eliminate excessive air milling below planar pocket bottom.
  • DataAdaptive Pocket Start: Use adaptive algorithm to eliminate excessive air milling above planar pocket top.
  • DataCut Mode: The direction that the toolpath should go around the part ClockWise (CW) or CounterClockWise (CCW)
  • DataExtra Offset: Extra offset to apply to the operation. Direction is operation dependent.
  • DataHandle Multiple Features: Choose how to process multiple Base Geometry features.
  • DataKeep Tool Down: Attempts to avoid unnecessary retractions.
  • DataMin Travel: Use 3D Sorting of Path
  • DataProcess Stock Area: Process the model and stock in an operation with no Base Geometry selected.
  • DataStart At: Start pocketing at center or boundary
  • DataStep Over: Percent of cutter diameter to step over on each pass
  • DataZig Zag Angle: Angle of the zigzag pattern

Rotation

Note: Rotation is not available for 3D Pocket as of 0.19.

  • DataEnable Rotation: Enable rotation to gain access to pockets or areas not normal to Z axis.

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.

View

Empty

Scripting

See also: FreeCAD Scripting Basics.

Example:

#Place code example here.