Metadata-Version: 2.1
Name: supy
Version: 2022.8.2.dev1
Summary: the SUEWS model that speaks python
Home-page: https://github.com/UMEP-Dev/SuPy
Author: Dr Ting Sun, Dr Hamidreza Omidvar, Prof Sue Grimmond
Author-email: ting.sun@reading.ac.uk, h.omidvar@reading.ac.uk, c.s.grimmond@reading.ac.uk
License: GPL-V3.0
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Requires-Python: ~=3.7
Description-Content-Type: text/markdown
Requires-Dist: pandas (>=1.3)
Requires-Dist: matplotlib
Requires-Dist: scipy
Requires-Dist: dask
Requires-Dist: f90nml
Requires-Dist: seaborn
Requires-Dist: atmosp
Requires-Dist: cdsapi
Requires-Dist: xarray
Requires-Dist: multiprocess
Requires-Dist: click
Requires-Dist: lmfit
Requires-Dist: numdifftools
Requires-Dist: pvlib
Requires-Dist: platypus-opt (==1.0.4)
Requires-Dist: supy-driver (==2021a8)
Provides-Extra: hdf
Requires-Dist: tables ; extra == 'hdf'

# SuPy

[![Python Version Support Status](https://img.shields.io/pypi/pyversions/supy.svg)](https://pypi.org/project/supy)
[![Latest Version Status](https://img.shields.io/pypi/v/supy.svg)](https://pypi.org/project/supy)
[![Downloads](https://pepy.tech/badge/supy)](https://pepy.tech/project/supy)
[![Launch Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/UMEP-dev/SuPy/master)

[![Documentation Status](https://readthedocs.org/projects/supy/badge/?version=latest)](https://supy.readthedocs.io/en/latest/?badge=latest)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.2574404.svg)](https://doi.org/10.5281/zenodo.2574404)



[**SU**EWS](https://suews-docs.readthedocs.io) that speaks **Py**thon

## Installation

SuPy requires 64-bit `python` 3.7+ and can be installed with `pip` in command line prompt:


```shell
python3 -m pip install supy --upgrade
```

## Quick Demo

Once installed, `supy` can be quickly started to get [SUEWS](https://suews-docs.readthedocs.io) simulations done:

```python {cmd}
import supy as sp
import matplotlib.pyplot as plt

#load sample data
df_state_init, df_forcing = sp.load_SampleData()
grid = df_state_init.index[0]

#run supy/SUEWS simulation
df_output, df_state_end = sp.run_supy(df_forcing, df_state_init)

#plot results and save figure
res_plot = df_output.SUEWS.loc[grid, ['QN', 'QF', 'QS', 'QE', 'QH']]
ax=res_plot.loc['2012 6 4':'2012 6 6'].resample('30T').mean().plot()
plt.show()
ax.figure.savefig('sample_plot.png')
```

The above code will produce a plot of surface energy balance components as follows:

![sample plot](https://github.com/UMEP-dev/SuPy/raw/master/sample_plot.png)

## Tutorial

Please check out [more SuPy tutorials here!](https://supy.readthedocs.io/en/latest/tutorial/tutorial.html)



