{ "version": 1, "database_mtime_ns": "1792204194828950876", "records": 6238420, "generated_utc": "2026-10-17T03:40:23.589565+00:00", "bucket_algorithm": "fnv1a_utf8_mod65536_hex4_split2", "datasets": [ { "key": "record", "table": "trees", "title": "Original tree record", "evidence": "Source record", "note": "Original source IDs, names and coordinates remain unchanged. See current crown and identity evidence for the v5 association. v6.3: species_common of the 1,205 kauri survey records reads Kauri; the result codes the name carried up to v6.2 are in the survey dataset (species_name_v62).", "fields": [ "source_primary", "source_object_id", "source_tree_id", "species_common_raw", "species_latin_raw", "species_common", "species_latin", "species_confidence", "owner_raw", "owner_class", "lon", "lat", "approx_x_m", "approx_y_m", "is_protected_notable", "notable_point_match", "notable_point_spatial_candidate", "notable_point_name_compatible", "notable_point_review_required", "notable_point_objectid", "notable_point_name", "notable_point_type", "notable_point_type_label", "notable_point_distance_m", "notable_point_match_confidence", "notable_group_match", "notable_group_count", "notable_group_objectids", "notable_group_names", "as_of_utc", "record_role", "taxon_assertion_status" ], "multiple": false }, { "key": "identity", "table": "tree_identity_v5", "title": "Current crown and record links", "evidence": "Spatial evidence", "note": "Polygon containment, audited crown continuity (v5.1) and record-to-crown links (v5.2) associate source records with current crowns. A shared crown can contain several trees; original positions, identities and histories remain separate.", "fields": [ "seg_key", "current_primary_tree_id", "evidence_tier", "link_role", "current_height_m", "current_crown_area_m2", "top_distance_m", "method_id", "source_records", "inventory_records", "members_json", "new_overlapping_crowns", "old_overlapping_crowns", "within_v5_footprint", "spatial_evidence_note" ], "multiple": false }, { "key": "tree_number", "table": "tree_number_v61", "title": "Tree number (permanent ID)", "evidence": "ALTO registry", "note": "The permanent public number of the map tree this record belongs to (T + 6 Crockford base-32 characters + a Luhn mod 32 check character; never reused). role: marker (this record is the tree's map marker), member (a record on the tree's crown without its own marker) or merged (joined to the tree by a reviewer correction). Old IDs and crown keys resolve through data/tree_ids (see its schema.json). Link: https://alto.tfwelch.com/tree/.", "fields": [ "number", "role", "kind", "status", "representative_tree_id", "minted_release", "correction_id" ], "multiple": false }, { "key": "crown", "table": "tree_current_crown_v5", "title": "Current canopy dimensions", "evidence": "Remote sensing", "note": "V5 crown boundaries and maximum height from the 2024 survey; crown_source record_seeded_v52 marks a crown drawn in v5.2 from the returns at a source record's position, awaiting confirmation. Earlier v4 crowns remain in areas outside the v5 survey footprint. v6.2: crown_source record_seeded_v52_confirmed marks a crown drawn in v5.2 from a record that a reviewer confirmed is the record's tree (evidence tier very_likely; the corrections dataset names the confirmation).", "fields": [ "crown_area_m2", "crown_diameter_m", "crown_max_chm_m", "mean_veg_height_m", "method_id", "crown_source", "current_primary_tree_id", "gap_filled_fraction", "ndvi_mean", "evidence_tier", "evidence_reasons" ], "multiple": false }, { "key": "outline", "table": "tree_crown_outline_v6", "title": "Crown outline (v6)", "evidence": "Remote sensing", "note": "The map draws this crown with the smoothed v6 outline: an area-preserving smoothing of the same v5 crown cells (crown_v53 \"B\"). Crown area, height and every estimate keep the v5 cell area (cell_area_m2); outline_area_m2 is the area of the smoothed polygon.", "fields": [ "seg_key", "crown_source", "outline_method", "outline_area_m2", "cell_area_m2", "method_id" ], "multiple": false }, { "key": "pointcloud", "table": "tree_current_pointcloud_v5", "title": "Current laser-return evidence", "evidence": "Remote sensing", "note": "Return counts and structure within the v5 crown. Interpolated area is reported as gap_filled_fraction.", "fields": [ "canopy_top_m", "n_veg_returns", "n_building_returns", "n_ground_returns", "n_unclassified_returns", "n_water_returns", "n_bridge_returns", "multi_return_fraction", "intensity_mean", "aerial_greenness", "ndvi_mean", "elongation", "bbox_fill", "gap_filled_fraction", "pointcloud_class", "method_id" ], "multiple": false }, { "key": "assets", "table": "tree_current_assets_v5", "title": "Current trunk estimates and retired size labels", "evidence": "Hypothesis", "note": "Existing height and crown sensitivity equations applied to current dimensions. Trunk diameter and life stage still need field measurements.", "fields": [ "height_max_m", "height_mean_m", "dbh_cm_crown_est", "dbh_confidence", "life_stage", "replacement_years_canopy", "irreplaceability_class", "method_id" ], "multiple": false, "retired_fields": { "life_stage": "Retired label: a height-only class stored under life-stage words, on the v5.2 growth-form class (v6.2 and earlier). The size dataset holds the height class.", "irreplaceability_class": "Retired (25 m override): every crown 25 m or taller was placed in the top class whatever its regrowth time (v6.2 and earlier). The size dataset holds the crown replacement time.", "replacement_years_canopy": "Retired: crown area divided by the planning rate of the v5.2 growth-form class (v6.2 and earlier). The size dataset holds regrowth years on the class the service estimates use." }, "title_v62": "Current trunk and life-stage estimates" }, { "key": "roots", "table": "tree_current_roots_v5", "title": "Current root scenarios", "evidence": "Hypothesis", "note": "Crown and estimated trunk dimensions set exploratory root extents. Known paving can constrain the scenario; missing paving leaves effective extent unknown. Root depth is unmeasured.", "fields": [ "dbh_cm", "trunk_circumference_cm", "crown_radius_m", "foraging_radius_m", "effective_radius_m", "effective_area_m2", "stability_radius_m", "root_constraint_flag", "rpa_radius_m", "rpa_area_m2", "life_stage", "method_id", "model_confidence", "constraint_basis" ], "multiple": false, "retired_fields": { "life_stage": "Retired label: a height-only class stored under life-stage words, on the v5.2 growth-form class (v6.2 and earlier). The size dataset holds the height class." } }, { "key": "services", "table": "tree_current_services_v6", "title": "Current ecosystem-service scenarios", "evidence": "Modelled", "note": "Existing sensitivity equations updated with current crown dimensions, once per representative crown. Several trees may share a crown. Monetary coefficients and height-based biomass remain uncalibrated. V6: where the growth-form model gives a call, LAI and the height-to-DBH curve are weighted by its calibrated probabilities and the other class parameters follow the call; a crown whose growth form is not yet determined keeps the flagged evergreen default. Records whose estimate did not change keep their V5.2 values (blank v6 fields).", "fields": [ "species_class", "species_class_source", "species_class_confidence_ml", "species_allometry_source", "paved_fraction_source", "crown_area_m2", "crown_max_chm_m", "in_flood_prone_area", "paved_fraction_used", "interception_fraction_used", "runoff_coefficient_used", "intercepted_rainfall_m3_y", "avoided_runoff_m3_y", "stormwater_value_nzd_y", "dbh_cm_est", "agb_kg_est", "bgb_kg_est", "carbon_kg_est", "stored_co2e_tonnes_est", "annual_sequestration_tco2e_y_est", "carbon_value_nzd_stored", "carbon_value_nzd_y", "cooling_value_nzd_y_temp", "cooling_value_nzd_y_paved", "cooling_value_nzd_y", "lai_used", "pm25_removed_kg_y", "air_quality_value_nzd_y", "total_value_nzd_y", "total_value_nzd_y_low", "total_value_nzd_y_high", "uncertainty_factor", "valuation_confidence", "method_id", "assumptions_json", "created_at_utc", "growth_form_basis", "growth_form_default", "growth_form_weights_json", "v52_species_class", "v52_species_class_source", "v52_total_value_nzd_y", "v52_avoided_runoff_m3_y", "v52_stored_co2e_tonnes_est" ], "multiple": false, "retired_fields": { "total_value_nzd_y": "Kept for provenance; not release-eligible from v6.3. Sum of stormwater, carbon, cooling and air-quality dollars (v6 to v6.2 headline); the benefits dataset holds the release value.", "total_value_nzd_y_low": "Kept for provenance; not release-eligible from v6.3.", "total_value_nzd_y_high": "Kept for provenance; not release-eligible from v6.3.", "air_quality_value_nzd_y": "Kept for provenance; not release-eligible from v6.3. PM2.5 removal priced at NZ$25 per kg.", "cooling_value_nzd_y": "Kept for provenance; not release-eligible from v6.3.", "cooling_value_nzd_y_temp": "Kept for provenance; not release-eligible from v6.3.", "cooling_value_nzd_y_paved": "Kept for provenance; not release-eligible from v6.3.", "pm25_removed_kg_y": "Kept for provenance; not release-eligible from v6.3. v6 rule: crown area × leaf area index × 0.008 kg a year." } }, { "key": "ground", "table": "tree_ground_evidence", "title": "Field observations", "evidence": "Reported / photographed", "note": "Dated field observations retain their provenance. Joined-crown dimensions derived from earlier segmentation are distinct from field measurements. v6.3: where a reviewer's note (notes dataset) replaces a field visit's wording, the visit's note shows the note's history line; the database keeps the original.", "fields": [ "observed_on", "presence", "photo_views", "gps_accuracy_m", "joined_records", "joined_crown_area_m2", "joined_crown_width_m", "joined_height_max_m", "joined_height_p95_m", "trunk_form", "leaves", "species_common", "species_latin", "species_basis", "note", "method_id", "created_at_utc" ], "multiple": false }, { "key": "field", "table": "tree_field_observation_v5", "title": "Recent field report", "evidence": "Observer report", "note": "Devonport Primary plaque observation and record links reported by the observer. Tentative identities and the schedule association remain marked for checking.", "fields": [ "observed_on", "observation_json" ], "multiple": false }, { "key": "location_review", "table": "tree_location_review_v5", "title": "Source location review", "evidence": "Source metadata", "note": "Unverified Council points remain register entries and are excluded from automatic crown matching.", "fields": [ "source_position_status", "source_schedule", "automatic_crown_link_allowed", "review_note" ], "multiple": false }, { "key": "notable_link_review", "table": "tree_notable_link_review_v5", "title": "Earlier notable-point association", "evidence": "Needs checking", "note": "The source notable point is unverified. This review concerns the notable association, while the inventory record keeps its own position.", "fields": [ "original_notable_objectid", "notable_source_position", "review_note", "protected_from_verified_or_group_evidence" ], "multiple": false }, { "key": "source_crosswalk", "table": "notable_source_crosswalk_v5", "title": "Council source-ID reconciliation", "evidence": "Provenance", "note": "Original ALTO identity and current Council IDs, matched by unchanged schedule, name and position. Renumbering does not create a new tree.", "fields": [ "old_objectid", "current_objectid", "old_globalid", "current_globalid", "source_snapshot_sha256", "match_method" ], "multiple": false }, { "key": "trajectory", "table": "tree_trajectory_pilot", "title": "Earlier canopy history 2013–2024", "evidence": "Estimated", "note": "Preserved historical matching results. V5 redraws the same 2024 survey; differences between v4 and v5 crown counts do not establish tree loss or growth.", "fields": [ "trajectory_id", "lon", "lat", "x_2193", "y_2193", "present_2013", "present_2016", "present_2024", "h_2013", "h_2016", "h_2024", "growth_2013_2016", "growth_2016_2024", "fate", "implausible", "created_at_utc" ], "multiple": false }, { "key": "species", "table": "tree_species_attributes_v63", "title": "Growth form and reference height", "evidence": "i-Tree species database", "note": "Mature height: i-Tree species database (USDA Forest Service), for the recorded species or its genus; i-Tree gives it in feet (mature_height_ft_as_supplied) and mature_height_m converts it (x 0.3048). i-Tree heights describe trees grown in the United States. height_plausibility: implausibly_tall where the LiDAR canopy height is above 1.3 x the mature height, ok at or below it, no_ceiling where either height is missing. growth_form_source curated_species: ALTO's class for a species the i-Tree database misclasses (pūriri evergreen broadleaf; cabbage tree palm or palm-like); growth_form_as_supplied and growth_form_source_as_supplied keep the i-Tree value. v6.3: read from tree_species_attributes_v63 (metres); fields_v62 lists the fields v6.2 published.", "fields": [ "growth_form", "growth_form_source", "growth_form_confidence", "model_confidence", "mature_height_m", "mature_height_ft_as_supplied", "lidar_height_m", "height_plausibility", "growth_form_as_supplied", "growth_form_source_as_supplied" ], "multiple": false, "fields_v62": [ "growth_form", "growth_form_source", "growth_form_confidence", "model_confidence", "mature_height_m", "lidar_height_m", "height_plausibility" ], "title_v62": "Species references and growth form", "table_v62": "tree_species_attributes", "note_v62": "Recorded identifications, reference matches and model guesses retain separate provenance. The v6 growth-form model estimate is a separate dataset (growth_form).", "retired_fields": { "height_plausibility": "Retired in v6.3. It compared the LiDAR height with 1.3 x the i-Tree mature height, a typical height for the species. Height checks against published maximum heights are in the height_check dataset." } }, { "key": "growth_form", "table": "tree_growth_form_v6", "title": "Growth form (model, v6)", "evidence": "Model estimate", "note": "Growth form estimated for the crown from the 2024 LiDAR and aerial imagery (phase-2b model A2, C1 palm detector, A2_robust on April and October flights). A model estimate, never an identified species; a recorded species stays the tree's species. display_key and wording follow the v6 display rules; display_r15 is the rule before the v6 palm guard and the outside-isthmus palm-type decision. Probabilities are calibrated four-class model outputs, rounded to 4 decimals. v6.2: the C1 palm detection is also used from a score of 0.2 (v6: 0.5) on crowns whose growth form v6 left undetermined, after a blind check; method_id says so on the crowns it changed.", "fields": [ "seg_key", "display_key", "wording", "display", "display_reason", "call", "band", "palm_subcall", "model_id", "model_call", "model_band", "c1_override", "p_palm_det", "guard_v2", "p_evergreen_broadleaf", "p_deciduous_broadleaf", "p_conifer", "p_palm", "p_palm_like", "p_tree_fern", "isthmus", "leaf_on", "lidar_flight_date", "late_june_flight", "display_r15", "display_reason_r15", "structure_call", "merged_call", "method_id" ], "multiple": false }, { "key": "predictions", "table": "tree_species_class_predictions", "title": "Earlier growth-form guesses", "evidence": "Prediction", "note": "Stored class scores from the previous inputs. These are not calibrated species probabilities and have not been rerun on v5 crowns.", "fields": [ "predicted_species_class", "species_class_confidence", "proba_evergreen_broadleaf", "proba_deciduous_broadleaf", "proba_conifer", "proba_palm_other", "model_id", "created_at_utc", "score_semantics", "release_eligible" ], "multiple": false }, { "key": "context", "table": "tree_context_pilot", "title": "Mapped surroundings", "evidence": "Mapped / modelled", "note": "Source-position context retained from the previous release. Absent values remain missing.", "fields": [ "in_flood_plain", "flood_plain_count", "in_flood_prone_area", "flood_prone_area_count", "flood_prone_max_depth_m", "dist_overland_flow_path_m", "dist_stormwater_pipe_m", "dist_stormwater_catchpit_m", "dist_stormwater_manhole_m", "dist_stormwater_inlet_outlet_m", "air_temp_mean_c", "air_temp_max_c", "fraction_paved_surfaces", "fraction_buildings", "fraction_trees", "context_confidence", "created_at_utc" ], "multiple": false }, { "key": "impervious", "table": "tree_impervious_pilot", "title": "Paving, buildings and roads", "evidence": "Mapped", "note": "Stored surface-cover samples at the original tree position.", "fields": [ "fraction_impervious_30m", "fraction_buildings_30m", "fraction_roads_30m", "fraction_other_imperv_30m", "source", "created_at_utc" ], "multiple": false }, { "key": "previous_crown_v4", "table": "tree_previous_crown_v4", "title": "Previous v4 crown measurements", "evidence": "Earlier segmentation", "note": "Original v4 geometry statistics, retained to compare redraws of the same 2024 survey.", "fields": [ "seg_key", "x_2193", "y_2193", "lon", "lat", "height_m", "crown_area_m2", "crown_diameter_m", "mean_veg_height_m", "n_veg_returns", "n_building_returns", "n_unclassified_returns", "n_bridge_returns", "n_water_returns", "n_ground_returns", "multi_return_fraction", "intensity_mean", "aerial_greenness", "elongation", "bbox_fill", "hedge_fraction", "gap_filled_fraction", "evidence_tier", "evidence_reasons", "n_records_linked", "method_id", "created_at_utc" ], "multiple": false }, { "key": "previous_assets", "table": "tree_assets_pilot", "title": "Earlier dimensions and neighbourhood estimates", "evidence": "Previous model", "note": "Preserved earlier canopy structure, neighbourhood, condition, diversity and life-stage estimates. Their inputs predate v5.", "fields": [ "height_p25_m", "height_p50_m", "height_p75_m", "height_p95_m", "height_max_m", "height_mean_m", "crown_volume_m3", "canopy_density_proxy", "crown_complexity_index", "vertical_ratio", "n_canopy_pixels", "nearest_tree_m", "neighbours_25m", "neighbours_50m", "local_canopy_density_25m", "local_canopy_density_50m", "crown_overlap_index", "cluster_id", "cluster_size", "growth_setting", "edge_tree", "dominance_class", "dbh_cm_crown_est", "dbh_confidence", "life_stage", "replacement_years_canopy", "irreplaceability_class", "condition_proxy", "condition_confidence", "neighbourhood_shannon", "neighbourhood_class_simpson", "neighbourhood_native_share", "neighbourhood_tree_count", "created_at_utc" ], "multiple": false, "retired_fields": { "life_stage": "Retired label: a height-only class stored under life-stage words, on the v5.2 growth-form class (v6.2 and earlier). The size dataset holds the height class.", "irreplaceability_class": "Retired (25 m override): every crown 25 m or taller was placed in the top class whatever its regrowth time (v6.2 and earlier). The size dataset holds the crown replacement time.", "replacement_years_canopy": "Retired: crown area divided by the planning rate of the v5.2 growth-form class (v6.2 and earlier). The size dataset holds regrowth years on the class the service estimates use." } }, { "key": "previous_roots", "table": "tree_root_zone_pilot", "title": "Earlier root scenarios", "evidence": "Previous model", "note": "Preserved root assumptions and estimates based on the earlier crown inputs.", "fields": [ "dbh_cm", "trunk_circumference_cm", "crown_radius_m", "foraging_radius_m", "effective_radius_m", "effective_area_m2", "stability_radius_m", "root_constraint_flag", "rpa_radius_m", "rpa_area_m2", "life_stage", "root_zone_avoided_runoff_m3_y", "root_zone_stormwater_value_nzd_y" ], "multiple": false, "retired_fields": { "life_stage": "Retired label: a height-only class stored under life-stage words, on the v5.2 growth-form class (v6.2 and earlier). The size dataset holds the height class." } }, { "key": "previous_services", "table": "tree_valuation_pilot", "title": "Earlier service estimates", "evidence": "Previous model", "note": "Preserved service and monetary scenarios from the earlier geometry; excluded from v5 headline totals within the new footprint.", "fields": [ "species_class", "species_class_source", "species_class_confidence_ml", "species_allometry_source", "paved_fraction_source", "crown_area_m2", "crown_max_chm_m", "in_flood_prone_area", "paved_fraction_used", "interception_fraction_used", "runoff_coefficient_used", "intercepted_rainfall_m3_y", "avoided_runoff_m3_y", "stormwater_value_nzd_y", "dbh_cm_est", "agb_kg_est", "bgb_kg_est", "carbon_kg_est", "stored_co2e_tonnes_est", "annual_sequestration_tco2e_y_est", "carbon_value_nzd_stored", "carbon_value_nzd_y", "cooling_value_nzd_y_temp", "cooling_value_nzd_y_paved", "cooling_value_nzd_y", "lai_used", "pm25_removed_kg_y", "air_quality_value_nzd_y", "total_value_nzd_y", "total_value_nzd_y_low", "total_value_nzd_y_high", "uncertainty_factor", "valuation_confidence", "method_id", "assumptions_json", "created_at_utc" ], "multiple": false }, { "key": "scenarios", "table": "tree_valuation_scenarios", "title": "Earlier alternative service scenarios", "evidence": "Scenario", "note": "Includes nominal-crown scenarios for records without a segmented crown. Excluded from headline totals.", "fields": [ "scenario_row_id", "scenario_name", "remediation_run_id", "moved_at_utc", "species_class", "species_class_source", "species_class_confidence_ml", "species_allometry_source", "paved_fraction_source", "crown_area_m2", "crown_max_chm_m", "in_flood_prone_area", "paved_fraction_used", "interception_fraction_used", "runoff_coefficient_used", "intercepted_rainfall_m3_y", "avoided_runoff_m3_y", "stormwater_value_nzd_y", "dbh_cm_est", "agb_kg_est", "bgb_kg_est", "carbon_kg_est", "stored_co2e_tonnes_est", "annual_sequestration_tco2e_y_est", "carbon_value_nzd_stored", "carbon_value_nzd_y", "cooling_value_nzd_y_temp", "cooling_value_nzd_y_paved", "cooling_value_nzd_y", "lai_used", "pm25_removed_kg_y", "air_quality_value_nzd_y", "total_value_nzd_y", "total_value_nzd_y_low", "total_value_nzd_y_high", "uncertainty_factor", "valuation_confidence", "method_id", "assumptions_json", "created_at_utc" ], "multiple": true }, { "key": "previous_pointcloud", "table": "tree_pointcloud_pilot", "title": "Earlier laser-return profiles", "evidence": "Previous analysis", "note": "Original point-cloud classifications and foliage profiles remain available with their original spatial basis.", "fields": [ "n_points", "n_ground", "n_vegetation", "n_building", "n_water", "n_noise", "n_unclassified", "veg_fraction", "veg_cover", "multireturn_fraction", "intensity_mean", "point_density", "canopy_top_m", "canopy_base_m", "canopy_mean_m", "canopy_std_m", "canopy_relief_ratio", "pc_canopy_present", "is_vegetation", "is_building", "pc_false_positive", "pointcloud_class", "created_at_utc", "canopy_cover", "gap_fraction", "height_to_live_crown_m", "understory_present", "n_canopy_layers", "canopy_rugosity_m", "foliage_profile", "pc_review_no_canopy" ], "multiple": false }, { "key": "previous_crown", "table": "tree_crown_pilot", "title": "Earlier raster crown", "evidence": "Previous segmentation", "note": "Stored raster-derived canopy footprint measurements.", "fields": [ "crown_area_m2", "crown_diameter_m", "crown_mean_chm_m", "crown_max_chm_m", "method_id", "created_at_utc" ], "multiple": false }, { "key": "lidar", "table": "tree_lidar_pilot", "title": "Earlier canopy raster sample", "evidence": "Remote sensing", "note": "Height samples at the original point, separate from the v5 segmented crown maximum.", "fields": [ "x_2193", "y_2193", "chm_at_point_m", "chm_local_max_2m_m", "likely_canopy_ge_3m", "method_id", "created_at_utc" ], "multiple": false }, { "key": "previous_evidence", "table": "tree_evidence_v4", "title": "Previous detection assessment", "evidence": "Previous analysis", "note": "V4 assessment retained for comparison. Current location and identity review takes precedence.", "fields": [ "evidence_tier", "evidence_reasons", "seg_key", "link_role", "link_dist_m", "crown_source", "v4_height_m", "v4_crown_area_m2", "restored", "method_id", "created_at_utc" ], "multiple": false }, { "key": "restoration", "table": "tree_restoration_log", "title": "Restored record", "evidence": "Provenance", "note": "Records restored after an earlier processing error.", "fields": [ "restored_from", "reason", "restored_at_utc" ], "multiple": false }, { "key": "review", "table": "tree_hard_negative_candidates", "title": "Earlier alternative detection explanation", "evidence": "Hypothesis", "note": "Stored suggestions that a detection may represent another object, available for comparison with current evidence.", "fields": [ "candidate_type", "suggested_label", "reason", "osm_type", "osm_id", "osm_name", "lon", "lat", "crown_area_m2", "crown_max_chm_m", "total_value_nzd_y", "method_id", "created_at_utc" ], "multiple": false }, { "key": "crown_link_review", "table": "tree_crown_link_repairs_v5", "title": "Crown association audit", "evidence": "Audited spatial association", "note": "Small position offsets and dominant V4–V5 crown overlap support restored links. Review-needed candidates remain unlinked. This is not confirmation that shared source records describe one organism.", "fields": [ "seg_key", "primary_tree_id", "old_seg_key", "status", "reason", "evidence_json", "method_id" ], "multiple": false }, { "key": "record_link", "table": "tree_record_link_v52", "title": "Record-to-crown link (v5.2)", "evidence": "Positional matching with size and neighbour evidence", "note": "Joins a source record that v5.1 left unlinked to a v5 crown, or to a crown drawn from the LiDAR returns at its position. The source position is kept unchanged (source_lon, source_lat). joined_as says whether the record became the crown's map marker or a member of a tree that already had one. v6.2: where a reviewer confirmed or outlined the crown drawn from this record, or linked the record to another crown, review_status is confirmed and the link fields describe the reviewer's link; otherwise every field is the v5.2 linker's.", "fields": [ "seg_key", "link_class", "link_evidence", "confidence", "edge_distance_m", "top_distance_m", "shared_crown_n", "crown_source", "display_style", "review_status", "source_lon", "source_lat", "method_id", "crown_set_id", "status", "joined_as", "crown_canopy_class", "crown_in_service_totals" ], "multiple": false }, { "key": "record_link_status", "table": "tree_record_link_status_v52", "title": "Record-to-crown linking: left unlinked (v5.2)", "evidence": "Survey coverage", "note": "No v5 crowns or 2024 point cloud reach this position, so the record cannot be linked to a crown by any method. The record is unchanged and stays unlinked until the survey coverage is extended.", "fields": [ "status", "reason", "reason_text", "method_id", "crown_set_id" ], "multiple": false }, { "key": "corrections", "table": "config/corrections/corrections.jsonl", "title": "Reviewer corrections", "evidence": "Human review", "note": "Accepted human corrections that concern this tree, from the append-only ALTO corrections ledger, and how this release carries each one: applied (the map and record show it), recorded_in_release (published with the tree, values unchanged), already_in_release, or pending (needs a crown or association rebuild; reason given). data/corrections-applied.json lists every correction in the ledger. v6.3: public_summary gives each correction in tree numbers and plain names, as the receipt (data/corrections-applied.json) does; summary stays as recorded.", "fields": [ "id", "version", "type", "status", "outcome", "role", "summary", "decided_on", "reviewer", "evidence", "reason", "public_summary" ], "multiple": true }, { "key": "benefits", "table": "tree_benefits_v63", "title": "Benefit estimates (v6.3)", "evidence": "Service estimates on the published crown (v6 functions)", "fields": [ "benefit_value_nzd_y", "benefit_value_nzd_y_low", "benefit_value_nzd_y_high", "components", "pm25_removed_g_y", "cooling_index", "release_eligible", "withheld_reason", "method_id" ], "field_labels": { "benefit_value_nzd_y": "Benefit value (stormwater and carbon), NZ$ a year", "benefit_value_nzd_y_low": "Benefit value, low end of band, NZ$ a year", "benefit_value_nzd_y_high": "Benefit value, high end of band, NZ$ a year", "components": "Benefit value components", "pm25_removed_g_y": "PM2.5 removed (g a year): deposition velocity × annual mean PM2.5 × leaf area × time in leaf × share kept on leaves (Nowak et al. 2013; Auckland Council monitoring, 2024)", "cooling_index": "Cooling index (no unit): crown area (m²) × (paved fraction + 2 × degrees of mean air temperature above 18 °C)", "release_eligible": "PM2.5 removal and cooling index release-eligible (1) or kept in the record only (0)", "withheld_reason": "Why estimates are withheld", "method_id": "Method" }, "columns": { "benefit_value_nzd_y": "headline_value_nzd_y", "benefit_value_nzd_y_low": "headline_value_nzd_y_low", "benefit_value_nzd_y_high": "headline_value_nzd_y_high", "components": "components", "pm25_removed_g_y": "pm25_removed_g_y", "cooling_index": "cooling_index", "release_eligible": "pm25_cooling_release_eligible", "withheld_reason": "withheld_reason", "method_id": "method_id" }, "note": "Benefit value is stormwater plus carbon in NZ$ a year, with a low to high band from the valuation confidence (±30 % for modelled medium, ±60 % for modelled low). Air-quality and cooling dollar values stay in the services dataset, labelled not release-eligible. Estimates are withheld where the crown height is not plausible. PM2.5 removal and the cooling index: Not release-eligible in v6.3: the method awaits confirmation of its sources. (release_eligible 0).", "multiple": false }, { "key": "size", "table": "tree_size_class_v63", "title": "Height class and crown replacement time", "evidence": "LiDAR crown measurements", "fields": [ "height_class", "height_share_pct", "reference_height_m", "class_used", "height_m", "crown_area_m2", "planning_rate_m2_y", "regrowth_years", "replacement_band", "crown_replacement", "not_classed_reason", "tall_tree", "withheld_reason", "in_comparisons", "comparisons_excluded_by" ], "note": "Height class: the crown's measured height (2024 LiDAR) as a share of the reference height for its growth form (evergreen broadleaf 22 m, deciduous broadleaf 25 m, conifer 35 m, palm or palm-like 14 m), rounded down to 0.1 %: very small under 18 %, small 18–35 %, medium 35–60 %, large 60–90 %, very large 90 % or more. Crown replacement time: the years a newly planted tree would take to grow a crown of this area at the planning rate for its growth form (2.2, 2.6, 2.0 and 0.6 m² a year), in bands: under 5, 5–15, 15–40, 40–80, 80 years or more; the band follows the years alone. Growth form: the class the published service estimates use. Not classed: crowns under 5 m tall, crowns whose height is not plausible (height check; values withheld) and markers with no crown estimate; they are left out of comparisons. Tall tree: 25 m or taller, a separate fact. Reference heights and planning rates are ALTO planning defaults for four growth forms. Plantation forest crowns are classed by regrowth time like every other crown (v6.3 does not overlay a land-cover map).", "multiple": false }, { "key": "height_check", "table": "tree_height_check_v63", "title": "Height check", "evidence": "LiDAR crown measurements", "fields": [ "level", "rules", "note", "height_m", "crown_area_m2", "mean_veg_height_m", "pointcloud_record", "n_veg_returns", "n_building_returns", "taxon", "taxon_ceiling_m", "taxon_ceiling_source", "excluded_from", "withheld_reason" ], "note": "Height checks on the crown's measured height (v6.3). Not plausible: 55 m or more; or 30 m or more with no vegetation returns, or more building than vegetation returns, in the crown's laser-return record. To check: over 30 m tall with a crown under 20 m²; highest point more than 3 times the mean vegetation height (20 m or more); more than 10 % taller than the credible maximum height published for the recorded species or genus. A crown whose height is not plausible keeps its values here and is left out of comparisons, maxima, property tallest tree, estimates and totals. A crown whose height is to check is counted in totals and left out of comparisons, maxima and property tallest tree.", "multiple": false }, { "key": "link_check", "table": "tree_link_check_v63", "title": "Record and crown check", "evidence": "LiDAR and the growth-form model", "fields": [ "level", "rules", "note", "crown_height_m", "point_height_m", "ceiling_taxon", "ceiling_m", "ceiling_source", "record_class", "model_class", "model_probability", "reviewer_confirmed", "marker_tree_id", "excluded_from" ], "note": "Checks that this record and the crown it is linked to describe the same tree (v6.3): r1 the LiDAR height at the recorded point is under a quarter of the crown height (crown 8 m or more); r2 the crown is more than 10 % taller than the credible maximum height published for the recorded species or genus (crown 8 m or more); r3 the growth-form model reads the crown as another growth form than the recorded species' class (the i-Tree species database; ALTO's class for pūriri and cabbage tree), at 0.8 or more. Two or more: record and crown may be different trees; one: to check. A link a reviewer confirmed stays as confirmed. The crown of a record to check, or one that may be a different tree, is counted in totals and left out of comparisons, maxima and property tallest tree.", "multiple": false }, { "key": "trajectory_label", "table": "tree_trajectory_label_v63", "title": "Canopy history label", "evidence": "LiDAR 2013–2024", "fields": [ "label", "display", "reason", "fate_v62" ], "note": "An \"established since\" fate needs a current crown with vegetation returns; where there is none, the history reads not assessed. fate_v62 keeps the earlier value.", "multiple": false }, { "key": "services_drawn", "table": "tree_services_drawn_v63", "title": "Estimates on the drawn crown", "evidence": "v6 service functions", "fields": [ "crown_area_m2", "crown_max_chm_m", "services_area_m2_v62", "avoided_runoff_m3_y", "stormwater_value_nzd_y", "stored_co2e_tonnes_est", "carbon_value_nzd_y", "dbh_cm_crown_est", "replacement_years_canopy", "crown_radius_m", "rpa_radius_m", "basis" ], "note": "Estimates for this crown recomputed on the crown outline the map draws (area and height), with the same functions as every other crown; up to v6.2 they used an earlier crown outline (services_area_m2_v62).", "multiple": false }, { "key": "schedule_entry", "table": "tree_schedule_entry_v63", "title": "Schedule 10 entry", "evidence": "Auckland Unitary Plan Schedule 10 (July 2026); Council's Notable Trees Overlay (retrieved 4 Jun 2026)", "fields": [ "item", "line", "trees_listed", "trees_text", "common_names", "botanical_names", "address", "locality", "legal_description", "points_total", "points_here", "alto_trees", "collapsed", "fewer_points_than_trees", "schedule_version" ], "note": "The Schedule 10 entry whose Council point (Notable Trees Overlay) this tree holds: trees listed, names and address as the July 2026 schedule gives them. Collapsed: the entry lists 2 or more trees, Council has 2 or more points for it, and ALTO maps those points on fewer crowns. Schedule 10 is the legal record; the overlay is indicative.", "multiple": true }, { "key": "group_area", "table": "tree_group_area_v63", "title": "Notable Group of Trees area", "evidence": "Council's Notable Group of Trees Overlay (retrieved 4 Jun 2026)", "fields": [ "schedule_item", "group_name", "objectid", "line", "layer_retrieved" ], "note": "The map marker lies inside a polygon of Council's Notable Group of Trees Overlay (Auckland Unitary Plan). Whether this tree is one of the scheduled trees has not been established; the flag does not change the tree's protected status.", "multiple": false }, { "key": "notes", "table": "tree_note_v63", "title": "Reviewer note", "evidence": "ALTO corrections ledger", "fields": [ "text", "history_line", "decided_on", "reviewer", "correction_id" ], "note": "A reviewer's note on this tree, carried by the corrections ledger (type tree_note). It changes wording only: protection and every measured value stay as they are. Where a field visit shown on the tree carried the wording the note replaces, the visit shows the history line.", "multiple": true }, { "key": "survey", "table": "tree_name_fix_v63", "title": "Kauri survey result", "evidence": "Auckland Council kauri survey", "fields": [ "survey", "p_agathidicida", "p_cinnamomi", "soil_sample_result", "species_name_v62", "credit", "caveat" ], "note": "Result codes of this kauri survey record. p_agathidicida and p_cinnamomi read \"recorded\" where the survey record has a value in its Phytophthora agathidicida or Phytophthora cinnamomi field. soil_sample_result is the survey's soil sample result as supplied. species_name_v62 is the species name ALTO showed up to v6.2, with the codes appended.", "multiple": false }, { "key": "licence", "table": "tree_licence_v63", "title": "Licence", "evidence": "OpenStreetMap", "fields": [ "licence", "licence_name", "licence_url", "attribution", "attribution_url", "noncommercial_terms", "method", "method_url", "note" ], "note": "Licence of a record derived from OpenStreetMap (v6.3). © OpenStreetMap contributors; the record is available under the Open Database Licence 1.0 and stays under it; ALTO's noncommercial terms do not apply to it; exports that contain it carry the ODbL's share-alike condition. method_url is the script that derives these records.", "multiple": false } ], "coverage": { "record": 6238420, "identity": 6238420, "tree_number": 6238420, "crown": 5578675, "outline": 5390357, "pointcloud": 5391480, "assets": 3512410, "roots": 3512410, "services": 3540500, "ground": 6, "field": 6, "location_review": 647, "notable_link_review": 22, "source_crosswalk": 3188, "trajectory": 1351818, "species": 1588678, "growth_form": 5389771, "predictions": 1511866, "context": 1561369, "impervious": 1574748, "previous_crown_v4": 5576618, "previous_assets": 1561369, "previous_roots": 1561369, "previous_services": 1794514, "scenarios": 27309, "previous_pointcloud": 1444293, "previous_crown": 5811821, "lidar": 5825200, "previous_evidence": 5839130, "restoration": 144385, "review": 0, "crown_link_review": 33396, "record_link": 3088, "record_link_status": 13613, "corrections": 356, "benefits": 3540500, "size": 3574821, "height_check": 2772, "link_check": 42491, "trajectory_label": 1646, "services_drawn": 103, "schedule_entry": 6294, "group_area": 8265, "notes": 1, "survey": 1205, "licence": 4800 }, "resharded_utc": "2026-09-27T20:47:31+00:00", "reshard_note": "Same release records re-divided into 65,536 buckets so a profile fetches about 60 KB instead of 1 MB. Ground rows added for KYTE visits accepted after the release: akl_tree_lcp_0159718, akl_tree_lid_1097574.", "release": "20261017-v6.3", "rebuild": { "strategy": "v6.2's 65,536 buckets; every record v6.2's with the v6.3 datasets added (DETAILS_ORDER), species read from tree_species_attributes_v63, the DB-06 kauri names, the T162DYHP ground note (SKP-10 A) and the corrections rows of the v6.3 receipt (public_summary, C00002 version 2, C00355)", "records": 6238420, "buckets": 65536, "datasets_added": [ "benefits", "size", "height_check", "link_check", "trajectory_label", "services_drawn", "schedule_entry", "group_area", "notes", "survey", "licence" ], "base_release": "20261013-v6.2", "base_manifest_sha256": "9c78ecbc9d1db1950187ce51d469d518bdad7bb89dd2d14a311ea76380ee04c3" }, "corrections": { "ledger_sha256": "4fdf11665193fe1ffaeb2d3b6f57821a633e293ccddc84ff857b8fd9ff33497f", "records_with_corrections": 356, "receipt": "data/corrections-applied.json" }, "tree_numbers": { "alias_table": "data/tree_ids/schema.json", "url": "https://alto.tfwelch.com/tree/" }, "licence_notice": { "text": "Each record keeps its source's licence (source_licences, by source_primary; every source on credits.html). ALTO's own detections, measurements and estimates: CC BY-NC 4.0 (ALTO data). Records derived from OpenStreetMap: © OpenStreetMap contributors, available under the Open Database Licence 1.0 (https://opendatacommons.org/licenses/odbl/1-0/); see https://www.openstreetmap.org/copyright. They stay under the ODbL, ALTO's noncommercial terms do not apply to them, and exports that contain them carry its share-alike condition. Method: pipeline/base/scripts/fetch_osm_natural_trees.py (https://github.com/squirmen/alto). Data under CC BY 4.0: LiDAR from the LINZ Data Service (licensed by Regional Software Holdings Limited and Auckland Council) and aerial photographs from New Zealand Imagery (each survey's licensor on credits.html); NZ Primary Land Parcels and NZ Building Outlines (LINZ Data Service); the Auckland Unitary Plan Notable Trees and Notable Group of Trees overlays (Plans and Places, Auckland Council); Auckland Council context layers; Public Conservation Land (Crown Copyright: Department of Conservation Te Papa Atawhai 2026); local boards (Stats NZ – Tatauranga Aotearoa). Auckland Council tree register (incl. Auckland Transport): © Auckland Council, retrieved June 2026. Kauri survey records (Ruru ObsKauri Tiaki): Auckland Council terms of use; Bio Info Team, Environmental Services, Auckland Council; not a complete record of kauri or kauri dieback. i-Tree Database values: i-Tree Cooperative (USDA Forest Service and cooperators), used with credit.", "odbl": { "source_primary": "osm_natural_tree", "records": 4800, "licence": "Open Database Licence (ODbL) 1.0", "licence_url": "https://opendatacommons.org/licenses/odbl/1-0/", "attribution": "© OpenStreetMap contributors", "attribution_url": "https://www.openstreetmap.org/copyright", "noncommercial_terms": "do not apply (ODbL 4.7)", "method": "pipeline/base/scripts/fetch_osm_natural_trees.py", "method_url": "https://github.com/squirmen/alto/blob/main/pipeline/base/scripts/fetch_osm_natural_trees.py", "dataset": "licence" }, "credits": "credits.html" }, "source_licences": { "tree_register_points": { "licence": "© Auckland Council", "provider": "Auckland Council", "attribution": "© Auckland Council.", "retrieved": "June 2026", "note": "The Council's public service for the register now requires a token.", "credits": [ "Auckland Council tree register (incl. Auckland Transport)" ] }, "notable_trees_overlay": { "licence": "CC BY 4.0", "licence_url": "https://creativecommons.org/licenses/by/4.0/", "provider": "Plans and Places, Auckland Council", "attribution": "Auckland Unitary Plan Notable Trees Overlay. Plans and Places, Auckland Council. Licensed under CC BY 4.0.", "retrieved": "2026-06-04", "credits": [ "Notable trees" ] }, "ruru_obskauri_tiaki_public": { "licence": "Auckland Council terms of use", "licence_url": "https://www.arcgis.com/home/item.html?id=98eb8eb841ed4205a5e97f7bd0dbdf86", "provider": "Bio Info Team, Environmental Services, Auckland Council", "attribution": "Bio Info Team, Environmental Services, Auckland Council.", "caveat": "Not a complete record of kauri or kauri dieback; verify before relying on it.", "credits": [ "Kauri survey records" ] }, "osm_natural_tree": { "licence": "Open Database Licence (ODbL) 1.0", "licence_url": "https://opendatacommons.org/licenses/odbl/1-0/", "provider": "OpenStreetMap contributors", "attribution": "© OpenStreetMap contributors", "attribution_url": "https://www.openstreetmap.org/copyright", "noncommercial_terms": "do not apply (ODbL 4.7)", "method_url": "https://github.com/squirmen/alto/blob/main/pipeline/base/scripts/fetch_osm_natural_trees.py", "dataset": "licence", "credits": [ "OpenStreetMap" ] }, "lidar_pointcloud_v4": { "licence": "CC BY-NC 4.0 (ALTO data)", "provider": "ALTO (Better Places Lab, Waipapa Taumata Rau | University of Auckland)", "derived_from": "Auckland 2024 LiDAR (sourced from the LINZ Data Service and licensed by Regional Software Holdings Limited and Auckland Council for re-use under CC BY 4.0) and Auckland 0.075m Urban Aerial Photos (2024–2025) (licensed by Auckland Council for re-use under CC BY 4.0)", "credits": [ "Auckland 2024 LiDAR, Parts 1 and 2", "Auckland 0.075m Urban Aerial Photos (2024–2025), RGB and near-infrared" ] }, "lidar_pointcloud_v5": { "licence": "CC BY-NC 4.0 (ALTO data)", "provider": "ALTO (Better Places Lab, Waipapa Taumata Rau | University of Auckland)", "derived_from": "Auckland 2024 LiDAR (sourced from the LINZ Data Service and licensed by Regional Software Holdings Limited and Auckland Council for re-use under CC BY 4.0) and Auckland 0.075m Urban Aerial Photos (2024–2025) (licensed by Auckland Council for re-use under CC BY 4.0)", "credits": [ "Auckland 2024 LiDAR, Parts 1 and 2", "Auckland 0.075m Urban Aerial Photos (2024–2025), RGB and near-infrared" ] }, "lidar_inferred_canopy": { "licence": "CC BY-NC 4.0 (ALTO data)", "provider": "ALTO (Better Places Lab, Waipapa Taumata Rau | University of Auckland)", "derived_from": "Auckland 2024 LiDAR (sourced from the LINZ Data Service and licensed by Regional Software Holdings Limited and Auckland Council for re-use under CC BY 4.0) and Auckland 0.075m Urban Aerial Photos (2024–2025) (licensed by Auckland Council for re-use under CC BY 4.0)", "credits": [ "Auckland 2024 LiDAR, Parts 1 and 2", "Auckland 0.075m Urban Aerial Photos (2024–2025), RGB and near-infrared" ] }, "low_canopy_promoted": { "licence": "CC BY-NC 4.0 (ALTO data)", "provider": "ALTO (Better Places Lab, Waipapa Taumata Rau | University of Auckland)", "derived_from": "Auckland 2024 LiDAR (sourced from the LINZ Data Service and licensed by Regional Software Holdings Limited and Auckland Council for re-use under CC BY 4.0) and Auckland 0.075m Urban Aerial Photos (2024–2025) (licensed by Auckland Council for re-use under CC BY 4.0)", "credits": [ "Auckland 2024 LiDAR, Parts 1 and 2", "Auckland 0.075m Urban Aerial Photos (2024–2025), RGB and near-infrared" ] } }, "built_on": "metro-2026.10.17-pointcloud-v6.3" }