Add project setup CLI script

[dbetchkal]

Closes #35. Closes #69. Intended to replace NMSIM_CreateBaseLayers.ipynb and to further escape the need for an ArcGIS Pro license.

• Flexible ingestion of the two contextual inputs to NPS-ActiveSpace (study area + listening location). will add later
• Initialize a standard NMSIM site directory given inputs from config file.
• Automatically clip, convert units and save .tif DEM output for downstream modules.
• Save ESRI GridFloat format (.flt, .hdr) for modeling.
• Save NMSIM .sit file to represent the listening location.
• Update script usage README appropriately.

[elliott-ruebush]

Edit: apologies if this PR wasn't ready for review - I missed that it was still marked as a draft

Nice! This'll be sweet to get in the repo rather than needing that separate ArcGIS workflow.

I've left some comments with questions/potential suggestions, lmk if you want to chat more on anything

[arpitjain099]

Nice addition - having a setup script that handles directory creation + DEM clipping + site file in one step will save a lot of manual work.

A couple things I noticed:

1. The new make_NMSIM_site_dir() and create_NMSIM_site_file() use Windows-style backslash paths (e.g. r"Input_Data\01_ELEVATION", r"Input_Data\05_SITES"). Since the codebase is moving toward cross-platform support, these could use os.path.join("Input_Data", "01_ELEVATION") etc. Same for output_base in project_setup.py.

2. The coords_to_utm() return type changes from str to tuple[str, int] here, which is a good change (callers often need the zone number). Worth noting that PR #84 also touches coords_to_utm() callers, so there will be a merge conflict between the two. Happy to rebase #84 once this lands, or we can coordinate.

3. Small typo in scripts/README.md: "Fundemental" should be "Fundamental".

4. Missing newline at end of helpers.py.

[elliott-ruebush]

Will plan to take another look a little later today!

…

On Thu, Jul 9, 2026 at 12:37 PM D.Halyn Betchkal ***@***.***> wrote: @dbetchkal <https://github.com/dbetchkal> requested your review on: dbetchkal/NPS-ActiveSpace#75 <#75> Add project setup CLI script. — Reply to this email directly, view it on GitHub <#75?email_source=notifications&email_token=AFP7WUG42EQ3NEG7GY5SZ735D7C5BA5CNFSNUABQM5UWIORPF5TWS5BNNB2WEL2JONZXKZKFOZSW45CON52GSZTJMNQXI2LPNYXTENZXG42TIOJQHEYTTJTSMVQXG33OWBZGK5TJMV3V64TFOF2WK43UMVSKKZLWMVXHJLDGN5XXIZLSL5RWY2LDNM#event-27775490919>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AFP7WUEWSZZTISCSANSG7VD5D7C5BAVCNFSNUABFKJSXA33TNF2G64TZHMZTQOJXG42TKMRXHNEXG43VMU5TINZXGA4DSOBXGQZKC5QC> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/AFP7WUFIZ5QEIVXD2OO3QJL5D7C5BA5CNFSNUABQM5UWIORPF5TWS5BNNB2WEL2JONZXKZKFOZSW45CON52GSZTJMNQXI2LPNYXTENZXG42TIOJQHEYTTJTSMVQXG33OWBZGK5TJMV3V64TFOF2WK43UMVSKKZLWMVXHJKTGN5XXIZLSL5UW64Y> and Android <https://github.com/notifications/mobile/android/AFP7WUAE2SXTOIRYBBC4A4D5D7C5BA5CNFSNUABQM5UWIORPF5TWS5BNNB2WEL2JONZXKZKFOZSW45CON52GSZTJMNQXI2LPNYXTENZXG42TIOJQHEYTTJTSMVQXG33OWBZGK5TJMV3V64TFOF2WK43UMVSKKZLWMVXHJLTGN5XXIZLSL5QW4ZDSN5UWI>. Download it today! You are receiving this because your review was requested.Message ID: ***@***.***>

[elliott-ruebush]

I missed commenting on this on first pass, but I was looking some more and wanted to raise the point that some of these setup functions are seemingly duplicated between here and ActiveSpaceGenerator https://github.com/dbetchkal/NPS-ActiveSpace/blob/main/nps_active_space/active_space/active_space_generator.py

project_setup.py	ActiveSpaceGenerator
create_NMSIM_site_dir()	_make_dir_tree()
create_NMSIM_site_file()	_create_site_file()
create_gridfloat()	_create_dem_flt()
create_NMSIM_elevation_tif()	_mask_dem_file() (+ project_raster() in computation.py)

So it seems that there's some repetition of function defintions across the two.

IMO the correct place for this to live might be project setup scripts, so maybe we move forward with merging this PR and then move the logic out of active space generator in a follow-up

[arpitjain099]

Good catch on the duplication @elliott-ruebush. I ran into the same thing when reviewing - the DEM clipping and site file creation logic in ActiveSpaceGenerator does roughly the same work as what's here. Merging this first and then pulling the shared logic into one place sounds like the right order to me. Would keep this PR's scope clean and avoid a messy rebase.

[elliott-ruebush]

No change needed on this PR.

One other minor [nit], I think that it's nice to define constants like these as all caps global vars at the top of the files. e.g. FEET_TO_METERS = 0.3048

I have a later change which will add a few general constants, so I'll take a quick pass at updating this then. Something like FEET_TO_METERs in particular feels like it could live somewhere central.