st_minimum_bounding_circle() returns geometries representing the smallest circle that contains the input; #2473fix type checks in C++ GDAL area and length computation functions, anticipating GDAL 3.10.0; #2466, #2468, #2469 by @rsbivand and @rouault
improve test on empty geometries, which changed in 1.0-18; #2463
gdal_utils() ogrinfo has an argument read_only which, when TRUE (or options includes "-ro"), opens a datasource in read-only mode (#2460; sf did this before 1.0-17); by default a datasource is opened in update (read-write) mode (since sf 1.0-17; #2420)
the sf -> ppp conversion as.ppp.sf() accepts a data.frame of marks instead of just 1 column #2450, by @agila5
add flag for preservation of point order in st_voronoi #1371 for GEOS >= 3.12
support POLYGON FULL simple feature geometry, representing the entire Earth surface, as used by s2geometry; see also https://r-spatial.org/r/2024/10/11/polygonfull.html for a longer introduction; #2441
st_sfc() has an argument oriented which, when set to TRUE, adds an attribute oriented=TRUE to an sfc object, indicating that this object should not be reoriented in conversion to s2_geography (avoiding using the global option s2_oriented); st_as_sfc.bbox() sets this to TRUE; #2441
fix build failure with GDAL < 3.4.0 #2436
st_simplify() now accepts feature-wise tolerance values when s2 is switched on #2442
add st_transform() method for bbox objects; this uses OGRCoordinateTransformation::TransformBounds(), densifying first and antemeridian proof; #2415
st_filter.sf() correctly scopes x and y arguments using !! operator; #2416
[.sfc and [<-.sfc use matrix/array type subsetting for sfc objects that have a dim attribute
add st_exterior_ring() to extract exterior rings (remove holes); #2406
add text.sf(), text.sfc(), points.sf(), points.sfc() to annotate base plots at geometry centroids; #2399
st_sf() no longer strips tbl or tbl_df class labels; #2378
st_layers() returns an object of class c("sf_layers", "data.frame"), with a dedicated print method.
when dim is not XYZM, sf_as_sf.data.frame() interprets a length 4 coords argument to specify the corners of a rectangular polygon; #2357
st_interpolate_aw() gains an na.rm argument, for removing features with NA attributes before interpolating; #830
merge.sf() no longer renames geometry column; #2334
st_join() no longer renames the geometry column; #2327
st_sample() works when unprojected polygon geometry crosses the antemeridian; #2331
clean up and modernization of S3 registration of methods and tests; #2285, #2288, #2316, #2341, #2342, by @olivroy
[.sfc works when setting argument op; #2320
st_sample() for polygons is sensitive to setting oriented = TRUE to prevent wrongly correcting ring directions; #2308
add support for the GDAL footprint utility (requiring GDAL >= 3.8.0) to gdal_utils; #2305, by @goergen95
existing environment variables PROJ_LIB and PROJ_DATA are (again) ignored on sf binary CRAN installations (win + macos), effectively by overwriting them during the R session and restoring them on exit; this does not happen if environment variable R_SF_USE_PROJ_DATA is set to true. #2298
add st_line_project() to find how far a point is when projected on a line; #2291
add st_line_interpolate() to obtain a point at a certain distance along a line; #2291
add st_perimeter() generic to cover both geographic and projected coordinates; #268, #2279, by @JosiahParry
add st_sample() method for bbox, with special provisions for ellipsoidal coordinates; #2283
st_convex_hull() uses s2::s2_convex_hull() for geodetic coordinates; #2250
add directed argument to st_line_merge(); #2264
st_union.sfc() given x and y works consistently across geodetic and projected objects; #2262
st_union.sf() given x and y unions pairwise if by_feature = TRUE; #2259
st_read() work around issue with GPKG driver if wkt_filter is set; #2248
st_read() uses GDAL's stream reading when use_stream = TRUE; #2238 by @paleolimbot
st_transform() responds to in-session changes to sf_proj_network(); #2166
plot.sf(): key.width is sensitive to pointsize graphics parameter par("ps"); keys with factor levels suggest a proper size if they won't fit.
plot.sf(): key.pos can hold a second value in [0, 1] determining the relative position of the key in the available space
[<-.sf fixes the agr attribute when it is broken; #2211
if the env. variable ADD_SF_NAMESPACE is set to true, sf objects get a new attribute, .sf_namespace, which forces loading the sf namespace when it has not been loaded so far, e.g. for proper printing or plotting of an sf object; #2212 by Mike Mahoney
distinct.sf() is type-safe for sf objects with zero rows; #2204
summarise.sf() raises an error if .by is given but no across() on the geometry; #2207
st_write() matches fields on name first, than on position; this matters for formats that have pre-defined names, such as GPX; #2202
fix plot.sf() when using a key for multiple factor variables; #2196, #2195
fix use of as.numeric_version in a test, for upcoming change in r-devel
code tidy-ing: fix many lintr suggestions, thanks to Michael Chirico (#2181 - #2191)
gdal_utils() adds "ogrinfo" utility (requires GDAL >= 3.7.0); #2160
st_as_sf() catches errors when setting invalid crs values, raised by Jon Skøien
add rename_with.sf() method; #1472
use GEOS' overlayNG routines for (GEOS) Intersection, Difference, Union and SymDifference; #2143
select.sf() allows selecting the same column twice under different names; #1886
st_as_sf.ppplist() is deprecated; #1926
st_cast() handles empty geometries; #1961
don't repeat longlat messages in summarise.sf(); #1519
fix random sampling on the sphere; #2133
update NAMESPACE to useDynLib(sf, .registration=TRUE); #2127 thanks to @eddelbuettel
fix call in gdal_addo(); #2124
fix issues that came up with older GDAL version, use GDAL_VERSION_NUM consistently; #2123 #2121 #2119
st_make_grid() also accepts area units for cellsize, for square and hexagonal grids; #1505
add st_concave_hull(), for concave hulls, if GEOS >= 3.11.0; #1964
add st_triangulate_constrained(), for constrained Delaunay triangulation, if GEOS >= 3.10.0; #1964
clean up the retrieval of length or angle units from WKT representations; https://lists.osgeo.org/pipermail/gdal-dev/2023-March/056994.html
conversion to GEOS uses the GEOS_PREC_VALID_OUTPUT flag, which makes sure that the "[o]utput is always valid. Collapsed geometry elements (including both polygons and lines) are removed."
gdal_utils() has a config_options argument to set further GDAL options, just like st_write(); #2003
fix slow writing of logical vectors in st_write(); #1409; #1689
st_drivers() has an argument regex to filter on driver (long) name; #2090
drop C++11 as a system requirement
c.sfc() (and, consequently, dplyr::bind_rows()) gives an error if components have different CRS; #1884
data imported from maps are associated with the Clark 1866 ellipsoid; #2080
fix importing legacy SpatialPolygon objects without comments; #2063, #2069, https://github.com/rstudio/leaflet/issues/833
st_read() no longer errors on mixes of XY and XYZ geometries; #2046 #1592
in plot.sf(), when numeric breaks are given a legend key is always plotted; #2065
st_crs()$axes returns a data.frame with axes properties (name, orientation, conversion factor) when GDAL >= 3.0.0
clean up unit handling for geometry measures (length, area, distance) and crs;
st_crs(x)$ud_unit returns NULL if units are unknown; #2049
st_write() substitutes an NA crs with ENGCRS["Undefined Cartesian SRS with unknown unit"]; #2049, #2054
st_can_transform() checks whether a transformation between two crs exists; see https://github.com/dieghernan/tidyterra/issues/64; #2049
the matrix returned by st_coordinates() has no row names, to reduce output size
adjust for changes how R-devel handles POSIXlt; #2028
add Fibonacci as a spatial sampling type in st_sample()
use the global options("sf_use_s2") to determine whether to use s2, rather than a value in a local environment; #1977
fix utils mdiminfo and mdimtranslate in gdal_utils()
extend arguments of gdal_read_mdim() needed by stars::read_mdim() if stars >= 0.5-7; add gdal_write_mdim()
add drop_na() method for sf objects; #1975
st_drop_geometry.default() returns x unmodified;
sf_project() accepts 3- or 4-column matrices, containing z and t values;
optimization for st_sfc() by @paleolimbot; #1938, #1925
[<-.sfc() recomputes the bounding box; st_sfc() gets parameter compute_bbox; #1965
add new algorithm and drop option to st_make_valid() when using GEOS and GEOS >= 3.10.1; #1655
add st_minimum_rotated_rectangle(), available when GEOS >= 3.9.0; #1953
fix st_sample() with type = "hexagonal" for corner case (n=1), add a progress argument for a progress bar; #1945
add package pbapply to Suggests; #1945
add pdf driver to windows build; #1942
clarify pipeline argument in st_transform() when axis order is ambiguous; #1934
handle argument xpd in calls to plot.sfc_POLYGON() and plot.sfc_MULTIPOLYGON()
add pivot_wider() method, by Henning Teickner; #1915
add gdal_addo() to add or remove overviews from raster images; #1921
st_layers() returns crs of each layer in a crs list of crs objects
restore st_graticule() behaviour to pre-sf 1.0-0; https://github.com/tidyverse/ggplot2/issues/4571
gdal_metadata() sets metadata item names properly
st_read() gains an argument optional passed on to as.data.frame to avoid changing column names; #1916
GPX files are autodetected by st_read(); #1917
unnecessary coordinate names are not returned in st_sample(), making the output size smaller; #1879
st_drop_geometry() is a generic; #1914
st_crs(x)$ud_unit returns the unit of the coordinate reference system of x
geometric predicates return sgbp objects omitting self-intersections etc. by passing remove_self = TRUE and unique symmetric relationship by passing retain_unique = TRUE (to ... if needed); this simplifies identifying (and removing) duplicated geometries; duplicates are identified by e.g. by st_equals(x, retain_unique = TRUE) |> unlist() |> unique(); #1893
fix compile issue against GDAL < 2.5.0 introduced in 1.0-6; #1899
adapt to new spatstat.random package; #1892
st_geometry<-() also allows to rename a geometry column in an sf object; #1890
for sf objects, the st_as_sfc() method is an alias for st_geometry(); #1882
st_make_grid() speeded up; #1579 thanks to Krzysztof Dyba
remove direct and indirect dependencies on rgeos and rgdal; #1869
use stats::dist rather than GEOS for symmetric point-point Euclidian distance computation; #1874
package startup message reports status of sf_use_s2(); #1782
sf_use_s2() uses message() to report a change; #1782
st_sample() using regular sampling for ellipsoidal coordinates "works" as if coordinates were Cartesian; #1837
new function st_delete() deletes a data source, or layer(s) within a data source; #1828
fix memory leak in WKT1_ESRI retrieval; #1690
cope with how GEOS >= 3.10.0 handles illegal geometries (e.g., non-closed rings); #1807
crs objects have a $srid method to extract the SRID (as authority "name:code"); #1804
st_as_grob() methods for sfc_* objects correctly handle empty geometries; #1789 with help from Hiroaki Yutani
when writing objects with NA as CRS to GeoPackage, assign "Unknown Cartesian CRS" first - this is in line with using Cartesian geometry operations for objects with NA as CRS; #1776
add coerce method from sgbp to sparseMatrix; #1750
fix st_cast() for GEOMETRYCOLLECTIONS containing empty geometries; #1767
fix st_is_valid() for bogus polygons and projected coordinates; #1666, #1760; #1761
st_read() and st_write() using GDAL handle binary attributes (OFTBinary fields) ; #1721
a pivot_longer method is added for sf objects (the data.frame method works, but raises a warning)
rbind.sf preserves primary geometry column; #1717
configure constrains using --static to Darwin platform; #1702, #1712, #1713
old-style crs objects created with sf < 0.9-0 generate a message, and will cause a warning in the future.
when st_crs() is called with a WKT2 as text input, its input field will be replaced with the CRS name (if it has one).
GEOS (>= 3.9.0) operations use GEOSGeom_setPrecision_r to set precision of geometries; #1535
st_read() with specified query ignores argument layers, and warns if it is given; #1444
fix regression in st_intersection(): when using s2 attributes were assigned wrongly; #1704
crs (sf) to CRS (sp) conversion no longer needs validation by rgdal; https://github.com/edzer/sp/issues/107
retrieve ESRI's WKT version of CRS by st_crs(id)$WKT1_ESRI; #1690
add s2 to Imports:
add Dewey Dunnington to contributors
sf_use_s2() prints a message when using s2 has been switched to on or off.
use s2 spherical geometry as default when coordinates are ellipsoidal. This can
be switched off (defaulting to planar geometry, using GEOS, as in sf < 1.0-0)
by setting environment variable _SF_USE_S2 to false before package sf
is loaded, or by sf_use_s2(FALSE); #1649
st_nearest_feature() with missing y returns nearest features in the remaining set of x; https://github.com/r-spatial/s2/issues/111
st_write() gains an argument config_options to set GDAL config options; #1618
fix regression in sf_project(..., keep = TRUE); #1635
add st_as_sf() method for terra's SpatVector class; #1567
distinct.sf() works by default on all variables, and keeps active geometry active; #1613
improve (fix?) polygonize/contour code; #1608
sf_proj_network() reports whether PROJ uses network (CDN) grids, can switch it on or off, and can set the CDN url.
st_write() returns obj, invisibly; #1597
fix regression in n-ary st_intersection(), #1595, introduced at #1549
st_inscribed_circle() computes the maximum inscribed circle for polygons (requires GEOS >= 3.9.0)
allow to st_cast() from COMPOUNDCURVE, MULTISURFACE or CURVEPOLYGON to GEOMETRYCOLLECTION, and back; #1573
Fixed a bug in st_as_grob() when plotting a mix of MULTI and non-MULTI geometries of the same base type
n-ary st_intersection() skips failing geometries, rather than returning an error; #1549
use s2_centroid() for geographical coordinates if sf_use_s2() is TRUE.
st_as_text() method for crs objects can return projjson (if GDAL >= 3.1.0 and PROJ > 6.2.0)
st_transform() no longer warns on conversions like "+proj=ob_tran +o_proj=longlat +o_lat_p=45 +o_lon_p=30"
st_as_wkb() takes srid from wkt field of crs when input field doesn't contain it; #1490
plot.sf() adds key.pos=0 option to run the logic behind the key without plotting it; #1487
fix bug in select.sf() when selected variables were renamed; #1483
st_as_sf.stars(..., merge = TRUE) now works if CRS is NA; #1389
add (dynamically loaded) as_wkb() methods for sf, sfc and sfg, making st_as_s2() unnecessary
st_as_s2() transforms non-longlat objects to EPSG:4326 first
gdal_utils() print (GDAL-style) progress bar if quiet = FALSE (except for info and mdiminfo)
fix CPL_gdal_warper for multi bands; https://github.com/r-spatial/stars/issues/320
sf_proj_search_paths() retrieves and sets the proj search path (if GDAL > 3.0.3)
when loading sf, sf_use_s2() is set to FALSE unless environment variable _SF_USE_S2 equals true (this changes to TRUE in sf 1.0-0)
resolve GDAL/PROJ version vulnerabilities in CRS-crs conversion; #1479
st_sample() gains an argument, by_polygon, to more clevery sample MULTIPOLYGON geometries; #1480
st_sample() accepts non-integer sample sizes, with a (suppressable) warning and handles values of sizes that would round to zero; #1480
gdal_utils() adds utils mdiminfo and mdimtranslate (requires GDAL >= 3.1)
st_union() gains an argument is_coverage, which, when set to TRUE, leads to much faster unioning in case features form a coverage (polygons don't overlap); #1462 by Don Baston
fix gdal_utils("translate") locking input file; #1452
st_make_grid() no longer selects cells intersecting with x; #1447
use s2::s2_dwithin_matrix() in st_is_within_distance(); #1367
Only when package s2 >= 1.0.1 is available: support for spherical geometry operators (predicates, transformers, measures, nearest point/feature) for geographic coordinates in package s2 is now by default switched off, and can be switched on by sf_use_s2(TRUE); see https://www.r-spatial.org/r/2020/06/17/s2.html and vignette sf7. It is planned to be switched on by default in sf 1.0-0.
drop Z and/or M coordinate in st_as_s2(), with message
geometry predicates and transformers gain an ... argument to pass s2::s2_options()
dplyr::select() now ensures the geometry column sticks to the back rather than the front of the data frame; #1425
dplyr::rename() now preserves the active geometry column even when it is renamed; #1431
proj units query adjusted to PROJ 7.1.0 release; #1434
empty geom generators take care of XYZ etc dim; #1400
write_sf() and read_sf() no longer warn when reading tables without geometries
st_write() writes non-spatial tables when given a plain data.frame or tbl_df; #1345
the default for stringsAsFactors in st_read and st_sf is FALSE for R version >= 4.1.0
the sf method for dplyr::select() supports renaming the geometry column; #1415
st_is_valid() is a generic
Windows CRAN binaries use GDAL 3.0.4, PROJ 6.3.1 and GEOS 3.8.0, thanks to Jeroen Ooms' rwinlib work; #1275
plot.sf() gains an extent argument to set the extent (xlim, ylim) of the plot; extent must be an object with an st_bbox() method, such as an sf or a stars object; #1193
st_axis_order(TRUE) gives and error if GDAL has version < 2.5.0
loading PROJ units link, us_in, ind_yd, ind_ft, and ind_ch into the udunits database is no longer done at package load time, but when function sf_add_proj_units() is called.
fix line sampling for small densities; #1365
sf_project() handles crs objects when PROJ version is below 6 using proj.4 string representations.
avoid using isFALSE in st_write(); #1342
fix regression in gdal_utils("translate", ...); #1339
fix an invalid read bug in st_m_range(); #1332
st_crs(4326) == st_crs("+proj=longlat +ellps=WGS84 +datum=WGS84 +no_defs") returns TRUE for GDAL >= 3.0, irrespective authority compliance of axis order; see #1331 and https://github.com/ropensci/scrubr/issues/34
sf_project() has a parameter authority_compliant to return coordinates in "visualisation order"; when TRUE it returns coordinates in authority compliant axis order (e.g. EPSG:4326 latitude longitude); default is st_axis_order().
fix test for Solaris and certain GDAL/PROJ versions
fix error reading category table through GDAL; https://github.com/r-spatial/stars/issues/245
see r-spatial blog post: https://www.r-spatial.org/r/2020/03/17/wkt.html
modify crs objects to reflect our post-proj4string world (#1146; #1225): crs objects contain two fields, input with the user input (if any), and wkt with a well-known-text (or WKT2) representation of the coordinate reference system. crs objects have a $ method to dynamically retrieve the epsg (integer) or proj4string representation, using e.g. x$epsg.
support for PostGIS 3 using WKT and the new-style crs objects; #1234, #1303, #1308 by @etiennebr
st_write_db() and st_read_db() are defunct. Use st_write and st_read instead.
st_write() uses append, replacing (and deprecating) argument update; st_write fails when a layer already exists and append has not been set explicitly to TRUE (append) or FALSE (overwrite); #1266
st_proj_info() was renamed into sf_proj_info; sf_proj_info can get and set the PROJ data search path and use of CDN; #1277
adapt to new dplyr version; https://github.com/tidyverse/dplyr/issues/4917
st_sample() is a generic
write stars rasters with wkt info, rather than proj4strings
when GEOS >= 3.8.0, st_make_valid is provided by sf rather than by lwgeom #989
allow for single-sided buffers for linear geometries; #1001
add st_reverse() methods to reverse points in a linestring (requires GEOS >= 3.7.0); #1246
st_make_grid() returns grid cells or points that intersect with the target geometry, not its bounding box; #1260
allow for PROJ >= 7; #1254
st_geometry_type() accepts by_geometry argument; #1264
st_as_sf.map() no longer requires maptools and sp; dropped dependency on maptools.
work around a bug in 6.0.0 <= PROJ < 6.3.1: replace +init=epsg:XXXX ... strings with the XXXX EPSG integer, to work around a bug in PROJ; see https://github.com/OSGeo/PROJ/pull/1875 and links therein. If ... arguments are present, raise a warning that these are ignored.
st_as_sf.map() no longer requires maptools and sp; drop dependency on maptools.
conversion between spatstat classes owin, ppp and psp and sf classes no longer use maptools; #1204
gdal_utils() processes open options -oo and -doo properly; https://github.com/ITSLeeds/geofabric/issues/12
st_sample() directly interfaces spatstat sampling methods, e.g. type = "Thomas" calls spatstat::rThomas after converting input arguments (window) and converts returned ppp object to sf's POINT geometries; #1204 with help from Ege Rubak and Jakub Nowosad
sf_project() gains an option keep = TRUE to return Inf values for points not projectable; #1228
support vctrs methods for geometry list columns; this makes unnest work again (#1172); #1196 by Lionel Henry
st_as_sf.pq_geometry() converts binary geom columns from RPostgres::dbGetQuery; #1195
st_cast() can convert MULTICURVE to MULTILINESTRING; #1194
st_read() gains a parameter wkt_filter for spatially filtering the features to be read; #1192
st_area() and st_length() handle +to_meter argument in PROJ strings; #1170
add st_filter() generic for filtering on spatial features only; #1148
new method st_shift_longitude() to re-center data for a Pacific view. #1218
output of st_as_text() with MULTIPOINT has nested parentheses around points. E.g., MULTIPOINT ((0 0), (1 1)) instead of MULTIPOINT (0 0, 1 1); #1219, #1221
fix tests for PROJ 6.2.0 not accepting +units=
fixes for tidyr 1.0-0 release; attempt to port nest.sf() and unnest.sf(); #1068, #1145
gdal_utils() better closes connections after use; #1143
st_write() gains a drivers options, to limit the drivers attempted; #1142
rather than replacing, st_write() and write_sf() append to an existing layer if update=TRUE; #1126
improve plotting of POSIXct and Date attributes (Date requiring classInt >= 0.4-2)
NULL geometries read by GDAL are returned as empty geometries; #1119
gdal_utils('rasterize', ...) accepts non-existing destinations, defined by e.g. resolution and extent options (see #1116 for an example), and overwrites if needed (see #1136 for an example)
add Dan Baston as contributor; #1120 and many others
in addition to NULL, st_sfc() also converts NA values into empty geometries; #1114.
st_join() is a generic
plot() handles POSIXct values in legend
constructor functions like st_linestring() check and break on NA coordinates; #1101, #1102
st_write write only to the temporary R session directoryas(x, "Spatial") gives a proper error message on empty geometries; #1093
st_cast() takes care of empty polygons; #1094
st_nearest_* functions warn in case they are used with geographic coordinates; #1081
st_union() no longer segfaults on zero row sf objects; #1077
st_transform() no longer breaks on zero row sf objects; #1075
when PROJ >= 6.1.0 is available and sf comes with datum files (as is the case with statically linked Windows and OSX CRAN binaries), PROJ_LIB is no longer temporarily overwritten, but the PROJ C api is used to set the datum path; #1074, suggested by Jeroen Ooms
sf compiles against GDAL 3.x and PROJ 6.1.0, using the new proj.h interface; #1070
st_distance() returns NA for empty geometries, rather than 0; #1055
add example on how voronoi polygons can be tied back to the points they contain; #1030
st_difference(x, y), with x an sfc with zero feature geometries, returns x; #1024
don't reset (base) plot device when add = TRUE
== and != return NA when one of the operands is an empty geometry; #1013
st_intersects() is a generic
drop requiring proj_api.h in favor of proj.h, this enables compatibility to PROJ 6.0.0 and GDAL 2.5.0-dev; #988
fix regression in binary predicates introduced in #855; #999 reported by Barry Rowlingson
fix bug in gdal_utils util warper on certain GDAL/OS combinations; https://github.com/r-spatial/stars/issues/117
c.sfc() ignores the type (class) of empty sfc objects when choosing the result type; #985, #982
rename the default value for distance to "Euclidean", rather than "distance" in st_distance()
add argument exact to st_sample(), defaulting to FALSE; #896
fixed n-ary st_difference() for cases where geometries are entirely contained in others; #975, by Jonathan Marshall
faster Ops.sfc(), added st_normalize(); #973 by Thomas Lin Pedersen
new grob constructor for sfc objects; #971 by Thomas Lin Pedersen; add Thomas as contributor
add group_split() and group_map() methods for sf objects (experimental); #969
make st_interpolate_aw() a generic;
argument col for plot of GEOMETRY sfc's is NA (open) for (multi) polygon geometries
feature IDs are no longer returned as names on the geometry list column, but optionally returned by st_read as attribute column; #812
when plotting multiple attributes, plot.sf adds a (single, common) key if key.pos is set
precision can be specified in distance units; #901
support log-scale in color legend by setting logz to TRUE in plot.sf
st_intersects() etc. will prepare y when y is polygons and x is points; #885 by Dan Baston
st_write() (and write_sf()) returns its first argument, invisibly; #889
st_intersection() on platforms using clang; #867adds several interfaces to GDAL functions, meant to be used by package stars
st_read() receives a query argument that can run queries against OGR datasets; #834, by Barry Rowlingson and Michael Sumner
read_sf() no longer first creates tibbles from data.frames, but creates them directly; #853, db propagation by Etienne Racine
check difference between compile-time and run-time GEOS versions; #844
all GEOS routines are (more) robust against memory leaks, by using unique pointers; #822, #845, by Dan Baston
st_buffer() receives the buffer styles endCapStyle, joinStyle and mitreLimit; #833, #842 by Michael Sumner
st_area() is a generic; https://github.com/r-spatial/stars/issues/32
st_write() resolves ~ correctly; #456
read and write feature IDs as sfc list column names; #812
st_centroid() works for empty geometries, returning an empty point #769
add st_nearest_points(), to obtain the (LINESTRING connecting the) two nearest points for pairs of geometries; #788
add hexagonal tiling to st_make_grid()
add regular and hexagonal sampling to st_sample()
fixes for PROJ 5.0.1; #545
fixes for GDAL 2.3.0; #759
st_sample() supports regular sampling of LINESTRING; #725 by @statnmap
Support reading and writing of database Pool objects; #756
fix plotting of sf objects without attributes; #755
add reference to the R Journal article in CITATION
move dependency RPostgreSQL from Imports: back to Suggests:
st_centroid.sf() and st_point_on_surface.sf also warn if attributes are not constant over geometries.
summarise() allows the user to define geometries for summaries; #714, by Kirill Mueller
plot.sf() emits a warning if col does not have length 1 or nrow(x), and requires pal (rather than col) to set a palette for factors.
plot.sf() provides control over legend keys using key.length and key.width, decrease default key length; #731
sgbp objects receive an as.data.frame method; #715
GDAL read/write supports logical variables; #722
add st_crop() to simplify cropping objects with a rectangular area; #720
fix bug in [<- when columns are added to an sf object; #718
use dynamic registration of S3 methods, similar to how hms does this; #710 by Kirill Mueller
(partially) address writing GPKG to network drive, writing to temp file first; #628
add Kirill Mueller as contributor
st_make_grid() is faster; #708, by Dan Baston
st_read() and st_write() are generic, with methods for directly reading from and writing to database connections; st_read_db and st_write_db are deprecated; #558, thanks to Etienne Racine @etiennebr
Package RPostgreSQL moved from Suggests to Imports
restore compatibility with GDAL 2.0.x versions (which won't have gdal_utils); #686
read_sf() can also read tables without geometry; #684, by Andy Teucher
+, -, * and / for pairs of geometries (sfg, sfc) return geometric union, difference, intersection and symmetric difference, respectively.
st_cast() from MULTIPOLYGON to MULTILINESTRING should work properly; #660
all Rcpp interfaces needed by package stars have been moved into sf; pkg stars is R-only, and only sf needs linking to GDAL.
gdal_utils() interfaces the 9 gdal utils using the C++ API
improve resetting (base) plots; add reset = FALSE in a call to plot to enable adding to plots that have a legend
st_read() returns a data.frame when a table contains no geometries, rather than giving an error; it does emit a warning in this case. See https://stat.ethz.ch/pipermail/r-sig-geo/2018-February/026344.html
move pillar from Imports: to Suggests:
update to the new rwinlib distribution of gdal (adds JPG2000); #639
speed up computation of centroids for largest polygon; #623
add st_as_sfc.raw method
Bugfix: binary operations (st_intersection, st_difference, etc) no longer fail when operating on data frames of class "tbl_df" with common column names; #644
add pillar to Imports: to provide method for printing WKT geometries in tibbles
st_as_text, and subsequently format and print, use argument digits (or options(digits = n)) to control the number of digits used for printing coordinates; default is options("digits"), which is typically 7.
st_is_within_distance works with geographic coordinates
st_cast from MULTIPOLYGON to MULTILINESTRING no longer changes the number of features/feature geometries, but conversion from MULTIPOLYGON to LINESTRING (typically) does; #596
st_distance for long/lat geographic coordinates uses lwgeom, accepting all geometry types; argument dist_fun is deprecated as a consequence, and distance calculations are different from those in sf versions 0.5-5 or earlier; #593
add package lwgeom to Suggests; st_area, st_length, st_distance, st_segmentize for long/lat CRS use package lwgeom instead of geosphere; #593
st_length returns zero for polygon-type geometries; #593
if present, add units of attribute to default plot title; #591
add unnest method, which depends on tidyr > 0.7-2; #570 PR by @karldw
add largest option to st_join to get largest intersection match only; #547, by @tiernanmartin
change default maximum number of feature to print to 10, controllable by options(sf_max_print); #556
add Hausdorff (and Frechet for those with GEOS 3.7.0) as options to st_distance; add par for densified versions
add st_snap, for snapping geometries to other geometries, within a tolerance
make st_wrap_dateline a generic, with methods for sf, sfc and sfg; #541
plot.sf and st_as_grob (used by ggplot2) are robust against misspecified ring directions (holes that have the same direction as the exterior rings), by using rule = "evenodd"; #540
functions depending on liblwgeom (st_make_valid, st_geohash, st_plit) have been moved to their own package, https://github.com/r-spatial/lwgeom; argument use_gdal of st_transform has been deprecated, instead one can use lwgeom::st_transform_proj; sf no longer tries to link to liblwgeom; #509, #537, #487
st_read, st_sf and st_sfc gain a parameter check_ring_dir (default: FALSE) that checks ring directions and corrects to: exterior counter clockwise, holes clockwise, when seen from above.
get rid of classInt::classIntervals warning if number of unique values is smaller than the number of breaks asked for
have classInt in Imports:, to not break other package checks
add vignettes 5: plotting sf objects and 6: miscellaneous; #324
add (default) color key to plot.sf if single map is plotted, contributed by @hughjonesd; #528
st_as_sfc can read EWKT; #530
argument max.plot takes its default from options(sf_max.plot=n), if present; #516
plot.sf gets an arguments pal to specify a color palette function; #526
plot.sf gets arguments breaks and nbreaks; add support for classInt::classIntervals styles for finding class intervals (using breaks)
add st_as_sf methods for ppp, lpp and psp objects from spatstat.
allow for direct route to proj.4 ignoring GDAL (requiring liblwgeom); #509, #511
add print method for crs objects; #517
sf_extSoftVersion reveals whether GDAL was linked to GEOS; #510
better check input of st_polygon; #514
add st_node, similar to rgeos::gNode
support for reading OFTInteger64List fields; #508
sparse geometric binary predicate lists have a class, sgbp, and attributes region.id and predicate; #234, #524
prevent st_split from stopping the R session; #492
st_intersection, st_union and so on also print a message when used directly on long/lat coordinates; #496
add rep method for sfc objects
comparing two crs objects uses the GDAL function IsSame; #180
add st_collection_extract, which, given an object with geometries of type GEOMETRY or GEOMETRYCOLLECTION, returns an object consisting only of elements of the specified type; by Andy Teucher, #482
st_write exports GeoJSON with UTF-8 encoding on Windows; #444
move package methods from Imports: to Depends: ; #478
deal better with precision setting and propagation; #476
fix bug in st_layers in case layers have no geometry; #334
clarify argument envelope in st_voronoi; #474
change aggregate to make it return the same geometry as 'by', padding attributes with NA where needed; #453
fix compatibility problems introduced by tidyr 0.7-0 using rlang magic
convert path names to UTF-8 in st_read, st_write and st_layers; #471
st_sfc converts NULL values into empty geometries, and correctly identifies empty POINTs; #466, #463
st_write abbreviates column names if driver is ESRI Shapefile; #464
add of_largest_polygon argument to st_centroid, to get the centroid of the largest polygon; #450
fix use of st_relate as join predicate for st_join; #454
fix bug where st_intersects with empty second argument would crash; #458
produce better WKT; #463
change st_read SRS assignment logic; corrects reading projected geojson with gdal 2.2.0; #449
st_intersection etc. on tbl also return tbl; #448
[.sf preserves class, e.g. of tbl; #448
support and propagate all Proj.4 +units=xx length units; #446
allow for arith ops on empty sfc objects
have st_graticule return an empty graticule object when argument datum is NA;
export as_Spatial, to make it easier for packages to convert sfc objects without importing sf
st_distance gains a parameter by_element to obtain pairwise distances; #437
add the ability to aggregate using a simple feature by argument; #429
make the op argument to [.sf work
speed up st_coordinates for POINT geometries; #433
fix performance regression for st_bbox; #418
correct bug in st_union, st_difference and st_sym_difference introduced in 0.5-2; #431
inform gdal about the CRS always through the proj4string, never through the epsg; see #424
properly deal with kilometre units; #424 (fixed by Karl Dunkle Werner)
add st_is_within_distance, only to return a sparse index matrix; #419
have st_graticule work with world2 (0,360); #421, #422, fixed by Ben Best
st_graticule to return graticules in native crs; https://github.com/tidyverse/ggplot2/issues/2200 (WIP)
st_graticule to support data in NA_crs_; https://github.com/tidyverse/ggplot2/issues/2199
fix bug when joining an sf-tibble with a tibble; #414
read gdal StringList, RealList, and IntegerList fields into a list-column; #416
made ready for rwinlib/gdal2; #408
make [.sf for selections including NA values like x[c(1,NA,2)]; #403
add a [<- method for sfc objects; automatically replaces NULL with an empty geometry; #411
add st_point_on_surface() to return a point that is guaranteed to be on the surface (standard compliance)
read_sf returns an sf-tibble, an object of class c("sf", "tbl_df", "tbl", "data.frame")
work around for dplyr::filter not dispatching geometry column subsetting to sf::[.sfc
allow units object as dist argument to st_buffer; these must be convertable to arc_degree for geographic, and to a length unit for non-geographic data; #399
prevent gdal from crashing when trying to st_transform an empty geometry; #398
add st_as_sfc method for bbox, returning the bbox polygon; #377
strip file name extension from default layer name in st_write; #392
have st_sf replace NULL values in an sfc list-column with the appropriate empty geometry; #372
allow setting ndiscr through ggplot2::coords_sf to improve graticule plotting in geom_sf; #396
add spatial indexes to most binary geometry operations; #394 and http://r-spatial.org/r/2017/06/22/spatial-index.html
drastically reduce memory footprint of st_intersection and similar; #394
support RSQLite 2.0 by providing an st_as_sfc method for list columns of class blob
drop dependency on dbplyr
better handle empty/NULL geometries in shapefiles; #351
add unite_.sf method
deprecate FUN argument to st_join; #376
improve graticule tic label placement in ggplot2; #375 and https://github.com/tidyverse/ggplot2/issues/2119
improve configure logic to deal with libraries installed in custom locations; #335
fix bug where geom_sf wouldn't deal with Z and/or M geoms; #373
return more conveniently typed empty geoms; #372
fix subsetting with [ of sf using drop = TRUE, #370
in addition to m, allow rad units to st_segmentize
add example how to st_read GeoJSON from a string; #185
add separate_.sf method
add st_split to split geometries (only available if compiled against liblwgeom), #359
fix bug reading and writing dates (months 1 off): #358
[.sf and [.sfc also select on i when i is an sfg object, and accept a geometric predicate function with optional arguments; #352
on reading through GDAL, empty (NULL) geometries no longer result in an error; on creation, they no longer automatically give a GEOMETRY object; #351
on plotting with ggplot2::geom_sf, empty geometries no longer break; grid functions return nullGrob() for them; #351
arith operations on empty geometries no longer break or give warnings; #351
have st_as_sf.data.frame by default break on NA values in coordinates; #342
have st_join accept further arguments, to be passed on to the join function (e.g. a pattern for st_relate)
have WKB reader throw an error on (some) malformed inputs, and check for buffer bounds
back-port do_union argument to dplyr <= 0.5.0, using lazyeval
all strings returned from OGR/GDAL get encoding set to UTF-8, making them work on non-UTF-8 platforms; #5
$.crs retrieves proj4string components, such as st_crs(4326)$datum in addition to epsg and proj4string
let st_geohash return geohash for (average) points (only when sf was linked to liblwgeom)
summarise.sf always returns an sf object, also for global (non-grouped) summaries.
summarise.sf gains an argument do_union which determines whether to union the geometries for which a summary is given, or to st_combine them (not resolving boundaries); #331
rename argument union of aggregate.sf into do_union, for consistency with summarise; #331
add a nest_ method for sf objects
st_relate gets a pattern parameter, same as rgeos::gRelate; add examples to get rook and queen neighbour lists using this; #234
support for direct reading of spatialite and sqlite geometry wkb blobs
build proper support for cbind and rbind methods for sf, which work (as documented) when all arguments are of class sf; dplyr::bind_cols or st_sf(data.frame(sf, df)) work for binding data.frames to an sf object.
st_segmentize() and st_line_sample() accept units arguments
document problem reading shapefiles from USB drives on OSX; #252
improve docs of st_is_valid and st_make_valid; #296
coercing sf to data.frame works better; #298
st_line_sample gains argument sample to specify the points t.b. sampled; #299 #300 thanks to @joethorley
write GDAL fields by name, not by number, fixing a KML problem #308
st_write gains arguments delete_layer and delete_dsn to allow overwrite capability #307 #274
write_sf defaults to delete_layer=TRUE, silently overwriting layers if they're already present
replace st_write_db with a version that is fast for large datasets (#285), thanks to Josh London
take out more memory leaking examples in tests
the aggregate method for sf objects assumes the by argument to be identical to that of stats::aggregate
st_wrap_dateline wraps (cuts up) geometries crossing the antimeridian, such that they no longer cross it.
restore 3.3.0 and c++11 requirement
st_read respects time that is read as UTC
st_write writes time always as UTC, since GDAL does not have a mechanism to define local timezones other than "unknown" or "local"
st_length works for POINT and MULTIPOINT (returning 0); POLYGON and MULTIPOLYGON are converted to MULTILINESTRING before computing length, thus giving polygon perimeter (#268)
st_write has update depend on driver; for databases, the default is TRUE, otherwise FALSE (it refers to update of the database, and not to overwriting the table in the database, this will by default not succeed); #274
st_read supports reading objects with multiple geometry columns #257 #255
support writing (exporting) objects with non-standard columns, such as units or POSIXlt #264
catch dependencies on GEOS 3.3.5 (hence no 0.4-0 CRAN binary for MacOSX) #260
have st_is_valid catch corrupt geometries too, returning NA in that case (requiring GEOS 3.5.0)
add st_make_valid, only available when sf was linked to liblwgeom
add st_coordinates method, returning coordinates matrix with indexes
remove unlist.sfg
add as.matrix.sfg; have as.matrix.sfg add indexes to coordinates
add st_bind_cols method
improve handling features that can't be projected
support uniform sampling over polygons on the sphere
add st_sample, for sampling points on multipoints, linestrings, or polygons
add c method for sfc objects
import and export magrittr::%>%
support ggplot'ing geometrycollections
drop C++11 requirement, allowing build for older R versions
add st_proj_info, modelled after rgdal::projInfo
overwriting datasets with st_write() is no longer allowed; update=TRUE appends to them, permitted the driver supports appending.
st_write gains an argument, update, which when TRUE will try to append to existing datasets (#204)
added list of corresponding function for migration from sp, rgdal and rgeos to sf at https://github.com/edzer/sfr/wiki/migrating
remove deprecated st_list
rename st_makegrid to st_make_grid, and st_linemerge to st_line_merge
add NEWS.md file (#207)
faster conversion of data.frame into POINT sf object, using st_as_sf (Michael Sumner)
rbind method for sf objects keeps coordinate reference system
add st_contains_properly spatial predicate
GEOS functions (geometry operations) accept XYZ geometries (and ignore Z)
make prepared = TRUE the default for all geometry binary operations
add user interrupt checks in all GEOS geometry operations
make st_graticule do something useful for polar projections
make st_graticule return NA labels when labels are useless
add merge.sf methods to merge sf object and data.frame (#193)
add st_join for table joins based on (user-defined) spatial predicates
add dplyr-style non-spatial joins for sf objects (left_join, full_join etc.) (#193)
allow for multiple non-gathered variables (#196)
add missing meridian to st_graticule (#198)
add merge method (#193)
st_graticule for laea (#198)
allow st_buffer with feature-dependent buffer distance (#197)
have spread return an sf object (#196)
clarify overwrite = TRUE in write docs
fix st_as_sf.map (#194)
add prepared arg to spatial binary predicates, to speed up large intersections
add st_voronoi interface (requires that lib GEOS >= 3.5.0)
add st_as_sf methods for map objects (library maps)
add RStudio project file
have st_bbox return a bbox object which has an st_crs method
rename st_drop_zm into st_zm, for general more handling of Z and M
allow for 3D coordinates returned, when +proj=geocent (#172; #103)
fix NA_integer_ handling in shapefiles I/O (#184)
add and fix st_agr API, to set and get attribute-to-geometry relationships