Skip to content

Commit a823ce7

Browse files
AlexisRenchonAlexisRenchon
authored
add era5 lake cover an depth artifacts (#154)
1 parent 0b7e8d6 commit a823ce7

File tree

7 files changed

+438
-0
lines changed

7 files changed

+438
-0
lines changed

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,7 @@ S. Gupta et al 2022, 2024](https://github.com/CliMA/ClimaArtifacts/tree/main/soi
7878
- [P-model implementation test data](https:////github.com/CliMA/ClimaArtifacts/tree/main/pmodel_unittests)
7979
- [FLUXNET2015 site data](https:////github.com/CliMA/ClimaArtifacts/tree/main/fluxnet2015)
8080
- [Initial conditions for the optimal LAI model](https://github.com/CliMA/ClimaArtifacts/tree/main/optimal_lai_inputs)
81+
- [ERA5 Lake Cover and Lake Depth](https://github.com/CliMA/ClimaArtifacts/tree/main/era5_lake_cover_and_depth)
8182

8283
### Coupler/shared
8384

‎era5_lake_cover_and_depth/Manifest.toml‎

Lines changed: 327 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,327 @@
1+
# This file is machine-generated - editing it directly is not advised
2+
3+
julia_version = "1.12.5"
4+
manifest_format = "2.0"
5+
project_hash = "e12274832541e5ee28b988bad9e6c10379fb71cb"
6+
7+
[[deps.ArgTools]]
8+
uuid = "0dad84c5-d112-42e6-8d28-ef12dabb789f"
9+
version = "1.1.2"
10+
11+
[[deps.ArtifactUtils]]
12+
deps = ["Downloads", "Git", "HTTP", "Pkg", "ProgressLogging", "SHA", "TOML", "gh_cli_jll"]
13+
git-tree-sha1 = "d111d8f4f6158a083869cb987adb957cd7330e6c"
14+
uuid = "8b73e784-e7d8-4ea5-973d-377fed4e3bce"
15+
version = "0.2.5"
16+
17+
[[deps.Artifacts]]
18+
uuid = "56f22d72-fd6d-98f1-02f0-08ddc0907c33"
19+
version = "1.11.0"
20+
21+
[[deps.Base64]]
22+
uuid = "2a0f44e3-6c83-55bd-87e4-b1978d98bd5f"
23+
version = "1.11.0"
24+
25+
[[deps.BitFlags]]
26+
git-tree-sha1 = "0691e34b3bb8be9307330f88d1a3c3f25466c24d"
27+
uuid = "d1d4a3ce-64b1-5f1a-9ba4-7e7e69966f35"
28+
version = "0.1.9"
29+
30+
[[deps.ClimaArtifactsHelper]]
31+
deps = ["ArtifactUtils", "Downloads", "Pkg", "REPL", "SHA"]
32+
path = "../ClimaArtifactsHelper.jl"
33+
uuid = "6ffa2572-8378-4377-82eb-ea11db28b255"
34+
version = "0.0.1"
35+
36+
[[deps.CodecZlib]]
37+
deps = ["TranscodingStreams", "Zlib_jll"]
38+
git-tree-sha1 = "962834c22b66e32aa10f7611c08c8ca4e20749a9"
39+
uuid = "944b1d66-785c-5afd-91f1-9de20f533193"
40+
version = "0.7.8"
41+
42+
[[deps.CompilerSupportLibraries_jll]]
43+
deps = ["Artifacts", "Libdl"]
44+
uuid = "e66e0078-7015-5450-92f7-15fbd957f2ae"
45+
version = "1.3.0+1"
46+
47+
[[deps.ConcurrentUtilities]]
48+
deps = ["Serialization", "Sockets"]
49+
git-tree-sha1 = "21d088c496ea22914fe80906eb5bce65755e5ec8"
50+
uuid = "f0e56b4a-5159-44fe-b623-3e5288b988bb"
51+
version = "2.5.1"
52+
53+
[[deps.Dates]]
54+
deps = ["Printf"]
55+
uuid = "ade2ca70-3891-5945-98fb-dc099432e06a"
56+
version = "1.11.0"
57+
58+
[[deps.Downloads]]
59+
deps = ["ArgTools", "FileWatching", "LibCURL", "NetworkOptions"]
60+
uuid = "f43a241f-c20a-4ad4-852c-f6b1247861c6"
61+
version = "1.7.0"
62+
63+
[[deps.ExceptionUnwrapping]]
64+
deps = ["Test"]
65+
git-tree-sha1 = "d36f682e590a83d63d1c7dbd287573764682d12a"
66+
uuid = "460bff9d-24e4-43bc-9d9f-a8973cb893f4"
67+
version = "0.1.11"
68+
69+
[[deps.Expat_jll]]
70+
deps = ["Artifacts", "JLLWrappers", "Libdl"]
71+
git-tree-sha1 = "27af30de8b5445644e8ffe3bcb0d72049c089cf1"
72+
uuid = "2e619515-83b5-522b-bb60-26c02a35a201"
73+
version = "2.7.3+0"
74+
75+
[[deps.FileWatching]]
76+
uuid = "7b1f6079-737a-58dc-b8bc-7a2ca5c1b5ee"
77+
version = "1.11.0"
78+
79+
[[deps.Git]]
80+
deps = ["Git_LFS_jll", "Git_jll", "JLLWrappers", "OpenSSH_jll"]
81+
git-tree-sha1 = "824a1890086880696fc908fe12a17bcf61738bd8"
82+
uuid = "d7ba0133-e1db-5d97-8f8c-041e4b3a1eb2"
83+
version = "1.5.0"
84+
85+
[[deps.Git_LFS_jll]]
86+
deps = ["Artifacts", "JLLWrappers", "Libdl"]
87+
git-tree-sha1 = "bb8471f313ed941f299aa53d32a94ab3bee08844"
88+
uuid = "020c3dae-16b3-5ae5-87b3-4cb189e250b2"
89+
version = "3.7.0+0"
90+
91+
[[deps.Git_jll]]
92+
deps = ["Artifacts", "Expat_jll", "JLLWrappers", "LibCURL_jll", "Libdl", "Libiconv_jll", "OpenSSL_jll", "PCRE2_jll", "Zlib_jll"]
93+
git-tree-sha1 = "dc34a3e3d96b4ed305b641e626dc14c12b7824b8"
94+
uuid = "f8c6e375-362e-5223-8a59-34ff63f689eb"
95+
version = "2.53.0+0"
96+
97+
[[deps.HTTP]]
98+
deps = ["Base64", "CodecZlib", "ConcurrentUtilities", "Dates", "ExceptionUnwrapping", "Logging", "LoggingExtras", "MbedTLS", "NetworkOptions", "OpenSSL", "PrecompileTools", "Random", "SimpleBufferStream", "Sockets", "URIs", "UUIDs"]
99+
git-tree-sha1 = "51059d23c8bb67911a2e6fd5130229113735fc7e"
100+
uuid = "cd3eb016-35fb-5094-929b-558a96fad6f3"
101+
version = "1.11.0"
102+
103+
[[deps.InteractiveUtils]]
104+
deps = ["Markdown"]
105+
uuid = "b77e0a4c-d291-57a0-90e8-8db25a27a240"
106+
version = "1.11.0"
107+
108+
[[deps.JLLWrappers]]
109+
deps = ["Artifacts", "Preferences"]
110+
git-tree-sha1 = "0533e564aae234aff59ab625543145446d8b6ec2"
111+
uuid = "692b3bcd-3c85-4b1f-b108-f13ce0eb3210"
112+
version = "1.7.1"
113+
114+
[[deps.JuliaSyntaxHighlighting]]
115+
deps = ["StyledStrings"]
116+
uuid = "ac6e5ff7-fb65-4e79-a425-ec3bc9c03011"
117+
version = "1.12.0"
118+
119+
[[deps.LibCURL]]
120+
deps = ["LibCURL_jll", "MozillaCACerts_jll"]
121+
uuid = "b27032c2-a3e7-50c8-80cd-2d36dbcbfd21"
122+
version = "0.6.4"
123+
124+
[[deps.LibCURL_jll]]
125+
deps = ["Artifacts", "LibSSH2_jll", "Libdl", "OpenSSL_jll", "Zlib_jll", "nghttp2_jll"]
126+
uuid = "deac9b47-8bc7-5906-a0fe-35ac56dc84c0"
127+
version = "8.15.0+0"
128+
129+
[[deps.LibGit2]]
130+
deps = ["LibGit2_jll", "NetworkOptions", "Printf", "SHA"]
131+
uuid = "76f85450-5226-5b5a-8eaa-529ad045b433"
132+
version = "1.11.0"
133+
134+
[[deps.LibGit2_jll]]
135+
deps = ["Artifacts", "LibSSH2_jll", "Libdl", "OpenSSL_jll"]
136+
uuid = "e37daf67-58a4-590a-8e99-b0245dd2ffc5"
137+
version = "1.9.0+0"
138+
139+
[[deps.LibSSH2_jll]]
140+
deps = ["Artifacts", "Libdl", "OpenSSL_jll"]
141+
uuid = "29816b5a-b9ab-546f-933c-edad1886dfa8"
142+
version = "1.11.3+1"
143+
144+
[[deps.Libdl]]
145+
uuid = "8f399da3-3557-5675-b5ff-fb832c97cbdb"
146+
version = "1.11.0"
147+
148+
[[deps.Libiconv_jll]]
149+
deps = ["Artifacts", "JLLWrappers", "Libdl"]
150+
git-tree-sha1 = "be484f5c92fad0bd8acfef35fe017900b0b73809"
151+
uuid = "94ce4f54-9a6c-5748-9c1c-f9c7231a4531"
152+
version = "1.18.0+0"
153+
154+
[[deps.Logging]]
155+
uuid = "56ddb016-857b-54e1-b83d-db4d58db5568"
156+
version = "1.11.0"
157+
158+
[[deps.LoggingExtras]]
159+
deps = ["Dates", "Logging"]
160+
git-tree-sha1 = "f00544d95982ea270145636c181ceda21c4e2575"
161+
uuid = "e6f89c97-d47a-5376-807f-9c37f3926c36"
162+
version = "1.2.0"
163+
164+
[[deps.Markdown]]
165+
deps = ["Base64", "JuliaSyntaxHighlighting", "StyledStrings"]
166+
uuid = "d6f4376e-aef5-505a-96c1-9c027394607a"
167+
version = "1.11.0"
168+
169+
[[deps.MbedTLS]]
170+
deps = ["Dates", "MbedTLS_jll", "MozillaCACerts_jll", "NetworkOptions", "Random", "Sockets"]
171+
git-tree-sha1 = "8785729fa736197687541f7053f6d8ab7fc44f92"
172+
uuid = "739be429-bea8-5141-9913-cc70e7f3736d"
173+
version = "1.1.10"
174+
175+
[[deps.MbedTLS_jll]]
176+
deps = ["Artifacts", "JLLWrappers", "Libdl"]
177+
git-tree-sha1 = "ff69a2b1330bcb730b9ac1ab7dd680176f5896b8"
178+
uuid = "c8ffd9c3-330d-5841-b78e-0817d7145fa1"
179+
version = "2.28.1010+0"
180+
181+
[[deps.MozillaCACerts_jll]]
182+
uuid = "14a3606d-f60d-562e-9121-12d972cd8159"
183+
version = "2025.11.4"
184+
185+
[[deps.NetworkOptions]]
186+
uuid = "ca575930-c2e3-43a9-ace4-1e988b2c1908"
187+
version = "1.3.0"
188+
189+
[[deps.OpenSSH_jll]]
190+
deps = ["Artifacts", "JLLWrappers", "Libdl", "OpenSSL_jll", "Zlib_jll"]
191+
git-tree-sha1 = "301412a644646fdc0ad67d0a87487466b491e53d"
192+
uuid = "9bd350c2-7e96-507f-8002-3f2e150b4e1b"
193+
version = "10.2.1+0"
194+
195+
[[deps.OpenSSL]]
196+
deps = ["BitFlags", "Dates", "MozillaCACerts_jll", "NetworkOptions", "OpenSSL_jll", "Sockets"]
197+
git-tree-sha1 = "1d1aaa7d449b58415f97d2839c318b70ffb525a0"
198+
uuid = "4d8831e6-92b7-49fb-bdf8-b643e874388c"
199+
version = "1.6.1"
200+
201+
[[deps.OpenSSL_jll]]
202+
deps = ["Artifacts", "Libdl"]
203+
uuid = "458c3c95-2e84-50aa-8efc-19380b2a3a95"
204+
version = "3.5.4+0"
205+
206+
[[deps.PCRE2_jll]]
207+
deps = ["Artifacts", "Libdl"]
208+
uuid = "efcefdf7-47ab-520b-bdef-62a2eaa19f15"
209+
version = "10.44.0+1"
210+
211+
[[deps.Pkg]]
212+
deps = ["Artifacts", "Dates", "Downloads", "FileWatching", "LibGit2", "Libdl", "Logging", "Markdown", "Printf", "Random", "SHA", "TOML", "Tar", "UUIDs", "p7zip_jll"]
213+
uuid = "44cfe95a-1eb2-52ea-b672-e2afdf69b78f"
214+
version = "1.12.1"
215+
weakdeps = ["REPL"]
216+
217+
[deps.Pkg.extensions]
218+
REPLExt = "REPL"
219+
220+
[[deps.PrecompileTools]]
221+
deps = ["Preferences"]
222+
git-tree-sha1 = "07a921781cab75691315adc645096ed5e370cb77"
223+
uuid = "aea7be01-6a6a-4083-8856-8a6e6704d82a"
224+
version = "1.3.3"
225+
226+
[[deps.Preferences]]
227+
deps = ["TOML"]
228+
git-tree-sha1 = "8b770b60760d4451834fe79dd483e318eee709c4"
229+
uuid = "21216c6a-2e73-6563-6e65-726566657250"
230+
version = "1.5.2"
231+
232+
[[deps.Printf]]
233+
deps = ["Unicode"]
234+
uuid = "de0858da-6303-5e67-8744-51eddeeeb8d7"
235+
version = "1.11.0"
236+
237+
[[deps.ProgressLogging]]
238+
deps = ["Logging", "SHA", "UUIDs"]
239+
git-tree-sha1 = "f0803bc1171e455a04124affa9c21bba5ac4db32"
240+
uuid = "33c8b6b6-d38a-422a-b730-caa89a2f386c"
241+
version = "0.1.6"
242+
243+
[[deps.REPL]]
244+
deps = ["InteractiveUtils", "JuliaSyntaxHighlighting", "Markdown", "Sockets", "StyledStrings", "Unicode"]
245+
uuid = "3fa0cd96-eef1-5676-8a61-b3b8758bbffb"
246+
version = "1.11.0"
247+
248+
[[deps.Random]]
249+
deps = ["SHA"]
250+
uuid = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c"
251+
version = "1.11.0"
252+
253+
[[deps.SHA]]
254+
uuid = "ea8e919c-243c-51af-8825-aaa63cd721ce"
255+
version = "0.7.0"
256+
257+
[[deps.Serialization]]
258+
uuid = "9e88b42a-f829-5b0c-bbe9-9e923198166b"
259+
version = "1.11.0"
260+
261+
[[deps.SimpleBufferStream]]
262+
git-tree-sha1 = "f305871d2f381d21527c770d4788c06c097c9bc1"
263+
uuid = "777ac1f9-54b0-4bf8-805c-2214025038e7"
264+
version = "1.2.0"
265+
266+
[[deps.Sockets]]
267+
uuid = "6462fe0b-24de-5631-8697-dd941f90decc"
268+
version = "1.11.0"
269+
270+
[[deps.StyledStrings]]
271+
uuid = "f489334b-da3d-4c2e-b8f0-e476e12c162b"
272+
version = "1.11.0"
273+
274+
[[deps.TOML]]
275+
deps = ["Dates"]
276+
uuid = "fa267f1f-6049-4f14-aa54-33bafae1ed76"
277+
version = "1.0.3"
278+
279+
[[deps.Tar]]
280+
deps = ["ArgTools", "SHA"]
281+
uuid = "a4e569a6-e804-4fa4-b0f3-eef7a1d5b13e"
282+
version = "1.10.0"
283+
284+
[[deps.Test]]
285+
deps = ["InteractiveUtils", "Logging", "Random", "Serialization"]
286+
uuid = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
287+
version = "1.11.0"
288+
289+
[[deps.TranscodingStreams]]
290+
git-tree-sha1 = "0c45878dcfdcfa8480052b6ab162cdd138781742"
291+
uuid = "3bb67fe8-82b1-5028-8e26-92a6c54297fa"
292+
version = "0.11.3"
293+
294+
[[deps.URIs]]
295+
git-tree-sha1 = "bef26fb046d031353ef97a82e3fdb6afe7f21b1a"
296+
uuid = "5c2747f8-b7ea-4ff2-ba2e-563bfd36b1d4"
297+
version = "1.6.1"
298+
299+
[[deps.UUIDs]]
300+
deps = ["Random", "SHA"]
301+
uuid = "cf7118a7-6976-5b1a-9a39-7adc72f591a4"
302+
version = "1.11.0"
303+
304+
[[deps.Unicode]]
305+
uuid = "4ec0a83e-493e-50e2-b9ac-8f72acf5a8f5"
306+
version = "1.11.0"
307+
308+
[[deps.Zlib_jll]]
309+
deps = ["Libdl"]
310+
uuid = "83775a58-1f1d-513f-b197-d71354ab007a"
311+
version = "1.3.1+2"
312+
313+
[[deps.gh_cli_jll]]
314+
deps = ["Artifacts", "JLLWrappers", "Libdl"]
315+
git-tree-sha1 = "894b4ad6ac54832386f8d01e84cab691b588f364"
316+
uuid = "5d31d589-30fb-542f-b82d-10325e863e38"
317+
version = "2.83.2+0"
318+
319+
[[deps.nghttp2_jll]]
320+
deps = ["Artifacts", "Libdl"]
321+
uuid = "8e850ede-7688-5339-a07c-302acd2aaf8d"
322+
version = "1.64.0+1"
323+
324+
[[deps.p7zip_jll]]
325+
deps = ["Artifacts", "CompilerSupportLibraries_jll", "Libdl"]
326+
uuid = "3f19e933-33d8-53b3-aaab-bd5110c3b7a0"
327+
version = "17.7.0+0"

‎era5_lake_cover_and_depth/OutputArtifacts.toml‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
[era5_lake_cover_and_depth]
2+
git-tree-sha1 = "da338fdaf3704c744a90f79e1b84526afc9f092b"
3+
4+
[[era5_lake_cover_and_depth.download]]
5+
sha256 = "d822dfccbe72d194c3e7bc5e88e6485c0496fdef4ee5b33aa6e1ce9dae746389"
6+
url = "https://caltech.box.com/shared/static/andadm1km9mitehanga1ae186u0drw2p.gz"

‎era5_lake_cover_and_depth/Project.toml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
[deps]
2+
ClimaArtifactsHelper = "6ffa2572-8378-4377-82eb-ea11db28b255"

‎era5_lake_cover_and_depth/README.md‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# ERA5 Lake Cover and Lake Depth
2+
3+
This artifact contains ERA5 lake cover and lake total depth data at 0.25 degree
4+
resolution.
5+
6+
## Files
7+
- `era5_lake_cover.nc` (~644KB): Fraction of grid cell covered by inland water
8+
bodies (lakes, reservoirs, rivers).
9+
- `era5_lake_depth.nc` (~2.2MB): Lake total depth in meters.
10+
11+
Both files have the following structure:
12+
- Latitude ("latitude"): from 90.0 to -90.0 degrees at 0.25 degree resolution
13+
- Longitude ("longitude"): from 0.0 to 359.75 degrees at 0.25 degree resolution
14+
- Valid time ("valid_time"): single time step
15+
16+
The data variables are:
17+
- `cl` (valid_time, latitude, longitude): Lake cover (0-1) in `era5_lake_cover.nc`
18+
- `dl` (valid_time, latitude, longitude): Lake total depth (m) in `era5_lake_depth.nc`
19+
20+
According to the
21+
[documentation](https://cds.climate.copernicus.eu/datasets/reanalysis-era5-single-levels?tab=overview),
22+
these fields are time-invariant.
23+
24+
## Prerequisites
25+
1. Python (with `cdsapi` package)
26+
2. Julia
27+
28+
## Usage
29+
To recreate this artifact:
30+
1. Clone this repository and navigate to this directory.
31+
2. Follow the instructions [here](https://cds.climate.copernicus.eu/how-to-api)
32+
to set up a CDS API personal access token.
33+
3. Run `python get_era5_lake_cover_and_depth.py` to download the raw data.
34+
4. Run `julia --project=. create_artifact.jl` to create the artifact.
35+
36+
## Attribution
37+
Hersbach, H. et al., (2018) was downloaded from the Copernicus Climate Change Service (2023). Our dataset contains modified Copernicus Climate Change Service information [2023]. Neither the European Commission nor ECMWF is responsible for any use that may be made of the Copernicus information or data it contains.
38+
39+
Copernicus Climate Change Service (2023): ERA5 hourly data on single levels from 1940 to present. Copernicus Climate Change Service (C3S) Climate Data Store (CDS), DOI: 10.24381/cds.adbb2d47 (Accessed on 31-MAR-2026)
40+
41+
Hersbach, H., Bell, B., Berrisford, P., Biavati, G., Horanyi, A., Munoz Sabater, J., Nicolas, J., Peubey, C., Radu, R., Rozum, I., Schepers, D., Simmons, A., Soci, C., Dee, D., Thepaut, J-N. (2018): ERA5 hourly data on single levels from 1940 to present. Copernicus Climate Change Service (C3S) Climate Data Store (CDS), DOI: 10.24381/cds.adbb2d47
42+
43+
Hersbach, H., Bell, B., Berrisford, P., Hirahara, S., Horanyi, A., Munoz-Sabater, J., Nicolas, J., Peubey, C., Radu, R., Schepers, D., Simmons, A., Soci, C., Abdalla, S., Abellan, X., Balsamo, G., Bechtold, P., Biavati, G., Bidlot, J., Bonavita, M., ... Thepaut, J.-N. (2020). The ERA5 global reanalysis. Quarterly Journal of the Royal Meteorological Society, 146(730), 1999-2049. https://doi.org/10.1002/QJ.3803
44+
45+
## Licence
46+
Please see [License to Use Copernicus Products](https://object-store.os-api.cci2.ecmwf.int/cci2-prod-catalogue/licences/licence-to-use-copernicus-products/licence-to-use-copernicus-products_b4b9451f54cffa16ecef5c912c9cebd6979925a956e3fa677976e0cf198c2c18.pdf) for more information.

0 commit comments

Comments
 (0)