Skip to main content

Echo State Networks powered by xarray

Project description

xesn

codecov Documentation Status Conda Version PyPI version

Echo State Networks powered by xarray and dask.

Description

xesn is a python package for implementing Echo State Networks (ESNs), a particular form of Recurrent Neural Network originally introduced by Jaeger (2001). The main purpose of the package is to enable ESNs for relatively large scale weather and climate applications, for example as by Smith et al., (2023) and Arcomano et al., (2020). The package is designed to strike the balance between simplicity and flexibility, with a focus on implementing features that were shown to matter most by Platt et al., (2022).

xesn uses xarray to handle multi-dimensional data, relying on dask for parallelization and to handle datasets/networks that are too large for a single compute node. At its core, xesn uses numpy and cupy for efficient CPU and GPU deployment.

Installation

Installation from conda-forge

conda install -c conda-forge xesn

Installation from pip

pip install xesn

Installation from source

git clone https://github.com/timothyas/xesn.git
cd xesn
pip install -e .

Note that additional dependencies can be installed to run the unit test suite::

pip install -e .[test]
pytest xesn/test/*.py

Getting Started

To learn how to use xesn, check out the documentation here

Get in touch

Report bugs, suggest features, or view the source code on GitHub.

License and Copyright

xesn is licensed under the Apache-2.0 License.

Development occurs on GitHub at https://github.com/timothyas/xesn.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xesn-0.2.1.tar.gz (2.3 MB view details)

Uploaded Source

Built Distribution

xesn-0.2.1-py3-none-any.whl (57.3 kB view details)

Uploaded Python 3

File details

Details for the file xesn-0.2.1.tar.gz.

File metadata

  • Download URL: xesn-0.2.1.tar.gz
  • Upload date:
  • Size: 2.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for xesn-0.2.1.tar.gz
Algorithm Hash digest
SHA256 21b902abe71f5557a5c9dc69001fc1f17ac9e9bbc59a9f37b1f66b04d35a89cb
MD5 712ede0378e3e9521f4309f7080e8054
BLAKE2b-256 7f3856771ea64d83e396cfa1391b48db688a6ee1f5fe0bb8884e5f7e43080cef

See more details on using hashes here.

Provenance

The following attestation bundles were made for xesn-0.2.1.tar.gz:

Publisher: publish.yaml on timothyas/xesn

Attestations:

File details

Details for the file xesn-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: xesn-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 57.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for xesn-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6f567edb01b7be74bf95d5aef9fa7701a5f960b489da197cc13bf8cc342c49a8
MD5 7b14fce69bc1f9dcc7bf863f48a5fe52
BLAKE2b-256 50e141c1654463fe8acd88d2fbc2565ff4109950329068cedc9b56e6599a2dbd

See more details on using hashes here.

Provenance

The following attestation bundles were made for xesn-0.2.1-py3-none-any.whl:

Publisher: publish.yaml on timothyas/xesn

Attestations:

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page