Describe the Issue
A clear and concise description of what the issue is.

Location
Following the convention of SUEWS, supy loads meteorological forcing (met-forcing) files at the grid level.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
grid level -- what is meant by this? for individual grids?

Describe the Issue
As with the other pages -- add some links so this is usable

Location
https://supy.readthedocs.io/en/latest/data-structure/df_output.html

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Direct link to this address from the paper -- user/reader -- does know how to use this -- they will come back to - but need some context an details

When forcing SUEWS to create error, no problems.txt is created.

Describe the Issue
Add to the manual -- then send a link -- when someone encounters a problem -- then instructions etc will become clearer and can be used by others

Location
Problem from a User -

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Please do the following:

1. dump df_state_init and df_forcing as pickle files:

df_state_init.to_pickle("df_state_init.pkl")
df_forcing.to_pickle("df_forcing.pkl")

2. save the .pkl files and your notebook into one archive file (e.g., test.zip)

Describe the Issue
Need to indicate which version of Python needs to be installed

Location
quick start

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

Describe the Issue
Need a starting point if someone doesn't know anything about Python. At the moment this is harder to get started than for someone who is not familiar with Fortran.

Location
The link to the page you noticed an issue.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

I cannot find info on how to access individual grid results in runs with more than one grid.

Filecode_SUEWS_OutputFormat.txt is not created in SuPy. This file should be created using supy.save_supy or is this information available somewhere else now? This file is used to create scroll-down lists in UMEP.

• visualisation,
• stat calculations

Describe the Issue
When I run supy in Jupyter, error of 'Kernel died and restart' occurs because missing values are set '-999'. After I change missing values to 'Nan', supy works.
supy version is 2019.5.28
platform is 'Windows-10-10.0.17134-SP0'
numpy version is '1.16.4'

Location
https://github.com/Urban-Meteorology-Reading/WRF-SUEWS-AMF/issues/4

• background climate
• surface characteristic
• human activities

Are the input and output paths available within supy and if so where?

Describe the Issue
Checking the forcing data?

1. Are there are no gaps
2. Are all the data there (e.g. rainfall)

Location
The link to the page you noticed an issue.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Shui Liu analysis - for site -- but no rainfall data

Describe the Issue
API changed in ver 2019.5.24 thus the interaction part should be updated.

Location
https://supy.readthedocs.io/en/dev-test/tutorial/external-interaction.html

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

• pickle
• csv
• netCDF

will adopt pint-based approach: https://pint.readthedocs.io/en/latest/pint-pandas.html

Need to add links/section in SUEWS manual about SuPY

• need to make it clear how the data are updated
  e.g. add a section in this part of the manual and other places (e.g. tutorials etc)
  https://suews-docs.readthedocs.io/en/latest/prepare-to-run-the-model.html

Originally posted by @suegrimmond in #6 (comment)

Describe the Issue
Parallel capacity has been natively integrated into supy; thus this tutorial should be updated.

Location
https://supy.readthedocs.io/en/dev-test/tutorial/impact-studies-parallel.html

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

QGIS3 provides capabilities to use tasks, i.e. threads which will make QGIS3 functional when SuPY is running. This probably requires that SuPY tells QGIS when computation is finished.

Describe the Issue
Not enough for a user to know what is actually needed

Location
https://supy.readthedocs.io/en/latest/data-structure/df_forcing.html

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Need to add links to SUEWS

• what height
  time step
  gap-filling

Describe the Issue
Need to link this to something to make it usable

Location
: https://supy.readthedocs.io/en/latest/data-structure/df_state.html

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
From this link - sent to it from the paper -- do not know how to use etc
Need some context, examples etc

I would like the old output written out. Will this be possible to add? I assume that many other users also would like this.

QGIS3 crash when error is happening in SuPy. I set netradiationmethod=43 in RunControl.nml and QGIS3 crash before eroor message appear in python console.

SuPY version 2019.4.17
QGIS version 3.6.1

Describe the Issue
lmfit needs to be added as requirement modules

Location
The link to the page you noticed an issue.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

some related issues:
numpy/numpy#6539
numpy/numpy#7855

No plots are produced on my Windows. The following code is used:

import supy as sp
import pandas as pd
import numpy as np
from pathlib import Path
#matplotlib inline
import time

path_runcontrol = Path('C:/Users/xlinfr/Documents/PythonScripts/Testthings/UMEP_run/RunControl.nml')
df_state_init = sp.init_supy(path_runcontrol)
grid = df_state_init.index[0]
df_forcing = sp.load_forcing_grid(path_runcontrol, grid)
t1_start = time.process_time()
df_output, df_state_final = sp.run_supy(df_forcing, df_state_init)
t1_stop = time.process_time()
print(t1_stop - t1_start)
df_output_suews=df_output['SUEWS']
df_output_suews_rsmp=df_output_suews.loc[grid].resample('1h').mean()
df_output_suews_rsmp.loc[:,['QN','QS','QE','QH','QF']].plot()

SuPy is currently writing out full number of columns (86). Make supy.save_supy write output files based on writeouoption similar to the fortran version of SUEWS.

Describe the Issue
A clear and concise description of what the issue is.
Not sure it is SuPy related or Jupiter notebook related. When I load the df_state_init data using SuPy, and then if I change a parameters in the run folder, e.g. Frpaved, and again load df_state_init, the new values are not loaded. I need to restart the kernel and run the scripts again to fix this problem. I was wondering if this is intentional to make sure users try to change the parameters indirectly from SuPy not the files.
Location
The link to the page you noticed an issue.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

to help users better identify issues and run simulations.

There should be a check if Albedo_min (or max) and Albedo_id Are inconsistent. Best wishes Sue

Describe the Issue
A downscaling time step of 10 min would result a dataframe with nan values.

Location
https://github.com/matlipson/supy_test

base input

• ERA-5 data
• WFDEI data
• user custom data

Where can I find changes in input files made since 2018a? I got errors now when running data from older versions.

An error has occurred while executing Python code:

KeyError: "None of [[('TrafficRate_WD', 'base', 'base'), ('TrafficRate_WE', 'base', 'base')]] are in the [columns]"
Traceback (most recent call last):
File "C:/Users/xlinfr/AppData/Roaming/QGIS/QGIS3\profiles\default/python/plugins\UMEP\SuewsSimple\suews_simple.py", line 545, in start_progress
Suews_wrapper_v2019a.wrapper(self.model_dir)
File "C:/Users/xlinfr/AppData/Roaming/QGIS/QGIS3\profiles\default/python/plugins\UMEP\suewsmodel\Suews_wrapper_v2019a.py", line 35, in wrapper
df_state_init = sp.init_supy(path_runcontrol)
File "C:\OSGEO41\apps\Python37\lib\site-packages\supy\supy_module.py", line 69, in init_supy
df_state_init = load_InitialCond_grid_df(path_runcontrol_x)
File "C:\OSGEO41\apps\Python37\lib\site-packages\supy\supy_load.py", line 1482, in load_InitialCond_grid_df
df_init = load_SUEWS_InitialCond_df(path_runcontrol)
File "C:\OSGEO41\apps\Python37\lib\site-packages\supy\supy_load.py", line 1270, in load_SUEWS_InitialCond_df
df_gridSurfaceChar = load_SUEWS_SurfaceChar_df(path_input)
File "C:\OSGEO41\apps\Python37\lib\site-packages\supy\supy_load.py", line 1024, in load_SUEWS_SurfaceChar_df
df_gridSurfaceChar_exp = gen_df_gridSurfaceChar_exp(path_input)
File "C:\OSGEO41\apps\Python37\lib\site-packages\supy\supy_load.py", line 1014, in gen_df_gridSurfaceChar_exp
for k in dict_var_tuple
File "C:\OSGEO41\apps\Python37\lib\site-packages\supy\supy_load.py", line 1014, in
for k in dict_var_tuple
File "C:\OSGEO41\apps\Python37\lib\site-packages\pandas\core\indexing.py", line 1472, in getitem
return self._getitem_tuple(key)
File "C:\OSGEO41\apps\Python37\lib\site-packages\pandas\core\indexing.py", line 870, in _getitem_tuple
return self._getitem_lowerdim(tup)
File "C:\OSGEO41\apps\Python37\lib\site-packages\pandas\core\indexing.py", line 979, in _getitem_lowerdim
return self._getitem_nested_tuple(tup)
File "C:\OSGEO41\apps\Python37\lib\site-packages\pandas\core\indexing.py", line 1058, in _getitem_nested_tuple
obj = getattr(obj, self.name)._getitem_axis(key, axis=axis)
File "C:\OSGEO41\apps\Python37\lib\site-packages\pandas\core\indexing.py", line 1901, in _getitem_axis
return self._getitem_iterable(key, axis=axis)
File "C:\OSGEO41\apps\Python37\lib\site-packages\pandas\core\indexing.py", line 1143, in _getitem_iterable
self._validate_read_indexer(key, indexer, axis)
File "C:\OSGEO4~1\apps\Python37\lib\site-packages\pandas\core\indexing.py", line 1206, in _validate_read_indexer
key=key, axis=self.obj._get_axis_name(axis)))
KeyError: "None of [[('TrafficRate_WD', 'base', 'base'), ('TrafficRate_WE', 'base', 'base')]] are in the [columns]"

the issue is derived from #22

• phenology
• surface wetness

Describe the Issue
Need to show users how to modify model parameters etc. e.g Tutorial 1 - change land surface fractions

Location
The link to the page you noticed an issue.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Add any other context about the problem here.

Describe the Issue
Unexpected nan values are introduced when resampling Kdown if incomplete days are encountered.

Location
_load.py

QN related:

• albedo
• morphology
• LAI if vegetated surface

QS related:

• OHM coefficients

QE related:

• surface conductance

an example file
SUEWS_WithinGridWaterDist.txt