| 1 |
import grass.script as gs |
| 2 |
from grass.gunittest.case import TestCase |
| 3 |
from grass.gunittest.main import test |
| 4 |
|
| 5 |
|
| 6 |
class TestEvaporativeFraction(TestCase): |
| 7 |
@classmethod |
| 8 |
def setUpClass(cls): |
| 9 |
"""Set the GRASS region and generate synthetic input rasters.""" |
| 10 |
cls.input_prefix = "input_" |
| 11 |
cls.runModule("g.region", n=10, s=0, e=10, w=0, res=1, flags="p") |
| 12 |
cls.runModule( |
| 13 |
"r.mapcalc", expression="input_netrad = 500 + row() * 10", overwrite=True |
| 14 |
) |
| 15 |
cls.runModule( |
| 16 |
"r.mapcalc", |
| 17 |
expression="input_soilheat = 0.1 * input_netrad", |
| 18 |
overwrite=True, |
| 19 |
) |
| 20 |
cls.runModule( |
| 21 |
"r.mapcalc", expression="input_sensible = 50 + row() * 2", overwrite=True |
| 22 |
) |
| 23 |
|
| 24 |
@classmethod |
| 25 |
def tearDownClass(cls): |
| 26 |
"""Remove all synthetic maps created.""" |
| 27 |
cls.runModule( |
| 28 |
"g.remove", |
| 29 |
type="raster", |
| 30 |
pattern="input_*,evapfr_*,soilmoist_*,netrad_*,sensible_*,*more,*less,*scaled", |
| 31 |
flags="f", |
| 32 |
) |
| 33 |
|
| 34 |
def compute_evapfr_output(self): |
| 35 |
"""Helper function to execute the module""" |
| 36 |
self.assertModule( |
| 37 |
"i.eb.evapfr", |
| 38 |
netradiation="input_netrad", |
| 39 |
soilheatflux="input_soilheat", |
| 40 |
sensibleheatflux="input_sensible", |
| 41 |
evaporativefraction="evapfr_output", |
| 42 |
overwrite=True, |
| 43 |
) |
| 44 |
|
| 45 |
def test_evapfr_stats(self): |
| 46 |
"""Test that evaporative fraction output matches expected statistics.""" |
| 47 |
self.compute_evapfr_output() |
| 48 |
self.assertRasterFitsUnivar( |
| 49 |
"evapfr_output", |
| 50 |
reference={ |
| 51 |
"min": 0.870370, |
| 52 |
"max": 0.886710, |
| 53 |
"mean": 0.878147, |
| 54 |
"stddev": 0.005210, |
| 55 |
}, |
| 56 |
precision=1e-6, |
| 57 |
) |
| 58 |
|
| 59 |
def test_m_flag(self): |
| 60 |
"""Test that -m flag generates soil moisture output.""" |
| 61 |
self.assertModule( |
| 62 |
"i.eb.evapfr", |
| 63 |
flags="m", |
| 64 |
netradiation="input_netrad", |
| 65 |
soilheatflux="input_soilheat", |
| 66 |
sensibleheatflux="input_sensible", |
| 67 |
evaporativefraction="evapfr_output", |
| 68 |
soilmoisture="soilmoist_output", |
| 69 |
overwrite=True, |
| 70 |
) |
| 71 |
|
| 72 |
self.assertRasterFitsUnivar( |
| 73 |
"soilmoist_output", |
| 74 |
reference={ |
| 75 |
"min": 0.733844, |
| 76 |
"max": 0.762865, |
| 77 |
"mean": 0.747573, |
| 78 |
"stddev": 0.009252, |
| 79 |
}, |
| 80 |
precision=1e-6, |
| 81 |
) |
| 82 |
|
| 83 |
def test_evapfr_decreases_with_increased_sensible_heat(self): |
| 84 |
"""Verify that increasing sensible heat results in lower evaporative fraction.""" |
| 85 |
self.compute_evapfr_output() |
| 86 |
self.runModule( |
| 87 |
"r.mapcalc", |
| 88 |
expression="sensible_high = input_sensible + 100", |
| 89 |
overwrite=True, |
| 90 |
) |
| 91 |
|
| 92 |
self.assertModule( |
| 93 |
"i.eb.evapfr", |
| 94 |
netradiation="input_netrad", |
| 95 |
soilheatflux="input_soilheat", |
| 96 |
sensibleheatflux="sensible_high", |
| 97 |
evaporativefraction="evapfr_less", |
| 98 |
overwrite=True, |
| 99 |
) |
| 100 |
|
| 101 |
stats_base = gs.parse_command("r.univar", map="evapfr_output", flags="g") |
| 102 |
stats_less = gs.parse_command("r.univar", map="evapfr_less", flags="g") |
| 103 |
self.assertGreater( |
| 104 |
stats_base["mean"], |
| 105 |
stats_less["mean"], |
| 106 |
msg="Evap. fraction did not decrease with increased sensible heat.", |
| 107 |
) |
| 108 |
|
| 109 |
def test_evapfr_increases_with_increased_net_radiation(self): |
| 110 |
"""Verify that increasing net radiation results in higher evaporative fraction.""" |
| 111 |
self.compute_evapfr_output() |
| 112 |
self.runModule( |
| 113 |
"r.mapcalc", expression="netrad_high = input_netrad + 100", overwrite=True |
| 114 |
) |
| 115 |
|
| 116 |
self.assertModule( |
| 117 |
"i.eb.evapfr", |
| 118 |
netradiation="netrad_high", |
| 119 |
soilheatflux="input_soilheat", |
| 120 |
sensibleheatflux="input_sensible", |
| 121 |
evaporativefraction="evapfr_more", |
| 122 |
overwrite=True, |
| 123 |
) |
| 124 |
|
| 125 |
stats_base = gs.parse_command("r.univar", map="evapfr_output", flags="g") |
| 126 |
stats_more = gs.parse_command("r.univar", map="evapfr_more", flags="g") |
| 127 |
self.assertGreater( |
| 128 |
stats_more["mean"], |
| 129 |
stats_base["mean"], |
| 130 |
msg="Evap. fraction did not increase with increased net radiation.", |
| 131 |
) |
| 132 |
|
| 133 |
def test_evapfr_invariance_to_linear_energy_scaling(self): |
| 134 |
"""Ensure that linearly scaling all energy flux inputs does not affect evaporative fraction.""" |
| 135 |
self.compute_evapfr_output() |
| 136 |
self.runModule( |
| 137 |
"r.mapcalc", expression="netrad_scaled = 2 * input_netrad", overwrite=True |
| 138 |
) |
| 139 |
self.runModule( |
| 140 |
"r.mapcalc", |
| 141 |
expression="soilheat_scaled = 2 * input_soilheat", |
| 142 |
overwrite=True, |
| 143 |
) |
| 144 |
self.runModule( |
| 145 |
"r.mapcalc", |
| 146 |
expression="sensible_scaled = 2 * input_sensible", |
| 147 |
overwrite=True, |
| 148 |
) |
| 149 |
|
| 150 |
self.assertModule( |
| 151 |
"i.eb.evapfr", |
| 152 |
netradiation="netrad_scaled", |
| 153 |
soilheatflux="soilheat_scaled", |
| 154 |
sensibleheatflux="sensible_scaled", |
| 155 |
evaporativefraction="evapfr_scaled", |
| 156 |
overwrite=True, |
| 157 |
) |
| 158 |
|
| 159 |
stats_base = gs.parse_command("r.univar", map="evapfr_output", flags="g") |
| 160 |
stats_scaled = gs.parse_command("r.univar", map="evapfr_scaled", flags="g") |
| 161 |
self.assertAlmostEqual( |
| 162 |
stats_base["mean"], |
| 163 |
stats_scaled["mean"], |
| 164 |
places=6, |
| 165 |
msg="Linearly scaled inputs changed evaporative fraction.", |
| 166 |
) |
| 167 |
|
| 168 |
|
| 169 |
if __name__ == "__main__": |
| 170 |
test() |