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.
Files changed (229) hide show
  1. {forefire-2.5.0 → forefire-2.6.0}/.gitignore +1 -1
  2. forefire-2.6.0/CHANGELOG.md +285 -0
  3. {forefire-2.5.0 → forefire-2.6.0}/CMakeLists.txt +144 -7
  4. {forefire-2.5.0 → forefire-2.6.0}/CONTRIBUTING.md +12 -5
  5. {forefire-2.5.0 → forefire-2.6.0}/Dockerfile +4 -2
  6. {forefire-2.5.0 → forefire-2.6.0}/PKG-INFO +18 -1
  7. {forefire-2.5.0 → forefire-2.6.0}/README.md +21 -4
  8. forefire-2.6.0/TESTING.md +263 -0
  9. {forefire-2.5.0 → forefire-2.6.0}/app/forefire/ForeFire.cpp +10 -4
  10. {forefire-2.5.0 → forefire-2.6.0}/app/forefire/commands.md +39 -32
  11. {forefire-2.5.0 → forefire-2.6.0}/bindings/python/README.md +16 -0
  12. {forefire-2.5.0 → forefire-2.6.0}/bindings/python/src/pyforefire/__init__.py +1 -0
  13. {forefire-2.5.0 → forefire-2.6.0}/bindings/python/src/pyforefire/_pyforefire.cpp +18 -8
  14. forefire-2.6.0/bindings/python/src/pyforefire/_runner.py +110 -0
  15. forefire-2.6.0/bindings/python/src/pyforefire/_validate.py +246 -0
  16. forefire-2.6.0/bindings/python/src/pyforefire/_worker.py +34 -0
  17. {forefire-2.5.0 → forefire-2.6.0}/bindings/python/src/pyforefire/helpers.py +5 -5
  18. forefire-2.6.0/bindings/wasm/README.md +257 -0
  19. forefire-2.6.0/bindings/wasm/forefire_wasm.cpp +226 -0
  20. forefire-2.6.0/bindings/wasm/index.html +1231 -0
  21. forefire-2.6.0/bindings/wasm/landscape.mjs +284 -0
  22. forefire-2.6.0/bindings/wasm/smoke.mjs +123 -0
  23. forefire-2.6.0/bindings/wasm/terrain3d.mjs +465 -0
  24. forefire-2.6.0/bindings/wasm/worker.mjs +249 -0
  25. {forefire-2.5.0 → forefire-2.6.0}/pyproject.toml +12 -1
  26. {forefire-2.5.0 → forefire-2.6.0}/src/Command.cpp +99 -24
  27. {forefire-2.5.0 → forefire-2.6.0}/src/Command.h +29 -1
  28. {forefire-2.5.0 → forefire-2.6.0}/src/DataBroker.cpp +64 -9
  29. {forefire-2.5.0 → forefire-2.6.0}/src/DataBroker.h +10 -0
  30. {forefire-2.5.0 → forefire-2.6.0}/src/EventCommand.cpp +2 -0
  31. {forefire-2.5.0 → forefire-2.6.0}/src/EventCommand.h +2 -1
  32. {forefire-2.5.0 → forefire-2.6.0}/src/FFEvent.cpp +0 -12
  33. {forefire-2.5.0 → forefire-2.6.0}/src/FFEvent.h +3 -3
  34. {forefire-2.5.0 → forefire-2.6.0}/src/FFPoint.cpp +0 -37
  35. {forefire-2.5.0 → forefire-2.6.0}/src/FFPoint.h +8 -13
  36. {forefire-2.5.0 → forefire-2.6.0}/src/FFVector.cpp +0 -6
  37. {forefire-2.5.0 → forefire-2.6.0}/src/FFVector.h +0 -4
  38. {forefire-2.5.0 → forefire-2.6.0}/src/FireDomain.cpp +81 -36
  39. {forefire-2.5.0 → forefire-2.6.0}/src/FireDomain.h +18 -8
  40. {forefire-2.5.0 → forefire-2.6.0}/src/FireFront.cpp +8 -0
  41. {forefire-2.5.0 → forefire-2.6.0}/src/FireNode.cpp +0 -19
  42. {forefire-2.5.0 → forefire-2.6.0}/src/FireNode.h +6 -6
  43. {forefire-2.5.0 → forefire-2.6.0}/src/ForeFireAtom.h +13 -2
  44. {forefire-2.5.0 → forefire-2.6.0}/src/ForeFireModel.cpp +7 -1
  45. {forefire-2.5.0 → forefire-2.6.0}/src/HttpCommandServer.hpp +97 -9
  46. {forefire-2.5.0 → forefire-2.6.0}/src/SimulationParameters.cpp +7 -3
  47. {forefire-2.5.0 → forefire-2.6.0}/src/SimulationParameters.h +0 -2
  48. {forefire-2.5.0 → forefire-2.6.0}/src/StringRepresentation.cpp +14 -12
  49. {forefire-2.5.0 → forefire-2.6.0}/src/StringRepresentation.h +11 -2
  50. {forefire-2.5.0 → forefire-2.6.0}/src/TimeTable.cpp +1 -0
  51. {forefire-2.5.0 → forefire-2.6.0}/src/flux/BurnupHeatFluxModel.cpp +0 -1
  52. {forefire-2.5.0 → forefire-2.6.0}/src/flux/CraterHeatFluxModel.cpp +0 -1
  53. {forefire-2.5.0 → forefire-2.6.0}/src/flux/CraterVaporFluxModel.cpp +0 -1
  54. {forefire-2.5.0 → forefire-2.6.0}/src/flux/FactorChemFluxModel.cpp +0 -1
  55. {forefire-2.5.0 → forefire-2.6.0}/src/flux/ForeFireV1HeatFluxModel.cpp +0 -1
  56. {forefire-2.5.0 → forefire-2.6.0}/src/flux/ForeFireV1VaporFluxModel.cpp +0 -1
  57. {forefire-2.5.0 → forefire-2.6.0}/src/flux/HeatFluxBasicModel.cpp +0 -1
  58. {forefire-2.5.0 → forefire-2.6.0}/src/flux/HeatFluxFromObsModel.cpp +0 -1
  59. {forefire-2.5.0 → forefire-2.6.0}/src/flux/HeatFluxNominalModel.cpp +0 -1
  60. {forefire-2.5.0 → forefire-2.6.0}/src/flux/LavaSO2FluxModel.cpp +0 -1
  61. {forefire-2.5.0 → forefire-2.6.0}/src/flux/ScalarFluxNominalModel.cpp +0 -1
  62. {forefire-2.5.0 → forefire-2.6.0}/src/flux/ScalarFromObsModel.cpp +0 -1
  63. {forefire-2.5.0 → forefire-2.6.0}/src/flux/SpottingFluxBasicModel.cpp +0 -1
  64. {forefire-2.5.0 → forefire-2.6.0}/src/flux/VaporFluxBasicModel.cpp +0 -1
  65. {forefire-2.5.0 → forefire-2.6.0}/src/flux/VaporFluxFromObsModel.cpp +0 -1
  66. {forefire-2.5.0 → forefire-2.6.0}/src/flux/VaporFluxNominalModel.cpp +0 -1
  67. forefire-2.6.0/src/include/Version.h +3 -0
  68. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/ANNPropagationModel.cpp +0 -3
  69. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/BMapLoggerForANNTraining.cpp +0 -3
  70. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/Balbi2015.cpp +4 -0
  71. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/Balbi2020.cpp +5 -3
  72. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/BalbiNov2011.cpp +7 -0
  73. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/BalbiNov2011Curv.cpp +4 -0
  74. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/BalbiNov2011TMdMl.cpp +4 -0
  75. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/BalbiUnsteady.cpp +4 -0
  76. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/Rothermel.cpp +1 -1
  77. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/RothermelAndrews2018.cpp +12 -1
  78. {forefire-2.5.0 → forefire-2.6.0}/tests/python/test_wheel.py +31 -0
  79. forefire-2.6.0/third_party/README.md +40 -0
  80. forefire-2.6.0/third_party/doctest/doctest.h +9148 -0
  81. {forefire-2.5.0 → forefire-2.6.0}/tools/README.md +13 -4
  82. {forefire-2.5.0 → forefire-2.6.0}/tools/TODO.md +0 -1
  83. {forefire-2.5.0 → forefire-2.6.0}/tools/check_all_lfs.bash +7 -0
  84. forefire-2.6.0/tools/devops/install-netcdf-manylinux.sh +107 -0
  85. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/READMEscripts.md +2 -2
  86. forefire-2.6.0/tools/preprocessing/genForeFireCase.py +164 -0
  87. forefire-2.5.0/TESTING.md +0 -41
  88. forefire-2.5.0/src/include/Version.h +0 -3
  89. forefire-2.5.0/tools/devops/install-netcdf-manylinux.sh +0 -51
  90. {forefire-2.5.0 → forefire-2.6.0}/.dockerignore +0 -0
  91. {forefire-2.5.0 → forefire-2.6.0}/.gitattributes +0 -0
  92. {forefire-2.5.0 → forefire-2.6.0}/.readthedocs.yaml +0 -0
  93. {forefire-2.5.0 → forefire-2.6.0}/CITATION.cff +0 -0
  94. {forefire-2.5.0 → forefire-2.6.0}/CODE_OF_CONDUCT.md +0 -0
  95. {forefire-2.5.0 → forefire-2.6.0}/FUELCOVER.md +0 -0
  96. {forefire-2.5.0 → forefire-2.6.0}/LICENSE +0 -0
  97. {forefire-2.5.0 → forefire-2.6.0}/app/forefire/AdvancedLineEditor.cpp +0 -0
  98. {forefire-2.5.0 → forefire-2.6.0}/app/forefire/AdvancedLineEditor.hpp +0 -0
  99. {forefire-2.5.0 → forefire-2.6.0}/bindings/java/JLibForeFire.cpp +0 -0
  100. {forefire-2.5.0 → forefire-2.6.0}/bindings/java/JLibForeFire.h +0 -0
  101. {forefire-2.5.0 → forefire-2.6.0}/bindings/python/src/pyforefire/_cli.py +0 -0
  102. {forefire-2.5.0 → forefire-2.6.0}/bindings/python/src/pyforefire/_pyforefire.h +0 -0
  103. {forefire-2.5.0 → forefire-2.6.0}/cmake-build.sh +0 -0
  104. {forefire-2.5.0 → forefire-2.6.0}/install-forefire-osx.sh +0 -0
  105. {forefire-2.5.0 → forefire-2.6.0}/install-forefire.sh +0 -0
  106. {forefire-2.5.0 → forefire-2.6.0}/src/ArrayDataLayer.h +0 -0
  107. {forefire-2.5.0 → forefire-2.6.0}/src/BurningMap.cpp +0 -0
  108. {forefire-2.5.0 → forefire-2.6.0}/src/BurningMap.h +0 -0
  109. {forefire-2.5.0 → forefire-2.6.0}/src/BurningMapLayer.h +0 -0
  110. {forefire-2.5.0 → forefire-2.6.0}/src/BurningRatioLayer.h +0 -0
  111. {forefire-2.5.0 → forefire-2.6.0}/src/CLibForeFire.cpp +0 -0
  112. {forefire-2.5.0 → forefire-2.6.0}/src/CLibForeFire.h +0 -0
  113. {forefire-2.5.0 → forefire-2.6.0}/src/DataLayer.h +0 -0
  114. {forefire-2.5.0 → forefire-2.6.0}/src/FDCell.cpp +0 -0
  115. {forefire-2.5.0 → forefire-2.6.0}/src/FDCell.h +0 -0
  116. {forefire-2.5.0 → forefire-2.6.0}/src/FFArrays.h +0 -0
  117. {forefire-2.5.0 → forefire-2.6.0}/src/FireFront.h +0 -0
  118. {forefire-2.5.0 → forefire-2.6.0}/src/FireFrontData.cpp +0 -0
  119. {forefire-2.5.0 → forefire-2.6.0}/src/FireFrontData.h +0 -0
  120. {forefire-2.5.0 → forefire-2.6.0}/src/FireNodeData.cpp +0 -0
  121. {forefire-2.5.0 → forefire-2.6.0}/src/FireNodeData.h +0 -0
  122. {forefire-2.5.0 → forefire-2.6.0}/src/FluxLayer.h +0 -0
  123. {forefire-2.5.0 → forefire-2.6.0}/src/FluxModel.cpp +0 -0
  124. {forefire-2.5.0 → forefire-2.6.0}/src/FluxModel.h +0 -0
  125. {forefire-2.5.0 → forefire-2.6.0}/src/ForeFireModel.h +0 -0
  126. {forefire-2.5.0 → forefire-2.6.0}/src/FuelDataLayer.h +0 -0
  127. {forefire-2.5.0 → forefire-2.6.0}/src/GradientDataLayer.h +0 -0
  128. {forefire-2.5.0 → forefire-2.6.0}/src/MultiplicativeLayer.h +0 -0
  129. {forefire-2.5.0 → forefire-2.6.0}/src/NCXYZTDataLayer.h +0 -0
  130. {forefire-2.5.0 → forefire-2.6.0}/src/ParallelData.cpp +0 -0
  131. {forefire-2.5.0 → forefire-2.6.0}/src/ParallelData.h +0 -0
  132. {forefire-2.5.0 → forefire-2.6.0}/src/ParallelException.cpp +0 -0
  133. {forefire-2.5.0 → forefire-2.6.0}/src/ParallelException.h +0 -0
  134. {forefire-2.5.0 → forefire-2.6.0}/src/PropagationModel.cpp +0 -0
  135. {forefire-2.5.0 → forefire-2.6.0}/src/PropagationModel.h +0 -0
  136. {forefire-2.5.0 → forefire-2.6.0}/src/PropagativeLayer.h +0 -0
  137. {forefire-2.5.0 → forefire-2.6.0}/src/RosLayer.h +0 -0
  138. {forefire-2.5.0 → forefire-2.6.0}/src/Simulator.cpp +0 -0
  139. {forefire-2.5.0 → forefire-2.6.0}/src/Simulator.h +0 -0
  140. {forefire-2.5.0 → forefire-2.6.0}/src/TimeGradientDataLayer.h +0 -0
  141. {forefire-2.5.0 → forefire-2.6.0}/src/TimeTable.h +0 -0
  142. {forefire-2.5.0 → forefire-2.6.0}/src/TwoTimeArrayLayer.h +0 -0
  143. {forefire-2.5.0 → forefire-2.6.0}/src/Visitable.h +0 -0
  144. {forefire-2.5.0 → forefire-2.6.0}/src/Visitor.h +0 -0
  145. {forefire-2.5.0 → forefire-2.6.0}/src/WeatherDataLayer.h +0 -0
  146. {forefire-2.5.0 → forefire-2.6.0}/src/colormap.h +0 -0
  147. {forefire-2.5.0 → forefire-2.6.0}/src/flux/FromObsModels.h +0 -0
  148. {forefire-2.5.0 → forefire-2.6.0}/src/include/FFConstants.h +0 -0
  149. {forefire-2.5.0 → forefire-2.6.0}/src/include/Futils.h +0 -0
  150. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/ANN.h +0 -0
  151. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/CurvatureDrivenPropagationModel.cpp +0 -0
  152. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/FarsitePropagationModel.cpp +0 -0
  153. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/FrontDepthDrivenPropagationModel.cpp +0 -0
  154. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/IsotropicFuelPropagationModel.cpp +0 -0
  155. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/IsotropicIsospeed.cpp +0 -0
  156. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/LavaPropagationModel.cpp +0 -0
  157. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/SamplePropagationModel.cpp +0 -0
  158. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/TroisPourcent.cpp +0 -0
  159. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/TroisPourcent.h +0 -0
  160. {forefire-2.5.0 → forefire-2.6.0}/src/propagation/WindDrivenPropagationModel.cpp +0 -0
  161. {forefire-2.5.0/src → forefire-2.6.0/third_party}/stb_image_write.h +0 -0
  162. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/000_ARCH/2MHGETECMWFBC +0 -0
  163. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/000_ARCH/FFMNH.yml +0 -0
  164. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/000_ARCH/GETECMWFBC +0 -0
  165. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/000_ARCH/JOBARCHIVE +0 -0
  166. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/001_pgd/MAKE_PGD +0 -0
  167. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/001_pgd/RUN_PGD +0 -0
  168. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/001_pgd/cleanDir +0 -0
  169. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/002_real/MAKE_PREAL +0 -0
  170. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/002_real/RUN_REAL +0 -0
  171. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/002_real/cleanDir +0 -0
  172. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/003_run/MAKE_RUN1 +0 -0
  173. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/003_run/RUN_MESONH_120p +0 -0
  174. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/003_run/cleanDir +0 -0
  175. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/004_SpawnReal/MAKE_SPAWNREAL +0 -0
  176. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/004_SpawnReal/RUN_SPAWN_REAL +0 -0
  177. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/004_SpawnReal/cleanDir +0 -0
  178. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/005_SpawnReal/MAKE_SPAWNREAL23 +0 -0
  179. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/005_SpawnReal/RUN_SPAWN_REAL +0 -0
  180. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/005_SpawnReal/cleanDir +0 -0
  181. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/ForeFire/Params.ff +0 -0
  182. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/ForeFire/fuels.ff +0 -0
  183. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/ForeFire/run.ff +0 -0
  184. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/MAKE_RUNFF +0 -0
  185. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/RUN_MNH_100p +0 -0
  186. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/cleanDir +0 -0
  187. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/sbatchRunVtkFilesM1 +0 -0
  188. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/sbatchRunVtkFilesM2 +0 -0
  189. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/006_runff/sbatchRunVtkFilesM3 +0 -0
  190. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/RESULTS/README.md +0 -0
  191. {forefire-2.5.0 → forefire-2.6.0}/tools/3nestFFCASE/makeRunFromTemplate +0 -0
  192. {forefire-2.5.0 → forefire-2.6.0}/tools/devops/increment-version.yml +0 -0
  193. {forefire-2.5.0 → forefire-2.6.0}/tools/increment-version.sh +0 -0
  194. {forefire-2.5.0 → forefire-2.6.0}/tools/makeColormapH.py +0 -0
  195. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/MNHCDF_to_FFNC_atmodataset.py +0 -0
  196. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/__init__.py +0 -0
  197. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/atmo_fire_plotsFrom.py +0 -0
  198. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/bmapToVTK.py +0 -0
  199. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/diag_arrays.py +0 -0
  200. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/extractSurfaceInXarray.py +0 -0
  201. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/genDomain.py +0 -0
  202. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/pMNHFF2VTK.py +0 -0
  203. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/pMNHFF2vdb.py +0 -0
  204. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/pMNHFF2vti.py +0 -0
  205. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/sciplots.py +0 -0
  206. {forefire-2.5.0 → forefire-2.6.0}/tools/postprocessing/sounding.py +0 -0
  207. {forefire-2.5.0 → forefire-2.6.0}/tools/preflight/verify-lfs.sh +0 -0
  208. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/PGD2Init.py +0 -0
  209. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/PRE_IDEA1.pattern +0 -0
  210. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/clickImageToLocation.py +0 -0
  211. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/extract_from_eu_land_cover.py +0 -0
  212. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/ffToGeoJson.py +0 -0
  213. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/fireObs2ATime.py +0 -0
  214. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/genPrepIdeal.py +0 -0
  215. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/geo_to_kml.py +0 -0
  216. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/getBGFromCFCase.py +0 -0
  217. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/indexRVB.html +0 -0
  218. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/kmlDomain.py +0 -0
  219. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/learnFuelTifPng.py +0 -0
  220. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/lidar2fuel.py +0 -0
  221. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/pngs2bmap.py +0 -0
  222. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/prealCF2Case.py +0 -0
  223. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/satImage2fuel.py +0 -0
  224. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/tifToPngFuel.py +0 -0
  225. {forefire-2.5.0 → forefire-2.6.0}/tools/preprocessing/upDirHDR.py +0 -0
  226. {forefire-2.5.0 → forefire-2.6.0}/tools/processing/plotFireFiles.py +0 -0
  227. {forefire-2.5.0 → forefire-2.6.0}/tools/processing/plotcontour.py +0 -0
  228. {forefire-2.5.0 → forefire-2.6.0}/tools/runANN/ANNTest.cpp +0 -0
  229. {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/altitude.png
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(DEFINED ENV{SRC_MESONH} AND DEFINED ENV{XYZ} AND DEFINED ENV{FF_STATIC})
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
- target_include_directories(forefire_netcdf INTERFACE ${NETCDF_CXX_INCLUDE_DIR} ${NETCDF_INCLUDE_DIR})
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
- add_executable(forefire app/forefire/ForeFire.cpp app/forefire/AdvancedLineEditor.cpp)
278
- target_link_libraries(forefire PRIVATE forefireL)
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
- install(TARGETS forefire RUNTIME DESTINATION bin)
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 the [Testing Documentation](https://forefire.readthedocs.io/en/latest/developer_guide/testing.html) *(Placeholder: Link to testing section once created)* for details on how to run tests. Ensure all tests pass locally.
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
- # Example command to run tests (adjust as needed)
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. **Commit Changes:**
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
- 8. **Push to Your Fork:**
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
- 9. **Open a Pull Request (PR):**
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.5.0
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