Repository navigation
Description
genForeFireCase.py builds the landscape file, without which ForeFire runs only on the shipped example. Users hit this about twenty minutes after the Docker demo works.
Documented in four places, present in none
git ls-files | grep genForeFireCase returns nothing, while these describe it:
docs/source/user_guide/landscape_file.rst:84tools/README.md:12,20,62— documentsFiretoNC()argument by argumenttools/preprocessing/READMEscripts.mddocs/_legacy/UserGuide/ForeFireGeneralUsage.tex:170
It was removed in ac0baba ("clean more post-processing", Dec 2023).
It is recoverable and still works, with three fixes
I pulled it back with git show ac0baba^:tools/preprocessing/genForeFireCase.py and ran it. A 100×100 landscape loads, ignites and steps:
variables: ['fuel', 'altitude', 'windU', 'windV', 'domain', 'parameters']
LOADED OK
SIMULATED OK
But it is not a clean revert.
1. The 3-D and 4-D paths are broken. addFieldToNcFile reads the input shape as (NY, NX, NZ, NT):
ncfile.createDimension('%sNX'%fieldname, sp[1])
ncfile.createDimension('%sNY'%fieldname, sp[0])
ncfile.createDimension('%sNZ'%fieldname, sp[2])
ncfile.createDimension('%sNT'%fieldname, sp[3])
variable = ncfile.createVariable(fieldname, dvartype, ('NT','NZ','NY','NX'))
variable[:,:,:,:] = fieldthen creates the variable with the axes in the opposite order and assigns without transposing. That only succeeds when NY == NT and NX == NZ. A 4-D field fails:
ValueError: could not broadcast input array from shape (1,1,100,100) into shape (100,100,1,1)
Only the 2-D path is correct — and time-varying wind is exactly what a 4-D field is for.
2. scipy.io.netcdf is deprecated, emitting DeprecationWarning: … will be removed in SciPy 2.0.0. One-line fix to netcdf_file, or better netCDF4, which the project already depends on for testing.
3. parametersProperties has seven undocumented required keys. Omitting any of date, duration, refYear, refDay, year, month, day raises a bare KeyError after the file is partially written. tools/README.md calls this argument "the other optional properties you may want to put in the list" — it is not optional.
Suggested fix
Restore the file to tools/preprocessing/, fix the axis order, move off the deprecated import, document or default the required keys, add a smoke test (the sequence above is already one), then correct the four documents. Roughly half a day.
The alternative — deleting every mention — is much cheaper but leaves users with no way to build a case at all.
Drafted by Claude Opus 5 from a codebase audit. Reviewed by a maintainer before filing.
EDIT: rewrote for human readability.
Activity
fix(tools): restore genForeFireCase.py, with the axis order fixed
HugoFara commentedon Aug 12, 2026
Correction to this issue: the removal was deliberate, and the wording above implies otherwise.
Two months apart, consumer first. The function was inlined where it was used and the standalone file was then removed as dead code. That is ordinary de-duplication, not an oversight, and any restoration is a reversal of it rather than a repair.
What has changed since is that
prealCF2Case.py's copy diverged. It now sets thedomainandparametersattributes by iterating the dicts with no required-key check, writes elevation asf4, and writes wind as a single combinedwindvariable in a potential-field form with thewindU/windVcalls commented out above it. It is the back half of the Meso-NH PGD pipeline and needs a PGD file to run.So the gap this issue describes is real — there is no general-purpose landscape writer, while four documents describe one — but the fix is a decision, not a correction. #179 proposes restoring the general writer and is left as a draft for that reason. Deleting the four references instead is cheaper and respects
ac0babamore directly; it just leaves a new user with no way to build a case.antonio-leblanc commentedon Aug 18, 2026
ok merged to dev
Dev to master -> v2.6.0 (#224)