Tip
- Need help? Please let us know in the UMEP Community.
- Find an issue within this page? Please report it in the GitHub issues.
- A good understanding of SUEWS is a prerequisite to the proper use of SuPy.
Tutorials¶
To familiarise users with SuPy urban climate modelling and to demonstrate the functionality of SuPy, we provide the following tutorials in Jupyter notebooks:
Note
- The Anaconda distribution is suggested as the scientific Python 3 environment for its completeness in necessary packages. Please follow the official guide for its installation.
- Users with less experience in Python are suggested to go through the following section first before using SuPy.
Python 101 before SuPy¶
Admittedly, this header is somewhat misleading: given the enormity of Python, it’s more challenging to get this section correct than coding SuPy per se. As such, here a collection of data analysis oriented links to useful Python resources is provided to help novices start using Python and then SuPy.
The gist of Python: a quick introductory blog that covers Python basics for data analysis.
Jupyter Notebook: Jupyter Notebook provides a powerful notebook-based data analysis environment that SuPy users are strongly encouraged to use. Jupyter notebooks can run in browsers (desktop, mobile) either by easy local configuration or on remote servers with pre-set environments (e.g., Google Colaboratory, Microsoft Azure Notebooks). In addition, Jupyter notebooks allow great shareability by incorporating source code and detailed notes in one place, which helps users to organise their computation work.
Installation
Jupyter notebooks can be installed with pip on any desktop/server system and open .ipynb notebook files locally:
python3 -m pip install jupyter -U
Extensions: To empower your Jupyter Notebook environment with better productivity, please check out the Unofficial Jupyter Notebook Extensions. Quick introductory blogs can be found here and here.
pandas:
pandas
is heavily used in SuPy and thus better understanding of pandas is essential in SuPy workflows.- Introductory blogs:
- Quick dive into Pandas for Data Science: introduction to pandas.
- Basic Time Series Manipulation with Pandas: pandas-based time series manipulation.
- Introduction to Data Visualization in Python: plotting using pandas and related libraries.
- A detailed tutorial in Jupyter Notebooks:
- Introductory blogs: