Allgemeine Tipps & Logfiles
Tipps
Beginnen Sie mit einem groben Rechennetz. Die voreingestellten Kantenlängen ergeben ein feines Rechennetz mit langen Rechenzeiten. Verwenden Sie größere Kantenlängen, während der Ränder, der Rauheit und der Ausgangszustand noch verifiziert werden, und verfeinern Sie danach (Rechennetzkonfiguration).
Überprüfen Sie vor dem Bau.
axqua <case-file> --checküberprüft die Fall-Datei, die Eingabedateien und die Simulationssoftware innerhalb einer Sekunde und erkennt die meisten Probleme, die das Preprocessing sonst nach einigen Minuten stoppen würden.Lesen Sie das Protokoll des Preprocessing vor dem Start einer Simulation. Die Rechennetz-Qualität, die Zuordnung des Ränders und der Anfangszustand werden unter Preprocessing entschieden und in dessen Log-Datei gemeldet.
Testen Sie zuerst ein OpenFOAM-Modell mit dem starren Deckel. Ein grober Lauf im Modus
rigid-liddauert Minuten und zeigt Fehler im Rechennetz und im Ränder auf, bevor ein langer Lauf gestartet wird (OpenFOAM-Auswahl).Wiederholen Sie einen fehlgeschlagenen Job im Vordergrund.
axqua execute <job-id>führt den Job im Terminal aus, so dass alle Nachrichten sichtbar sind.Verwenden Sie das gleiche Minimum Wassertiefe in allen Auswertungen. Die Auswertungen von aXqua betrachten Wasser flacher als
hydrodynamics.wet_depth(0,01 m) als trocken. Wenden Sie den gleichen Grenzwert in QGIS, ParaView und VisIt an, damit Karten und gemeldete Zahlen übereinstimmen.
Logfiles
aXqua zeichnet jeden Schritt in Logfiles auf. Welche Datei gelesen werden soll, hängt davon ab, wie der Schritt gestartet wurde.
Datei |
Inhalt |
|---|---|
|
Das Protokoll eines Workflowschritts. Jeder Schritt schreibt seine eigene Datei in seinen Ausgabeordner, zum Beispiel |
|
Das Protokoll eines Jobs: seine Zustände, die Befehle, die ausgegeben wurden und, wenn der Job fehlschlug, der Fehler mit seiner Abhilfe. |
|
Die Ausgabe des Simulationscodes für einen Auftrag. |
|
Die Auflistung von TELEMAC im Modellordner. Es enthält die Nachrichten von TELEMAC selbst und den Abflüssen am Ränder. |
|
Der Rechennetz-Check von OpenFOAM, im OpenFOAM Fall-Ordner. |
Im Plugin öffnet View logs unterhalb der Jobliste das Protokoll des ausgewählten Jobs. Die Nachrichten des Plugins selbst sind im QGIS-Panel Log Messages auf der Registerkarte aXqua aufgeführt.
Eine Zeile von axqua.log besteht aus der Zeit, der Ebene der Nachricht und dem Text. Durchsuchen Sie die Datei nach den beiden Ebenen, die Aufmerksamkeit erfordern:
WARNINGDer Schritt ging weiter, aber das Ergebnis kann beeinflusst werden. Jede Warnung sollte verstanden werden, bevor das Ergebnis verwendet wird (Warnmeldungen).
ERRORDer Schritt konnte nicht abgeschlossen werden (Fehlermeldungen).
Die Zeilen START und DONE ... in N s markieren den Anfang und das Ende jedes Teils eines Schrittes. Sie zeigen, wo ein Schritt fehlschlug und wie lange jeder Teil dauerte.
Wenn eine Simulation ohne eine Fehlermeldung von aXqua stoppt, wird die Ursache in der Regel durch den Simulationscode gemeldet. Lesen Sie das Ende des .sortie Listing (TELEMAC) oder das Ende der Ausgabe des Simulationscodes im Ordner solver/ des Jobs (OpenFOAM).
Freigeben des Scheibenraums
Ein Fall sammelt Dateien, die nichts mehr braucht, und Ergebnisse, die größer sind, als sie sein müssen. Ein stetiger TELEMAC-Lauf schreibt jeden Zeitschritt in sein Ergebnis, von dem aXqua nur den letzten liest; auf einem Flussabschnitt mit einigen hunderttausend Knoten dauert ein solches Ergebnis etwa 1 GB, und jeder Lauf einer Kalibrierung oder einer Netzkonvergenzstudie schreibt einen. Clean Up, links von Help über den Registerkarten des Plugins, listet für einen Fall auf, was gehen kann, nach Kategorie und mit dem Speicherplatz, den es freigibt:
Arbeitsordner, die TELEMAC hinterlässt, wenn ein Lauf gestoppt wurde oder fehlgeschlagen ist;
Listen der einzelnen Prozessoren eines Parallellaufs und Listen früherer Läufe (die neueste Liste jeder Steuerdatei wird beibehalten);
Zeitschritte von TELEMAC-Ergebnissen: das Ergebnis wird nur mit dem letzten Zeitschritt oder mit jedem 5. oder 10. Zeitschritt und dem letzten umgeschrieben. Die gespeicherten Zeitschritte werden unverändert kopiert. Der letzte Zeitschritt ist derjenige, den aXqua liest, von dem ein Hotstart weitergeht und den QGIS zeigt, also funktionieren diese weiter; eine Animation des Laufs verliert die entfernten Zeitschritte;
Prozessorordner von OpenFOAM-Läufen, die rekonstruiert wurden, die Zeitordner zwischen dem Start und der letzten Zeit und die Ergebnisse eines früheren Laufs, den OpenFOAM in
previous-run;Exporte für ParaView und VisIt, die Export wieder macht.
Die Kategorien, die keinen zweiten Gedanken brauchen, werden angekreuzt; die Zeitschritte sind es nicht. Remove selected fragt, bevor etwas entfernt wird, und entfernte Dateien können nicht wiederhergestellt werden. Die Eingabedateien, die Falldatei, das erstellte Modell (Geometrie, Randbedingungen, Lenk- und Reibungsdateien, Anfangsbedingungen) und der letzte Zeitschritt eines Ergebnisses werden nie aufgeführt, ebenso wenig wie die Prozessorordner eines nicht rekonstruierten OpenFOAM-Laufs, die die einzige Kopie seiner Ergebnisse enthalten. Nichts wird entfernt, während ein Job des Falls wartet oder läuft oder während die Liste der Jobs nicht gelesen werden kann. Ein Lauf, der von einem Terminal gestartet wird, ist kein Job, daher wird ein Arbeitsordner oder ein Ergebnis auch nicht aufgeführt, während ein Programm auf diesem Computer darin arbeitet, oder für 15 Minuten, nachdem es zuletzt geschrieben wurde; Das Fenster benennt, was es aus diesem Grund zurückhält. In einem Terminal listet axqua cleanup <case-file> die gleichen Elemente auf und --remove entfernt sie (Terminalsyntax).
Melden eines Problems
Melden Sie Probleme unter https://github.com/sschwindt/aXqua/issues. Fügen Sie die Version von aXqua (axqua --version), die Version von QGIS, das Betriebssystem und die entsprechende Protokolldatei hinzu.