SWATGenX I/O reference

File-level reference for what a SWATGenX package contains and how the SWATGenX engine extensions read and write it. Stock SWAT+ input files are documented upstream; this reference covers only SWATGenX deltas and extensions.

/

Contents

1.Model bundle structureDirectory tree of a generated bundle and the sidecar metadata files.
2.SWAT+ input filesPatches applied to the stock QSWAT+ / SWAT+ Editor TxtInOut; stock semantics are documented upstream.
3.PFAS fate and transportpfas.dat, pfas_hru.ini, pfas_cha.dat, pfas_calib.dat, and the output and mass-balance files.
4.Engine I/O and run modesRun modes, print_filter.prt channel filtering, and NetCDF (cdfout) output.
5.Compile the SWAT+ forkClone the fork, ifx + NetCDF-Fortran prerequisites, CMake NetCDF/OpenMP build, and install into TxtInOut.
6.MODFLOW couplingOne-way steady-state MODFLOW 6 package and the research daily BMI/XMI coupling files.
7.Calibration artifactscal_parms control file, channel_sd_day.nc, streamflow_data/, and MMPSO outputs.
8.Python packageThe swatgenx PyPI client: public data functions, authenticated ordering and download.
Appendix — service limitsSize, storage, concurrency, and coverage limits as engineering constants.

A SWATGenX model bundle is a standard SWAT+ project plus a defined set of additions: sidecar metadata, optional PFAS fate-and-transport inputs, engine output-filtering and NetCDF controls, an optional sibling MODFLOW 6 package, research-grade daily coupling files, and calibration artifacts. Each chapter documents one subsystem: purpose, field-by-field schemas with types and units, and the reader/writer code that defines each file. The compile chapter covers cloning and building the SWAT+ fork that reads those extensions.

Link-out policy for stock SWAT+ files

Stock SWAT+ input/output files (file.cio, hru.hru, channel.cha, soils.sol, time.sim, plant.ini, …) are read and written by the upstream SWAT+ code and documented in the official SWAT+ I/O documentation. This reference does not duplicate that material. Where SWATGenX modifies a stock file (print.prt patches, recall handling, Editor/QSWAT+ version pinning), only the delta is documented here — see the SWAT+ input files chapter. Official stock-build docs for upstream SWAT+ stay upstream; the fork compile procedure is documented here.

SWAT+ I/O documentation (official)

Every schema in this reference is transcribed from the engine readers/writers (Fortran) or the generator scripts (Python) that produce the files. When engine code and this reference disagree, the code is authoritative — report the discrepancy.