Skip to main content

GreenLearning

Documentation Status

GreenLearning is a deep learning library based on Tensorflow for learning Green's functions associated with partial differential operators.

laplace_rational.png
Exact and learned Green’s function of the Laplace operator..

Below is an example of the Green's function of a second-order differential operator with variable coefficients learned by GreenLearning.

laplace_rational.png
Learned Green’s function of a second order ODE with variable coefficients.

See https://greenlearning.readthedocs.io/en/latest/gallery.html for more examples.

The library is maintained by Nicolas Boullé. If you are interested in using it, do not hesitate to get in contact with him at boulle@maths.ox.ac.uk.

Documentation: ReadTheDocs

Features

  • GreenLearning learns Green's functions and homogeneous solutions associated with scalar and systems of linearized partial differential equations in 1D and 2D with deep learning.
  • Rational neural networks are implemented and used to increase the accuracy of the learned Green's functions.
  • GreenLearning requires no hyperparameter tuning to successfully learn Green's functions.
  • The neural networks can be created and trained easily with a few lines of code.
  • It is simple to generate the training datasets with MATLAB scripts.

Installation

Requirements

GreenLearning relies on the following Python libraries:

How to install GreenLearning

  • For users, you can install the stable version with pip:
pip install greenlearning

or with conda:

conda install -c conda-forge greenlearning
  • For developers, you should clone the GitHub repository and install it manually on your machine::
git clone https://github.com/NBoulle/greenlearning.git
cd greenlearning
pip install -e.

Citation

Please cite the following papers if you are using GreenLearning.

  • About GreenLearning:
@article{boulle2021data,
title={Data-driven discovery of physical laws with human-understandable deep learning},
author={Boull{\'e}, Nicolas and Earls, Christopher J. and Townsend, Alex,
journal={arXiv preprint arXiv:},
year={2021}
}
  • About Rational neural networks:
@inproceedings{boulle2020rational,
title={Rational neural networks},
author={Boull{\'e}, Nicolas and Nakatsukasa, Yuji and Townsend, Alex},
booktitle = {Advances in Neural Information Processing Systems},
volume = {33},
pages = {14243--14253},
year={2020},
url = {https://proceedings.neurips.cc/paper/2020/file/a3f390d88e4c41f2747bfa2f1b5f87db-Paper.pdf}
}

Metadata

Release files for GreenLearning 1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for GreenLearning 1.0
File Size Uploaded
GreenLearning-1.0.zip 29.0 kB Details

Release files / GreenLearning-1.0.zip

Download URL GreenLearning-1.0.zip
Size 29.0 kB
Tags Source
SHA-256 checksum
How to use checksums
238b41ffe21a423416d933c2a1a819f45bf8666b8e97c555ebb4f016c98c615e
BLAKE2b-256 checksum
How to use checksums
35c4a0687839a525d5b3ee8a57464231b0ee60a1bf222ff334ed322c320fb70d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/3.10.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.9

Release history Release notifications | RSS feed

This release

1.0 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page