Skip to content

Installation#

Prerequisites#

Pixi handles all other dependencies including Python, and compiling SFINCS and SCHISM from source. No containers are required.

Install#

git clone https://github.com/NGWPC/nwm-coastal
cd nwm-coastal
pixi install -e dev

The first activation compiles both SFINCS and SCHISM from source (they are included as git submodules). Subsequent activations skip the build if dependencies have not changed.

Running Commands#

All commands must be run through Pixi to activate the environment:

pixi r -e dev coastal-calibration --help

You should see the CLI help output:

Usage: coastal-calibration [OPTIONS] COMMAND [ARGS]...

  Coastal calibration workflow manager (SCHISM, SFINCS).

Commands:
  create             Create a SFINCS model from an AOI polygon.
  init               Create a minimal configuration file.
  prepare-topobathy  Download NWS topobathy DEM clipped to an AOI bounding box.
  run                Run the calibration workflow.
  stages             List available workflow stages.
  update-dem-index   Rebuild the NOAA DEM spatial index from S3 STAC metadata.
  validate           Validate a configuration file.

Available Environments#

Environment Description Command
dev Every binary and dev tool pixi r -e dev <cmd>
test311 CI matrix on Python 3.11 pixi r -e test311 test
test313 CI matrix on Python 3.13 pixi r -e test313 test
typecheck Type checking pixi r -e typecheck typecheck
lint Linting with pre-commit pixi r lint
docs Documentation building pixi r -e docs docs-serve

dev installs every binary (SCHISM, SFINCS, predict_tide) and every Python dependency needed to develop, test, and run the package. The test311 / test313 envs mirror it for the CI Python-version matrix.

QGIS Plugin#

The repository includes a QGIS plugin for interactive domain definition. See the QGIS Plugin guide for installation and usage instructions.