NEWS.md
print() method for sfnetwork objects now correctly prints networks with active edges that are spatially implicit. Refs #256.print() method for sfnetwork objects no longer uses the deprecated function tibble::trunc_mat(). Refs #247.to_spatial_contracted() now correctly handles group indices that are not ordered. Refs #243. Thanks @MattArran.igraph::adjacent_vertices() and igraph::incident_edges() inside to_spatial_smooth() is now aligned to updates in igraph v2.1.1 that changed the zero-based indexing of the return to one-based indexing. This alignment is done dynamically, without forcing the most recent igraph version as required dependency. Refs #282. Thanks @krlmlr.igraph::get_edge_ids() is used instead of the deprecated igraph::get.edge.ids() inside to_spatial_smooth().sfnetwork() construction function now has an argument message which can be set to FALSE when the network validity checks should not print informational messages to the console. Refs #261.sf::st_geometry(), sf::st_bbox(), sf::st_m_range() and sf::st_set_precision() are updated to be consistent with their corresponding generic functions in sf.active and ... are removed from the sfnetwork S3 method for sf::st_precision() to be consistent with its corresponding generic function in sf.active is removed from the sfnetwork S3 method for sf::st_crs() to be consistent with the above-mentioned change regarding sf::st_precision() (since both CRS and precision can not differ between nodes and edges).to_spatial_contracted() morpher now correctly handles cases for undirected networks in which only loop edges are created after contraction. Refs #237.to_spatial_contracted() morpher now directly returns the original network when none of the contraction groups contain more than one node.to_spatial_smooth() morpher:
summarise_attributes added to summarise attribute values of concatenated edges. Refs #120.require_equal added to specify if and which attributes should be checked for equality before removing a pseudo node. Refs #124.protect added to specify nodes that should never be removed, even if they are a pseudo node. Refs #177.st_network_cost():
to argument. Refs #183.direction added to specify if outbound, inbound or all edges should be considered. This replaces the argument mode from igraph::distances(). The default is “out”, while before it was “all”. For undirected networks this argument is ignored.edge_azimuth() gained an argument degrees which can be set to TRUE to return angles in degrees instead of radians.st_network_paths() now encodes nodes by their name, whenever a name attribute is present in the nodes table. This can be disabled by setting use_names = FALSE. Refs #154.sf::st_precision() and sf::st_set_precision() now have a method for sfnetwork objects, such that coordinate precision can be queried and set. Refs #209.sf::st_intersection() and sf::st_difference() now have a method for sfnetwork objects, such that networks can be spatially clipped. The method for sf::st_crop() now uses the same workflow. These functions do not work yet on edges of undirected networks. Refs #133.sf::st_drop_geometry() is now a generic and therefore got an sfnetwork method.sfnetwork method, merely to be consistent in the type of functions we provide a method for. Only those functions that mutate the geometry column of an sf object in such a way that would break the valid spatial network structure are not supported.sf::st_coordinates(), sf::st_bbox() and sf::st_crs() gained an active argument such that this information can be extracted from any network element without first activating it. Refs #215.edge_circuity() does not return units objects anymore, since circuity is unitless.sf::sf_extSoftVersion()["proj.4"] since sf::sf_extSoftVersion()["PROJ"] might not be defined for sf < 1.0. Refs #198 and #200.dplyr 1.0.8. Ref #202. Thanks @romainfrancois.spatial_edge_measures
Roxel dataset. Refs #190 and fixed with #193.n_active and n_inactive arguments to the print method of an sfnetwork object. The arguments define how many rows are printed for respectively the active and inactive network element. The values of these arguments can also be set globally by running e.g. options(sfn_max_print_active = 1, sfn_max_print_inactive = 2). Refs #157
Roxel is updated to comply with recent updates on the way a CRS is specified in an sf object. Refs #167
s2 by adding a s2::as_s2_geography() method for sfnetwork objects. In the new version of sf, the s2 package will be used for geometric operations involving longitude-latitude coordinates, see here.length_as_weight = TRUE in the sfnetwork construction function, the added weight column now preserves specification of units.st_network_blend() now internally uses sf::st_cast() instead of sfheaders::sfc_cast() to avoid errors with some CRS specifications.tidygraph behavior regarding the weight attribute settings is sometimes differing from igraph.spatstat v2, which is now splitted into multiple sub-packages. See here for details. In sfnetworks, this affected the functions as_sfnetwork.linnet(), as_sfnetwork.psp() and as.linnet.sfnetwork(). Using this functions now requires spatstat >= 2.0.0 and sf >= 0.9.8.match for checking coordinate equality is replaced by a new st_match function specifically designed for this task. This fixes bugs related to numeric approximations of detailed coordinates. See #130
sf::st_reverse() to reverse edge linestrings is only possible with GEOS versions >= 3.7.to_spatial_contracted() morpher, to contract groups of nodes based on given grouping variables. Refs #104
to_spatial_neighborhood() morpher, to limit a network to the neighborhood of a given node, based on a given cost threshold. Refs #90
st_network_blend(), which is faster and more reliable. The sort argument is deprecated, since the returned network is now always sorted.summarise_attributes argument to the to_spatial_simple() morpher, allowing to specify on a per-attribute basis how attribute values of merged multiple edges should be inferred from the original ones. Refs #113. The same argument is also part of the new to_spatial_contracted() morpher, where it can be used to specify on a per-attribute basis how attribute values of contracted groups of nodes should be inferred from the original ones.remove_parallels of the to_spatial_simple() morpher is renamed to remove_multiples to better fit naming conventions in igraph.store_orig_data of the to_spatial_smooth() morpher is renamed to store_original_data to be better interpretable. This argument is also added to the morphers to_spatial_simple() and to_spatial_contracted(), allowing to store original node or edge data in a .orig_data column, matching the design standards of tidygraph.Inf_as_NaN argument to st_network_cost(), to store cost values of paths between unconnected edges as NaN instead of Inf. The default value of this argument is FALSE. Refs #111
Inf_as_NaN argument in edge_circuity() is changed from TRUE to FALSE, to better fit with the change mentioned above, and to make sure no changes to R defaults are made without the user explicitly specifying them.sf::st_join(), only the information of the first match is now joined. Before, this used to throw an error. Refs #108
sf::st_geometry<-, since geometries should not be replaced in a morphed state.st_network_blend() now correctly blends points that are very close to the network. Fixes #98
st_network_blend() now preserves the directedness of the input network. Fixes #127
st_network_blend() now runs even if the network contains edges of length 0. Fixes #125
sf::st_crop() now correctly updates the nodes table after cropping the edges. Fixes #109
to_spatial_smooth() now returns the original network when no pseudo nodes are present. Fixes #112
to_spatial_subdivision() now returns the original network when there are no locations for subdivision.to_spatial_subdivision() now returns correct node indices for undirected networks.edge_azimuth(), to calculate the azimuth (i.e. bearing) of edges. Refs #107
to_spatial_transformed() morpher, to temporarily transform a sfnetwork into a different CRS.linnet objects, to enhance interoperability between sfnetworks and the spatstat package for spatial point patterns on linear networks.Inf_as_NaN argument to the edge_circuity() function, to store circuity values of loop edges as NaN instead of Inf. The default value of this argument is TRUE.st_network_paths():
type, which lets you set the type of paths calculation that should be performed.type = 'all_shortest' instead of all = TRUE. The latter argument is deprecated.type = 'all_simple'. Be aware that computation time gets high when providing a lot of ‘to’ nodes, or when the network is large and dense. Refs #105
weights = NULL and there is no column named ‘weight’ in the edges table, geographic edge length will be calculated internally and used as weights in shortest path calculation. Before, paths would be calculated without edge weights in this case. Refs #106
to_spatial_smooth() morpher. As a result of this it does not store the original edge data anymore in a ‘.orig_data’ column. Instead, non-merged edges keep their attributes, while merged edges loose their attributes. The ‘.orig_data’ column can still be added by setting store_orig_data = TRUE, but this is not the default.st_network_paths() now correctly handles cases where an unexisting column is passed to the weights argument, by throwing an error. Fixes #99
sf::st_join() now correctly handles inner joins (i.e. joins where left = FALSE).st_shortest_paths() and st_all_shortest_paths() are now merged into a single function st_network_paths(). By default it call igraph::shortest_paths() internally. Setting all = TRUE will make it call igraph::all_shortest_paths() instead.st_network_paths() function is different from its predecessors. It returns a tibble instead of a list, to fit better in tidyverse workflows. See #77
snap argument is removed from all shortest paths related functions, which will now always snap geospatial points provides as from or to locations to their nearest node on the network before calculating paths.keep argument is removed from the to_spatial_simple() morpher. It is now recommended to first sort data with dplyr::arrange() before calling the morpher.to_spatial_coordinates() is deprecated. Use the new node coordinate query functions instead.to_spatial_dense_graph() is deprecated. A new morpher to_spatial_subdivision(), with slightly different functionality, is added instead.to_spatial_implicit_edges() is deprecated. Use sf::st_set_geometry() instead, with activated edges and value NULL.st_network_distance(), edge_straight_length() and to_spatial_explicit_edges() are renamed to respectively st_network_cost(), edge_displacement() and to_spatial_explicit(), which either reflects their purpose better or fits better into the naming conventions within the package.graph are renamed to x, to have more consistency across the package.sfnetwork() now has an argument length_as_weight that, if set to TRUE, will add the lengths of edges as a weight attribute to the edges data. Refs #65
as_sfnetwork() method for sfc objects. Refs #41
st_network_* functions in sfnetwork are now generic, such that they can easily be modified by extensions of sfnetwork objects. Refs #80
to_spatial_explicit_edges() morpher now accepts arguments that are forwarded directly to sf::st_as_sf(). Refs #83
edge_length() function can now also be applied to spatially implicit edges.sf::st_as_sf(), sf::st_geometry() and sf::st_agr() now have an argument active to directly retrieve information from a network element without activating it. Use as st_as_sf(x, active = "nodes"), et cetera.st_network_blend() implements a process that we called ‘blending points into a network’. The functions accepts a network and a set of points. For each point p in the set of given points, it finds the projection p* of p on the network, splits the edges of the network at the location of p*, and finally adds p* along with the attributes of p as a node to the network. Refs #27 and #54
st_network_join() does a network specific join of two sfnetworks. It combines a spatial full join on the nodes data with a bind_rows operation on the edges data, and updates the from and to indices of the edges accordingly. Refs #22
st_network_bbox() calculates the bounding box of the whole network by combining the bounding boxes of nodes and edges.to_spatial_subdivision() subdivides edges at locations where an interior point is shared with either another interior point or endpoint of another edge. Refs #73
to_spatial_smooth() iteratively removes pseudo-nodes from the network. Refs #70
node_X(), node_Y(), node_Z() and node_M() are implemented to query specific coordinate values from the nodes.ggplot2::autoplot() method for sfnetworks, allowing to easily plot a sfnetwork as a ggplot2 object. Refs #86
print method for morphed sfnetworks. Refs #88
sf::st_geometry<-(), sf::st_join(), sf::st_filter() and sf::st_crop(). Refs #85
as_sfnetwork() now handles circular linestrings. Fixes #59
to_spatial_coordinates(). Refs #62
as_sfnetwork(). Refs #41