EVOLUTION-MANAGER
Edit File: st_nearest_points.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><title>R: get nearest points between pairs of geometries</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <link rel="stylesheet" type="text/css" href="R.css" /> </head><body> <table width="100%" summary="page for st_nearest_points {sf}"><tr><td>st_nearest_points {sf}</td><td style="text-align: right;">R Documentation</td></tr></table> <h2>get nearest points between pairs of geometries</h2> <h3>Description</h3> <p>get nearest points between pairs of geometries </p> <h3>Usage</h3> <pre> st_nearest_points(x, y, ...) ## S3 method for class 'sfc' st_nearest_points(x, y, ..., pairwise = FALSE) ## S3 method for class 'sfg' st_nearest_points(x, y, ...) ## S3 method for class 'sf' st_nearest_points(x, y, ...) </pre> <h3>Arguments</h3> <table summary="R argblock"> <tr valign="top"><td><code>x</code></td> <td> <p>object of class <code>sfg</code>, <code>sfc</code> or <code>sf</code></p> </td></tr> <tr valign="top"><td><code>y</code></td> <td> <p>object of class <code>sfg</code>, <code>sfc</code> or <code>sf</code></p> </td></tr> <tr valign="top"><td><code>...</code></td> <td> <p>ignored</p> </td></tr> <tr valign="top"><td><code>pairwise</code></td> <td> <p>logical; if <code>FALSE</code> (default) return nearest points between all pairs, if <code>TRUE</code>, return nearest points between subsequent pairs.</p> </td></tr> </table> <h3>Details</h3> <p>in case <code>x</code> lies inside <code>y</code>, when using S2, the end points are on polygon boundaries, when using GEOS the end point are identical to <code>x</code>. </p> <h3>Value</h3> <p>an <a href="sfc.html">sfc</a> object with all two-point <code>LINESTRING</code> geometries of point pairs from the first to the second geometry, of length x * y, with y cycling fastest. See examples for ideas how to convert these to <code>POINT</code> geometries. </p> <h3>See Also</h3> <p><a href="st_nearest_feature.html">st_nearest_feature</a> for finding the nearest feature </p> <h3>Examples</h3> <pre> r = sqrt(2)/10 pt1 = st_point(c(.1,.1)) pt2 = st_point(c(.9,.9)) pt3 = st_point(c(.9,.1)) b1 = st_buffer(pt1, r) b2 = st_buffer(pt2, r) b3 = st_buffer(pt3, r) (ls0 = st_nearest_points(b1, b2)) # sfg (ls = st_nearest_points(st_sfc(b1), st_sfc(b2, b3))) # sfc plot(b1, xlim = c(-.2,1.2), ylim = c(-.2,1.2), col = NA, border = 'green') plot(st_sfc(b2, b3), add = TRUE, col = NA, border = 'blue') plot(ls, add = TRUE, col = 'red') nc = read_sf(system.file("gpkg/nc.gpkg", package="sf")) plot(st_geometry(nc)) ls = st_nearest_points(nc[1,], nc) plot(ls, col = 'red', add = TRUE) pts = st_cast(ls, "POINT") # gives all start & end points # starting, "from" points, corresponding to x: plot(pts[seq(1, 200, 2)], add = TRUE, col = 'blue') # ending, "to" points, corresponding to y: plot(pts[seq(2, 200, 2)], add = TRUE, col = 'green') </pre> <hr /><div style="text-align: center;">[Package <em>sf</em> version 0.9-5 <a href="00Index.html">Index</a>]</div> </body></html>