CHANGELOG.md

Changelog

Unreleased

List of commits

Added

• add multivariate plotting options to plot
• added plot_kwargs keyword to plot function
• added checks and unified error message for common inputs.
• added command line --version option
• -ll CLI option as a shorthand for --log-level
• basic json support for CLI config files, which are detected by .json-extension.
• --json-field CLI option to use a non-root element of a json file.

Changed

• pin pandas to versions >= 2.0
• parameter fill_na of SaQC.flagUniLOF and SaQC.assignUniLOF is now of type bool instead of one of [None, "linear"]
• in plot function: changed default color for single variables to black with 80% transparency
• in plot function: added seperate legend for flags

Removed

• removed deprecated DictOfSeries.to_df
• removed plotting option with complete history (history="complete")

Fixed

• Bug in SaQC.assignChangePointCluster and SaQC.flagChangePoints: A tuple passed to min_period was only recognised if also window was a tuple.
• SaQC.propagateFlags was overwriting existing flags

Deprecated

• SaQC.andGroup: option to pass dictionaries to the parameter group.
• SaQC.orGroup: option to pass dictionaries to the parameter group.
• plot: parameter phaseplot in favor of usage with mode="biplot"
• plot: parameter cyclestart in favor of usage with marker_kwargs
• plot: option "complete" for parameter history

2.4.1 - 2023-06-22

List of commits

Added

Changed

• pin pandas to versions >= 2.0

Removed

• removed deprecated DictOfSeries.to_df

Fixed

Deprecated

2.4.0 - 2023-04-25

List of commits

Added

• Methods logicalAnd and logicalOr
• Flags support slicing and column selection with list or a pd.Index.
• Expose the History via SaQC._history
• Config function cv (coefficient of variation)

Changed

• Rename interplateInvalid to interpolate
• Rename interpolateIndex to align
• Rewrite of dios.DictOfSeries

Removed

• Parameter limit from align
• Parameter max_na_group_flags, max_na_flags, flag_func, freq_check from resample

Fixed

• func arguments in text configurations were not parsed correctly
• fail on duplicated arguments to test methods
• reample was not writing meta entries
• flagByStatLowPass was overwriting existing flags
• flagUniLOF and flagLOF were overwriting existing flags

Deprecated

• Deprecate flagMVScore parameters: partition in favor of window, partition_min in favor of min_periods, min_periods in favor of min_periods_r
• Deprecate interpolate, linear and shift in favor of align
• Deprecate roll in favor of rolling
• Deprecate DictOfSeries.to_df in favor of DictOfSeries.to_pandas

2.3.0 - 2023-01-17

List of commits

Added

• add option to not overwrite existing flags to concatFlags
• add option to pass existing axis object to plot
• python 3.11 support
• added Local Outlier Factor functionality

Changed

• Remove all flag value restrictions from the default flagging scheme FloatTranslator
• Renamed TranslationScheme.forward to TranslationScheme.toInternal
• Renamed TranslationScheme.backward to TranslationScheme.toExternal
• Changed default value of the parameter limit for SaQC.interpolateIndex and SaQC.interpolateInvalid to None
• Changed default value of the parameter overwrite for concatFlags to False
• Deprecate transferFlags in favor of concatFlags

Removed

• python 3.7 support

Fixed

• Error for interpolations with limits set to be greater than 2 (interpolateNANs)
• Error when fitting polynomials to irregularly sampled data (fitPolynomial)

2.2.1 - 2022-10-29

List of commits

Added

• data label to plot legend

Changed

• dfilter default value inference to respect the function default value of plot

Removed

Fixed

• functions not handling target failed to overwrite existing variables

2.2.0 - 2022-10-28

List of commits

Added

• translation of dfilter
• new generic function clip
• parameter min_periods to SaQC.flagConstants
• function fitLowpassFilter
• tracking interpolation routines in History

Changed

• test function interface changed to func(saqc: SaQC, field: str | Sequence[str], *args, **kwargs)
• lib function butterFilter returns NaN for too-short series
• dfilter default value precedence order

Removed

• closed keyword in flagJumps

Fixed

• fixed undesired behavior in flagIsolated for not harmonized data
• fixed failing translation of dfilter-defaults
• fixed unbound recursion error when interpolating with order-independent methods in interpolateIndex
• fixed not working min_periods condition if window=None in assignZScore
• fixed Exception occuring when fitting polynomials via polyfit to harmonized data, containing all-NaN gaps wider than the polynomial fitting window size.
• fixed bug in function parameter checking
• fixed bug one-off bug in flagJumps

2.1.0 - 2022-06-14

List of commits

Added

• documentation of global keywords
• generic documentation module docurator.py
• documentation of flagging constants
• pyproject.toml
• new function progagateFlags
• include function typehints in parameter documentation
• label parameter to the generic function isflagged

Changed

• flagOffsets parameters thresh and thresh_relative are optional
• corrected false notion of the term residual (replace all occurences of residue by residual)
• FILTER_NONE and FILTER_ALL are top level constants (imported in saqc.__init__)
• renamed maskTime to selectTime
• SaQC.data returns dios.DictOfSeries
• SaQC.flags returns dios.DictOfSeries or pd.DataFrame
• SaQC.data and SaQC.flags are not mutated by function calls
• renamed History.max to History.squeeze
• renamed parameter freq of function flagByStray to window
• DmpScheme: set DFILTER_DEFAULT to 1 in order to not mask the flag 'OK'

Removed

• data accessors SaQC.result, SaQC.data_raw, SaQC.flags_raw

Fixed

• flagOffset failure on falsy thresh
• flagCrossStatistics failure on unaligned input variables
• plot data loss when using dfilter kwarg
• correctDrift: failure on single value intervals
• concatFlags: information loss by appending squeezed histories
• interpolateInvalid: replace flags by interpolated values
• resample: pass resampling function to history.appy()
• tools.seasonalMask: mask swapping with include_bounds=True
• flagGeneric:
  • fixed inconsistent history meta writing
  • fixed handling of existing flags
• proGeneeric: fixed inconsistent history meta writing
• docs: removed documentation of data/flags parameters from automatic sphinx doc

2.0.1 - 2021-12-20

List of commits

Added

• CLI now accepts remote configuration and data files as URL
• new function transferFlags
• improved error messages from flagGeneric and processGeneric
• new ax_kwargs keyword to SaQC.plot function

Changed

• generate documentation from the develop branch
• doctest is now ran upon push to the develop branch, failing doc snippets cause CI-pipeline to fail
• renamed function flagCrossStatistic to flagCrossStatistics

Removed

• removed function flagDriftFromScaledNorm
• removed stats keywords and functionality from SaQC.plot function

Fixed

• RDM/UFZ logos:
  • use the English versions of the respective images
  • use full URLs instead of the repository local URLs in README.md
• fix code snippets in README.md
• fix version confusion
• copyField: fix misleading error message
• flagGeneric: fix failure on empty data
• existing target variables led to function calls on target instead of field
• the functions flagDriftFromNorm, flagDriftFromReference, flagCrossStatistics and flagMVScores now properly support the field-target workflow
• field was not masked for resampling functions
• allow custom registered functions to overwrite built-ins.

2.0.0 - 2021-11-25

List of commits

This release marks the beginning of a new release cycle. Basically the entire system got reworked between versions 1.4 and 2.0, a detailed changelog is not recoverable and/or useful.