CHANGELOG.md

Changelog

0.4.1

ipyforcegraph 0.4.1

• adds Tint and Colorize wrappers to fine-tune color channels (and opacity)
• all wrappers have a convenience root property (not trait), which returns the final feature which would change a graph (e.g. NodeShapes)
  • care should be taken to avoid cycles of .wrapped wrappers: these will crash the renderer

@jupyrdf/jupyter-forcegraph 0.4.1

• updated to force-graph 1.43.3 and 3d-force-graph 1.72.3

0.4.0

ipyforcegraph 0.4.0

• adds CaptureAs, which can wrap any nearly any value (such as a Nunjucks, Column, or subclasses like ContinuousColor) to store the calculated property in a new column on the node or link
  • the captured value might be available e.g. in other Nunjucks values, but there are likely race conditions
  • care should be taken to avoid conflicting column names, either with the original source data or those configured by other behaviors and facets
    • selecting a column_name known to be used by force-graph (such as x or y) will raise a trait error

Breaking

• blanket var(--...) replacing, introduced in 0.3.8 is removed
  • the ReplaceCssVariables wrapper can now be applied to any property

@jupyrdf/jupyter-forcegraph 0.4.0

TBD

0.3.8

ipyforcegraph 0.3.8

TBD

@jupyrdf/jupyter-forcegraph 0.3.8

• adds support for CSS var() values in relevant behaviors and values (e.g. colors, fonts)
  • this does not support calc

0.3.7

ipyforcegraph 0.3.7

• adds LinkShapes.shapes with support for the Text shape
• adds offset_x, offset_y, and offset_z to all shapes
• adds Text.size_pixels for fine-tuning performance/quality when rendering in 3D

@jupyrdf/jupyter-forcegraph 0.3.7

• adds LinkShapesModel.shapes with support for the TextModel shape

0.3.6

ipyforcegraph 0.3.6

• rename GraphDirector.padding to .fit_padding

@jupyrdf/jupyter-forcegraph 0.3.6

• normalize GraphDirectorModel.padding to fit_padding

0.3.5

ipyforcegraph 0.3.5

@jupyrdf/jupyter-forcegraph 0.3.5

• 2D node text can now be provided by non-text values (by constant or Column)

0.3.4

ipyforcegraph 0.3.4

• adds GraphCamera behavior which can observe the contents of a graph viewport
• adds GraphDirector behavior which can update the graph viewport

@jupyrdf/jupyter-forcegraph 0.3.4

TBD

0.3.3

ipyforcegraph 0.3.3

@jupyrdf/jupyter-forcegraph 0.3.3

• improves handling of node_ and link_preserve_columns, respecting ordering

0.3.2

ipyforcegraph 0.3.2

• improves default selection behavior for LinkShapes.curvature and LinkShapes.line_dash
• adds line_dash to all 2D shapes
• removes the significance of order in ForceGraph.behaviors
  • all node, link, and graph behaviors now have a (sensible default) .rank trait which determines the order in which they are applied.
  • lower rank are applied before higher rank
• adds DodoSource for interpreting doit tasks graphs
• adds node_preserve_columns, link_id_column, and link_preserve_columns
  • these allow for keeping values when updating data, such as those created by the simulation engine (e.g. x and y) and custom columns, such as created by Selection behaviors
  • link_id_column is required if the number and or order of links change
• adds ContinuousColor and OrdinalColor color schemes, supported by d3-scale-chromatic

@jupyrdf/jupyter-forcegraph 0.3.2

• adds more jsMath functions (cosh, sinh, tanh, and hypot) and provided more comprehensive documentation for them in Behaviors.ipynb

Documentation

• adds NodeShape UI controls in Shapes.ipynb and Behaviors.ipynb
• fixes labels for UI controls in Behaviors.ipynb
• updates to latest JupyterLite packages
• adds non-JupyterLite-compatible examples
  • DodoSource.ipynb for viewing and running doit tasks
  • DodoApp.ipynb for demonstrating a full app, featuring
    • ipylab
    • ipydatagrid

0.3.1

ipyforcegraph 0.3.1

• fixes compatibility with jupyterlab_widgets 3.0.6
• adds curvature, line_dash to LinkShapes

@jupyrdf/jupyter-forcegraph 0.3.1

0.3.0

ipyforcegraph 0.3.0

• adds a configurable NodeShapes, compatible with both ForceGraph and ForceGraph3D
  • adds initial Text, Circle and Rectangle which can be stacked in .shapes
• adds DAG to GraphForces
• adds manual ForceGraph.reheat to restart simulation

Breaking Changes

• the column_name and template features of Behaviors are consolidated into the Nunjucks and Column classes

  • each has a single value,
  • and may be coerced into a specific JS-compatible type (e.g. boolean or number)

• most dynamic behaviors have been merged to use this pattern, diverging from the upstream JS API in favor of more idiomatic, compact descriptions. For example, for link arrows:

  • 0.2.x

    graph.behaviors = [
        LinkDirectionalArrowColor(column="color"),
        LinkDirectionalArrowLength(template="10"),
        LinkDirectionalArrowRelPos(template="{{ link.value / 10 }}"),
    ]

  • 0.3.x

    graph.behaviors = [
        LinkArrows(
            color=Column("color"),
            length=1.0,
            relative_position=Nunjucks("{{ link.value / 10 }}")
        ),
    ]

@jupyrdf/jupyter-forcegraph 0.3.0

• adds connection to force-graph DAG configuration

0.2.0

ipyforcegraph 0.2.0

• raise minimum python from 3.7 to 3.8
• improve types and add py.typed file
• adds background_color (defaults to transparent, encoded as rgba(0, 0, 0, 0.0))
• adds GraphData which can capture the as-simulated data from the browser
• adds LinkSelection which mirrors NodeSelection, but returns link indices in .source.links, as they are not guaranteed to have a an id column
• adds LinkWidths
• adds NodeSizes
• adds most of the browser's Math functions and constants to the environment made available to .template values
• adds GraphForces, which exposes a large number of the forces from [d3-force-3d]
• renames the top-level graph imports ipyforcegraph.graphs (was ipyforcegraph.forcegraph)
• the DataFrameSource, and its new subclass WidgetSource, can be imported from ipyforcegraph.sources

@jupyrdf/jupyter-forcegraph 0.2.0

• implements bidirectional serialization of zstd-compressed dataframes
• updates TypeScript target to es2018
• update to 3d-force-graph 1.71.1
• update to force-graph 1.43.0

0.1.0

ipyforcegraph 0.1.0

• initial release

@jupyrdf/jupyter-forcegraph 0.1.0

• initial release