Releases | Open Sustainable Technology

[0.9.2] = 2026-01-15

Fixed

fixed problems with sample data downloading (403 errors)

Hydrosphere - Freshwater and Hydrology - Python
Published by hcwinsemius about 2 months ago

[0.9.1] = 2026-01-13

Fixed

fixed python<3.10 compatibility

Hydrosphere - Freshwater and Hydrology - Python
Published by hcwinsemius about 2 months ago

[0.9.0] = 2025-12-23

Changed

Updated documentation to remove OpenPIV as possible engine for PIV.
Updated dependencies to be ready for python >= 3.13

Removed

Frames.get_piv(engine="openpiv") has now been removed. Use Frames.get_piv(engine="numba") instead. This is also
the default engine.

Fixed

fixed unnecessary warning in Velocimetry.Mask.variances related to all-NaN slices

Hydrosphere - Freshwater and Hydrology - Python
Published by hcwinsemius 3 months ago

[0.8.12] = 2025-11-13

Added

Added CrossSection.detect_water_level_s2n for signal to noise ratios.

Changed

The CLI recipe .yml can now handle lists in water_level.frames_options and usage of a signal to noise acceptance
threshold in each frames_options to control if a water level is accepted. If the signal to noise is lower than
set threshold, the next frames_options will be used to attempt resolving a water level with a higher signal to
noise ratio. This allows for treatment of videos under varying conditions, in which water level detection may
profit from different video treatments.

Deprecated

Removed

Fixed

docstring of masks indentation issue
CrossSection docstring Sphinx repetition removed.

Hydrosphere - Freshwater and Hydrology - Python
Published by hcwinsemius 4 months ago

[0.8.11] = 2025-10-01

Added

Derivation of transect properties surface area and wetted perimeter.
Added method transect.get_v_surf for average surface velocity, and transect.get_v_bulk for bulk velocity.

Changed

Using add_text=True in transect.plot now also displays average surface and bulk velocity.

Removed

transect.get_wetted_perspective is no longer required as this can be derived from transect.cross_section.
transect.get_xyz_perspective is no longer required as this can be derived from transect.cross_section.

Hydrosphere - Freshwater and Hydrology - Python
Published by hcwinsemius 5 months ago

[0.8.10] = 2025-09-22

Added

option ensemble_corr with frames.get_piv. This performs ensemble correlation averaging on cross-correlation and
results in a less noisy estimate of surface velocities, albeit only one single time stamp. With this option, also a
number additional thresholds can be defined:
- corr_min (default: 0.2): minimum correlation accepted in the cross-correlation results.
- s2n_min (default: 3): minimum signal=to-noise ratio accepted in the cross-correlation results.
- count_min (default: 0.2) minimum valid correlation results after masking on corr_min and s2n_min to accept
  results over the interrogation window.

Hydrosphere - Freshwater and Hydrology - Python
Published by hcwinsemius 6 months ago

[0.8.9] = 2025-08-29

Fixed

issue with water level plot on a perfect flat plane. Solved by not plotting water level in this case.

Hydrosphere - Freshwater and Hydrology - Python
Published by hcwinsemius 6 months ago

[0.8.8] = 2025-07-14

Added

Changed

Deprecated

Removed

Fixed

issues with plotting cross sections in edge cases with water levels equal to lowest point or above highest point
fixed problem with situations where either the cross section data from a shapefile or the camera configuration
did not contain CRS information. This is now correctly parsed when creating a CrossSection instance.

Hydrosphere - Freshwater and Hydrology - Python
Published by hcwinsemius 8 months ago

[0.8.7] = 2025-06-30

Added

CLI option --cross_wl
A new 3-point bounding box estimation, ideal for selecting a bounding box in strongly oblique cases. First select left
bank, then right bank, then a point up- or downstream from the selected line for the size of the bounding box.
rvec and tvec are written to camera configuration after fitting.

Changed

CLI option --cross_wl now replaces --cross for optical water level estimation. --cross is only used for
discharge calculation
Plotting in camera objective is accelerated
water level detection with CrossSection.detect_water_level can now consume either min_z and max_z (for levels
in the original coordinate system) or min_h and max_h (for levels using the local h_ref datum if provided).
These minimum and maximum levels can be used to pre-condition the level range that the algoithm will seek in.
Pose fitting can now be performed with a pre-defined camera matrix and set of distortion coefficients. This is very
useful when a user has already pre-calibrated these parameters. It will improve the fit of the rvec and tvec,
i.e. rotation and translation vectors.
Changed code coverage reporting from Codecov to sonarqube for code coverage reports. Codecov caused issues with
numba code.

Deprecated

Removed

Fixed

incorrect estimation of optical water level if bank="near" was used. This resulted in only a smaller portion of the
cross section being used. Now the full nearby side is used.

Hydrosphere - Freshwater and Hydrology - Python
Published by hcwinsemius 8 months ago

This release allows for pre-fixing camera lens parameter including focal length and the k1 and k2 radial distortion. When these parameters are provided on command line, the camera matrix and distortion coefficients are not optimized but fixed instead. If only one or two parameters, or none at all are provided, the remainder parameters will be estimated through optimization.

A small bug fix was also made in the reading of geojsons without CRS. This is now possible without resulting in any errors.

What's Changed

220 fit pose fix intrinsics by @hcwinsemius in https://github.com/localdevices/pyorc/pull/222

Full Changelog: https://github.com/localdevices/pyorc/compare/v0.8.5...v0.8.6

Hydrosphere - Freshwater and Hydrology - Python
Published by hcwinsemius 10 months ago