aqua-blue
Lightweight and basic reservoir computing library
🌊 What is aqua-blue?
aqua-blue is a lightweight python library for reservoir computing (specifically echo state networks) depending only on numpy. aqua-blue's namesake comes from:
- A blue ocean of data, aka a reservoir 💧
- A very fancy cat named Blue 🐾
🐜 Found a bug?
Please open an issue here if you found a bug! The easier it is to reproduce the bug, the faster we will find a solution to the problem. Please consider including the following info in your issue:
- Steps to reproduce
- Expected and actual behavior
- Version info, OS, etc.
🔧 Contributing
Please see CONTRIBUTING.md
for instructions on how to contribute to aqua-blue ☺
📥 Installation
aqua-blue is on PyPI, and can therefore be installed with pip:
pip install aqua-blue
📝 Quickstart
import numpy as np
import aqua_blue
# generate arbitrary two-dimensional time series
# y_1(t) = cos(t), y_2(t) = sin(t)
# resulting dependent variable has shape (number of timesteps, 2)
t = np.linspace(0, 4.0 * np.pi, 10_000)
y = np.vstack((2.0 * np.cos(t) + 1, 5.0 * np.sin(t) - 1)).T
# create time series object to feed into echo state network
time_series = aqua_blue.time_series.TimeSeries(dependent_variable=y, times=t)
# normalize
normalizer = aqua_blue.utilities.Normalizer()
time_series = normalizer.normalize(time_series)
# make model and train
model = aqua_blue.models.Model(
reservoir=aqua_blue.reservoirs.DynamicalReservoir(
reservoir_dimensionality=100,
input_dimensionality=2
),
readout=aqua_blue.readouts.LinearReadout()
)
model.train(time_series)
# predict and denormalize
prediction = model.predict(horizon=1_000)
prediction = normalizer.denormalize(prediction)
📃 License
aqua-blue is released under the MIT License.
Blue, the cat behind aqua-blue.
1 maintainer
Metadata
1 maintainer
Release files for aqua-blue 0.2.19
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aqua_blue-0.2.19.tar.gz | 17.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aqua_blue-0.2.19-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 36.1 kB
Release files / aqua_blue-0.2.19.tar.gz
| Download URL | aqua_blue-0.2.19.tar.gz |
|---|---|
| Size | 17.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cb7cc0d3396d549d8a4144ae30a5e00780e20aa2354a4cf9864c9a247d011514
|
|
BLAKE2b-256 checksum How to use checksums |
c12cb40150123294f2d5a3f9ea9cc8e23f86e33329eb3849b43a473dd4a09eca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 10, 2025.
Transparency logRelease files / aqua_blue-0.2.19-py3-none-any.whl
| Download URL | aqua_blue-0.2.19-py3-none-any.whl |
|---|---|
| Size | 19.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
268ca90b9c9f8f855b156451477920d8293c477e830c451dbb7e8b2dc2646b64
|
|
BLAKE2b-256 checksum How to use checksums |
fff8e81a28e4c96c5e2ceeb48e31ed882bb8f4f6f3a922819c2666f9a6d37c73
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 10, 2025.
Transparency log
