Topopyscale

This release includes a working version for exporting to FSM2ohd, and a number of other correction in the code. These are minor typos that led to inconsistencies.

New release bringing latest development of new features into TopoPyScale:
- Support to export to FSM2oshd format 3fe1e1a7bded57e282a8b35c0960881e5c6417a8
- added support for masking out domain or split domain in independent regions 81298bfa8714172cf61cfbb33bdc4c456523009f
- added support for custom `outputs` directory 951451e3e59c3cd633460ea923dd980ec803e338
- rename files containign FSM simulation routines to `sim_fsm.py`
- added support for C-implementation of solar position in pvlib library 074710a2e586d3bceadb78def108edca4e000dce
- `point_id` can be anything from int, float to string 1a32a5d9a3003103928a243b89997613a53258b1

and a number of minor bug fixes

This new version of the package is justified by the release of the JOSS publication following the [review process](https://github.com/openjournals/joss-reviews/issues/5059). In the meantime a number of features have been added.

- support for SLURM server type
- *realtime* processing, downloading latest ERA5 data. For operational setup c0fb49fff0f106bb39601f77b6b5a120901c18f0
- git commit hash and package version added to netcdf file metadata. This ensure to know which version of TopoPyScale was used to create data.
- climate input can now be located outside of the project directory. This prevent to copy multiple times the same data. 77fd990500bfe6934ad6997d70acb106fd44b6d1
- Outputs directory can be named independently of default
- export FSM as netcdf
- streamlined the `environment.yml` file 5af8c8dde5c0d8ca08c9c03de7dafa85a4c543e2
- fix Dask indexing: 4b00cd60bffe6fff5fa16e8f16c95b822c5238a4
- option to give specifc name to cluster points and not depend on the default `point_id` 7695450864e3b9f978c6e22c7c5fda800941d011
- function to export griddedata 420f80a55110b31abd4edede7c69fb30e608375d
- update `xarray` functions that were deprecated 3662908f635a6c7565a6c9217934b98a09b78b1d
- possibility to run FSM in parallel mode 91c8528db69499f5041f9849f739b3253b7f1d25
- added snow routine for steep slope 4d31fd1a2f9c628bd2a208e3862e449ab5af847a

This release includes:
- upgrade to Python 3.9 and Xarray 2.3
- no more problem of memory byt using `open_mfdataset`
- new testing script with github action
- added units to default downscaled dataset
- n_core option is less restrictive now.
- solved a number of path issues
- a number of improvements of the FSM simulation `topo_sim.py` routines
- corrected projection issues when interpolating the climate dataset
- `to_cryogrid()` now compatible with Cryogrid.jl
- added an `environment.yml` file for version controlled install of VE
- plotting function `map_variable()` has been generalized
- and a number of bugs have been caught along the way.

New release resolving a number of bugs:
- a crucial bug occurring when storing datasets during downscalng in `topo_scale.py`. More details in issues: https://github.com/ArcticSnow/TopoPyScale/issues/60 and commit https://github.com/ArcticSnow/TopoPyScale/commit/a33e79f77bd32fd6952c4a269024a31a9a584dae
- a bug resolved in `to_crocus()` https://github.com/ArcticSnow/TopoPyScale/commit/4e73489e85bc567d897752f6d8cc7db0eb6c3011
- a bug when computing level elevation from geopotential https://github.com/ArcticSnow/TopoPyScale/commit/6a4c68e9a0e2f9f1c66427924e75d8c126fbd963
- a bug in to_musa() https://github.com/ArcticSnow/TopoPyScale/commit/81e8978cb152a7b908e53a20eea90853b63aaa18

TopoPyScale` is improving and being tested by more users. New features, improvements and bug fixes justify a new release. The whole downscaling process gain speed by spreading the load on multicores. This was tested on laptops and servers.

**WARNING**: This new release requires Python >= 3.8. Otherwise, python runs into a memory leak and crashes.

New features:
- multicore, paralleization of `topo_scale`
- tools to explore optimal number of clusters in `topo_sub`
- implementation of feature importance for clustering. New field in config file needed
- added precipitation lapse-rate option, [commit](1dfec4804560b7ae331800de17ad0afe1bf0fe5c)

Improvements:
- simplification of path management using the library pathlib
- remove all usage of `open_mfdataset()` or `to_mfdataset` that are not as efficient as expected
- simplification of `tmp` files during downscaling. 85a4149137da173b392d5ceb336f6c18e4877ed9
- added error message in case upper pressure level is not high enough

Bug fixes:
- `to_netcdf()` default case bug fixed
- plotting routines for variable mapping fixed
- fixed bug in time-batch handling of files
- bug in `fetch_WMO()` fixed