Skip to content

Commit 17b0a87

Browse files
kasra-keshavarzCopilot
kasra-keshavarz
and
Copilot
authored
Iss85: Adding CaSRv3.1 workflows and docs (#86)
* Progress on CaSRv3.1 docs and general call scripts * Adding CaSRv3.1 information * Backing up * CaSRv3.1 Receipe This commit contributes to the package by adding relevant workflows for the CaSR3.1 dataset. Signed-off-by: Kasra Keshavarz <[email protected]> * adding casr info to dataset list * Updating docs--problems with levels displayed * Update var/repos/builtin/recipes/eccc-casr/README.md Fixing typos Co-authored-by: Copilot <[email protected]> * Update var/repos/builtin/recipes/eccc-casr/README.md Fixing typos Co-authored-by: Copilot <[email protected]> * Update docs/scripts/eccc-casr.rst Fixing typos Co-authored-by: Copilot <[email protected]> --------- Signed-off-by: Kasra Keshavarz <[email protected]> Co-authored-by: Copilot <[email protected]>
1 parent 8ccec7d commit 17b0a87

File tree

8 files changed

+1390
-2
lines changed

8 files changed

+1390
-2
lines changed

‎docs/datasets.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,8 @@ 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) |
44+
+----+------------------------------+--------------------------------------------------------------------------------------+
4345

4446
.. [#f1] For access to the files on the Graham cluster, please contact `Stephen O'Hearn <mailto:[email protected]>`_.
4547
.. [#f2] ERA5 data from 1950-1979 are based on `ERA5 preliminary extension <https://cds.climate.copernicus.eu/cdsapp#!/dataset/reanalysis-era5-single-levels-preliminary-back-extension?tab=overview>`_ and 1979 onwards are based on `ERA5 1979-present <https://doi.org/10.24381/cds.adbb2d47>`_.
@@ -58,6 +60,7 @@ Detailed Descriptions
5860
scripts/ccrn-canrcm4_wfdei_gem_capa.rst
5961
scripts/ccrn-wfdei_gem_capa.rst
6062
scripts/eccc-rdrs.rst
63+
scripts/eccc-casr.rst
6164
scripts/ecmwf-era5.rst
6265
scripts/gwf-ncar-conus_i.rst
6366
scripts/gwf-ncar-conus_ii.rst

‎docs/index.rst

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,15 +70,16 @@ documentation!
7070
:maxdepth: 2
7171
:caption: User Manual
7272

73-
index
7473
quick_start
7574
json
7675

76+
.. toctree::
7777
:maxdepth: 3
7878
:caption: Datasets
7979

8080
datasets
8181

82+
.. toctree::
8283
:maxdepth: 1
8384
:caption: License
8485

‎docs/scripts/eccc-casr.rst

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

‎etc/usages/DATASETS

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,4 +77,5 @@
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 |
8081
|--------------------------------|-----------|---------------------------|

‎extract-dataset.sh

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
#!/bin/bash
22
# Meteorological Data Processing Workflow
33
# Copyright (C) 2022-2023, University of Saskatchewan
4-
# Copyright (C) 2023-2024, University of Calgary
4+
# Copyright (C) 2023-2025, University of Calgary
55
#
66
# This file is part of Meteorological Data Processing Workflow
77
#
@@ -733,6 +733,11 @@ case "${dataset,,}" in
733733
"rdrs" | "rdrsv2.1")
734734
call_processing_func "$recipePath/eccc-rdrs/rdrs.sh" "6months"
735735
;;
736+
737+
# ECCC RDRS
738+
"casr" | "casrv3.1")
739+
call_processing_func "$recipePath/eccc-casr/casr.sh" "6months"
740+
;;
736741

737742
# ====================
738743
# Observation datasets

0 commit comments

Comments
 (0)