v0.8.0 (2025-03-24)

This release includes inclusion of
marimo apps, packaged with
docker, which can be used to expose a simple web interface where
fractopo validation and network analysis can be conducted. The
containers are found in
ghcr.io.

Besides that, much of the code is now being type-checked during runtime
with beartype. This might
result in errors when trying to input data in a wrong type when
fractopo is used as a library.

New Features

• (marimos): Add marimo apps to ./marimos
• (network): Allow specifying cell size for export
• (length_distributions): Allow specifying which fits to plot. E.g.,
  you can now only plot a powerlaw fit.
• (network): Export full network description, including length
  distribution fit variables, in parameter point.
• (length_distributions): Add calculation of an approximate
  Kolmogorov-Smirnov critical value.

Fixes

• (general): Allow underscore in names
• (general): Stop fractopo from crashing on joblib cache initialisation failure.

Full set of changes:
v0.7.1...v0.8.0

v0.7.1 (2025-02-05)

Minor bug release.

Bug Fixes

• general: Fix determine_node_junctions logic to avoid IndexError.

v0.7.0 (2024-11-1)

This release drops support for pygeos and Python 3.8 🐍 following
upstream packages. This has resulting in code refactoring and fixes. No
new features.

Bug Fixes

• analysis: Topological plotting fixes
• cli:
  • Fix allow_fix option for network tracevalidate
• tval:
  • Improve stacked (STACKED TRACES) detection
  • Handle empty trace geodataframe
  • Handle split overlap error
  • Handle flaky shapely overlap detection
• Force return types for some flaky functions (convert to float)
• Remove all pygeos references, i.e., stop using it as it is merged
  into shapely

Changelog

v0.6.0 (2023-12-14)

New Features

• analysis: Allow creating contour grids without determination of
  branches and nodes i.e. topology
  (854d1e03)

Fixes

• analysis: Disable parallel processing on Windows due to
  instability
  (614070fd)

Full set of changes:
v0.5.3...v0.6.0

Changelog

v0.5.3 (2023-05-09)

New Features

• A basic input geometry check is done before starting tracevalidate and
  network command-line invocations as suggested in
  #36.

• joblib cache settings can be set from environment
  variables.

Fixes

• (branches_and_nodes): Fixed angle_to_point by setting distance
  and similarity checks to more reasonable accuracy.

• (general): Now crs is added before merging geodataframes in
  dissolve_multi_part_traces

• (length_distribution): Handle empty arrays in in powerlaw.Fit
  invocations by returning None instead of a Fit instance.

• (analysis): Length plot ticks are set explicitly in setup_ax_for_ld to
  avoid differences between Python package versions
  (#25).

• Z-coordinates are now handled across fractopo i.e. they do not raise
  errors. However, they are not guaranteed to be kept in results such as
  validated traces. Reported in
  #21.

• (analysis): Removed function signatures with mutable default arguments.

Full set of changes:
v0.5.2...v0.5.3

Changelog

v0.5.2 (2023-01-16)

New Features

• Add plain keyword argument to output less visualized rose and
  length plots.

Fixes

• Deprecated CachedNetwork.

• Fixed typos in code.

Build

• Restructured continous integration and build structure.

  • E.g. optimized auxiliary task runs on GitHub Actions and added
    a binary cache for runs.

Docs

• Added ./paper directory with a manuscript describing fractopo.

Full set of changes:
v0.5.1...v0.5.2

Changelog

v0.5.1 (2022-11-28)

Fixes

• (analysis): Fixed XYI and branch ternary plot sample count to only report the
  valid node and branch counts.

• (analysis): Fixed the cut-off vertical line to correspond to the
  actual cut-off rather than the lowest remaining length.

• (general): Allow MultiLineStrings in determine_valid_intersection_points.

• (analysis): Made sure the order of lengths used in plotting the fitted y values
  is correct in multi-scale length plots.

Full set of changes:
v0.5.0...v0.5.1

Changelog

v0.5.0 (2022-11-04)

New Features

• Implemeted caching and parallel execution of expensive functions
  in Network analysis. This should speed up (repeated) runs on the
  same datasets. This implementation is based on joblib which provided
  the functionality without issue.

• (analysis): Implemented plotting length data with the Probability Density
  Function (PDF) on the y-axis instead of Complementary Cumulative Number (CCM)

Fixes

• (analysis): Reported CachedNetwork deprecation

Full set of changes:
v0.4.1...v0.5.0

Changelog

v0.4.1 (2022-10-24)

New Features

• (cli): Save additional json data to output directory
  when running fractopo network for possible post-processing
  needs.

Fixes

• (network): General fixes to fractopo network command-line
  entrypoint.

• Sort keys in any json output.

• (network): Allow MultiLineString geometries when possible.
  Topologically non-valid data should be analyzeable with the
  best effort possible.

• (branches_and_nodes): Fixes small logging bug.

Full set of changes:
v0.4.0...v0.4.1

Changelog

v0.4.0 (2022-06-17)

New Features

• (analysis.network): Added method (export_network_analysis) for
  exporting a selected set of Network analysis results.

• (analysis): Added parameters for representing the real counts of traces and
  branches.

• (general): Added azimuth_to_unit_vector function.

• (analysis): Implemented rose plot functionality for non-axial data.

• (analysis.multi_network): Added a MultiNetwork description function
  (basic_network_descriptions_df).

• (analysis.multi_network): Implemented a rough first draft of a multi-scale
  length distribution fit optimizer using scipy.

Fixes

• (analysis): handle empty dataframe

• update single dist plot

• (analysis): change zorder

• (analysis): handle empty array

• (analysis): finalize multi-scale shadows

• (analysis): show truncated length data

• (analysis): add shadows to ternary plot points

• (general): use latex format for units

• (analysis): extend rose plot

• (analysis): return polyfits from set-wise dists

• (analysis): improve length distributions plots

• (analysis): improved length distribution plots

• (analysis): specify if lengths are normed

• (analysis): pass using_branches to LineData

• (analysis): fix basic_network_descriptions_df

• (analysis): fix rename

• (analysis): report min and max lengths

• (analysis): handle extra args

• (analysis): finalize implement of optimization

Full set of changes:
v0.3.0...v0.4.0