forefire 2.5.0__tar.gz → 2.6.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {forefire-2.5.0 → forefire-2.6.0}/.gitignore +1 -1
- forefire-2.6.0/CHANGELOG.md +285 -0
- {forefire-2.5.0 → forefire-2.6.0}/CMakeLists.txt +144 -7
- {forefire-2.5.0 → forefire-2.6.0}/CONTRIBUTING.md +12 -5
- {forefire-2.5.0 → forefire-2.6.0}/Dockerfile +4 -2
- {forefire-2.5.0 → forefire-2.6.0}/PKG-INFO +18 -1
- {forefire-2.5.0 → forefire-2.6.0}/README.md +21 -4
- forefire-2.6.0/TESTING.md +263 -0
- {forefire-2.5.0 → forefire-2.6.0}/app/forefire/ForeFire.cpp +10 -4
- {forefire-2.5.0 → forefire-2.6.0}/app/forefire/commands.md +39 -32
- {forefire-2.5.0 → forefire-2.6.0}/bindings/python/README.md +16 -0
- {forefire-2.5.0 → forefire-2.6.0}/bindings/python/src/pyforefire/__init__.py +1 -0
- {forefire-2.5.0 → forefire-2.6.0}/bindings/python/src/pyforefire/_pyforefire.cpp +18 -8
- forefire-2.6.0/bindings/python/src/pyforefire/_runner.py +110 -0
- forefire-2.6.0/bindings/python/src/pyforefire/_validate.py +246 -0
- forefire-2.6.0/bindings/python/src/pyforefire/_worker.py +34 -0
- {forefire-2.5.0 → forefire-2.6.0}/bindings/python/src/pyforefire/helpers.py +5 -5
- forefire-2.6.0/bindings/wasm/README.md +257 -0
- forefire-2.6.0/bindings/wasm/forefire_wasm.cpp +226 -0
- forefire-2.6.0/bindings/wasm/index.html +1231 -0
- forefire-2.6.0/bindings/wasm/landscape.mjs +284 -0
- forefire-2.6.0/bindings/wasm/smoke.mjs +123 -0
- forefire-2.6.0/bindings/wasm/terrain3d.mjs +465 -0
- forefire-2.6.0/bindings/wasm/worker.mjs +249 -0
- {forefire-2.5.0 → forefire-2.6.0}/pyproject.toml +12 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/Command.cpp +99 -24
- {forefire-2.5.0 → forefire-2.6.0}/src/Command.h +29 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/DataBroker.cpp +64 -9
- {forefire-2.5.0 → forefire-2.6.0}/src/DataBroker.h +10 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/EventCommand.cpp +2 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/EventCommand.h +2 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/FFEvent.cpp +0 -12
- {forefire-2.5.0 → forefire-2.6.0}/src/FFEvent.h +3 -3
- {forefire-2.5.0 → forefire-2.6.0}/src/FFPoint.cpp +0 -37
- {forefire-2.5.0 → forefire-2.6.0}/src/FFPoint.h +8 -13
- {forefire-2.5.0 → forefire-2.6.0}/src/FFVector.cpp +0 -6
- {forefire-2.5.0 → forefire-2.6.0}/src/FFVector.h +0 -4
- {forefire-2.5.0 → forefire-2.6.0}/src/FireDomain.cpp +81 -36
- {forefire-2.5.0 → forefire-2.6.0}/src/FireDomain.h +18 -8
- {forefire-2.5.0 → forefire-2.6.0}/src/FireFront.cpp +8 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FireNode.cpp +0 -19
- {forefire-2.5.0 → forefire-2.6.0}/src/FireNode.h +6 -6
- {forefire-2.5.0 → forefire-2.6.0}/src/ForeFireAtom.h +13 -2
- {forefire-2.5.0 → forefire-2.6.0}/src/ForeFireModel.cpp +7 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/HttpCommandServer.hpp +97 -9
- {forefire-2.5.0 → forefire-2.6.0}/src/SimulationParameters.cpp +7 -3
- {forefire-2.5.0 → forefire-2.6.0}/src/SimulationParameters.h +0 -2
- {forefire-2.5.0 → forefire-2.6.0}/src/StringRepresentation.cpp +14 -12
- {forefire-2.5.0 → forefire-2.6.0}/src/StringRepresentation.h +11 -2
- {forefire-2.5.0 → forefire-2.6.0}/src/TimeTable.cpp +1 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/BurnupHeatFluxModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/CraterHeatFluxModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/CraterVaporFluxModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/FactorChemFluxModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/ForeFireV1HeatFluxModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/ForeFireV1VaporFluxModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/HeatFluxBasicModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/HeatFluxFromObsModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/HeatFluxNominalModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/LavaSO2FluxModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/ScalarFluxNominalModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/ScalarFromObsModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/SpottingFluxBasicModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/VaporFluxBasicModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/VaporFluxFromObsModel.cpp +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/VaporFluxNominalModel.cpp +0 -1
- forefire-2.6.0/src/include/Version.h +3 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/ANNPropagationModel.cpp +0 -3
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/BMapLoggerForANNTraining.cpp +0 -3
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/Balbi2015.cpp +4 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/Balbi2020.cpp +5 -3
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/BalbiNov2011.cpp +7 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/BalbiNov2011Curv.cpp +4 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/BalbiNov2011TMdMl.cpp +4 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/BalbiUnsteady.cpp +4 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/Rothermel.cpp +1 -1
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/RothermelAndrews2018.cpp +12 -1
- {forefire-2.5.0 → forefire-2.6.0}/tests/python/test_wheel.py +31 -0
- forefire-2.6.0/third_party/README.md +40 -0
- forefire-2.6.0/third_party/doctest/doctest.h +9148 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/README.md +13 -4
- {forefire-2.5.0 → forefire-2.6.0}/tools/TODO.md +0 -1
- {forefire-2.5.0 → forefire-2.6.0}/tools/check_all_lfs.bash +7 -0
- forefire-2.6.0/tools/devops/install-netcdf-manylinux.sh +107 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/READMEscripts.md +2 -2
- forefire-2.6.0/tools/preprocessing/genForeFireCase.py +164 -0
- forefire-2.5.0/TESTING.md +0 -41
- forefire-2.5.0/src/include/Version.h +0 -3
- forefire-2.5.0/tools/devops/install-netcdf-manylinux.sh +0 -51
- {forefire-2.5.0 → forefire-2.6.0}/.dockerignore +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/.gitattributes +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/.readthedocs.yaml +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/CITATION.cff +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/CODE_OF_CONDUCT.md +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/FUELCOVER.md +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/LICENSE +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/app/forefire/AdvancedLineEditor.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/app/forefire/AdvancedLineEditor.hpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/bindings/java/JLibForeFire.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/bindings/java/JLibForeFire.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/bindings/python/src/pyforefire/_cli.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/bindings/python/src/pyforefire/_pyforefire.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/cmake-build.sh +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/install-forefire-osx.sh +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/install-forefire.sh +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/ArrayDataLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/BurningMap.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/BurningMap.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/BurningMapLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/BurningRatioLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/CLibForeFire.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/CLibForeFire.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/DataLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FDCell.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FDCell.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FFArrays.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FireFront.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FireFrontData.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FireFrontData.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FireNodeData.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FireNodeData.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FluxLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FluxModel.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FluxModel.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/ForeFireModel.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/FuelDataLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/GradientDataLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/MultiplicativeLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/NCXYZTDataLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/ParallelData.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/ParallelData.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/ParallelException.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/ParallelException.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/PropagationModel.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/PropagationModel.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/PropagativeLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/RosLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/Simulator.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/Simulator.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/TimeGradientDataLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/TimeTable.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/TwoTimeArrayLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/Visitable.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/Visitor.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/WeatherDataLayer.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/colormap.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/flux/FromObsModels.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/include/FFConstants.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/include/Futils.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/ANN.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/CurvatureDrivenPropagationModel.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/FarsitePropagationModel.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/FrontDepthDrivenPropagationModel.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/IsotropicFuelPropagationModel.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/IsotropicIsospeed.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/LavaPropagationModel.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/SamplePropagationModel.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/TroisPourcent.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/TroisPourcent.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/src/propagation/WindDrivenPropagationModel.cpp +0 -0
- {forefire-2.5.0/src → forefire-2.6.0/third_party}/stb_image_write.h +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/000_ARCH/2MHGETECMWFBC +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/000_ARCH/FFMNH.yml +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/000_ARCH/GETECMWFBC +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/000_ARCH/JOBARCHIVE +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/001_pgd/MAKE_PGD +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/001_pgd/RUN_PGD +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/001_pgd/cleanDir +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/002_real/MAKE_PREAL +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/002_real/RUN_REAL +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/002_real/cleanDir +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/003_run/MAKE_RUN1 +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/003_run/RUN_MESONH_120p +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/003_run/cleanDir +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/004_SpawnReal/MAKE_SPAWNREAL +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/004_SpawnReal/RUN_SPAWN_REAL +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/004_SpawnReal/cleanDir +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/005_SpawnReal/MAKE_SPAWNREAL23 +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/005_SpawnReal/RUN_SPAWN_REAL +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/005_SpawnReal/cleanDir +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/ForeFire/Params.ff +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/ForeFire/fuels.ff +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/ForeFire/run.ff +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/MAKE_RUNFF +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/RUN_MNH_100p +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/cleanDir +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/sbatchRunVtkFilesM1 +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/sbatchRunVtkFilesM2 +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/sbatchRunVtkFilesM3 +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/RESULTS/README.md +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/makeRunFromTemplate +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/devops/increment-version.yml +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/increment-version.sh +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/makeColormapH.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/MNHCDF_to_FFNC_atmodataset.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/__init__.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/atmo_fire_plotsFrom.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/bmapToVTK.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/diag_arrays.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/extractSurfaceInXarray.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/genDomain.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/pMNHFF2VTK.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/pMNHFF2vdb.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/pMNHFF2vti.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/sciplots.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/sounding.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preflight/verify-lfs.sh +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/PGD2Init.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/PRE_IDEA1.pattern +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/clickImageToLocation.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/extract_from_eu_land_cover.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/ffToGeoJson.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/fireObs2ATime.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/genPrepIdeal.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/geo_to_kml.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/getBGFromCFCase.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/indexRVB.html +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/kmlDomain.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/learnFuelTifPng.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/lidar2fuel.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/pngs2bmap.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/prealCF2Case.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/satImage2fuel.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/tifToPngFuel.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/upDirHDR.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/processing/plotFireFiles.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/processing/plotcontour.py +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/runANN/ANNTest.cpp +0 -0
- {forefire-2.5.0 → forefire-2.6.0}/tools/sampleUses.py +0 -0
|
@@ -53,7 +53,7 @@ tests/python/FF_FS4roslog.csv
|
|
|
53
53
|
tests/python/ros_computation.py
|
|
54
54
|
tests/python/ros_sampling.py
|
|
55
55
|
tests/python/test_logdb.csv
|
|
56
|
-
tests/runff
|
|
56
|
+
tests/runff/*.png
|
|
57
57
|
tests/runff/httpConnectInfo.txt
|
|
58
58
|
tests/python/log.txt
|
|
59
59
|
tests/python/runROS.bash
|
|
@@ -0,0 +1,285 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to ForeFire are recorded here.
|
|
4
|
+
|
|
5
|
+
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
|
|
6
|
+
Version numbers are the tags in this repository and the values reported by
|
|
7
|
+
`forefire -v`; they are also what `pip install forefire==<version>` resolves.
|
|
8
|
+
|
|
9
|
+
Entries below v2.5.0 were reconstructed from the release notes and the commit
|
|
10
|
+
history, so they summarise each release rather than list every change. The
|
|
11
|
+
`Full Changelog` link on each version gives the complete commit range.
|
|
12
|
+
|
|
13
|
+
## [v2.6.0] — 2026-10-26
|
|
14
|
+
|
|
15
|
+
### Added
|
|
16
|
+
|
|
17
|
+
- C++ unit tests covering every propagation and flux model, built by default
|
|
18
|
+
and registered with CTest. They exercise the models one call at a time,
|
|
19
|
+
which the `runff` regression test cannot reach. ([#156])
|
|
20
|
+
- A dead fuel moisture invariant suite (`tests/python/test_moisture_invariants.py`)
|
|
21
|
+
and the `invariants.yml` workflow that runs it. Unlike `runff` it holds no
|
|
22
|
+
reference data: every assertion follows from the published spread equations,
|
|
23
|
+
so it stays valid across recalibration. ([#158])
|
|
24
|
+
- A blocking AddressSanitizer job, and `-DFOREFIRE_SANITIZE=<list>` to build
|
|
25
|
+
with `-fsanitize=<list>` on the compile line, the executables and the shared
|
|
26
|
+
library. ([#180])
|
|
27
|
+
- Characterisation tests pinning the HTTP command server's current behaviour.
|
|
28
|
+
([#174])
|
|
29
|
+
- A concurrency stress test for free-threaded CPython
|
|
30
|
+
(`tests/python/test_threading.py`). It does not pass yet: it is the failing
|
|
31
|
+
test for the shared-state work in [#175]. ([#176])
|
|
32
|
+
- `-Wall -Wextra` on ForeFire's own sources, with `FOREFIRE_ENABLE_WARNINGS`
|
|
33
|
+
and `FOREFIRE_WARNINGS_AS_ERRORS` to control them. NetCDF's headers are
|
|
34
|
+
included as system headers so their warnings do not appear. ([#156])
|
|
35
|
+
- `FOREFIRE_BUILD_TESTS` (default on outside wheel builds) to build the unit
|
|
36
|
+
tests. ([#156])
|
|
37
|
+
- `TESTING.md` now documents every suite, how to run it, and which ones CI
|
|
38
|
+
validates.
|
|
39
|
+
- `pyforefire.ForeFireRunner`, a `ForeFire` that runs in its own worker
|
|
40
|
+
process, so several simulations in one Python process no longer share
|
|
41
|
+
state, and a crash in the kernel raises `pyforefire.WorkerDied` instead of
|
|
42
|
+
ending Python. `ForeFire()` itself is unchanged. ([#175])
|
|
43
|
+
- `forefire-validate landscape.nc fuels.csv` checks a landscape against its
|
|
44
|
+
fuel table before a run: fuel indices missing from the table, a fuel and
|
|
45
|
+
elevation shape mismatch, and missing elevation or wind. ([#190])
|
|
46
|
+
- `tools/preprocessing/genForeFireCase.py` is back as a general landscape
|
|
47
|
+
writer. Its 3-D and 4-D fields are written in the right axis order, it uses
|
|
48
|
+
`netCDF4` instead of the deprecated `scipy.io.netcdf`, and it checks the
|
|
49
|
+
required `parametersProperties` keys before writing. ([#179])
|
|
50
|
+
- A User Guide page on driving a simulation from NumPy arrays, with no
|
|
51
|
+
landscape file and no GIS. ([#189])
|
|
52
|
+
- `-DFOREFIRE_ENABLE_NETCDF=OFF` builds the engine without NetCDF or HDF5,
|
|
53
|
+
the first step towards a WebAssembly build and a slim wheel. Commands that
|
|
54
|
+
read or write NetCDF files report that the build has no NetCDF support.
|
|
55
|
+
The default stays on. ([#171])
|
|
56
|
+
- An experimental WebAssembly build: `emcmake cmake` compiles the engine
|
|
57
|
+
without NetCDF into an ES module whose embind API mirrors `pyforefire`, with
|
|
58
|
+
typed arrays in place of NumPy arrays. `FOREFIRE_BUILD_CLI` and
|
|
59
|
+
`FOREFIRE_BUILD_WASM` control the two executables. See
|
|
60
|
+
`bindings/wasm/README.md`. ([#171])
|
|
61
|
+
- A browser demo of the WebAssembly build (`bindings/wasm/index.html`): pick
|
|
62
|
+
a square of ground on a map, and the page builds fuel and elevation layers
|
|
63
|
+
from satellite and terrain tiles, runs the fire in a worker, and plays it
|
|
64
|
+
back in 2D or on 3D terrain. Explore mode lights a fire where you click;
|
|
65
|
+
Research mode exposes the model, its tuning factors, the numerics, and the
|
|
66
|
+
fuel moisture and classes. ([#171])
|
|
67
|
+
- The browser demo colours the burnt area by arrival time, with labelled
|
|
68
|
+
isochrones, and the fire front by its rate of spread. ([#171])
|
|
69
|
+
|
|
70
|
+
### Fixed
|
|
71
|
+
|
|
72
|
+
- `pyforefire` calls that read the domain (`ff[key]`, `addLayer`,
|
|
73
|
+
`addScalarLayer`, `addIndexLayer`, `getDoubleArray`) segfaulted Python when
|
|
74
|
+
run before `FireDomain[...]`. They now raise `RuntimeError`. ([#202])
|
|
75
|
+
- `clear[]` after `loadData` freed the propagative layer twice and crashed.
|
|
76
|
+
The data broker lists that layer but no longer deletes it; the domain does.
|
|
77
|
+
([#205])
|
|
78
|
+
- Rate of spread stayed finite and decreasing at high dead fuel moisture, and
|
|
79
|
+
`DataBroker` no longer serves `moisture` through the five-slot getter, which
|
|
80
|
+
returned a neighbouring property. ([#158])
|
|
81
|
+
- The model properties array was freed twice on destruction. ([#157])
|
|
82
|
+
- `~ForeFireModel` freed an uninitialised pointer when construction had not
|
|
83
|
+
reached the allocation. ([#156])
|
|
84
|
+
- `runANN` had failed on its second line since it was committed: it diffed
|
|
85
|
+
against `result.txt.ref`, a file that is not in the repository. It now checks
|
|
86
|
+
the root mean squared error that `ANN_test` already computes, which does not
|
|
87
|
+
depend on the last digit of a machine-specific reference, and it runs in CI.
|
|
88
|
+
([#183])
|
|
89
|
+
- The `ForeFireAtom` instance counter is now atomic and the `SimulationParameters`
|
|
90
|
+
singleton is initialised safely, so two threads no longer race for ids or
|
|
91
|
+
construct the singleton twice. ([#177])
|
|
92
|
+
- `StringRepresentation` kept its output buffer, current level and GeoJSON
|
|
93
|
+
cursor in file-scope globals shared by every instance. They are now members.
|
|
94
|
+
([#178])
|
|
95
|
+
- A fire front reduced to two nodes kept a deleted node as its head, and the
|
|
96
|
+
next burning scan crashed the simulation. ([#198])
|
|
97
|
+
- `clear[]` no longer crashes after a simulation whose fire front stopped
|
|
98
|
+
everywhere, for instance an ignition in non-burnable fuel. ([#194])
|
|
99
|
+
- `Balbi2020` multiplied by the fuel surface-to-volume ratio instead of
|
|
100
|
+
dividing by it in eq. C7, which drove the radiant fraction to zero. It now
|
|
101
|
+
matches `Balbi2020.py` in `wildfire_ROS_models`, and its rate of spread is
|
|
102
|
+
floored at zero on a downslope with no wind. ([#196])
|
|
103
|
+
- A fuel map loaded with `loadData` that does not overlap the domain is now
|
|
104
|
+
stretched over it, as the warning says and as the other layers already were.
|
|
105
|
+
It was left at its own extent, so the whole domain read the fuel of its first
|
|
106
|
+
cell. ([#220])
|
|
107
|
+
- `Rothermel` wrote the wind exponent coefficient as `3.59*10E-4`, which is
|
|
108
|
+
3.59e-3 in C++, ten times the 3.59e-4 of Rothermel (1972), so wind raised
|
|
109
|
+
the rate of spread too little. Results with wind
|
|
110
|
+
change: +6% on the `runff` fuel at 5 m/s, several times more in loose fuel
|
|
111
|
+
beds such as sparse shrub. The `runff` references and the unit test pin are
|
|
112
|
+
regenerated. ([#195])
|
|
113
|
+
|
|
114
|
+
### Changed
|
|
115
|
+
|
|
116
|
+
- Release builds compile with `-ffp-contract=off`, so the compiler no longer
|
|
117
|
+
fuses multiply-adds (FMA) where the CPU allows it. `-march=native` and ARM
|
|
118
|
+
builds now give the same simulation results as x86 builds without it.
|
|
119
|
+
- Linux wheels are built against a NetCDF without DAP and HDF4, roughly halving
|
|
120
|
+
the wheel. ([#154])
|
|
121
|
+
- Free-threaded (`cp314t`) wheels are no longer published, because the core is
|
|
122
|
+
not yet thread-safe; CPython 3.14 is declared supported. ([#155])
|
|
123
|
+
- `import pyforefire` no longer loads matplotlib; it is imported only when
|
|
124
|
+
`printToPathe` or `plot_simulation` is called. `plt`, `cm`, `mpath`,
|
|
125
|
+
`mpatches` and `ListedColormap` are no longer reachable as `pyforefire`
|
|
126
|
+
attributes. ([#193])
|
|
127
|
+
- `listenHTTP[]` binds to `localhost` by default and to the host given in
|
|
128
|
+
`listenHTTP[host:port]`; use `listenHTTP[0.0.0.0:8000]` for the network
|
|
129
|
+
(and inside Docker), which prints a warning.
|
|
130
|
+
`systemExec` is refused over HTTP, the static file server only serves the run
|
|
131
|
+
directory and `FOREFIREHOME/tools/htdocs`, and commands from another site or
|
|
132
|
+
host name are refused. Other commands can still read and write files, so the
|
|
133
|
+
server is meant for trusted local use. ([#199], [#203])
|
|
134
|
+
- A safe-topology failure in a step no longer ends the process; the command
|
|
135
|
+
reports an error and the coupled run continues. ([#181])
|
|
136
|
+
- `stb_image_write.h` moved to `third_party/`, with its version, origin and
|
|
137
|
+
MIT / public-domain licence recorded. ([#192])
|
|
138
|
+
- One-line accessors called from the propagation loops (`FireNode`, `FFPoint`,
|
|
139
|
+
`FFEvent`, `FireDomain` corners) are defined in their headers so they can be
|
|
140
|
+
inlined, which makes simulations faster with identical output. ([#221])
|
|
141
|
+
|
|
142
|
+
## [v2.5.0] — 2026-08-11
|
|
143
|
+
|
|
144
|
+
### Added
|
|
145
|
+
|
|
146
|
+
- **Pip-installable wheels** for Linux (x86_64, aarch64) and macOS on Apple
|
|
147
|
+
Silicon, CPython 3.9 and newer. `pip install forefire` gives both the
|
|
148
|
+
`forefire` command-line interpreter and the `pyforefire` module, with NetCDF
|
|
149
|
+
bundled inside the wheel. Wheels are built without MPI and without
|
|
150
|
+
`-march=native`. There is no Intel macOS wheel — the `macos-13` runner was
|
|
151
|
+
retired before the release, so Intel Macs build from the source
|
|
152
|
+
distribution. ([#151])
|
|
153
|
+
|
|
154
|
+
### Changed
|
|
155
|
+
|
|
156
|
+
- The Dockerfile is a multi-stage build, and only `libforefireL` is built in
|
|
157
|
+
the builder stage. ([#147])
|
|
158
|
+
- The `install-forefire.sh` build is driven by an option-based `CMakeLists.txt`
|
|
159
|
+
(`FOREFIRE_ENABLE_MPI`, `FOREFIRE_NATIVE_ARCH`, `FOREFIRE_BUILD_PYTHON`,
|
|
160
|
+
`FOREFIRE_STATIC_CORE`, `FOREFIRE_BUILD_TOOLS`, `FOREFIRE_CHECK_LFS`).
|
|
161
|
+
|
|
162
|
+
### Fixed
|
|
163
|
+
|
|
164
|
+
- A double free in `FireFront` cleanup. ([#145])
|
|
165
|
+
- `CMakeLists.txt` was matched by `.gitignore`, so it was missing from the
|
|
166
|
+
source distribution. ([#152])
|
|
167
|
+
- Bugs in `tests/run.bash`, including a `runANN` typo and an unreachable
|
|
168
|
+
`./clean.bash`. ([#146])
|
|
169
|
+
|
|
170
|
+
**Full Changelog**: <https://github.com/forefireAPI/forefire/compare/v2.4.2...v2.5.0>
|
|
171
|
+
|
|
172
|
+
## [v2.4.2] — 2025-11-27
|
|
173
|
+
|
|
174
|
+
- Simplified the installation process, following review comments on the JOSS
|
|
175
|
+
submission, and corrected the installation instructions.
|
|
176
|
+
- Aligned the coupling with
|
|
177
|
+
[PACK-MNH-V5-7-2](https://src.koda.cnrs.fr/mesonh/mesonh-code/-/releases/PACK-MNH-V5-7-2).
|
|
178
|
+
- Aligned the repository with the accepted JOSS paper
|
|
179
|
+
([10.21105/joss.08680](https://doi.org/10.21105/joss.08680)).
|
|
180
|
+
|
|
181
|
+
**Full Changelog**: <https://github.com/forefireAPI/forefire/compare/v2.1.122...v2.4.2>
|
|
182
|
+
|
|
183
|
+
## [v2.1.122] — 2025-09-16
|
|
184
|
+
|
|
185
|
+
Tagged, but never published as a GitHub release.
|
|
186
|
+
|
|
187
|
+
- Docker images published to the GitHub container registry, and tested in CI.
|
|
188
|
+
- Python bindings reworked, with the example from [#103] applied.
|
|
189
|
+
- macOS CI runs the test script.
|
|
190
|
+
|
|
191
|
+
**Full Changelog**: <https://github.com/forefireAPI/forefire/compare/v2.0...v2.1.122>
|
|
192
|
+
|
|
193
|
+
## [v2.0] — 2025-06-05
|
|
194
|
+
|
|
195
|
+
The V2 release: the HTTP interface, and alignment with Meso-NH V4.7.2.
|
|
196
|
+
|
|
197
|
+
### Added
|
|
198
|
+
|
|
199
|
+
- The built-in **HTTP command server and web UI** (`listenHTTP[]`, or
|
|
200
|
+
`forefire -l`), serving a map view of the simulation.
|
|
201
|
+
- The **Read the Docs documentation site**, built with Sphinx, Breathe and
|
|
202
|
+
Doxygen.
|
|
203
|
+
- `install-forefire.sh`, with `-y` to add `forefire` to `PATH` and set
|
|
204
|
+
`FOREFIREHOME`.
|
|
205
|
+
- A working Dockerfile, and GitHub Actions for Linux and macOS.
|
|
206
|
+
- The `RothermelAndrews2018` propagation model. ([#34])
|
|
207
|
+
|
|
208
|
+
### Changed
|
|
209
|
+
|
|
210
|
+
- CMake replaces SCons throughout; references to SCons were removed.
|
|
211
|
+
|
|
212
|
+
### Fixed
|
|
213
|
+
|
|
214
|
+
- The `-lnetcdf_c++4` link failure. ([#26])
|
|
215
|
+
- A division by zero in `setArrivalTime`/`getArrivalTime`. ([#36])
|
|
216
|
+
|
|
217
|
+
**Full Changelog**: <https://github.com/forefireAPI/forefire/compare/v1.2...v2.0>
|
|
218
|
+
|
|
219
|
+
## [v1.2] — 2024-01-16
|
|
220
|
+
|
|
221
|
+
### Added
|
|
222
|
+
|
|
223
|
+
- The `geojson` dump mode.
|
|
224
|
+
|
|
225
|
+
## [v1.1.10] — 2022-10-25
|
|
226
|
+
|
|
227
|
+
### Changed
|
|
228
|
+
|
|
229
|
+
- CMake became the default build system. ([#9])
|
|
230
|
+
|
|
231
|
+
## [v1.1.0] — 2022-09-28
|
|
232
|
+
|
|
233
|
+
Tagged before the sources were moved into `src/`, so that this point in the
|
|
234
|
+
repository stays easy to return to.
|
|
235
|
+
|
|
236
|
+
[v2.6.0]: https://github.com/forefireAPI/forefire/releases/tag/v2.6.0
|
|
237
|
+
[v2.5.0]: https://github.com/forefireAPI/forefire/releases/tag/v2.5.0
|
|
238
|
+
[v2.4.2]: https://github.com/forefireAPI/forefire/releases/tag/v2.4.2
|
|
239
|
+
[v2.1.122]: https://github.com/forefireAPI/forefire/releases/tag/v2.1.122
|
|
240
|
+
[v2.0]: https://github.com/forefireAPI/forefire/releases/tag/v2.0
|
|
241
|
+
[v1.2]: https://github.com/forefireAPI/forefire/releases/tag/v1.2
|
|
242
|
+
[v1.1.10]: https://github.com/forefireAPI/forefire/releases/tag/v1.1.10
|
|
243
|
+
[v1.1.0]: https://github.com/forefireAPI/forefire/releases/tag/v1.1.0
|
|
244
|
+
|
|
245
|
+
[#9]: https://github.com/forefireAPI/forefire/issues/9
|
|
246
|
+
[#26]: https://github.com/forefireAPI/forefire/pull/26
|
|
247
|
+
[#34]: https://github.com/forefireAPI/forefire/pull/34
|
|
248
|
+
[#36]: https://github.com/forefireAPI/forefire/pull/36
|
|
249
|
+
[#103]: https://github.com/forefireAPI/forefire/issues/103
|
|
250
|
+
[#145]: https://github.com/forefireAPI/forefire/pull/145
|
|
251
|
+
[#146]: https://github.com/forefireAPI/forefire/pull/146
|
|
252
|
+
[#147]: https://github.com/forefireAPI/forefire/pull/147
|
|
253
|
+
[#151]: https://github.com/forefireAPI/forefire/pull/151
|
|
254
|
+
[#152]: https://github.com/forefireAPI/forefire/pull/152
|
|
255
|
+
[#154]: https://github.com/forefireAPI/forefire/pull/154
|
|
256
|
+
[#155]: https://github.com/forefireAPI/forefire/pull/155
|
|
257
|
+
[#156]: https://github.com/forefireAPI/forefire/pull/156
|
|
258
|
+
[#157]: https://github.com/forefireAPI/forefire/pull/157
|
|
259
|
+
[#158]: https://github.com/forefireAPI/forefire/pull/158
|
|
260
|
+
[#174]: https://github.com/forefireAPI/forefire/pull/174
|
|
261
|
+
[#175]: https://github.com/forefireAPI/forefire/issues/175
|
|
262
|
+
[#176]: https://github.com/forefireAPI/forefire/pull/176
|
|
263
|
+
[#177]: https://github.com/forefireAPI/forefire/pull/177
|
|
264
|
+
[#178]: https://github.com/forefireAPI/forefire/pull/178
|
|
265
|
+
[#180]: https://github.com/forefireAPI/forefire/pull/180
|
|
266
|
+
[#183]: https://github.com/forefireAPI/forefire/pull/183
|
|
267
|
+
[#193]: https://github.com/forefireAPI/forefire/pull/193
|
|
268
|
+
[#198]: https://github.com/forefireAPI/forefire/pull/198
|
|
269
|
+
[#197]: https://github.com/forefireAPI/forefire/pull/197
|
|
270
|
+
[#194]: https://github.com/forefireAPI/forefire/pull/194
|
|
271
|
+
[#196]: https://github.com/forefireAPI/forefire/issues/196
|
|
272
|
+
[#220]: https://github.com/forefireAPI/forefire/pull/220
|
|
273
|
+
[#195]: https://github.com/forefireAPI/forefire/pull/195
|
|
274
|
+
[#202]: https://github.com/forefireAPI/forefire/pull/202
|
|
275
|
+
[#199]: https://github.com/forefireAPI/forefire/pull/199
|
|
276
|
+
[#179]: https://github.com/forefireAPI/forefire/pull/179
|
|
277
|
+
[#181]: https://github.com/forefireAPI/forefire/pull/181
|
|
278
|
+
[#182]: https://github.com/forefireAPI/forefire/pull/182
|
|
279
|
+
[#189]: https://github.com/forefireAPI/forefire/pull/189
|
|
280
|
+
[#190]: https://github.com/forefireAPI/forefire/pull/190
|
|
281
|
+
[#192]: https://github.com/forefireAPI/forefire/pull/192
|
|
282
|
+
[#221]: https://github.com/forefireAPI/forefire/pull/221
|
|
283
|
+
[#203]: https://github.com/forefireAPI/forefire/pull/203
|
|
284
|
+
[#205]: https://github.com/forefireAPI/forefire/issues/205
|
|
285
|
+
[#171]: https://github.com/forefireAPI/forefire/issues/171
|
|
@@ -31,6 +31,7 @@ if(DEFINED SKBUILD)
|
|
|
31
31
|
set(_ff_default_static ON)
|
|
32
32
|
set(_ff_default_tools OFF)
|
|
33
33
|
set(_ff_default_lfs OFF)
|
|
34
|
+
set(_ff_default_tests OFF)
|
|
34
35
|
else()
|
|
35
36
|
set(_ff_wheel_build OFF)
|
|
36
37
|
set(_ff_default_mpi ON)
|
|
@@ -39,14 +40,41 @@ else()
|
|
|
39
40
|
set(_ff_default_static OFF)
|
|
40
41
|
set(_ff_default_tools ON)
|
|
41
42
|
set(_ff_default_lfs ON)
|
|
43
|
+
set(_ff_default_tests ON)
|
|
44
|
+
endif()
|
|
45
|
+
|
|
46
|
+
# Emscripten has no NetCDF and no reason for one: a browser build reads its
|
|
47
|
+
# data from JS typed arrays. Detecting it here rather than making the caller
|
|
48
|
+
# pass the flags keeps `emcmake cmake` a one-liner.
|
|
49
|
+
if(EMSCRIPTEN)
|
|
50
|
+
set(_ff_default_mpi OFF)
|
|
51
|
+
set(_ff_default_native OFF)
|
|
52
|
+
set(_ff_default_python OFF)
|
|
53
|
+
set(_ff_default_static ON)
|
|
54
|
+
set(_ff_default_tools OFF)
|
|
55
|
+
set(_ff_default_lfs OFF)
|
|
56
|
+
set(_ff_default_netcdf OFF)
|
|
57
|
+
set(_ff_default_cli OFF)
|
|
58
|
+
set(_ff_default_tests OFF)
|
|
59
|
+
else()
|
|
60
|
+
set(_ff_default_netcdf ON)
|
|
61
|
+
set(_ff_default_cli ON)
|
|
42
62
|
endif()
|
|
43
63
|
|
|
44
64
|
option(FOREFIRE_ENABLE_MPI "Enable MPI coupling when MPI is available" ${_ff_default_mpi})
|
|
65
|
+
option(FOREFIRE_ENABLE_NETCDF "Build the NetCDF-backed I/O paths" ${_ff_default_netcdf})
|
|
66
|
+
option(FOREFIRE_BUILD_CLI "Build the interactive forefire command line shell" ${_ff_default_cli})
|
|
67
|
+
option(FOREFIRE_BUILD_WASM "Build the Emscripten/embind module" ${EMSCRIPTEN})
|
|
45
68
|
option(FOREFIRE_NATIVE_ARCH "Optimise for the build machine's CPU (-march=native)" ${_ff_default_native})
|
|
46
69
|
option(FOREFIRE_BUILD_PYTHON "Build the pyforefire Python extension module" ${_ff_default_python})
|
|
47
70
|
option(FOREFIRE_STATIC_CORE "Build the ForeFire core as a static library" ${_ff_default_static})
|
|
48
71
|
option(FOREFIRE_BUILD_TOOLS "Build the ANN_test helper executable" ${_ff_default_tools})
|
|
49
72
|
option(FOREFIRE_CHECK_LFS "Run the Git LFS data integrity check at configure time" ${_ff_default_lfs})
|
|
73
|
+
option(FOREFIRE_BUILD_TESTS "Build the C++ unit tests, registered with CTest" ${_ff_default_tests})
|
|
74
|
+
option(FOREFIRE_ENABLE_WARNINGS "Compile ForeFire's own sources with -Wall -Wextra" ON)
|
|
75
|
+
option(FOREFIRE_WARNINGS_AS_ERRORS "Fail the build on a compiler warning" OFF)
|
|
76
|
+
set(FOREFIRE_SANITIZE "" CACHE STRING
|
|
77
|
+
"Sanitizers to build with, passed to -fsanitize= (e.g. address, undefined, address,undefined)")
|
|
50
78
|
|
|
51
79
|
# ----------------------------------
|
|
52
80
|
# Set C++ Standard
|
|
@@ -130,7 +158,12 @@ endif()
|
|
|
130
158
|
# detection logic below lives in exactly one place.
|
|
131
159
|
add_library(forefire_netcdf INTERFACE)
|
|
132
160
|
|
|
133
|
-
if(
|
|
161
|
+
if(NOT FOREFIRE_ENABLE_NETCDF)
|
|
162
|
+
# FF_NO_NETCDF compiles out every NetCDF-backed path; each entry point keeps
|
|
163
|
+
# a stub that reports the missing support (see DataBroker.h).
|
|
164
|
+
message(STATUS "NetCDF support disabled (FOREFIRE_ENABLE_NETCDF=OFF)")
|
|
165
|
+
target_compile_definitions(forefire_netcdf INTERFACE FF_NO_NETCDF)
|
|
166
|
+
elseif(DEFINED ENV{SRC_MESONH} AND DEFINED ENV{XYZ} AND DEFINED ENV{FF_STATIC})
|
|
134
167
|
message(STATUS "MESONH and XYZ environment variables are set. FF_STATIC too, static NetCDF.")
|
|
135
168
|
set(MESONH $ENV{SRC_MESONH})
|
|
136
169
|
set(XYZ $ENV{XYZ})
|
|
@@ -154,7 +187,7 @@ if(DEFINED ENV{SRC_MESONH} AND DEFINED ENV{XYZ} AND DEFINED ENV{FF_STATIC})
|
|
|
154
187
|
message(FATAL_ERROR "Required static library not found: ${lib}")
|
|
155
188
|
endif()
|
|
156
189
|
endforeach()
|
|
157
|
-
target_include_directories(forefire_netcdf INTERFACE "${NETCDF_HOME}/include")
|
|
190
|
+
target_include_directories(forefire_netcdf SYSTEM INTERFACE "${NETCDF_HOME}/include")
|
|
158
191
|
target_link_libraries(forefire_netcdf INTERFACE
|
|
159
192
|
${NETCDF_LIB}
|
|
160
193
|
${NETCDF_CXX_LIB}
|
|
@@ -200,7 +233,9 @@ else()
|
|
|
200
233
|
|
|
201
234
|
message(STATUS "NetCDF C: ${NETCDF_LIBRARY} (headers: ${NETCDF_INCLUDE_DIR})")
|
|
202
235
|
message(STATUS "NetCDF C++: ${NETCDF_CXX_LIBRARY} (headers: ${NETCDF_CXX_INCLUDE_DIR})")
|
|
203
|
-
|
|
236
|
+
# SYSTEM: the NetCDF C++4 headers trip -Wunused-variable, and that is not a
|
|
237
|
+
# warning anyone here can act on.
|
|
238
|
+
target_include_directories(forefire_netcdf SYSTEM INTERFACE ${NETCDF_CXX_INCLUDE_DIR} ${NETCDF_INCLUDE_DIR})
|
|
204
239
|
target_link_libraries(forefire_netcdf INTERFACE ${NETCDF_CXX_LIBRARY} ${NETCDF_LIBRARY})
|
|
205
240
|
endif()
|
|
206
241
|
|
|
@@ -213,15 +248,54 @@ endif()
|
|
|
213
248
|
# ----------------------------------
|
|
214
249
|
if(MPI_FOUND)
|
|
215
250
|
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g -O0 -DMPI_COUPLING")
|
|
251
|
+
elseif(FOREFIRE_SANITIZE)
|
|
252
|
+
# A sanitizer build wants frame pointers and debug info; the release set
|
|
253
|
+
# below strips both, and -flto makes the reports harder to read besides.
|
|
254
|
+
# -O1 keeps the suites quick enough to run in CI.
|
|
255
|
+
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g -O1 -fno-omit-frame-pointer")
|
|
216
256
|
else()
|
|
217
257
|
# uncomment if want to debug
|
|
218
258
|
# set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g -O0")
|
|
219
|
-
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -O3 -flto -fomit-frame-pointer -finline-functions -funroll-loops -ftree-vectorize -fno-strict-aliasing")
|
|
259
|
+
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -O3 -ffp-contract=off -flto -fomit-frame-pointer -finline-functions -funroll-loops -ftree-vectorize -fno-strict-aliasing")
|
|
220
260
|
if(FOREFIRE_NATIVE_ARCH)
|
|
221
261
|
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -march=native")
|
|
222
262
|
endif()
|
|
223
263
|
endif()
|
|
224
264
|
|
|
265
|
+
# Sanitizers have to reach the link line as well as the compile line, and the
|
|
266
|
+
# shared library too: the core is where the allocations happen.
|
|
267
|
+
if(FOREFIRE_SANITIZE)
|
|
268
|
+
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fsanitize=${FOREFIRE_SANITIZE}")
|
|
269
|
+
set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -fsanitize=${FOREFIRE_SANITIZE}")
|
|
270
|
+
set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -fsanitize=${FOREFIRE_SANITIZE}")
|
|
271
|
+
message(STATUS "Sanitizers enabled: -fsanitize=${FOREFIRE_SANITIZE}")
|
|
272
|
+
endif()
|
|
273
|
+
|
|
274
|
+
# Warnings are a target property rather than a global flag on purpose: they
|
|
275
|
+
# should apply to code this project writes, not to pybind11's headers or to
|
|
276
|
+
# whatever a consumer compiles against the installed library.
|
|
277
|
+
set(_ff_warning_flags "")
|
|
278
|
+
if(FOREFIRE_ENABLE_WARNINGS)
|
|
279
|
+
if(CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang|AppleClang")
|
|
280
|
+
list(APPEND _ff_warning_flags -Wall -Wextra)
|
|
281
|
+
elseif(MSVC)
|
|
282
|
+
list(APPEND _ff_warning_flags /W4)
|
|
283
|
+
endif()
|
|
284
|
+
endif()
|
|
285
|
+
if(FOREFIRE_WARNINGS_AS_ERRORS AND _ff_warning_flags)
|
|
286
|
+
if(MSVC)
|
|
287
|
+
list(APPEND _ff_warning_flags /WX)
|
|
288
|
+
else()
|
|
289
|
+
list(APPEND _ff_warning_flags -Werror)
|
|
290
|
+
endif()
|
|
291
|
+
endif()
|
|
292
|
+
|
|
293
|
+
if(EMSCRIPTEN)
|
|
294
|
+
# Emscripten defaults to -fno-exceptions; the command parser signals bad
|
|
295
|
+
# input by throwing, so every translation unit needs them enabled.
|
|
296
|
+
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fexceptions")
|
|
297
|
+
endif()
|
|
298
|
+
|
|
225
299
|
# ----------------------------------
|
|
226
300
|
# Output Directories
|
|
227
301
|
# ----------------------------------
|
|
@@ -258,10 +332,18 @@ endif()
|
|
|
258
332
|
target_include_directories(forefireL PUBLIC
|
|
259
333
|
"${CMAKE_CURRENT_SOURCE_DIR}/src"
|
|
260
334
|
"${CMAKE_CURRENT_SOURCE_DIR}/src/include")
|
|
335
|
+
# SYSTEM and PRIVATE: vendored headers are ours to use but not ours to fix, so
|
|
336
|
+
# the warning flags below must not apply to them, and nothing outside this
|
|
337
|
+
# library includes them.
|
|
338
|
+
target_include_directories(forefireL SYSTEM PRIVATE
|
|
339
|
+
"${CMAKE_CURRENT_SOURCE_DIR}/third_party")
|
|
261
340
|
# Threads is explicit because a static core does not drag libpthread in for
|
|
262
341
|
# its consumers the way the shared library does.
|
|
263
342
|
find_package(Threads REQUIRED)
|
|
264
343
|
target_link_libraries(forefireL PUBLIC forefire_netcdf Threads::Threads)
|
|
344
|
+
if(_ff_warning_flags)
|
|
345
|
+
target_compile_options(forefireL PRIVATE ${_ff_warning_flags})
|
|
346
|
+
endif()
|
|
265
347
|
|
|
266
348
|
# ----------------------------------
|
|
267
349
|
# Test Executable
|
|
@@ -274,8 +356,61 @@ endif()
|
|
|
274
356
|
# ----------------------------------
|
|
275
357
|
# Main Project Executable
|
|
276
358
|
# ----------------------------------
|
|
277
|
-
|
|
278
|
-
|
|
359
|
+
# The shell is termios-driven and has no meaning in a browser, so a WASM build
|
|
360
|
+
# skips it and ships the embind module below instead.
|
|
361
|
+
if(FOREFIRE_BUILD_CLI)
|
|
362
|
+
add_executable(forefire app/forefire/ForeFire.cpp app/forefire/AdvancedLineEditor.cpp)
|
|
363
|
+
target_link_libraries(forefire PRIVATE forefireL)
|
|
364
|
+
if(_ff_warning_flags)
|
|
365
|
+
target_compile_options(forefire PRIVATE ${_ff_warning_flags})
|
|
366
|
+
endif()
|
|
367
|
+
endif()
|
|
368
|
+
|
|
369
|
+
# ----------------------------------
|
|
370
|
+
# Unit Tests
|
|
371
|
+
# ----------------------------------
|
|
372
|
+
if(FOREFIRE_BUILD_TESTS)
|
|
373
|
+
enable_testing()
|
|
374
|
+
add_subdirectory(tests/unit)
|
|
375
|
+
endif()
|
|
376
|
+
|
|
377
|
+
# ----------------------------------
|
|
378
|
+
# WebAssembly Module
|
|
379
|
+
# ----------------------------------
|
|
380
|
+
if(FOREFIRE_BUILD_WASM)
|
|
381
|
+
add_executable(forefire_wasm bindings/wasm/forefire_wasm.cpp)
|
|
382
|
+
target_link_libraries(forefire_wasm PRIVATE forefireL)
|
|
383
|
+
# Two things are non-obvious here. embind refuses to compile below C++17,
|
|
384
|
+
# so this one translation unit moves up while the core stays on C++11 —
|
|
385
|
+
# both sit on the same libc++. And the output is an ES module, which Node
|
|
386
|
+
# only recognises from a .js file when a package.json says so, hence .mjs.
|
|
387
|
+
set_target_properties(forefire_wasm PROPERTIES
|
|
388
|
+
OUTPUT_NAME "forefire"
|
|
389
|
+
SUFFIX ".mjs"
|
|
390
|
+
CXX_STANDARD 17
|
|
391
|
+
CXX_STANDARD_REQUIRED ON)
|
|
392
|
+
target_link_options(forefire_wasm PRIVATE
|
|
393
|
+
"--bind"
|
|
394
|
+
# A single ES module plus its .wasm, so a static page can import it.
|
|
395
|
+
"-sMODULARIZE=1"
|
|
396
|
+
"-sEXPORT_ES6=1"
|
|
397
|
+
"-sEXPORT_NAME=createForeFire"
|
|
398
|
+
"-sENVIRONMENT=web,worker,node"
|
|
399
|
+
# The domain allocates its grids up front and can grow well past the
|
|
400
|
+
# 16 MB default; the fire domain sizes are not known at build time.
|
|
401
|
+
"-sALLOW_MEMORY_GROWTH=1"
|
|
402
|
+
"-sINITIAL_MEMORY=64MB"
|
|
403
|
+
"-sSTACK_SIZE=4MB"
|
|
404
|
+
# C++ exceptions are load-bearing here: BadOption and friends are how
|
|
405
|
+
# the command parser reports bad input.
|
|
406
|
+
"-fexceptions"
|
|
407
|
+
# There is no main(): the module is driven entirely through embind.
|
|
408
|
+
# FS stays exported so callers can stage fuels.csv and read back what
|
|
409
|
+
# print[<file>] writes.
|
|
410
|
+
"-sEXPORTED_RUNTIME_METHODS=['FS']"
|
|
411
|
+
"-sFORCE_FILESYSTEM=1")
|
|
412
|
+
target_compile_options(forefire_wasm PRIVATE "-fexceptions")
|
|
413
|
+
endif()
|
|
279
414
|
|
|
280
415
|
# ----------------------------------
|
|
281
416
|
# Python Extension Module
|
|
@@ -319,7 +454,9 @@ if(NOT _ff_wheel_build)
|
|
|
319
454
|
set(CPACK_RESOURCE_FILE_LICENSE "${CMAKE_SOURCE_DIR}/LICENSE") # Adjust as necessary
|
|
320
455
|
|
|
321
456
|
# Specify installation directories
|
|
322
|
-
|
|
457
|
+
if(FOREFIRE_BUILD_CLI)
|
|
458
|
+
install(TARGETS forefire RUNTIME DESTINATION bin)
|
|
459
|
+
endif()
|
|
323
460
|
if(NOT FOREFIRE_STATIC_CORE)
|
|
324
461
|
# With a static core there is no libforefireL to install: it is linked
|
|
325
462
|
# straight into the executables.
|
|
@@ -64,25 +64,32 @@ We welcome code contributions, from bug fixes to new features.
|
|
|
64
64
|
Implement your code changes, following existing coding style and conventions where possible.
|
|
65
65
|
6. **Add Tests (if applicable):**
|
|
66
66
|
|
|
67
|
-
For new features or significant bug fixes, please add corresponding tests or update existing ones. See
|
|
67
|
+
For new features or significant bug fixes, please add corresponding tests or update existing ones. See [TESTING.md](TESTING.md) for what each suite covers, how to run it, and which ones CI validates. Ensure all tests pass locally.
|
|
68
68
|
```bash
|
|
69
|
-
#
|
|
69
|
+
# The C++ unit tests
|
|
70
|
+
cmake -S . -B build && cmake --build build -j
|
|
71
|
+
ctest --test-dir build --output-on-failure
|
|
72
|
+
|
|
73
|
+
# The script-driven suites (runff, runANN)
|
|
70
74
|
cd tests && bash run.bash
|
|
71
75
|
```
|
|
72
|
-
7. **
|
|
76
|
+
7. **Record the Change:**
|
|
77
|
+
|
|
78
|
+
Add an entry under `## [Unreleased]` in [CHANGELOG.md](CHANGELOG.md), in the section that fits (`Added`, `Changed`, `Deprecated`, `Removed`, `Fixed`, `Security`). Write it for someone upgrading: what changed for them, not what you edited. Skip this for changes with no user-visible effect, such as a typo fix or an internal refactor.
|
|
79
|
+
8. **Commit Changes:**
|
|
73
80
|
|
|
74
81
|
Commit your changes with clear and concise commit messages.
|
|
75
82
|
```bash
|
|
76
83
|
git add .
|
|
77
84
|
git commit -m "feat: Implement new flux model calculation"
|
|
78
85
|
```
|
|
79
|
-
|
|
86
|
+
9. **Push to Your Fork:**
|
|
80
87
|
|
|
81
88
|
Push your branch to your GitHub fork.
|
|
82
89
|
```bash
|
|
83
90
|
git push origin my-feature-branch
|
|
84
91
|
```
|
|
85
|
-
|
|
92
|
+
10. **Open a Pull Request (PR):**
|
|
86
93
|
|
|
87
94
|
Go to the `forefireAPI/forefire` repository on GitHub and open a Pull Request from your branch to the `dev` branch (or `master` if that's the target).
|
|
88
95
|
* Provide a clear description of the changes in the PR.
|
|
@@ -29,14 +29,16 @@ COPY --link app/ ./app/
|
|
|
29
29
|
# tools/check_all_lfs.bash and references tools/runANN/ANNTest.cpp.
|
|
30
30
|
COPY --link tools/ ./tools/
|
|
31
31
|
COPY --link src/ ./src/
|
|
32
|
+
COPY --link third_party/ ./third_party/
|
|
32
33
|
|
|
33
34
|
# -march=native is off: this image is published and has to run on CPUs other
|
|
34
|
-
# than the builder's.
|
|
35
|
+
# than the builder's. The LFS check and the unit tests are off too: tests/ is
|
|
36
|
+
# not copied into this stage, so they could only fail.
|
|
35
37
|
#
|
|
36
38
|
# Only libforefireL.so is carried into the runtime stage, and the wheel build
|
|
37
39
|
# below compiles the core again on its own terms, so building the `forefire`
|
|
38
40
|
# and ANN_test executables here as well would just be a wasted compile.
|
|
39
|
-
RUN cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DFOREFIRE_NATIVE_ARCH=OFF \
|
|
41
|
+
RUN cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DFOREFIRE_NATIVE_ARCH=OFF -DFOREFIRE_CHECK_LFS=OFF -DFOREFIRE_BUILD_TESTS=OFF \
|
|
40
42
|
&& cmake --build build -j"$(nproc)" --target forefireL
|
|
41
43
|
|
|
42
44
|
COPY --link bindings/ ./bindings/
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: forefire
|
|
3
|
-
Version: 2.
|
|
3
|
+
Version: 2.6.0
|
|
4
4
|
Summary: ForeFire wildfire simulation engine, with Python bindings
|
|
5
5
|
Keywords: ForeFire,forefire,pyforefire,wildfire,fire,simulation,wildfire-simulation
|
|
6
6
|
Author-Email: Jean-Baptiste Filippi <filippi_j@univ-corse.fr>, Quentin Duriani <qduriani@gmail.com>
|
|
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.10
|
|
|
15
15
|
Classifier: Programming Language :: Python :: 3.11
|
|
16
16
|
Classifier: Programming Language :: Python :: 3.12
|
|
17
17
|
Classifier: Programming Language :: Python :: 3.13
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
18
19
|
Classifier: Topic :: Scientific/Engineering
|
|
19
20
|
Classifier: Operating System :: POSIX :: Linux
|
|
20
21
|
Classifier: Operating System :: MacOS :: MacOS X
|
|
@@ -162,6 +163,22 @@ For examples that use real-world data (fuel, topography, wind), see the scripts
|
|
|
162
163
|
in the [`tests/python/`](https://github.com/forefireAPI/forefire/tree/master/tests/python)
|
|
163
164
|
directory of the main repository.
|
|
164
165
|
|
|
166
|
+
### Validating a landscape file
|
|
167
|
+
|
|
168
|
+
A landscape `.nc` and its fuel table have to agree: every fuel index in the
|
|
169
|
+
raster must be defined in the table, or the simulation fails or produces wrong
|
|
170
|
+
results without saying why. The `forefire-validate` command checks this up
|
|
171
|
+
front:
|
|
172
|
+
|
|
173
|
+
```bash
|
|
174
|
+
forefire-validate landscape.nc fuels.csv
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
It reports any fuel index present in the raster but missing from the table,
|
|
178
|
+
flags a fuel/elevation shape mismatch, and warns when elevation or wind is
|
|
179
|
+
absent. Reading the `.nc` needs the `netCDF4` package (`pip install netCDF4`);
|
|
180
|
+
it is not pulled in by the wheel automatically.
|
|
181
|
+
|
|
165
182
|
---
|
|
166
183
|
|
|
167
184
|
## Development
|