Ejecute el caso de validación de rotura de presa del autor
En esta página
Este ejemplo construye DualSPHysics 5.4 a partir del código fuente fijado por los autores, ejecuta su entrada de rotura de presa bidimensional sin cambios en 2 segundos y compara el frente simulado con las coordenadas experimentales agrupadas por los autores. La comparación encontró una discrepancia: MAE 0.2473 m, RMSE 0.2637 m, diferencia absoluta máxima 0.3347 m en 14 coordenadas previas al impacto. No se proporcionó ningún umbral de aprobación científica y la escala y la definición frontal del artículo original no se han verificado de forma independiente. Este es un caso de validación ejecutado, con revisión científica humana pendiente.
La referencia experimental es Koshizuka y Oka (1996), Método semiimplícito de partículas en movimiento para la fragmentación de fluidos incompresibles, Ciencia e ingeniería nucleares 123, 421–434. el documentación oficial del caso de prueba DualSPHysics describe la comparación de la punta de la presa antes del impacto contra la pared. El artículo histórico utiliza MPS; esta implementación actual utiliza SPH. No reproduce el algoritmo histórico ni los resultados de rendimiento del documento de software DualSPHysics de 2015.
Recuperar, construir y ejecutar#
Utilice una máquina Linux con soporte para Git, Python 3, GNU Make, GCC y OpenMP. El compilador probado fue GCC 13.3.0 en Linux x86-64. Ejecute estos comandos en un directorio con espacio para los archivos fuente, de compilación y de partículas:
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
El bootstrap recupera el compromiso ef3721a861fda961f0e2f9ec4cd317b19de99086 de el repositorio de autores. Construye el solucionador de CPU y suministra los datos faltantes de GCC. cstdint incluye y desactiva los componentes opcionales de Chrono, generador de ondas y MoorDyn que no se utilizan en este caso. Conserva la configuración de matemáticas rápidas ascendentes. Las ecuaciones del modelo y el XML de entrada no cambian.
El corredor utiliza dos subprocesos de CPU. Si su primer límite de 300 segundos expira, conserva esa salida y la reanuda una vez desde el último archivo de partículas nativas. En este anfitrión, la carrera inicial alcanzó aproximadamente 1,44 segundos antes del salto; la reanudación completó el horizonte de 2 segundos en otros 124,799 segundos. El solucionador advierte que reiniciar desde posiciones de partículas de precisión simple introduce pequeñas diferencias. Todas las coordenadas de comparación están cubiertas por la ejecución inicial no reiniciada, por lo que el reinicio no afecta la comparación informada. Un host más rápido puede finalizar sin reiniciar.
Los envoltorios enviados expresan los mismos comandos utilizados para la ejecución grabada; un arranque limpio completo no se ha reproducido por separado. Mantenga sus registros de comando y execution.json al repetir el ejemplo.
Compara lo observable#
el sin cambios CaseDambreakVal2D_Def.xml crea 21.001 partículas con un espaciamiento de 0,01 m, una columna de agua de 1 m por 2 m y un tanque de 4 m por 3 m. Utiliza gravedad de 9,81 m/s², viscosidad artificial de 0,02, difusión de densidad Fourtakas de 0,1, núcleo de Wendland e integración de Verlet. Su indicador SWL horizontal nativo muestra el frente en z=0.03 m.
Antes de la ejecución, la comparación seleccionó coordenadas experimentales cuya posición frontal suministrada fue como máximo 3,9, evitando el contacto con la pared de 4 m. El arnés interpola linealmente el calibre nativo en esos 14 momentos suministrados y escribe cada diferencia en front-comparison.csv. Informa errores sin inventar una tolerancia de aceptación. El dispositivo se utiliza en la escala de coordenadas suministrada; La normalización del artículo original y la alineación con este calibre siguen siendo requisitos de revisión. El localizador exacto de figuras en papel original no está resuelto.
Las parcelas opcionales requieren los paquetes en plot-requirements.txt; instálelos en un entorno aislado y agréguelos --plot al comando de comparación. La comparación numérica en sí utiliza sólo la biblioteca estándar de Python. Los archivos CSV, JSON y SVG archivados muestran las discrepancias reales; no son prueba de acuerdo.
Términos de atribución y componentes#
La fuente del solucionador es LGPL-2.1 o posterior. el río arriba El asistente GenCase es un componente binario separado: su aviso de tiempo de ejecución permite la redistribución binaria sin modificaciones con sus avisos, pero restringe la redistribución/modificación del código fuente sin permiso. Este paquete no distribuye ningún ejecutable auxiliar; el bootstrap recupera la distribución ascendente, cuyos avisos de componentes deben conservarse. El texto experimental es atribuido por sus autores a Koshizuka y Oka; no se localizó ninguna licencia de conjunto de datos independiente. La guía enlaza con él en lugar de redistribuir ese archivo de referencia. Los archivos de calibre del solucionador generados y la comparación compacta se incluyen como evidencia de ejecución.
Los archivos de partículas nativas, los archivos de reinicio, los registros completos y la evidencia de fallas de origen/compilación permanecen en la campaña de investigación. Aún se requiere una revisión científica humana, verificaciones del método del artículo original y una evaluación de la convergencia espacial/temporal antes de interpretar este caso como una predicción validada.
Descargar los archivos grabados#
- front-comparison.csv — Las 14 diferencias puntuales con respecto al accesorio asociado al papel aguas arriba.
- comparison.json — Comparación numérica literal y limitaciones científicas.
- dambreak-comparison.svg — Gráfico de comparación/error editable.
- dambreak-comparison.png — Vista previa de comparación.
- GaugesSWL_Swl_z003.csv — Salida de indicador frontal simulada nativa no reiniciada.
- run-record.json — Registro de ejecución, atribución y procedencia del compacto.
- bootstrap-dambreak.py — controlador portátil o registro de entorno/fuente.
- run-dambreak.py — controlador portátil o registro de entorno/fuente.
- compare-dambreak.py — controlador portátil o registro de entorno/fuente.
- plot-requirements.txt — controlador portátil o registro de entorno/fuente.
- GUIDE.md — controlador portátil o registro de entorno/fuente.
Registro de ejecución completo · Todos los intentos de los candidatos. La revisión científica humana está pendiente.