cartagen.propagation_network

propagation_network(network, index, geometry, propagation_distance=None, damping=0.1, tolerance=1e-06, inplace=False)

Propagate a displacement along the network.

This algorithm proposed by Lecordix et al. [1] propagate a geometry change inside a network along the whole network. The extremities of the network is always kept.

Parameters:

• network (GeoDataFrame of LineString or List[LineString]) – The road network in which to propagate the change.

• index (int) – The index of the modified geometry.

• geometry (LineString) – The new modified geometry.

• propagation_distance (float, optional) – The maximum distance to limit the propagation. Lower value will modify more heavily closer lines.

• damping (float, optional) – The damping factor.

• tolerance (float, optional) – The tolerance to consider touching roads.

• inplace (bool, optional) – Whether to modify the GeoDataFrame in place.

Returns:

GeoDataFrame of LineString or List[LineString]

See also

propagation_crow_flies

Propagate a displacement using the method “as the crow flies”.

propagation_network_batch

Propagate a displacement along the network by batch.

References

[1]

François Lecordix, Corinne Plazanet, and Jean-Philippe Lagrange. A platform for research in generalization: application to caricature. GeoInformatica, 1:161–182, 1997. URL: https://api.semanticscholar.org/CorpusID:14891064.

(Source code)