Tidy Geospatial Networks in R
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.test_join.R now successfully run also on R-devel.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.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.