Irrigation Module

[stefanocasirati]

Overview:

• Adds new land BCs version (v13)
• Allows Irrigation on Catchment ("land") tiles

Repositories affected by updates:
GEOSgcm_GridComp, GEOSldas_GridComp

New Files:

• GEOSgcm_GridComp/GEOSagcm_GridComp/GEOSphysics_GridComp/GEOSsurface_GridComp/GEOSland_GridComp/GEOSirrigation_GridComp/GEOS_IrrigationGridComp.F90
• GEOSgcm_GridComp/GEOSagcm_GridComp/GEOSphysics_GridComp/GEOSsurface_GridComp/GEOSland_GridComp/GEOSirrigation_GridComp/irrigation_model.F90
• GEOSgcm_GridComp/GEOSagcm_GridComp/GEOSphysics_GridComp/GEOSsurface_GridComp/Utils/Raster/makebcs/module_irrig_params.F90

Brief description:
New land BCs version:
v13 : NL3 + JPL veg height + PEATMAP + MODIS snow alb v2 + Irrigation

The bcs generation package reads different irrigated area datasets and generates a new file "irrigation_IMxJM_DL.dat" containing, for each tile, a static: irrigation fraction, Paddy fraction, Rainfed fraction, crop irrigation fraction, crop irrigation type, crop planting and harvest dates, sprinkler fractions, drip fractions, flood fractions, and minimum and maximum LAI.

Irrigation module:
Adapted from: feature/SM_irrigation_model
The irrigation module computes irrigation rates by applying three different irrigation schemes: sprinkler, drip, and flood (furrow). Irrigation is triggered based on location, growing season (Implemented alternative options: LAI-based and Crop Calendar-based), and soil moisture.

New Output Variables: each variable is weighted based on the specific irrigated fractions:
SPRINKLERRATE: sprinkler_irrigation_rate (kg m-2 s-1)
DRIPRATE: drip_irrigation_rate (kg m-2 s-1)
FLOODRATE: flood_irrigation_rate (kg m-2 s-1)
IRRLAND: total irrigation rate (kg m-2 s-1) = SPRINKLERRATE + DRIPRATE + FLOODRATE

LDAS nightly test

Runtype	Clone	Build	Build Time	Model Run/Compare	Assim Run/Compare
-------	-----	-----	----------	-----------------	-----------------
conus	pass	pass	43 min	pass/pass	-- / --
global	--	--	--	pass/pass	pass/pass
globalcs	--	--	--	pass/pass	pass/pass
globalcnclm4	--	--	--	pass/pass	-- / --