XyzPilot Documentation

Complete operating guide for CNC 3-axis milling workflows — from creating your first geometry to generating a verified CNC program.

About This Manual

This manual describes the operation of XyzPilot, a 2D CAD/CAM system designed to support CNC 3-axis milling workflows.

XyzPilot enables shop-floor personnel to create and modify 2D geometry, define machining features, and prepare CAM data for CNC milling operations. The software is intended for use by machine setters, operators, and manufacturing personnel who require a simple and efficient method of creating geometry and generating machining information directly from the shop floor.

This manual provides guidance on:

  • Getting started with XyzPilot
  • User interface navigation
  • Creating and editing 2D geometry
  • Preparing machining information
  • Generating CAM data
  • Workflow best practices
  • Common operating procedures
  • Troubleshooting and support information
Note: This guide applies to XyzPilot Version 1.0, published July 2026. Future software releases may introduce additional functions not covered by this edition.

Document Conventions

This section explains the conventions, terminology, symbols, and formatting used throughout this manual.

Command Syntax

XyzPilot uses an APT-style command structure to define geometry and machining operations. Command examples are shown in a fixed format:

POINT/CENTER,C1,Z LINE/P1,P2 LINE/PARLEL,L1,XSMALL,D

Geometry References

XyzPilot automatically assigns reference numbers to geometry entities when they are created:

PrefixGeometry TypeExample
PPointP1, P2, P3…
LLineL0, L1, L2…
CCircleC0, C1, C2…
AArcA0, A1, A2…
LChamfer (as Line)L0, L1… (chamfers are represented as lines)
BLBroken LineBL0, BL1…

Parameters and Variables

ParameterDescription
XX-axis coordinate
YY-axis coordinate
ZZ-axis coordinate or depth value
AAngle value
DDistance or offset value
NQuantity or count
RRadius value

Direction Selectors

Some commands require a solution direction when multiple valid results are available:

OptionDescription
XLARGEUses the solution with the largest X value
XSMALLUses the solution with the smallest X value
YLARGEUses the solution with the largest Y value
YSMALLUses the solution with the smallest Y value

Units of Measurement

ItemUnit
LengthMillimetres (mm)
AnglesDegrees (°)
CoordinatesCartesian X, Y, Z

Coordinate System

XyzPilot uses a standard Cartesian coordinate system:

  • Positive X values increase to the right
  • Positive Y values increase upward
  • Z values represent height, depth, or machining level depending on the operation

Safety Information

Warning: Incorrect geometry or machining data can result in machine collisions, tool breakage, damaged workpieces, or personal injury. Always verify machining parameters and CNC programs before use on production equipment.

General Safety Notice

XyzPilot is a software application used to create geometry and prepare machining information for CNC milling operations. While the software does not directly control machine movement, the data generated by XyzPilot may be used in CNC programs that control machine tools.

Users are responsible for verifying all geometry, dimensions, machining parameters, and generated CNC programs before machining a component.

Operator Responsibility

The operator is responsible for:

  • Verifying all geometry before creating toolpaths
  • Confirming dimensions and coordinate locations
  • Checking tools, work offsets, and workholding arrangements
  • Reviewing all generated machining information before production use
  • Performing safe machine setup procedures
  • Following all company safety policies and machine manufacturer's instructions

Verify CNC Programs Before Machining

  • Review all geometry and machining features
  • Verify cutter selection and tool dimensions
  • Confirm workpiece zero locations
  • Check programmed depths and coordinate positions
  • Simulate or prove-out the program where possible
  • Perform a safe test run before production machining
Warning: Never assume generated data is correct without verification. The operator remains responsible for the final accuracy and safety of all machined components.

Machine Safety

Always follow established CNC machine safety procedures. Before operating a machine:

  • Ensure guards and safety devices are functioning correctly
  • Confirm that tools are securely fitted
  • Verify workpieces are clamped securely
  • Remove adjustment tools and gauges from the machine envelope
  • Wear approved personal protective equipment (PPE)

Training Requirements

XyzPilot is intended for use by personnel familiar with basic CAD principles, CNC milling processes, technical drawings, coordinate systems, and safe machine operation. Additional training may be required before operating CNC machinery.

Getting Started

XyzPilot is a web-based application — no local software installation is required. Access is provided through a supported web browser and a network connection.

Before You Begin

  • You have a valid XyzPilot username and password
  • Your computer meets the minimum system requirements
  • You are connected to the network required to reach the XyzPilot server
  • A supported web browser is installed and up to date
Note: Supported browsers are Microsoft Edge (latest) and Google Chrome (latest). See the System Requirements page for full details.

Logging In

Starting XyzPilot

  1. Open a supported web browser (Microsoft Edge or Google Chrome)
  2. Enter the XyzPilot web address provided by your system administrator
  3. Press Enter to open the XyzPilot login page

Logging In

  1. Enter your Username
  2. Enter your Password
  3. Click Log In

If the login details are correct, XyzPilot will open and display the main working interface.

Incorrect Login Details

If an incorrect username or password is entered, an error message will be displayed and access will be denied. Re-enter your credentials and try again. If login problems persist, contact your system administrator.

Logging Out

  1. Save all work
  2. Close any open projects if required
  3. Select Log Out from the user menu
  4. Close the browser window
Important: Log out when leaving your workstation unattended. Do not share user accounts. Keep your password confidential.

User Interface Overview

XyzPilot uses a menu-driven interface based on established APT-style CAD/CAM principles. Rather than typing commands directly, operators select geometry and machining functions from menus, enter values where required, and use visual previews to verify results before committing them.

XyzPilot Workflow

The typical XyzPilot workflow follows this sequence:

  1. Select a geometry or CAM function
  2. Select the required geometry entities
  3. Enter dimensions, angles, offsets, or machining parameters
  4. Review the transient preview
  5. Commit the operation
  6. Verify the resulting geometry
  7. Continue with CAD creation or CAM preparation

Quick Input Panels

Most geometry creation and editing functions use a dedicated Quick Input panel. These panels provide a simple method of entering parameters without manually typing APT-style command syntax.

FieldDescription
XX Coordinate
YY Coordinate
ZZ Coordinate (normally 0)
PPoint Reference
LLine Reference
CCircle Reference
AArc Reference
RRadius
DDistance
AngleAngular Value
DirDirection Selection

Transient Preview

XyzPilot incorporates a transient preview system throughout all geometry creation and editing functions. As parameters are entered, a temporary representation of the resulting geometry is displayed within the graphics canvas. Geometry is not permanently created or modified until the operation is confirmed using Apply or Commit Preview.

Note: Always verify the transient preview before committing any operation. This reduces geometry errors and speeds up your CAD workflow.

CAD Geometry Functions

The CAD Geometry Functions provide the tools required to create, modify, and manage 2D geometry within XyzPilot. The geometry created forms the foundation for all subsequent measurement, editing, and CAM programming operations.

Points

The Points menu contains commands used to create individual points and point patterns. Points may be created using coordinate values, existing geometry, intersections, tangencies, angular positioning, and geometric relationships.

Note: In normal XyzPilot operation the Z value remains set to 0.
Managing Points: Points exist on their own dedicated layer and can be hidden or shown independently of other geometry. Use Edit → Clear All Points to delete all points at once without affecting any lines, arcs, circles, or toolpaths. This is useful after completing a construction sequence to keep the model clean.

Point — Coordinate

Creates a point at specified X and Y coordinates.

Quick Input: X, Y: 100, 50 Z: 0 Result: P0 = (100, 50)

Point — Circle Centre

Creates a point at the centre of an existing circle.

Quick Input: C: 0 Z: 0 Result: P1 = (50, 50) [centre of C0]

Point — Line/Circle Intersection

Creates a point at the intersection of a line and circle. Use direction selectors (XL, XS, YL, YS) to choose the correct solution.

Quick Input: L: 0 C: 0 Z: 0 XL selected Result: P2 = (100, 50) [largest X intersection]

Point — Delta Offset

Creates a new point by applying X and Y offsets to an existing point.

Quick Input: P: 0 Z: 0 dX: 25 dY: 10 Result: P16 = (125, 60) [P0 offset by +25X, +10Y]

Point — Angle & Distance

Creates a new point at a specified angle and distance from an existing point.

Quick Input: P: 0 Angle: 45 Dist: 50 Z: 0 Result: Point at 45° and 50mm from P0

Point on Arc

Creates a point on an existing arc at a specified angular position.

Quick Input: A: 0 Angle: 45 Z: 0 Result: Point on arc A0 at 45°

Tangent Point — Circle / Arc

Creates a point at the tangent location between a circle and an arc. The tangent direction defaults to external unless internal is selected in the Quick Input panel.

Quick Input: C: 0 A: 0 Z: 0 Label: (optional) Direction: Internal / External (default: External)
Note: The tangent is always external until the Internal option is selected in the Quick Input panel.

Intersect — Line / Arc

Creates a point at the intersection of a line and an arc. Direction selectors determine which intersection solution is used when multiple valid results exist.

Quick Input: L: 0 A: 0 Z: 0 Dir: XL (largest X) XS (smallest X) YL (largest Y) YS (smallest Y)

Tangent Point — 2 Arcs

Creates a point at the tangent location between two arcs.

Quick Input: A: 0 A2: 1 Z: 0 Result: Tangent point between A0 and A1

Intersect — 2 Arcs

Creates a point at the intersection of two arcs. Direction selectors determine which intersection solution is used when multiple valid results exist.

Quick Input: A: 0 A2: 1 Z: 0 Dir: XL (largest X) XS (smallest X) YL (largest Y) YS (smallest Y)
Note: The selected arc intersection solution is highlighted by the corresponding direction radio button in the Quick Input panel.

Lines

Create and modify straight-line geometry using points, angles, parallel relationships, perpendicular relationships, and tangencies.

Line Through Two Points

LINE/P1,P2 Quick Input: P: 1 P2: 2 Result: L0 = Line through P1 and P2

Parallel Line

LINE/PARLEL,L1,XSMALL,D Quick Input: L: 1 D: 25 XS selected Result: L1 = Parallel to L1, offset 25mm (smallest X side)

Tangent to Circle

Creates a line tangent to a circle. Direction selectors determine which tangent solution is used.

Note: Direction selectors (XLARGE, XSMALL, YLARGE, YSMALL) are commonly used with intersection, tangent, and offset geometry commands.
Important — Canvas Preview: When a selector is required but not yet specified, the transient preview on the canvas may show geometry in the wrong position. This is a preview only — no geometry has been created yet. Always confirm your selector choice before committing, and verify the final position on the canvas after the operation is complete.

Circles & Arcs

Create circular geometry, arcs, fillets, tangent features, and other curved entities. All circular geometry supports the transient preview system.

Circle by Centre & Radius

CIRCLE/CENTER,C1,Z Quick Input: X: 50 Y: 50 R: 25 Z: 0 Result: C0 = Circle at (50,50) radius 25

Fillet Arc

Creates a fillet arc of specified radius between two intersecting geometry entities. Essential for profile construction and corner blending.

Trim

Trims lines, circles, and arcs to defined boundaries. Use trim to clean up intersecting geometry and create accurate profiles.

Important: Always verify geometry after trimming. Inspect for missing entities, duplicate geometry, and unintended intersections.

User Coordinate System (UCS)

XyzPilot supports temporary User Coordinate System (UCS) transformations. The UCS allows operators to work relative to a translated or rotated coordinate system without permanently modifying existing geometry.

Available UCS Functions

  • Set Translation (UCS) — Shift the working origin
  • Set Rotation (UCS) — Rotate the working coordinate system
  • Set Rotation Center — Define the centre of rotation
  • Commit UCS Transform — Permanently apply the transformation
  • Reset Transform (UCS) — Return to standard Cartesian system
  • Restore Committed — Restore the last committed UCS state
Note: UCS transformations affect newly created geometry and editing operations while the UCS is active. Existing geometry is not permanently modified until the UCS transformation is committed.

Measure Functions

XyzPilot provides a dedicated set of measurement tools that allow operators to click directly on geometry entities and retrieve accurate dimensional data. Measurements can be taken at any point during geometry creation or CAM preparation.

Accessing Measure Tools

Select Measure from the top menu bar. The measurement tool panel will appear in the canvas area, showing the available measurement options.

Distance

Measures the distance between two selected geometry entities — points, lines, circles, or arcs.

Select: Measure → Distance Click first entity, then second entity Result: Distance value displayed

Angle

Measures the angle between two selected lines or geometry entities.

Select: Measure → Angle Click first line, then second line Result: Angle value in degrees displayed

Radius / Diameter

Measures the radius or diameter of a selected circle or arc entity.

Select: Measure → Radius/Diameter Click circle or arc entity Result: Radius and diameter values displayed

Length

Measures the length of a selected line or arc entity.

Select: Measure → Length Click line or arc entity Result: Length value displayed

Coordinates

Displays the exact X and Y coordinates of a selected point or entity position.

Select: Measure → Coordinates Click point or entity Result: X, Y coordinate values displayed

Entity Info

Clicking any entity displays a full property panel showing all available data for that entity. For an Arc, Entity Info displays:

PropertyDescription
typeEntity type (arc, line, circle, point)
ccwCounter-clockwise direction — Yes or No
centerCentre point coordinates (x, y)
radiusArc radius value
diameterArc diameter value
start_pointStart point coordinates (x, y)
end_pointEnd point coordinates (x, y)
start_angleStart angle in degrees
end_angleEnd angle in degrees
sweep_degreesTotal sweep angle in degrees
lengthArc length

Show Coordinates Panel

The Show Coordinates panel on the left side of the interface allows you to enter an entity reference (e.g. A3) to display its full coordinate and property data. Use the Start, End, and Angle buttons to extract specific values from the selected entity.

Note: Measurement data is displayed for reference only and does not modify geometry. Always verify measurements before using values in CAM programming.

DXF File Import

XyzPilot can import DXF files from any CAD system. The importer uses ezdxf to parse the file and extracts supported 2D geometry directly into XyzPilot's internal geometry envelope. It is a strict 2D primitive extractor — not a full CAD importer.

Supported CAD Sources

Any DXF file exported by a standard CAD system can be imported, including:

Note: There is no origin restriction. If ezdxf can parse the file, XyzPilot can import it.

How DXF Import Works

The import process follows these steps:

  1. Upload — Accept the .dxf file and pass it to ezdxf for parsing
  2. Parse modelspace — Iterate through doc.modelspace() and extract supported entities
  3. Build geometry envelope — Convert entities into XyzPilot's internal format: points, lines, circles, trimmed arcs
  4. Compute bounds — Calculate min/max X, min/max Y, width, and height
  5. Return JSON payload — Geometry is returned to the frontend for rendering

Supported DXF Entities

DXF EntityXyzPilot Conversion
POINTConverted to {x, y, z}
LINEConverted to {x1, y1, x2, y2}
CIRCLEConverted to {cx, cy, r}
ARCConverted to trimmed arc — centre, radius, start angle, end angle
LWPOLYLINEDecomposed into lines and arcs; bulge values converted to arc geometry
POLYLINEDecomposed into lines and arcs; bulge segments extracted

Ignored / Unsupported Entities

DXF EntityStatus
SPLINENot parsed
ELLIPSENot parsed
BLOCK / INSERTCompletely ignored
TEXT / MTEXTIgnored
HATCHExplicitly skipped to avoid duplicate boundaries
DIMENSION / LEADERIgnored
3DFACE / 3D entitiesNot supported
LAYERS / ATTRIBUTESLayer names discarded — all geometry flattened
VIEWPORT / PAPERSPACEIgnored

Important Limitations

Warning: DXF import is a strict 2D geometry extractor. Z values are read but never used. All geometry is flattened into a single layer — layer names are discarded. BLOCK and INSERT entities are ignored; drawings that rely heavily on blocks may appear incomplete. SPLINE and ELLIPSE entities are not converted. No colour, style, or metadata is imported.
Important: Always verify imported geometry before creating toolpaths. Check for missing entities, incorrect dimensions, and unintended intersections that may result from the DXF conversion process.

CAM Functions

The CAM functions allow operators to define machining features and prepare CNC data for 3-axis milling operations directly from the 2D geometry created in XyzPilot.

Defining Machining Features

Select geometry profiles and assign machining parameters including depth, tool selection, and feed rates.

Generating CNC Data

Once machining features are defined and verified, generate the CNC output data for use on the machine tool.

Warning: Always verify cutter selection, tool dimensions, workpiece zero locations, and programmed depths before running any CNC program produced using XyzPilot data.

CNC Workflow Example

A typical XyzPilot workflow from geometry creation to CNC output:

  1. Log in — Open XyzPilot in your browser and log in with your credentials
  2. Create geometry — Build your 2D component profile using Points, Lines, Circles, and Arcs
  3. Verify geometry — Check all dimensions, coordinates, and entity references using the Geometry Information Display
  4. Define CAM features — Select profiles, assign tools, set depths and machining parameters
  5. Generate CNC data — Produce the CNC output and review all generated information
  6. Verify & prove-out — Simulate or prove-out the program before production machining
Note: Ensure the correct drawing revision and manufacturing information are being used before creating geometry or preparing machining data.

Troubleshooting

Login Problems

If you cannot log in, verify your username and password are correct. If problems persist, contact your system administrator. For forgotten passwords, follow your company's password recovery procedure.

Geometry Errors

If geometry does not appear as expected, check for:

Browser Performance

If XyzPilot is running slowly, ensure your browser is up to date, maximise the browser window, and check your internet connection speed. Close unnecessary browser tabs and applications.

Unexpected Behaviour After Update

If unexpected behaviour occurs following a software update, report it to your system administrator or software support representative.

Note: XyzPilot is a browser-based application. Performance is influenced by internet connection speed, available computer resources, and the complexity of the CAD geometry being created or edited.

Glossary of Terms

TermDefinition
APTAutomatically Programmed Tool — a standard language for CNC programming
CADComputer-Aided Design — software used to create 2D or 3D geometry
CAMComputer-Aided Manufacturing — software used to generate machining data from CAD geometry
CNCComputer Numerical Control — automated machine tool control using programmed instructions
UCSUser Coordinate System — a temporary coordinate system offset from the standard Cartesian origin
Transient PreviewA temporary visual representation of geometry before it is committed
ToolpathThe path followed by a cutting tool during a machining operation
Work OffsetThe coordinate offset between the machine datum and the workpiece zero point
FilletA rounded internal corner created by an arc of specified radius
ChamferAn angled cut at a corner or edge
PPEPersonal Protective Equipment — safety equipment worn during machine operation