Skip to content

Commit 9032c3d

Browse files
Add full land variable set for model vs model comparison (#1007)
* add support to full set requested 2d land vars * add auxilary files * remove contour_levels with duplicated all zeros/near-zeros * add run script
1 parent 794d10b commit 9032c3d

File tree

5 files changed

+6399
-96
lines changed

5 files changed

+6399
-96
lines changed
Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
COMPREHENSIVE UNIT CONVERSION REFERENCE FOR ELM VARIABLES IN LAT_LON MAPS
2+
==========================================================================
3+
4+
BASED ON EXISTING E3SM_DIAGS DERIVATIONS AND CSV ANALYSIS
5+
6+
=== CARBON FLUX VARIABLES ===
7+
Original Units: gC/m²/s, kgC/m²/s
8+
Conversion Factor: 86400 (seconds per day)
9+
Target Units: gC/m²/day, kgC/m²/day
10+
Derivation: convert_units(target_units="g*/m^2/day")
11+
12+
Variables in original config using this pattern:
13+
- GPP: gC/m²/s -> gC/m²/day
14+
- HR: gC/m²/s -> gC/m²/day
15+
- NBP: gC/m²/s -> gC/m²/day
16+
- NPP: gC/m²/s -> gC/m²/day
17+
18+
Variables from CSV needing this pattern (currently using 3.15360E-02):
19+
- GPP, HR, NBP, NPP (apply to config variables too for consistency)
20+
- All other gC/m²/s variables in CSV: AR, ER, AGNPP, BGNPP, CH4PROD, etc.
21+
22+
=== CARBON STOCK VARIABLES ===
23+
Original Units: gC/m²
24+
Conversion Factor: 1.00000E-09 (gC/m² -> PgC in CSV) OR 1/1000 (gC/m² -> kgC/m² in derivations)
25+
Target Units: kgC/m² (for spatial maps)
26+
Derivation: convert_units(target_units="kgC/m^2")
27+
28+
Variables in original config using this pattern:
29+
- TOTVEGC: gC/m² -> kgC/m²
30+
- TOTSOMC: gC/m² -> kgC/m²
31+
- CPOOL: gC/m² -> kgC/m²
32+
- LEAFC: gC/m² -> kgC/m²
33+
34+
Variables from CSV needing this pattern:
35+
- CPOOL, LEAFC, TOTSOMC, TOTVEGC (use derivations conversion, not CSV 1.00000E-09)
36+
- Other carbon stock variables with scale factor 1.00000E-09
37+
38+
=== NITROGEN FLUX VARIABLES ===
39+
Original Units: gN/m²/s
40+
CSV Factor: 3.15360E+01 (includes area integration gN/m²/s -> TgN/yr)
41+
Proper lat_lon Factor: 86400 (seconds per day only)
42+
Target Units: gN/m²/day (or mgN/m²/day with factor 86400*1000)
43+
44+
Variables from CSV needing this pattern:
45+
- DENIT, GROSS_NMIN, NDEP_TO_SMINN, NFIX_TO_SMINN, SMINN_TO_PLANT
46+
47+
=== NITROGEN STOCK VARIABLES ===
48+
Original Units: gN/m²
49+
CSV Factor: 1.00000E-06 (gN/m² -> TgN includes area integration)
50+
Proper lat_lon Factor: 1.0 (no conversion needed)
51+
Target Units: gN/m² (or mgN/m² with factor 1000)
52+
53+
Variables from CSV needing this pattern:
54+
- SMINN
55+
56+
=== PHOSPHORUS FLUX VARIABLES ===
57+
Original Units: gP/m²/s
58+
CSV Factor: 3.15360E+01 (includes area integration gP/m²/s -> TgP/yr)
59+
Proper lat_lon Factor: 86400 (seconds per day only)
60+
Target Units: gP/m²/day (or mgP/m²/day with factor 86400*1000)
61+
62+
Variables from CSV needing this pattern:
63+
- GROSS_PMIN, SMINP_TO_PLANT
64+
65+
=== PHOSPHORUS STOCK VARIABLES ===
66+
Original Units: gP/m²
67+
CSV Factor: 1.00000E-06 (gP/m² -> TgP includes area integration)
68+
Proper lat_lon Factor: 1.0 (no conversion needed)
69+
Target Units: gP/m² (or mgP/m² with factor 1000)
70+
71+
Variables from CSV needing this pattern:
72+
- SMINP
73+
74+
=== WATER FLUX VARIABLES ===
75+
Original Units: kg/m²/s
76+
Existing Derivation: qflxconvert_units() -> mm/day (factor: 86400)
77+
Target Units: mm/day
78+
79+
Variables in original config using this pattern:
80+
- QRUNOFF: kg/m²/s -> mm/day
81+
82+
=== NO CONVERSION VARIABLES ===
83+
Variables that keep original units:
84+
- Temperature (K), fractions (unitless), rates already in daily units
85+
- Most CSV variables with scale factor 1.00000E+00
86+
87+
=== SUMMARY FOR CSV VARIABLE PROCESSING ===
88+
89+
1. Variables with CSV scale factor 3.15360E-02 (gC/m²/s to PgC/yr):
90+
-> Use factor 86400 for lat_lon maps (gC/m²/s to gC/m²/day)
91+
92+
2. Variables with CSV scale factor 3.15360E+01 (gN or gP per m²/s to Tg/yr):
93+
-> Use factor 86400 for lat_lon maps (g*/m²/s to g*/m²/day)
94+
95+
3. Variables with CSV scale factor 1.00000E-09 (gC/m² to PgC):
96+
-> Use factor 1/1000 for lat_lon maps (gC/m² to kgC/m²)
97+
98+
4. Variables with CSV scale factor 1.00000E-06 (gN or gP per m² to Tg):
99+
-> Use factor 1.0 for lat_lon maps (keep g*/m²)
100+
101+
5. Variables with CSV scale factor 1.00000E+00:
102+
-> Use factor 1.0 (no conversion needed)

0 commit comments

Comments
 (0)