echo6-autocommit ef8b1e0bd9 auto: docs sync 2026-07-13T12:00:23+00:00

Files changed: engine/.embcache.json engine/changelog.md engine/lint-report.md vault/.trash/2026-06-19.md vault/docs/hardware/environment.md vault/docs/hardware/ip-allocation.md vault/docs/matrix/archivist.md vault/docs/matrix/matrix_host.md vault/docs/matrix/mautrix_signal.md vault/docs/matrix/synapse.md vault/docs/matrix/synapse_retention_discovery.md vault/docs/navi/cc-rules.md vault/docs/navi/deployment.md vault/docs/navi/themes.md vault/docs/services/ots-setup.md vault/docs/services/services.md vault/docs/services/usenet.md vault/docs/software/authentik.md vault/docs/software/caddy.md vault/docs/software/central.md vault/docs/software/dns.md vault/docs/software/geo-tools.md vault/docs/software/navi.md vault/docs/software/recon.md vault/docs/software/searxng.md vault/glossary.md vault/notes/echo6-landing-page-data-export.md vault/notes/ia-download-queue.md vault/projects/advbbs-project.md vault/projects/argus.md vault/projects/deploy-livesync.md vault/projects/fleet-patch-audit.md vault/projects/fleet-platform-baseline.md vault/projects/matrix-synapse-deployment.md vault/projects/meshai-config-hot-apply.md vault/projects/meshai-region-routing-plan.md vault/projects/meshai.md vault/projects/meshcore-transport.md vault/projects/meshtastic-headscale-runbook.md vault/projects/mmud-project.md vault/projects/nominatim-v5-reimport.md vault/runbooks/add-peertube-channel.md vault/runbooks/authentik-access-groups.md vault/runbooks/authentik-create-invitation.md vault/runbooks/authentik-oidc-application.md vault/runbooks/authentik-upgrade.md vault/runbooks/central-deploy-cutover.md vault/runbooks/ct-runbook.md vault/runbooks/edge2-access-reference.md vault/runbooks/expose-service-contabo.md vault/runbooks/expose-service-edge2.md vault/runbooks/expose-service-home.md vault/runbooks/fleet-magicdns-resolved-migration.md vault/runbooks/headless-browser-page-verification.md vault/runbooks/headscale-oidc-boot-order.md vault/runbooks/headscale-onboard-node.md vault/runbooks/ia-cli-reference.md vault/runbooks/ia-download-mirror.md vault/runbooks/idahomesh-bridge-setup.md vault/runbooks/idahomesh-vpn-device-setup.md vault/runbooks/lxc-service-migration.md vault/runbooks/mailcow-create-mailbox.md vault/runbooks/meshai-prod-compose-override.md vault/runbooks/meshmonitor-password-reset.md vault/runbooks/meshtastic-sidecar-node.md vault/runbooks/meshtasticd-sim-nodes-runbook.md vault/runbooks/nordvpn-lxc.md vault/runbooks/peertube-remote-runner.md vault/runbooks/pg-backup.md vault/runbooks/pi-nas-omv-runbook.md vault/runbooks/pipeline-patterns.md vault/runbooks/proxmox-create-ubuntu-vm.md vault/runbooks/proxmox-onboard-node.md vault/runbooks/pymc-repeater-kiss-tnc-reenumeration.md vault/runbooks/recon-operations.md vault/runbooks/recon-service-integration.md vault/runbooks/syncthing-add-node.md vault/runbooks/toc-cortex-pve9.2-update.md vault/session-resume/SESSION-HANDOFF-meshai-test.md

2026-07-13 12:00:23 +00:00

2.2 KiB

Raw Blame History

title

type

Geo Processing Tools — Cortex

Overview

DEM processing, vector tile generation, and PMTiles manipulation tools installed on cortex for compute-tier geospatial batch jobs. Cortex is compute-only — no persistent operational data lives here. Data flows: pi-nas (archive) → cortex (compute) → pi-nas + VM 1130 (outputs).

Installed Tools

Tool	Version	Package	Purpose
gdal_contour	GDAL 3.8.4	gdal-bin (apt)	Generate contour lines from DEM rasters
gdalinfo	GDAL 3.8.4	gdal-bin (apt)	Raster metadata inspection
gdal_translate	GDAL 3.8.4	gdal-bin (apt)	Raster format conversion
gdalbuildvrt	GDAL 3.8.4	gdal-bin (apt)	Virtual raster mosaics
ogr2ogr	GDAL 3.8.4	gdal-bin (apt)	Vector format conversion
tippecanoe	v2.49.0	tippecanoe (apt)	GeoJSON → vector tiles (MBTiles/PMTiles)
pmtiles	v1.30.2	go-pmtiles (binary)	PMTiles inspection, conversion, tile extraction

Installed: 2026-04-22

Ephemeral Scratch Convention

All temporary/staging data goes in /home/zvx/scratch/. This directory is cleaned after batch jobs complete. Never treat scratch as persistent storage.

Typical layout:

/home/zvx/scratch/
└── nav-processing/          # Current: staged DEM for contour generation
    └── hillshade-na.pmtiles # 93 GB terrarium DEM (from pi-nas archive)

Terrarium DEM Decode

The Mapzen Terrarium format encodes elevation in RGB PNG tiles:

elevation_meters = (R * 256 + G + B/256) - 32768

To use with GDAL: decode RGB → Float32 elevation array → write as GeoTIFF via VRT with subClass="VRTRawRasterBand".

Data Tier Architecture

Tier	Host	Role	Example
Archive	pi-nas (192.168.1.245)	Source of truth, recovery	`/export/data/nav/hillshade-na.pmtiles`
Compute	cortex (192.168.1.150)	Batch processing, scratch	`/home/zvx/scratch/nav-processing/`
Operational	VM 1130 (192.168.1.130)	Serving tiles via nginx	`/mnt/nav/tiles/`

2.2 KiB Raw Blame History