kirra-docs
Kirra — Help & User Guide
Welcome to the official documentation for Kirra, a web-based blasting pattern design application developed by Brent Buffham for the mining, quarrying, and construction industries.
Documentation freshness
These guides were reviewed against the Kirra Design source tree at:
| Field | Value |
|---|---|
| Kirra app version | 1.0.240 (package.json / package-lock.json) |
| Git commit | 8372cd581d630941483ec8db7f9f1e724d0011e4 (short: 8372cd58) |
| Commit date | 2026-05-21 (author timezone +0800) |
Use this block to judge whether the docs may be ahead of or behind your installed build. For the live app version in use, check Help → About (or your deployment’s package.json).
Products
| Product | Description |
|---|---|
| Kirra Design | The core blast design application — 2D/3D pattern layout, hole management, surface tools, charging, timing, 20+ import/export formats, blast analytics, and flyrock modelling |
| Kirra Scheduler | A companion scheduling tool for planning and sequencing blast events with Gantt charts, equipment management, and 3D playback |
Kirra App Presentation ISEE April 2026
Kirra Design
Getting Started
- Overview — What Kirra Does
- Interface Tour — Menus, Toolbars, and Panels
- Your First Blast — Step-by-Step Walkthrough
Blast Hole Design
- Holes Toolbar — button-by-button reference
- Connect Toolbar — button-by-button reference (updated with Continuous Connect)
- Adding Holes
- Editing Holes
- Pattern Generation
- Pattern Templates
- Timing Sequences
- Electronic Timing Constructs
Surfaces
- Surfaces Toolbar — button-by-button reference
- Importing Surfaces
- Surface Gradients
- Surface Boolean & CSG
- Mesh Editing & Clean Mesh
- Surface Contours
Importing Data
- CSV Formats
- DXF Import
- Surpac DTM / STR
- OBJ / PLY / GLTF / GLB
- Other Formats (IREDES, KML, LAS, Shapefile)
Exporting Data
Printing
- Print to PDF
- Print from Template (XLSX)
- Formula Engine — print vs charging
fx:(see also Print Formula Reference)
Formula Engine
- Formula Engine Overview — three
fx:engines (charging, print, blast group); when to use which - Deck Builder Formula Guide & Examples — charging engine: variables, functions, PPV/SDoB examples
- Print Formula Reference — print template engine: cells, aggregation, maps, legends
- Blast Group Formulas — Assign Group predicates (boolean)
- Claude Formula Skill — Install & Use — optional AI helper; download zip
Charging
Blast Analytics
- Analyse Toolbar — button-by-button reference
- Analytics Overview
- PPV & Vibration Models (shader suite)
- PPV Voronoi Modes (A/B/C/E/F) — per-cell, receptor-aware (Mode F added v1.0.230)
- Time Window Dialog — IDI, Spectrum, Synthesis, Forward Array, Detune, Constrain (new)
- Flyrock Modelling
- Blast Statistics & Voronoi
KAD Drawing Tools
- KAD Toolbar — button-by-button reference
- Drawing Points, Lines, and Polygons
- Extrude, Boolean, and Section Plane
- Modify Toolbar
Reference
- Formula Engine Overview — hub for all
fx:formula documentation - Select Toolbar — button-by-button reference
- Supported File Formats — full import/export matrix
- Hole Properties
- Coordinate System
- 3D View & Orbit Focus
- Keyboard Shortcuts & Mouse Controls
- JavaScript pitfalls — zero vs falsy & import zoom (contributors)
- FAQ
Kirra Scheduler
- Quick Start
- Gantt Chart
- Blast Overview
- Pattern Library
- Equipment Management
- Drill Blocks
- Dependencies
- Pattern Preparation
- Explosive Forecast
- Conformance
- 3D Playback
- Import & Export
- Theming
About
Kirra Licence v1.0 — Kirra Design is free for mining, quarrying, construction, and research use. Commercial software integration requires written permission from Brent Buffham. See About for details.