Skip to content

Add file.cio and soft calibration file reference documentation#152

Draft
Copilot wants to merge 3 commits intoNAM_BRANCH_MAINfrom
copilot/discuss-soft-cal-files
Draft

Add file.cio and soft calibration file reference documentation#152
Copilot wants to merge 3 commits intoNAM_BRANCH_MAINfrom
copilot/discuss-soft-cal-files

Conversation

Copy link
Copy Markdown

Copilot AI commented Mar 26, 2026

Users needed guidance on the SWAT+ input file system — specifically what each position in file.cio controls and how the soft calibration (.sft) files work.

New docs

doc/file_cio.md — Master input file reference

Complete positional reference for all 30 data lines in file.cio, derived from src/readcio_read.f90 and src/input_file_module.f90:

  • Every section (simulation, basin, climate, connect, ..., chg, regions, path lines) with a per-position table of default filename + description
  • "What to change" callout per section (which positions are safe to null, which are required)
  • Annotated real example (Osu_1hru/file.cio)
  • Quick-reference table mapping common goals (enable reservoirs, hard/soft calibration, salt module, etc.) to the specific section and change needed

doc/soft_cal_files.md — Soft calibration file reference

Documents the full .sft file family (formerly .cal):

  • codes.sft — activation flags including HYD_HRU = a/b/n/y semantics
  • water_balance.sft — landscape water balance targets; documents the HYD_HRU = b internal conversion (SRR = WYR × (1 − BFR))
  • wb_parms.sft, ch_sed_budget.sft, ch_sed_parms.sft, plant_gro.sft, plant_parms.sft — formats and field descriptions
  • Calibration iteration workflow and output files (hru-new.cal, hru-out.cal)

README

Added links to both docs under Documentation and References.


⚡ Quickly spin up Copilot coding agent tasks from anywhere on your macOS or Windows machine with Raycast.

Copilot AI changed the title [WIP] Discuss functionality and features of soft.cal files Add documentation for SWAT+ soft calibration files (.sft / soft.cal) Mar 26, 2026
Copilot AI requested a review from tugraskan March 26, 2026 15:47
Copilot AI changed the title Add documentation for SWAT+ soft calibration files (.sft / soft.cal) Add file.cio and soft calibration file reference documentation Mar 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants