Skip to content

Commit be35e22

Browse files
kasra-keshavarzkasra-keshavarz
authored
CaSR3.2 recipes (#93)
CaSRv3.2 recipe added
1 parent e808f5a commit be35e22

File tree

6 files changed

+213
-5
lines changed

6 files changed

+213
-5
lines changed

‎docs/datasets.rst‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,9 @@ The following table lists available datasets, their DOI, and provides links to s
4040
+----+------------------------------+--------------------------------------------------------------------------------------+
4141
| 11 | NASA NEX-GDDP-CMIP6 | 10.1038/s41597-022-01393-4 |
4242
+----+------------------------------+--------------------------------------------------------------------------------------+
43-
| 12 | ECCC CaSRv3.1 (aka RDRS) | 10.1038/s41597-022-01393-4 (Same as RDRS) |
43+
| 12 | ECCC CaSRv3.1 (aka RDRS) | TBD |
44+
+----+------------------------------+--------------------------------------------------------------------------------------+
45+
| 13 | ECCC CaSRv3.2 (aka RDRS) | TBD |
4446
+----+------------------------------+--------------------------------------------------------------------------------------+
4547

4648
.. [#f1] For access to the files on the Graham cluster, please contact `Stephen O'Hearn <mailto:[email protected]>`_.
@@ -60,7 +62,8 @@ Detailed Descriptions
6062
scripts/ccrn-canrcm4_wfdei_gem_capa.rst
6163
scripts/ccrn-wfdei_gem_capa.rst
6264
scripts/eccc-rdrs.rst
63-
scripts/eccc-casr.rst
65+
scripts/eccc-casr31.rst
66+
scripts/eccc-casr32.rst
6467
scripts/ecmwf-era5.rst
6568
scripts/gwf-ncar-conus_i.rst
6669
scripts/gwf-ncar-conus_ii.rst

‎docs/scripts/eccc-casr.rst‎ renamed to ‎docs/scripts/eccc-casr31.rst‎

File renamed without changes.

‎docs/scripts/eccc-casr32.rst‎

Lines changed: 204 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,204 @@
1+
ECCC ``CaSR`` v3.2
2+
==================
3+
4+
In this file, the details of the dataset is explained.
5+
6+
Location of Dataset Files
7+
-------------------------
8+
9+
The ``CaSR`` v3.2 dataset is located under the following directories
10+
accessible from multiple clusters listed below:
11+
12+
.. code:: console
13+
14+
# DRAC Nibi (formerly Graham) cluster
15+
/project/def-kshook/Climate_Forcing_Data/meteorological-data/casrv3.2 # def-kshook allocation
16+
17+
# DRAC Fir cluster
18+
/project/rrg-alpie/data/meteorological-data/casrv3.2 # rrg-alpie allocation
19+
20+
# UCalgary ARC cluster
21+
/work/comphyd_lab/data/meteorological-data/casrv3.2 # comphyd_lab allocation
22+
23+
and the structure of the dataset hourly files is as following:
24+
25+
.. code:: console
26+
27+
/project/def-kshook/Climate_Forcing_Data/meteorological-data/casrv3.2
28+
├── 1979123112.nc
29+
├── 1980010112.nc
30+
├── 1980010212.nc
31+
├── 1980010312.nc
32+
├── .
33+
├── .
34+
├── .
35+
├── %Y010112.nc
36+
├── .
37+
├── .
38+
├── %Y%m%d12.nc
39+
├── .
40+
├── .
41+
├── %Y123112.nc
42+
├── 2024010112.nc
43+
├── .
44+
├── .
45+
├── .
46+
└── 2024123012.nc
47+
48+
Coordinate Variables and Time-stamps
49+
------------------------------------
50+
51+
Coordinate Variables
52+
~~~~~~~~~~~~~~~~~~~~
53+
54+
The coordinate variables of the ``CaSRv3.2`` simulations are ``lon`` and
55+
``lat`` representing the longitude and latitude data, respectively.
56+
57+
Variable Time-stamps
58+
--------------------
59+
60+
Time-stamps The time-stamps are included in the original files.
61+
62+
Dataset Variables
63+
-----------------
64+
65+
The NetCDF files of the dataset contain 38 variables. You may see a list
66+
of variables by using the ``ncdump -h`` command on one of the files:
67+
68+
.. code:: console
69+
70+
foo@bar:~$ ncdump -h /path/to/dataset/files/casrv3.2/2018010112.nc
71+
72+
Spatial Extent
73+
--------------
74+
75+
The spatial extent of the ``CaSR`` v3.2 is on latitudes from ``+7.75``
76+
to ``+84.75`` and longitudes from ``-179.9925`` to ``179.9728`` covering
77+
North America. The resolution is 0.09 degrees (~10km).
78+
79+
Temporal Extent
80+
---------------
81+
82+
The time-steps are hourly covering from ``January 1980`` to
83+
``December 2024``.
84+
85+
Short Description on ``CaSR`` v3.2 Variables
86+
--------------------------------------------
87+
88+
In most hydrological modelling applications, usually 7 variables are
89+
needed detailed as following: 1) specific humidity, 2) surface pressure,
90+
3) air temperature, 4) wind speed, 5) precipitation (surface level), 6)
91+
downward short wave radiation (surface level), and 7) downward long wave
92+
radiation (surface level). These variables are available through
93+
``CaSR`` v3.2 dataset and their details are described in the table
94+
below:
95+
96+
.. list-table:: Variable Mapping
97+
:widths: 30 30 10 30
98+
:header-rows: 1
99+
100+
* - Variable Name
101+
- CaSRv3.2 Variable
102+
- Unit
103+
- Comments
104+
* - surface pressure
105+
- CaSR_v3.2_P_P0_SFC
106+
- ``mb``
107+
-
108+
* - air temperature @20m
109+
- CaSR_v3.2_P_TT_09975
110+
- ``°C``
111+
-
112+
* - air temperature @1.5m
113+
- CaSR_v3.2_P_TT_1.5m
114+
- ``°C``
115+
-
116+
* - wind speed U-component @20m
117+
- CaSR_v3.2_P_UUC_09975
118+
- ``kts``
119+
- Corrected U-component along West-East direction at ~20m
120+
* - wind speed U-component @10m
121+
- CaSR_v3.2_P_UUC_10m
122+
- ``kts``
123+
- Corrected U-component along West-East direction at ~10m
124+
* - wind speed V-component @20m
125+
- CaSR_v3.2_P_VVC_09975
126+
- ``kts``
127+
- Corrected V-component along South-North direction at ~20m
128+
* - wind speed V-component @10m
129+
- CaSR_v3.2_P_VVC_10m
130+
- ``kts``
131+
- Corrected V-component along South-North direction at ~10m
132+
* - wind modulus @20m
133+
- CaSR_v3.2_P_UVC_09975
134+
- ``kts``
135+
- Forecast: Wind Modulus (derived using UU and VV) at 20m
136+
* - wind modulus @10m
137+
- CaSR_v3.2_P_UVC_10m
138+
- ``kts``
139+
- Forecast: Wind Modulus (derived using UU and VV) at 10m
140+
* - precipitation
141+
- CaSR_v3.2_A_PR0_SFC
142+
- ``m/hr``
143+
- Analysis: Quantity of precipitation (CaPA 24h disaggregated hourly) at surface
144+
* - short wave radiation
145+
- CaSR_v3.2_P_FB_SFC
146+
- ``W m-2``
147+
- Downward solar flux at the surface
148+
* - long wave radiation
149+
- CaSR_v3.2_P_FI_SFC
150+
- ``W m-2``
151+
- Downward infrared flux at the surface
152+
* - specific humidity @20m
153+
- CaSR_v3.2_P_HU_09975
154+
- 1
155+
- Specific humidity at ~20m (0.997502 hy)
156+
* - specific humidity @1.5m
157+
- CaSR_v3.2_P_HU_1.5m
158+
- 1
159+
- Specific humidity at ~1.50m
160+
161+
Other useful variables in hydrological modelling evaluations are:
162+
163+
.. list-table:: Snow and Precipitation Variables
164+
:widths: 35 30 10 25
165+
:header-rows: 1
166+
167+
* - Variable Name
168+
- CaSRv3.2 Variable
169+
- Unit
170+
- Comments
171+
* - Water equivalent of snow cover
172+
- CaSR_v3.2_P_SWE_LAND
173+
- ``kg m-2``
174+
- Water equivalent of snow cover at land surface subgrid tile
175+
* - Snow depth
176+
- CaSR_v3.2_P_SD_LAND
177+
- ``cm``
178+
- Snow depth at land surface subgrid tile
179+
* - Freezing precipitation
180+
- CaSR_v3.2_P_FR0_SFC
181+
- ``m``
182+
- Quantity of freezing precipitation (liquid water equivalent) at surface
183+
* - Geopotential height
184+
- CaSR_v3.2_P_GZ_09975
185+
- ``dam``
186+
- Geopotential height at ~20m (0.997502 hy)
187+
* - Geopotential height
188+
- CaSR_v3.2_P_GZ_SFC
189+
- ``dam``
190+
- Geopotential height at the surface
191+
* - Liquid precipitation
192+
- CaSR_v3.2_P_RN0_SFC
193+
- ``m``
194+
- Forecast: Quantity of liquid precipitation at surface
195+
* - Meteorological wind direction
196+
- CaSR_v3.2_P_WDC_09975
197+
- ``degree``
198+
- Forecast: Meteorological wind direction (derived using UU and VV) at ~20m (0.997502 hy)
199+
* - Meteorological wind direction
200+
- CaSR_v3.2_P_WDC_10m
201+
- ``degree``
202+
- Forecast: Meteorological wind direction (derived using UU and VV) at ~10m
203+
204+
Last updated: November 25, 2025

‎etc/usages/DATASETS‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,5 +77,6 @@
7777
| 11.32. NorESM2-MM | | ditto |
7878
| 11.33. TaiESM1 | | ditto |
7979
| 11.34. UKESM1-0-LL | | ditto |
80-
|12. ECCC CaSRv3.1 | casr | TBD |
80+
|12. ECCC CaSRv3.1 | casr3.1 | TBD |
81+
|12. ECCC CaSRv3.2 | casr3.2 | TBD |
8182
|--------------------------------|-----------|---------------------------|

‎extract-dataset.sh‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -744,7 +744,7 @@ case "${dataset,,}" in
744744
;;
745745

746746
# ECCC RDRS
747-
"casr" | "casrv3.1")
747+
"casr" | "casrv3.1" | "casrv3.2")
748748
call_processing_func "$recipePath/eccc-casr/casr.sh" "3months"
749749
;;
750750

‎var/repos/builtin/recipes/eccc-casr/casr.sh‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ do
7979
-t | --time-scale) timeScale="$2" ; shift 2 ;; # redundant - added for compatibility
8080
-l | --lat-lims) latLims="$2" ; shift 2 ;; # required
8181
-n | --lon-lims) lonLims="$2" ; shift 2 ;; # required
82-
-p | --prefix) prefix="$2" ; shift 2 ;; # optional
82+
-p | --prefix) prefix="$2" ; shift 2 ;; # optional
8383
-c | --cache) cache="$2" ; shift 2 ;; # required
8484
-m | --ensemble) ensemble="$2" ; shift 2 ;; # redundant - added for compatibility
8585
-S | --scenario) scenario="$2" ; shift 2 ;; # redundant - added for compatibility

0 commit comments

Comments
 (0)