Skip to content

VersionUpdate.md

Latest commit

 

History

History
55 lines (40 loc) · 3.1 KB

VersionUpdate.md

File metadata and controls

55 lines (40 loc) · 3.1 KB

Simulator of Hydrologic Unstructured Domains (SHUD)

Relation with PIHM family

SHUD v1.0 (2019.12)

MODIFICATIONS/ADDITIONS in SHUD V1.0 from previous PIHM family.

  1. Change the language and structure of code from C to C++.
  2. Update the CVODE from v2.2 to v5.0.
  3. Support OpenMP Parrallel computing.
  4. Change the input/output format. Check the Manual of SHUD on github.
  5. Change the structure of River.
  6. The functions to handle the time-series data, including forcing, LAI, Roughness Length, Boundary Condition, Melting factor.
  7. Lake Module is added into the hydrological process.

SHUD v2.0 (2022.04)

MODIFICATIONS/ADDITIONS from v1.0

  1. Update to SUNDIALS 6.x
  2. The units of forcing input.
    1. Forcing data: Precipitation (mm/day), Temperature (C), Windspeed (m/s), Radiation (w/m2), Relative Humidity (0~1), Pressure (kPa).
    2. Landcover parameters: Rough (Manning's Roughness) from [day m^{1/3}] to [s m^{1/3}].
    3. River parameters: Rough (Manning's Roughness) from [day m^{1/3}] to [s m^{1/3}].
  3. Add the Bucket Lake model. Water balance of a lake is: $ ds/dt = P + Q_surf + Q_sub + R_in - R_out - E $
  4. Change of the names of inputfile .sp.rivseg(v2.0), instead of .sp.rivchn (v1.0)
  5. The calculation of ET, particularly the Potential Evapotranspiration from Pennman-Monteith Equation.
  6. More calibration parameters are open now. Total number is 38 or more.
  7. Format of files:
    1. The number of columns of .sp.att file to 9 columns, that is "INDEX SOIL GEOL LC FORC MF BC SS iLake"
    2. Three table exist in the .sp.riv file: ggggRiver, parameter, points. Head of three tables are: River(Index Down Type Slope Length BC), Parameters(Index Depth BankSlope Width Sinuosity Manning Cwr KsatH BedThick), Points(From.x From.y From.z To.x To.y To.z)
    3. Change of the .cfg.ic file format, since the initial condition for lake stage is added. Three table (v2.0) (element, river reach and lake) exist within the file, instead of two tables (v1.0).
  8. Temporary permafrost parameterization scheme is added; yet, the testing and validation is on the track.
  9. Temperature decreases as elevation increases, dT/dz = 0.00065 Adiabatic Lapse Rate 6.5 [$K/km$]
  10. Lots of bugs are fixed.

SHUD v2.1 (2025.01)

MODIFICATIONS/ADDITIONS from v2.0

  1. Add Terrain Solar Radiation (TSR) module to correct shortwave radiation based on slope and aspect.
  2. New configuration parameters: TERRAIN_RADIATION, RAD_FACTOR_CAP, RAD_COSZ_MIN, RADIATION_INPUT_MODE, SOLAR_LONLAT_MODE, TSR_INTEGRATION_STEP_MIN.
    • Note: SOLAR_UPDATE_INTERVAL is deprecated and treated as TSR_INTEGRATION_STEP_MIN for backward compatibility.
  3. New diagnostic outputs when TSR enabled: *.rn_h.dat (horizontal radiation), *.rn_t.dat (terrain-corrected radiation), *.rn_factor.dat (TSR factor).
  4. Enhanced binary output file header with metadata (radiation mode, TSR status, solar coordinates).
  5. Add validation framework in validation/tsr/ with Python dat reader and unit tests.
  6. Add post-processing tools in post_analysis/ for TSR effect comparison.

See docs/TSR_Technical_Reference.md for detailed documentation.