Utilities for working with non-CF grid datasets
Project description
emsarray
The emsarray
package provides a common interface
for working with the many model formats used at CSIRO.
It enhances xarray
Datasets
and provides a set of common operations for manipulating datasets.
To use, open the dataset using the emsarray.open_dataset()
function
and use the dataset.ems
attribute:
import emsarray
import json
dataset = emsarray.tutorial.open_dataset('gbr4')
with open("geometry.geojson", "w") as f:
json.dump(dataset.ems.make_geojson_geometry(), f)
Some methods take a DataArray as a parameter:
# Plot the sea surface temperature for time = 0
temp = dataset['temp'].isel(time=0, k=-1)
dataset.ems.plot(temp)
Developing
To get set up for development, make a virtual environment and install the dependencies:
$ python3 -m venv
$ source venv/bin/activate
$ pip install --upgrade pip>=21.3
$ pip install -e . -r requirements.txt
Tests
To run the tests, install and run tox
:
$ python3 -m venv
$ source venv/bin/activate
$ pip install --upgrade pip>=21.3 tox
$ tox
Documentation
To build the documentation, install the development requirements as above and invoke Sphinx:
$ make -C docs/ html
While updating or adding to the documentation,
run the live
target to automatically rebuild the docs whenever anything changes.
This will serve the documentation via a livereload
server.
$ make -C docs/ live
You can the view the docs at http://localhost:5500
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for emsarray-0.1.0a1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 69458989faf528dfdc4726830864d85b62b5b17ebf04f44d3f334559e993329c |
|
MD5 | 1f2cb5f00e85525aeb39e52826827a11 |
|
BLAKE2b-256 | 6538a1d8d8ea5c1b9d613d4941f6459e25f2368dc770dfee99bb83d143611b3f |