ALTO methods
How ALTO is made
- Covers
- Releases 5 to 6.2
- Each release
- Methods
- Every source
- Sources and credits
An overview of how ALTO is built: the sources, the crowns drawn from the 2024 LiDAR survey, how records are linked to crowns, how estimates and their ranges are made, how reviews and corrections reach the map, and how releases are numbered. Each section links the release methods that hold the detail, the figures and the checks.
Sources
ALTO combines tree records from their publishers with airborne LiDAR surveys and aerial photographs. Each source record keeps its original identifier and position in the tree’s full record. ALTO crops, resamples, reprojects and combines these data, matches records to LiDAR crowns and adds its own estimates. The organisations that publish the data have not reviewed or endorsed ALTO’s estimates.
| Source | What ALTO uses it for |
|---|---|
| Auckland Council tree register, including Auckland Transport and Parks trees | Recorded trees, their species names, positions and record IDs |
| Notable Trees schedule, Auckland Unitary Plan | Scheduled trees and their recorded positions |
| Kauri survey records, Auckland Council | Survey records, with each record’s status as the Council publishes it |
| OpenStreetMap | Trees mapped by contributors; addresses, golf courses and island roads for property summaries |
| Auckland 2024 LiDAR survey | Crown outlines, heights and crown areas |
| Earlier LiDAR surveys, 2013 and 2016–18 | Earlier canopy records for each tree’s survey history |
| Aerial photographs | Vegetation index for drawing crowns, image features for the growth form, and the imagery on tree pages |
| KYTE ground visits | Photographs, notes and measurements made at the tree, published after a reviewer accepts them |
Species names come only from source records. Tree pages credit and link each register that lists a tree.
Crowns from the 2024 LiDAR survey
Release 5 redrew Auckland’s canopy from the 2024 LiDAR survey and aerial NDVI (normalised difference vegetation index). Each LiDAR crown 3 m or taller is one marker on the map. Separate layers show canopy 2–3 m tall and vegetation below 2 m, and those layers do not contribute to benefit totals.
Crowns are not merged beyond 400 m²; a larger tree can be split into several crowns. A crown outline can still split one tree or join several: large spreading and multi-stem trees can be split or partly trimmed.
Release 6 draws each crown with a smoothed outline around the same cells; the crown’s area, height and every estimate keep the cell area. Release 6 also estimates a growth form for each crown from its LiDAR returns, its surroundings and the 2024 aerial photograph. A growth form is shown only where calls of its kind agreed with the reference labels often enough when tested; otherwise the crown reads “growth form not yet determined”. A growth form is a coarse class. The labels made from imagery, used in training and in the checks, come from a machine-learning image-interpretation model in one pass; no independent second labeller has checked them.
Each crown carries the measures in Table 2. The tree page shows each with its source, date and margin; Species maxima ranks height, crown spread and crown area.
| Measure | Definition | Margin |
|---|---|---|
| Height | Highest point of the 2024 LiDAR canopy height model within the crown. The highest single laser return is usually a little higher, and airborne LiDAR usually reads below a field (hypsometer) height on a pointed crown. | Survey vertical accuracy ±0.2 m; ±2 m ranking margin on Species maxima (method and crown-edge differences) |
| Crown area | Area of the crown’s 0.5 m cells; release 6’s smoothed outline keeps that area. Crowns are not merged beyond 400 m². | Crown perimeter × 0.5 m |
| Crown diameter (equal-area circle) | Diameter of the circle with the crown’s area (equal-area circle). | From the crown area |
| Crown spread | Mean of the widest width and the width at right angles, from the 0.5 m crown cells. Held for the trees Species maxima ranks. A crown that is not round usually has a crown spread wider than its equal-area diameter. | ±1 m |
Linking records to crowns
Records are linked to crowns using the actual crown boundary. Where a record lies outside every crown, nearby crowns are scored on the distance from the record to the crown’s edge, whether the crown’s height and area suit the recorded taxon, conflicts with other records’ taxa on the same crown, and how many records a crown of that size usually carries. A record is linked only when its crown is clearly better than every alternative, including no crown at all. Records that cannot be linked with confidence go to review.
A link is spatial evidence that a record describes the tree on that crown. One crown may contain several trunks or trees, and a crown drawn from a record is a proposal until it is confirmed. Unverified Notable Trees schedule positions stay at their source locations and are excluded from automatic crown matching. “No crown linked” does not mean a tree is absent.
Every marker on the map, and every earlier LiDAR detection kept as a record, has a permanent tree number, such as TMCTT6X4, and a permanent link. An alias table resolves every tree number, record ID and crown key ALTO has published to the tree that carries it now, or to the reason it carries none.
Estimates and their ranges
Crown heights, areas and spreads are measured from the crowns of the 2024 LiDAR survey. Every value ALTO derives from them with a model is marked Estimate and, where the method gives one, shown with its range.
- Trunk diameter. The diameter at 1.4 m above the ground (on a slope, from mid-slope), the New Zealand convention; earlier methods pages say 1.3 m above the uphill ground, and no estimate changed. Each crown holds two model estimates, one from crown size and height and one from the benefit equations; the tree page shows their median as the central estimate, with the two models as its range. A trunk measured at a reviewed KYTE ground visit replaces both.
- Root space. Root extents are scenarios drawn from the trunk estimate and its range, with known paving where available. The root extent itself is not measured.
- Benefits. ALTO benefit scenario: simplified equations adapted from published i-Tree Eco components (USDA Forest Service and cooperators), with stated unit values; they are not run in i-Tree Eco. From release 6.3 the benefit value is stormwater plus carbon; PM2.5 removal and the cooling index are kept in the full record and not published. Benefit and trunk estimates are not independently validated; they remain sensitivity scenarios.
- Height class and crown replacement time. From release 6.3, the crown’s height as a share of a reference height for its growth form, and the years a newly planted tree would take to grow a crown of its area, in bands; crowns under 5 m tall, or whose height is not plausible, are not classed.
- Growth form. Marked Estimate, and shown only under the test described under Crowns from the 2024 LiDAR survey.
- Forecasts. Height scenarios start at the current height and reuse an earlier fitted model, whose transfer to the release 5 redraw has not yet been validated.
Reviews and corrections
Reviewer decisions about trees, crowns and records are kept in an append-only corrections ledger. Each release applies them, or records them with the trees they name, and publishes a receipt of every outcome. Each tree page lists the decisions that name the tree, its records or its crown.
Records with competing crowns, with nothing of tree height nearby or with a position that cannot be matched go to the researcher workbench, and every crown drawn from a record awaits confirmation there. Confirmations reach the map in a release.
Ground visits are recorded in KYTE: photographs, notes and measurements made at the tree. A visit appears on the tree’s page after a reviewer accepts it. Email the Better Places Lab (t.welch@auckland.ac.nz) to correct a record, with the tree number and what is wrong.
Releases
ALTO publishes numbered data releases. Each release has a dataset ID, a publication date and a methods page that says what changed, the methods, the checks and the limits. The map and its pages carry their own tool version; the release metadata records both. Releases 5 to 6.3 redraw or relink crowns of the same 2024 survey, so a change in the number of crowns between releases does not establish tree loss, new planting or growth.
-
Release 6.3: Benefit value, height checks and group areas
-
Release 6.2: Reviewer-confirmed crowns and palm-type crowns
-
Release 6.1: Permanent tree numbers
-
Release 6: Growth form and smoothed crown outlines
-
Release 5.2: Linking records to crowns
-
Release 5.1: Restoring links between records and crowns
-
Release 5: Redrawing Auckland’s canopy
