Usage#
To use oceanum in a project:
import oceanum
Or to import a subpackage:
import oceanum.datamesh as datamesh
Work with Datamesh#
Import and instantiate the Datamesh connector:
from oceanum.datamesh import Connector
datamesh=Connector(token=<your_datamesh_token>)
Get your Datamesh token from: https://home.oceanum.io/account/
Get and list a catalog of all datasources:
cat=datamesh.get_catalog()
print(cat)
Get more info on a datasource:
dsrc=datamesh.get_datasource('oceanum_wave_glob05_era5_v1_grid')
print(dsrc)
Look at the variables schema:
print(dsrc.variables)
Load the datasource as an xarray dataset:
ds=datamesh.load_datasource('oceanum_wave_glob05_era5_v1_grid')
Plot a timeseries from the datsource:
ds['hs'].sel(longitude=0, latitude=0).plot()
Make a query using a timefilter and geofilter:
dsq=datamesh.query({"datasource":"oceanum_wave_glob05_era5_v1_grid",
"variables":["hs","dp"],
"timefilter":{"times":["2010-01-01","2011-01-01"]},
"geofilter":{
"type":"feature",
"geom":{
"type":"Feature","geometry":{"type":"Point","coordinates":[170.2,-35.3]}
}
}
})
dsq['dp'].plot()