Diive

This update focuses on wind direction time series and adds the first example notebooks
to `diive`. From now on, new example notebooks will be added regularly.

New features

- **Wind direction offset correction**: Compare yearly wind direction histograms to
reference, detect offset in comparison to reference and correct wind directions
for offset per year (`pkgs.corrections.winddiroffset.WindDirOffset`)
- **Wind direction aggregation**: Calculate mean etc. of wind direction in
degrees (`core.funcs.funcs.winddirection_agg_kanda`)

Notebooks

- Added new notebook for **wind direction offset correction** in `notebooks/Corrections/WindDirectionOffset.ipynb`
- Added new notebok for **reading ICOS BM files** in `notebooks/ReadFiles/Read_data_from_ICOS_BM_files.ipynb`

Changes

- **Histogram analysis** now accepts pandas Series as input (`pkgs.analyses.histogram.Histogram`)

Additions

- Added unittests for reading (some) filetypes

Additions

- The DataFileReader can now directly read zipped files (`core.io.filereader.DataFileReader`)
- **Interactive time series plot**: (`core.plotting.timeseries.TimeSeries.plot_interactive`)
- added x- and y-axis to the plots
- new parameters `width` and `height` allow to control the size of the plot
- more controls such as undo/redo and zoom in/zoom out buttons were added
- The filetypes defined in `diive/configs/filetypes` now accept the setting `COMPRESSION: "zip"`.
In essence, this allows to read zipped files directly.
- New filetype `ICOS_H2R_CSVZIP_10S`

Changes

- Compression in filetypes is now given as `COMPRESSION: "None"` for no compression,
and `COMPRESSION: "zip"` for zipped CSV files.

Additions

- `LocalSD` in `StepwiseMeteoScreeningDb` now accepts the parameter `winsize` to
define the size of the rolling window (default `None`, in which case the window
size is calculated automatically as 1/20 of the number of records).
(`pkgs.qaqc.meteoscreening.StepwiseMeteoScreeningDb.flag_outliers_localsd_test`)

Bugfix

- Fixed bug: outlier test `LocalSD` did not consider user input `n_sd`
(`pkgs.qaqc.meteoscreening.StepwiseMeteoScreeningDb.flag_outliers_localsd_test`)

Bugfix

- Fixed bug: during resampling, the info for the tag `data_version` was incorrectly
stored in tag `freq`. (`pkgs.qaqc.meteoscreening.StepwiseMeteoScreeningDb.resample`)

Additions

- Added plotting library `bokeh` to dependencies

Changes

- When combining data of different time resolutions, the data are now combined using
`.combine_first()` instead of `.concat()` to avoid duplicates during merging. This
should work reliably because data of the highest resolution are available first, and then
lower resolution upsampled (backfilled) data are added, filling gaps in the high
resolution data. Because gaps are filled, overlaps between the two resolutions are avoided.
With `.concat()`, gaps were not filled, but timestamps were simply added as new records,
and thus duplicates in the timestamp occurred.
(`pkgs.qaqc.meteoscreening.StepwiseMeteoScreeningDb._harmonize_timeresolution`)
- Updated dependencies to newest possible versions

Changes

- Removed the packages `jupyterlab` and `jupyter-bokeh` from dependencies, because
the latter caused issues when trying to install `diive` in a `conda` environment
on a shared machine. Both dependencies are still listed in the `pyproject.toml`
file as `dev` dependencies. It makes sense to keep both packages separate from
`diive` because they are specifically for `jupyter` notebooks and not strictly
related to `diive` functionality.