Exécuter le cas de validation de l'auteur de la rupture de barrage
Sur cette page
Cet exemple construit DualSPHysics 5.4 à partir de la source épinglée par les auteurs, fait passer leur entrée bidimensionnelle de rupture de barrage à 2 secondes et compare le front simulé aux coordonnées expérimentales groupées par les auteurs. La comparaison a révélé un écart: MAE 0.2473 m, RMSE 0.2637 m, différence absolue maximale 0.3347 m 14 coordonnées pré-impact. Aucun seuil de passage scientifique n'a été fourni, et l'échelle et la définition frontale de l'article original n'ont pas été vérifiées de façon indépendante. Il s'agit d'un cas de validation exécuté, avec un examen scientifique humain en attente.
La référence expérimentale est Koshizuka et Oka (1996), Méthode semi-implicite des particules mobiles pour la fragmentation des fluides incompressibles, Science et ingénierie nucléaires 123, 421-434. Le fonctionnaire DualSPHysics la documentation relative au dossier d'essai; décrit la comparaison de l'extrémité du barrage avant l'impact de la paroi. Le document historique utilise le MPS; cette mise en œuvre actuelle utilise SPH. Il ne reproduit pas l'algorithme historique ou les résultats de performance du 2015 DualSPHysics papier logiciel.
Récupérer, construire et exécuter#
Utilisez une machine Linux avec Git, Python 3, GNU Make, GCC et OpenMP. Le compilateur testé était GCC 13.3.0 sur x86-64 Linux. Exécutez ces commandes dans un répertoire avec espace pour les fichiers source, build et particule :
python3 bootstrap-dambreak.py --source DualSPHysics
python3 run-dambreak.py --source DualSPHysics --output dam-break-results --wall-seconds 300
python3 compare-dambreak.py \
--gauge dam-break-results/initial/GaugesSWL_Swl_z003.csv \
--experiment 'DualSPHysics/examples/main/01_DamBreak/EXP_X-DamTipPosition_Koshizula&Oka1996.txt' \
--output comparison
Le bootstrap récupère commit ef3721a861fda961f0e2f9ec4cd317b19de99086 de le dépôt des auteurs. Il construit le solveur CPU, fournit les éléments manquants de GCC cstdint inclure et désactiver les composants en option Chrono, générateur d'onde et MoorDyn inutilisés dans ce cas. Il préserve les réglages en amont de la math rapide. Les équations du modèle et le XML d'entrée sont inchangés.
Le coureur utilise deux fils CPU. Si sa première liaison de 300 secondes expire, elle conserve cette sortie et reprend une fois à partir du dernier fichier de particule natif. Sur cet hôte, la course initiale a atteint environ 1,44 secondes avant la liaison; le redémarrage a complété l'horizon de 2 secondes en 124,799 secondes. Le solveur avertit que le redémarrage à partir de positions de particules à une seule précision introduit de petites différences. Toutes les coordonnées de comparaison sont couvertes par l'exécution initiale, mouvementée, de sorte que le redémarrage n'affecte pas la comparaison signalée. Un hôte plus rapide peut se terminer sans redémarrer.
Les emballages expédiés expriment les mêmes commandes utilisées pour l'exécution enregistrée; un bootstrap complet propre n'a pas été rejoué séparément. Gardez leurs journaux de commandes et execution.json en répétant l'exemple.
Comparer l'observable#
La valeur inchangée CaseDambreakVal2D_Def.xml crée 21 001 particules avec un espacement de 0,01 m, une colonne d'eau de 1 m à 2 m et un réservoir de 4 m à 3 m. Il utilise la gravité 9,81 m/s2, la viscosité artificielle 0,02, la diffusion de densité de Fourtakas 0,1, un noyau Wendland et l'intégration Verlet. Sa jauge horizontale native SWL échantillonne l'avant à z=0.03 m.
Avant exécution, la comparaison a sélectionné des coordonnées expérimentales dont la position avant fournie était d'au plus 3,9, évitant ainsi le contact avec le mur de 4 m. Le harnais interpole linéairement la jauge native à ces 14 heures fournies et écrit chaque différence dans front-comparison.csv. Il signale les erreurs sans inventer de tolérance d'acceptation. Le luminaire est utilisé dans son échelle de coordonnées fournie ; la normalisation de l’article original et l’alignement avec cette jauge restent des exigences de révision. Le localisateur exact des figures sur papier original n’est pas résolu.
Les placettes optionnelles nécessitent les paquets dans plot-requirements.txt; installez-les dans un environnement isolé et ajoutez --plot à la commande de comparaison. La comparaison numérique elle-même n'utilise que la bibliothèque standard de Python. Les données archivées CSV, JSON et SVG montrent les écarts réels; ils ne sont pas la preuve d'un accord.
Termes d’attribution et de composants#
La source du solveur est LGPL-2.1-ou-later. En amont GenCase helper est un composant binaire séparé: sa notification d'exécution autorise la redistribution binaire non modifiée avec ses notifications, mais restreint la redistribution/modification des sources sans autorisation. Ce bundle ne distribue aucun exécutable d'assistance ; le bootstrap récupère la distribution amont, dont les notices de composants doivent être conservées. Le texte expérimental est attribué par ses auteurs à Koshizuka et Oka ; aucune licence de jeu de données distincte n'a été trouvée. Le guide y renvoie plutôt que de redistribuer ce fichier de référence. Les fichiers de jauge du solveur générés et la comparaison compacte sont inclus comme preuve d'exécution.
Les fichiers de particules autochtones, les fichiers de redémarrage, les journaux complets et les preuves d'échec de la source/construction demeurent dans la campagne de recherche. Un examen scientifique humain, des vérifications de la méthode des articles originaux et une évaluation de la convergence spatiale et temporelle sont toujours nécessaires avant d'interpréter ce cas comme une prédiction validée.
Télécharger les fichiers enregistrés#
- front-comparison.csv — les 14 différences ponctuelles par rapport au montage en amont associé au papier.
- comparison.json — Comparaison numérique littéraire et limitations scientifiques.
- dambreak-comparison.svg — Comparatif modifiable/intrigue d'erreur.
- dambreak-comparison.png — Aperçu des comparaisons.
- GaugesSWL_Swl_z003.csv — Production simulée de jauges frontales simulées.
- run-record.json — Réalisation compacte, attribution et enregistrement de provenance.
- bootstrap-dambreak.py — le conducteur ou l'enregistrement d'environnement ou de source portable.
- run-dambreak.py — le conducteur ou l'enregistrement d'environnement ou de source portable.
- compare-dambreak.py — le conducteur ou l'enregistrement d'environnement ou de source portable.
- plot-requirements.txt — le conducteur ou l'enregistrement d'environnement ou de source portable.
- GUIDE.md — le conducteur ou l'enregistrement d'environnement ou de source portable.
Enregistrement complet · Toutes les tentatives des candidats. Un examen scientifique humain est en cours.