Releases: Qiskit/rustworkx
retworkx 0.5.0
This release include a number of new features and bug fixes. The main
focus of the improvements of this release was to increase the ease of
interacting with graph objects. This includes adding support for generating dot
output which can be used with graphviz (or similar tools) for visualizing
graphs adding more methods to query the state of graph, adding a generator
module for easily creating graphs of certain shape, and implementing the
mapping protocol so you can directly interact with graph objects.
Added
- A new method,
to_dot()
, was added toPyGraph
andPyDiGraph
. It will
generate a dot format representation of the object which can be used
with Graphivz (or similar tooling) to generate visualizations of the
graph. - Added a new function,
strongly_connected_components()
, to get the list
of strongly connected components of aPyDiGraph
object. - A new method,
compose()
, for combing another graph object of the same
type was added toPyGraph
andPyDiGraph
. - The
PyGraph
andPyDigraph
classes now implement the Python mapping
protocol for interacting with graph nodes. You can now access and
interact with node data directly by using standard map access patterns
in python. For example, runninggraph[1]
will return the data for the
index at node 1. - A new module,
retworkx.generators
, has been added. Functions in this
module can be used for quickly generating graphs of certain shape. - A new method,
remove_node_retain_edges()
, has been added to the
PyDiGraph
class. This method can be used to remove a node and add
edges from its predecesors to its successors. - Two new methods,
edge_list()
andweighted_edge_list()
, for getting a
list of tuples with the edge source and target (with or without edge
weights) have been added toPyGraph
andPyDigraph
. - A new function,
cycle_basis()
, for getting a list of cycles which form
a basis for cycles of aPyGraph
object. - Two new functions,
graph_floyd_warshall_numpy()
and
digraph_floyd_warshall_numpy()
, were added for running the Floyd Warshall
algorithm and returning all the shortest path lengths as a distance
matrix. - A new constructor method,
read_edge_list()
, has been added toPyGraph
and
PyDigraph
. This method will take in a path to an edge list file and
will read that file and generate a new object from the contents. - A new method,
extend_from_edge_list()
, has been added toPyGraph
and
PyDiGraph
. This method takes in an edge list and will add both the edges and
nodes (if a node index used doesn't exist yet) in the list to the graph.
Fixes
- The limitation with
is_isomorphic()
andis_isomorphic_node_match()
functions
that would cause segfaults when comparing graphs with node removals
has been fixed. You can now run either function with any
PyDiGraph
/PyDAG
objects, even if there are node removals. Fixes #27 - If an invalid node index was passed as part of the
first_layer
argument to thelayers()
function
retworkx 0.4.0
Changelog
This release includes many new features and fixes, including improved
performance and better documentation. But, the biggest change for this
release is that this is the first release of retworkx that supports
compilation with a stable released version of rust. This was made
possible thanks to all the hard work of the PyO3 maintainers and
contributors in the PyO3 0.11.0 release.
Added
- A new class for undirected graphs,
PyGraph
, was added. - 2 new functions
graph_adjacency_matrix()
and
digraph_adjacency_matrix()
to get the adjacency matrix of aPyGraph
andPyDiGraph
object. - A new
PyDiGraph
method,find_adjacent_node_by_edge()
, was added. This is
used to locate an adjacent node given a condition based on the edge between them. - New methods,
add_nodes_from()
,add_edges_from()
,
add_edges_from_no_data()
, andremove_nodes_from()
were added toPyDiGraph
(andPyGraph
). These methods allow for the addition (and removal) of
multiple nodes or edges from a graph in a single call. - A new function,
graph_greedy_coloring()
, which is used to return a
coloring map from aPyGraph
object. - 2 new functions,
graph_astar_shortest_path()
anddigraph_astar_shortest_path()
,
to find the shortest path from a node to a specified goal using the A*
search algorithm. - 2 new functions,
graph_all_simple_paths()
and
digraph_all_simple_paths()
, to return a list of all the simple paths
between 2 nodes in aPyGraph
orPyDiGraph
object. - 2 new functions,
directed_gnp_random_graph()
and
undirected_gnp_random_graph()
, to generate Gnp randomPyDiGraph
and
PyGraph
objects. - 2 new functions,
graph_dijkstra_shortest_path_lengths()
and
digraph_dijkstra_shortest_path_lengths()
, were added for find the shortest paths
between nodes inPyGraph
orPyDiGraph
object using Dijkstra's
algorithm.
Changed
- The
PyDAG
class was renamedPyDiGraph
to better reflect it's
functionality. For backwards compatibilityPyDAG
still exists as a python
subclass ofPyDiGraph
. No changes should be required for existing
users. - numpy is now a dependency of retworkx. This is used for the adjacency
matrix functions to return numpy arrays. The minimum version of numpy
supported is 1.16.0.
Fixes
- The retworkx exception classes are now properly exported from the
retworkx module. In prior releases it was not possible to import the
exception classes (normally to catch one being raised) requiring users
to catch the base Exception class. This has been fixed so a
specialized retworkx exception class can be used.
retworkx 0.3.4
Release 0.3.4
retworkx 0.3.3
Release 0.3.3
retworkx 0.3.2
Release 0.3.2 This release includes a performance fix on the ancestors() and descendants() functions. It also changes the return type from those functions to be a set instead of a list.
retworkx 0.3.1
Release 0.3.1
retworkx 0.3.0
Release 0.3.0
retworkx 0.2.0
Release 0.2.0
retworkx 0.1.1
Release 0.1.1
retworkx 0.1.0
This release moves from using daggy
to petgraph::StableDiGraph
for the underlying graph object in PyDAG
.