Released Saturday, October 21, 2023.
- Update package author email and website.
Released Tuesday, June 13, 2023.
- Replace retired packages
maptools
andrgdal
withsp
andsf
, see Issue #57 and Issue #70.- Special thanks @rsbivand.
Released Saturday, November 12, 2022.
- Fix failing
plot_usmap
tests, see Issue #58. - Fix
aes_string
andsize
deprecation in ggplot2, see Issue #59.
Released Sunday, February 27, 2022.
- Add
input_names
andoutput_names
parameters tousmap_transform
, see Issue #33. - Add
sortAndRemoveDuplicates
parameter tofips_info
, see Issue #47.- The default (
FALSE
) value changes existing behavior, to retain existing behavior, change the parameter value toTRUE
.
- The default (
- Improve map resolution.
- More polygons are shown, this has a marginal increase on the data set file sizes but it is negligible.
- Add shape file update history, see Issue #30.
- Extract map data frame to external usmapdata package to reduce
usmap
package size, see Issue #39.- All existing functions (including
us_map()
) should continue to work as usual.
- All existing functions (including
- Add data format examples for
plot_usmap
to "Mapping" vignette, see Issue #42.
- Fix CRS warnings, see Issue #40.
- Fix
plot_usmap()
issue when provided data has"values"
column, see Issue #48 and this Stack Overflow question.
Released Wednesday, October 7, 2020.
- Update links in documentation.
Released Wednesday, October 7, 2020.
- New website for the package: https://usmap.dev
- Lightweight landing page containing useful information, links, and examples of usmap usage.
state
can now be omitted when usingfips()
. In this case, all available FIPS codes are returned, sorted by state abbreviation, see Issue #28.fips
can now be omitted when usingfips_info()
. In this case, all available states are returned, sorted by state abbreviation, see Issue #28.- Fix duplicate coordinates from being removed during
usmap_transform
(if value columns differ), see Issue #32. - Prevent warnings introduced by
ggplot2
v3.3.0, see Issue #35. - Set minimum R version to 3.5.0. Versions lower than this do not support the latest version of the
rgdal
package.
Released Friday, September 13, 2019.
- Ability to include county name labels on county maps, see Issue #14.
- They currently work the same as state labels except they include the full county name (excluding the word "County").
- Ability to pass
ggplot2::geom_polygon()
parameters toplot_usmap()
, see Issue #15.- This is a breaking change and removes the
lines
parameter. The previous defaults ofcolor="black"
,fill="white"
, andsize=0.4
are maintained and will be used for any of those parameters that are omitted. - Refer to the
ggplot2::geom_polygon()
documentation for more information. - The following aesthetics are supported:
alpha
,colour
/color
,fill
,linetype
,size
- This feature provides more direct control over the appearance of plots.
- This is a breaking change and removes the
- Ability to exclude counties and states with new
exclude
parameter inus_map
,map_with_data
, andplot_usmap
, see Issue #19. - New function (
usmap_transform
) to transform longitude/latitude point data frames into coordinate reference system that matches the plotted map, see Issue #21.- Also includes
usmap_crs()
to easily access the coordinate reference system used by the package.
- Also includes
- In the data frames provided by
us_map()
,long
andlat
have been renamed tox
andy
, respectively, see Issue #16.- This should not affect the behavior of
plot_usmap()
but will be a breaking change for any code that relies onus_map()
.
- This should not affect the behavior of
- Added contributing guidelines and templates, see Issue #24.
- These can be see in the .github folder.
Released Sunday, September 16, 2018.
- Ability to include state abbreviation labels in state maps, see Issue #9.
- e.g.
plot_usmap(labels = TRUE)
- e.g.
- Add US Census Bureau regional divisions as constants for quick plotting of certain regions.
- e.g.
plot_usmap(include = .northeast_region)
- The provided regions and divisions can be seen on this map by the US Census Bureau.
- e.g.
- Allow ability to include only certain states while viewing county map, see Issue #11.
- e.g.
us_map("counties", include = "TX")
orplot_usmap("counties", include = c("AZ", "NM"))
- e.g.
- Vectorize counties in
fips
, see Issue #10.- e.g.
fips("NJ", c("Bergen", "Hudson"))
- e.g.
- Allow all columns in the data frame that's passed to
map_with_data()
orplot_usmap()
to be preserved.
- Add Kusilvak Census Area (FIPS code 02158), replaces Wade Hampton Census Area (FIPS code 02270).
Released Sunday, June 3, 2018.
- Update shape files to 2017 versions.
- Improvements to
fips
andfips_info
:- Vectorization support (e.g. enter multiple states in
fips
to receive a vector of corresponding FIPS codes) - e.g.
fips(c("AK", "AL"))
orfips(c("Alaska", "Alabama"))
- Mixed abbreviations and full names are also supported:
fips(c("AK", "Alabama"))
- Improved warning and error messages.
- Vectorization support (e.g. enter multiple states in
- Allow data to be specified by state abbreviation or full name in
plot_usmap
andmap_with_data
(instead of just by FIPS code).- The data frame passed to
plot_usmap
ormap_with_data
(via thedata =
parameter), can now be a two column data frame with columns "fips" and "values" or "state" and "values".
- The data frame passed to
Released Tuesday, August 15, 2017.
- Standardize documentation language.
- Improve descriptiveness of error messages and warnings.
- Allow data passed to
map_with_data
andplot_usmap
to contain FIPS codes with missing leading zeros.- This usually occurs when the codes are read as
numeric
from a.csv
file.
- This usually occurs when the codes are read as
Released Saturday, April 29, 2017.
- Add
map_with_data
function for adding user-defined data to map data. - Add ability to plot map with data automatically (utilizes new
map_with_data
function).
Released Sunday, January 29, 2017.
- First release
- Retrieve US map data frame for merging with data and plotting
- Lookup FIPS codes for states and counties (reverse-lookup as well)
- Map plotting convenience method (uses
ggplot2
)