Tool Database - Name Format

This dialog allows the editing of the name template used for naming tools with that tool type. It can be accessed through the name icon on any of the tools on the Tool Database dialog, and it will affect that particular tool or all tools with the same type.

Format

This field allows entering the name format / template that will be used for this tool (or tools of this type, controlled by the checkboxes).

The template contains variables of the format {Variable Name} which will be substituted by their real value for the tool.

  • For example, {Tool Type} will be End Mill for an End Mill tool and Ball Nose for a Ball Nose tool.
  • We can optionally format those the values in certain ways using modifiers {Variable Name|Modifier}. In the above example, {Tool Type|U} would result in END MILL or BALL NOSE.

The list of all available variables and modifiers is available at the bottom of the page. It can also be accessed by right-clicking the field and selecting the variable.

Variables could relate to the tool geometry, cutting data or even machine and material being used. The tool name will automatically update within the current context. For example,

  • We have materials MDF and Oak and a tool with the name template {Tool Type} {Diameter} {Material Name}. The tool is an 0.5 inch End Mill.
  • When the MDF material is active, the name of the tool becomes End Mill 0.5 MDF. When it Oak is active, it becomes End Mill 0.5 Oak.
  • When the tool is selected for toolpathing, the name of the tool with the correct material name will be used allowing you to see straight away which variant of the tool you've used.

Set as Default

This dialog can be used to manage name formating for each tool type. When a format is set as the default, any subsequently created tools will be named according to that format by default. Setting a format as a default (optionally) allows you to do just that.

Any tool which does not have the default name format for its type can be restored using the next to the format field.

Update existing tools

When changing the name format of a tool, there is the option to rename all the other tools with with the same Tool Type.

If you select this, you will have the option to either

  1. Rename all the tools that had a matching name.
  2. Rename all the tools indiscriminantly.

List of Variables

This is the full list of variables that can be used in the format.

In some cases, we may not be able to find a valid value. For example, if we use the {Material Name} when no material is active. In that case, we will simply keep the variable name in the tool name. This should not happen if the tool is valid / suitable for toolpath selection.

Variable

Type

Geometry

{Tool Type}

String

{Units}

String

{Units Short}

String

{Diameter}

Float

{Included Angle}

Float

{Side Angle}

Float

{Tip Radius}

Float

{Flat Diameter}

Float

{Num Flutes}

Integer

{Max Power}

Integer

Cutting Parameters

{Length Units}

String

{Length Units Short}

String

{Pass Depth}

Float

{Stepover}

Float

{Final Pass Stepover}

Float

{Clearance Pass Stepover}

Float

{Num Passes}

Integer

{Kerf}

Float

{Line Width}

Float

Feeds & Speeds

{Rate Units}

String

{Move Speed}

Float

{Plunge Rate}

Float

{Spindle Speed}

Integer

{Spindle Direction}

String

{Power}

Float

{Maximum Burn Rate}

Float

{Tool Number}

Integer

Material

{Material Name}

String

Machine

{Machine Name}

String

{Machine Model}

String

{Machine Make}

String

{Machine Controller}

String

List of Modifiers

Modifiers can be used on any variable. Valid modifiers depend on the type of the variable.

Variable Type

Modifiers

String

U Uppercase

Example: {Tool Type|U} => END MILL

L Lowercase

Example: {Tool Type|L} => end mill

Float

00.00 Padding / Decimal Points

  • The number of zeros to the left of the dot control the padding.
  • The number of zeros to the right of the dot control the number of decimal points.

Example (For a 1.5101 diameter),

  • {Diameter|0.00} => 1.51
  • {Diameter|0.0} => 1.5
  • {Diameter|00.0} => 01.5

F Fraction in inches

Example (for an 1/8 inch diameter):

  • {Diameter} => 0.125
  • {Diameter|F} => 1/8