Recent Releases of fractopo

fractopo - v0.8.0

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

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] about 1 year ago

fractopo - v0.7.1

v0.7.1 (2025-02-05)

Minor bug release.

Bug Fixes

  • general: Fix determinenodejunctions logic to avoid IndexError.

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 1 year ago

fractopo - v0.7.0

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

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 1 year ago

fractopo - v0.6.0

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

Scientific Software - Peer-reviewed - Python
Published by nialov over 2 years ago

fractopo - https://github.com/nialov/fractopo/releases/tag/v0.5.3

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 https://github.com/nialov/fractopo/issues/36.

  • joblib cache settings can be set from environment variables.

Fixes

  • (branchesandnodes): 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 (https://github.com/nialov/fractopo/issues/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 https://github.com/nialov/fractopo/issues/21.

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

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

Scientific Software - Peer-reviewed - Python
Published by nialov about 3 years ago

fractopo - v0.5.2

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

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 3 years ago

fractopo - v0.5.1

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

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 3 years ago

fractopo - v0.5.0

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

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 3 years ago

fractopo - v0.4.1

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.

  • (branchesandnodes): Fixes small logging bug.

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

Scientific Software - Peer-reviewed - Python
Published by nialov over 3 years ago

fractopo - v0.4.0

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.multinetwork): Added a MultiNetwork description function (`basicnetworkdescriptionsdf`).

  • (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 basicnetworkdescriptions_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

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] almost 4 years ago

fractopo - v0.3.0

Changelog

v0.3.0 (2022-02-11)

New Features

  • (analysis.multi_network): Added multi-scale azimuth set length distribution plotting.

  • (analysis.network): Implemented azimuth set length distribution plotting.

  • (analysis): Implemented a naive implementation of Network caching with CachedNetwork class. Errors will be raised if caching fails. User is recommended to fallback to Network in that case.

Fixes

  • (cli): Validation column in validated trace dataset is now set as a tuple instead of as list to avoid conflicts with string representations of the data in e.g. GeoJSON.

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

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 4 years ago

fractopo - v0.2.6

Changelog

v0.2.6 (2022-02-03)

New Features

  • (analysis.multi_network): Enable plotting multiple networks into the same ternary XYI or branch type plot.

Fixes

  • (analysis.network): Add missing property decorator to branch_lengths_powerlaw_fit_description.

Full set of changes: v0.2.5...v0.2.6

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 4 years ago

fractopo - v0.2.5

Changelog

v0.2.5 (2022-01-23)

Small update to clean up and update dependencies in pyproject.toml.

Full set of changes: v0.2.4...v0.2.5

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 4 years ago

fractopo - v0.2.4

Changelog

v0.2.4 (2022-01-13)

Contains minor fixes and a feature update to NetworkRandomSampler.

New Features

  • (random_sampling): Allow not determining topology when performing random sampling using NetworkRandomSampler.

Fixes

  • (tval): Handle TypeError from shapely.ops.split in split_to_determine_triangle_errors by checking for the intersection between traces.

  • (linedata): Refrain from using linegdf in operations as it might not contain up-to-date columns. Use line_data attributes instead.

  • (noxfile): Setup sphinx-autobuild session for automatic creation of documentations as source files change.

Full set of changes: v0.2.3...v0.2.4

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 4 years ago

fractopo - v0.2.3

Changelog

v0.2.3 (2021-12-04)

Fixes

  • (parameters): fix pie plot function

  • refactor deprecated shapely features

  • (general): check type

  • (random_sampling): get_ methods are deprecated

  • (branchesandnodes): set crs for outputs

Full set of changes: v0.2.2...v0.2.3

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 4 years ago

fractopo - v0.2.2

Changelog

v0.2.2 (2021-11-12)

New Features

  • (multi_network): add multi-scale length fit

  • (analysis): implement multiple fitters

Fixes

  • (cli): finalize nialog implement

  • change name to non-conflicting key

  • (cli): setup logging with nialog

  • (tval): fix trace validation slowdown logging

  • (general): use static minimum line length

  • (analysis): remove usage of cached_property

  • (tval): catch TypeError from shapely split

Full set of changes: v0.2.1...v0.2.2

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 4 years ago

fractopo - v0.2.1

Changelog

v0.2.1 (2021-09-22)

Full set of changes: v0.2.0...v0.2.1

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 4 years ago

fractopo - v0.2.0

Changelog

v0.2.0 (2021-09-20)

New Features

  • (analysis): implement multiscale fit

  • implement network-cli

Fixes

  • (analysis): handle mapped radii values

  • (cli): finish network-cli implement for now

  • deprecate saferunaryunion

  • fix truncate and circular input logic

Full set of changes: v0.1.4...v0.2.0

Scientific Software - Peer-reviewed - Python
Published by github-actions[bot] over 4 years ago