AETHER Core · Kommandozeilen-Engine · Windows / Linux / macOS
AETHER Core herunterladen
Die eigenständige Kommandozeilen-Engine für die Modellierung der RF-Ausbreitung. Sie dient zugleich als Backend für das QGIS-Plugin.
Was die Aether-Engine leistet
Aether ist die native Engine für RF-Ausbreitung hinter Waveshed. Sie berechnet Sichtlinie und Funkabdeckung über realem Gelände direkt auf Ihrem Rechner. Dabei nutzt sie die GPU, sofern vorhanden, und sonst die CPU. Das QGIS-Plugin von Waveshed verwendet sie als Backend. Der Download enthält die Engine und drei Kommandozeilen-Werkzeuge.
Ausbreitungsmodelle
- LOS
- Sichtlinie. Eine Ja/Nein-Karte, die zeigt, von wo der Sender sichtbar ist.
- ITM
- Pfaddämpfung nach dem Longley-Rice-Modell (Irregular Terrain Model) für 20 MHz bis 20 GHz.
- MIN_ALT
- Die geringste Höhe über Grund, ab der ein Punkt Sichtverbindung zum Sender hat (nur bei Abdeckung).
Berechnungsarten
- Abdeckung
- Signal- oder Sichtbarkeitskarte rund um einen Sender, oder eine Karte je Wegpunkt entlang einer Route.
- Punkt-zu-Punkt
- Signalpegel und Pfaddämpfung für eine Verbindung, mit SPLAT-kompatiblen Gelände- und Pfadprofilen.
- Batch-P2P
- Viele Verbindungen aus einer CSV-Liste. Das Ergebnis ist eine CSV-Datei mit Signalpegel (dBm) und Pfaddämpfung (dB) je Verbindung.
Technische Details
- Berechnung
- GPU über Vulkan, DirectX 12 oder Metal. Automatischer Fallback auf die CPU, der deutlich langsamer ist.
- Auflösung
- Rasterweite in Metern, pro Berechnung festgelegt. Das Gelände wird üblicherweise mit 2, 5, 10 oder 30 m aufbereitet.
- Gelände
- .abt-Kacheln, die aether_converter aus GeoTIFF-Höhenmodellen in beliebigem Koordinatensystem oder aus XYZ-Höhenkacheln erzeugt, auf Wunsch mit Gebäudegrundrissen.
- Ausgabe
- aether_export schreibt Abdeckungsergebnisse als Cloud-Optimized GeoTIFF, ohne GDAL. aether_aggregate führt mehrere Ergebnisse zu Maximum- und Anzahl-Rastern zusammen.
- Bedienung
- Kommandozeile. Pro Lauf eine JSON-Auftragsdatei: aether_core --config job.json
- Im ZIP
- aether_core, aether_converter, aether_export, aether_aggregate. Unter Windows zusätzlich dxcompiler.dll und dxil.dll.
Systemanforderungen
- Windows
- 64 Bit (x64). dxcompiler.dll und dxil.dll liegen der ZIP-Datei bei und müssen neben aether_core.exe bleiben.
- Linux
- 64 Bit (x64), gebaut unter Ubuntu 22.04. Erfordert glibc 2.35 oder neuer.
- macOS
- Apple Silicon (arm64). Intel-Macs werden nicht unterstützt.
- GPU
- Eine GPU mit aktuellen Vulkan-, DirectX-12- oder Metal-Treibern. Ohne GPU rechnet die Engine auf der CPU.
Zugangsschlüssel
Die Engine läuft nur mit einem gültigen, zeitlich begrenzten Zugangsschlüssel. Im Download ist nie ein Schlüssel enthalten.
Hinterlegen Sie den Schlüssel in der Umgebungsvariable AETHER_LICENSE oder als Datei license.key im Arbeitsverzeichnis. Das QGIS-Plugin speichert den Schlüssel und übergibt ihn für Sie an die Engine.
Holen Sie sich einen kostenlosen Schlüssel für die nicht-kommerzielle Nutzung. Für kommerzielle Nutzung und für die Nutzung durch Behörden oder Organisationen brauchen Sie unsere vorherige schriftliche Erlaubnis. Schreiben Sie uns, wenn Sie sie beantragen möchten.
Binärdateien
Windows
x64Installationsanleitung
Installation unter Windows
- Laden Sie die ZIP-Datei herunter und entpacken Sie sie in einen Ordner (z. B. C:\Program Files\AETHER).
- Lassen Sie dxcompiler.dll und dxil.dll im selben Verzeichnis wie aether_core.exe. Beide sind in der ZIP-Datei enthalten.
- Öffnen Sie PowerShell oder CMD im entpackten Verzeichnis und führen Sie aus: .\aether_core.exe --version
- Nehmen Sie das Verzeichnis bei Bedarf in den System-PATH auf, um es global aufrufen zu können.
- Für die GPU-Beschleunigung brauchen Sie aktuelle NVIDIA- oder AMD-GPU-Treiber. Diese finden Sie auf der Website des jeweiligen Herstellers.
Linux
x64Installationsanleitung
Installation unter Linux
- Laden Sie die ZIP-Datei herunter und entpacken Sie sie: unzip aether-*-linux-x64.zip -d aether
- Machen Sie die Binärdateien ausführbar: chmod +x aether/aether_*
- Lassen Sie die vier Binärdateien zusammen in einem Verzeichnis, denn aether_core ruft aether_export aus dem eigenen Ordner auf. Nehmen Sie das Verzeichnis bei Bedarf in den PATH auf.
- Prüfen Sie das Ergebnis: ./aether/aether_core --version
- Für die GPU-Beschleunigung installieren Sie die Vulkan-Treiber: sudo apt install libvulkan1 mesa-vulkan-drivers
- Bei NVIDIA-GPUs installieren Sie für die beste Leistung zusätzlich das proprietäre Treiberpaket.
macOS
arm64Installationsanleitung
Installation unter macOS
- Laden Sie die ZIP-Datei herunter und entpacken Sie sie (per Doppelklick oder mit: unzip aether-*-macos-arm64.zip).
- Lassen Sie die vier Binärdateien zusammen in einem Verzeichnis (z. B. ~/aether), denn aether_core ruft aether_export aus dem eigenen Ordner auf.
- Beim ersten Start blockiert der Gatekeeper von macOS sie möglicherweise. Klicken Sie in diesem Fall mit der rechten Maustaste auf die Binärdatei und wählen Sie „Öffnen", um sie freizugeben.
- Alternativ entfernen Sie das Quarantäne-Flag für das ganze Verzeichnis: xattr -dr com.apple.quarantine ~/aether
- Die Metal-GPU-Beschleunigung ist in macOS bereits enthalten. Zusätzliche Treiber brauchen Sie nicht.
QGIS-Plugin einrichten
Das Waveshed-Plugin führt Aether-Analysen in QGIS 3.28 oder neuer aus und fügt die Ergebnisse Ihrem Projekt hinzu. Die Engine lädt und installiert es selbst. Einen Binärpfad müssen Sie also nicht von Hand setzen.
Frühe Phase. Das Waveshed-Plugin ist neu. Wir haben viel getestet, trotzdem können Sie noch auf Ecken und Kanten stoßen. Wir freuen uns über jede Rückmeldung: Schreiben Sie uns, was funktioniert und was nicht.
Plugin installieren
Das Waveshed-Plugin ist freie Software unter der GNU GPL. Sie können es auf zwei Wegen installieren. Nutzen Sie nach Möglichkeit das Plugin-Repository: Dann hält QGIS das Plugin aktuell.
Option 1 · Plugin-Repository
EmpfohlenQGIS installiert das Plugin und bietet jede neue Version als Aktualisierung an.
- 1
Öffnen Sie in QGIS Erweiterungen → Erweiterungen verwalten und installieren… und wechseln Sie zum Reiter Einstellungen. Klicken Sie unter Erweiterungsrepositorien auf Hinzufügen…, vergeben Sie einen Namen wie Waveshed und tragen Sie diese URL ein:
https://waveshed.io/qgis/plugins.xml - 2
Bestätigen Sie mit OK.
- 3
Suchen Sie im Reiter Alle nach Waveshed und klicken Sie auf Erweiterung installieren.
Option 2 · ZIP-Datei
Keine automatischen Aktualisierungen: Wiederholen Sie diese Schritte bei jeder neuen Version.
Öffnen Sie in QGIS Erweiterungen → Erweiterungen verwalten und installieren… und wechseln Sie zu Aus ZIP installieren. Wählen Sie die heruntergeladene Datei und klicken Sie auf Erweiterung installieren.
- 01 · Plugin installieren
Installieren Sie Waveshed wie oben beschrieben, am besten über Option 1 · Plugin-Repository.
- 02 · Einstellungen öffnen
Öffnen Sie Erweiterungen → Waveshed → Waveshed Analysis und wechseln Sie zum Reiter Settings.
- 03 · Engine laden
Klicken Sie in der Gruppe Binaries auf Download Binaries. Das Plugin ermittelt die aktuelle Aether-Engine für Ihr System und zeigt deren Lizenzvereinbarung an. Mit Accept & Download stimmen Sie ihr zu. Der Download wird anhand seiner SHA-256-Prüfsumme geprüft und nach ~/.aether/bin installiert, sofern Sie unter Binary directory: nicht vorher einen anderen Ordner eingetragen haben.
- 04 · Schlüssel holen
Für Analysen brauchen Sie einen Zugangsschlüssel. Holen Sie sich einen kostenlosen Schlüssel für die nicht-kommerzielle Nutzung. Die Schaltfläche Get API Key im Plugin öffnet dieselbe Seite. Für kommerzielle Nutzung und für die Nutzung durch Behörden oder Organisationen brauchen Sie unsere vorherige schriftliche Erlaubnis: Schreiben Sie uns.
- 05 · Schlüssel eintragen
Fügen Sie den Schlüssel in der Gruppe API Key in das Feld API key: ein und klicken Sie auf Save. Die Statuszeile zeigt dann ✓ Key saved.
- 06 · Analyse starten
Richten Sie im Reiter 360° eine Abdeckungsberechnung oder im Reiter P2P Link eine Verbindung ein und klicken Sie auf Run Analysis. Das Plugin fügt die Ergebnisse Ihrem Projekt hinzu.
Der Reiter „Help“ im Plugin beschreibt jede Einstellung ausführlich.