kindred/create
1
1
Fork 0
Code Issues 44 Pull Requests Actions Packages Projects 9 Releases 2 Wiki Activity

[pre-commit.ci] auto fixes from pre-commit.com hooks

Browse Source 
for more information, see https://pre-commit.ci
This commit is contained in:
pre-commit-ci[bot]
2025-11-27 16:43:08 +00:00
parent 03e7200f68
commit bdc3781b88
1 changed files with 6 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
src/Mod/CAM/Roadmap/ADR/ADR-008.md
View File

@@ -13,13 +13,13 @@ Users are often confused by the terminology employed within FreeCAD's CAM workbe
This ADR describes the terminology to be used within the CAM workbench and how those concepts should be employed within operations, dressups, and post processors.
There are two types of offsets:
There are two types of offsets:
1) Offsets relative to the job origin.
2) Offsets relative to some other reference
## Decision
1) All offsets which are relative to the job origin will use The term 'Height'.
1) All offsets which are relative to the job origin will use The term 'Height'.
2) All offsets which are relative to some other reference will use the term 'Distance'.
3) The term 'Depth' is now deprecated and should not be used. It should be removed from documentation and task panels as soon as possible.
@@ -37,12 +37,12 @@ All operations will end with a rapid move to the clearance height.
### Retract (Height)
The retract offset is the height to which the cutter will move laterally between cutting passes. At the retract height, the cutter is assumed
to be able to move at rapid speed anywhere within the operation's working envelope
The retract offset is the height to which the cutter will move laterally between cutting passes. At the retract height, the cutter is assumed
to be able to move at rapid speed anywhere within the operation's working envelope
### Feed (Distance)
The feed offset is the distance above the cutting pass from which entry moves will begin. The feed distance controls how far away from the material the cutter will begin moving in a feed-rate controlled manner. A rapid move vertically from retract height to the (cutting plane + feed distance) will be assumed safe.
The feed offset is the distance above the cutting pass from which entry moves will begin. The feed distance controls how far away from the material the cutter will begin moving in a feed-rate controlled manner. A rapid move vertically from retract height to the (cutting plane + feed distance) will be assumed safe.
Example: In a pocket operation with multiple step-downs, the cutter will rapid from the retract height to the start depth + feed distance on the first step down. After the completion of the pass, the cutter will retract to the retract height, rapid to the start point, and then rapid down to begin the next pass. Presumably height = ((start depth - step down) + feed distance)
@@ -52,7 +52,7 @@ Start offset is the nominal highest cutting point in the operation.
### Final (Height)
Final offset is the nominal lowest cutting point in the operation. The actual lowest cutting point may differ from the final offset due to "stock to leave" settings and other configuration options.
Final offset is the nominal lowest cutting point in the operation. The actual lowest cutting point may differ from the final offset due to "stock to leave" settings and other configuration options.
## Consequences
@@ -62,4 +62,3 @@ Wiki and other documentatin should be revised as soon as possible.
Heights and Depths tabs should be consolidated into a single tab.
Unit tests should ensure that all operations begin and end with the correct entry and exit moves.