CDSAPI.jl
This package provides access to the Climate Data Store (a.k.a. CDS) service.
The CDS website provides a Show API request button at the bottom of the download tab of each dataset. This button generates the code to download the dataset with the Python cdsapi module. We've designed this Julia package so that one could copy/paste the generated Python code with minimum modification in Julia.
Installation
Please install the package with Julia's package manager:
] add CDSAPI
Usage
Make sure your ~/.cdsapirc
file exists. Instructions on how to create the file for your user account can be found here.
Suppose that the Show API request
button generated the following Python code:
#!/usr/bin/env python
import cdsapi
c = cdsapi.Client()
c.retrieve("insitu-glaciers-elevation-mass",
{
"variable": "all",
"product_type": "elevation_change",
"file_version": "20170405",
"format": "tgz"
},
"download.tar.gz")
You can obtain the same results in Julia with the following code:
using CDSAPI
CDSAPI.retrieve("insitu-glaciers-elevation-mass",
CDSAPI.py2ju("""
{
"variable": "all",
"product_type": "elevation_change",
"file_version": "20170405",
"format": "tgz"
}
"""),
"download.tar.gz")
We've copied/pasted the code and called the py2ju
function (exported by CDSAPI.jl) on the second argument of the retrieve
function. The py2ju
function simply converts the string containing a Python dictionary to an actual Julia dictionary.
Beside the downloaded file, retrieve function also return a dict with the following entires:
Dict{String,Any} with 6 entries:
"result_provided_by" => "8a3eb001-c8e3-4a9c-8170-28191ebea14b"
"location" => "http://136.156.133.36/cache-compute-0010/cache/data0/dataset-insitu-glaciers-elevation-mass-8a3eb001a14b.tar.gz"
"content_type" => "application/gzip"
"request_id" => "04534ef1-874d-4c81-bb59-9b5effe63e9e"
"content_length" => 193660
"state" => "completed"
Contributors
@michiboo @juliohm @LakshyaKhatri