- Add
data_year
parameter tous_map()
, see Issue #34.- Allows user to select the year for which to plot US map.
- This will allow the user to match the map that is provided to the data they are using.
- To start with, 2021, 2022, and 2023 maps are included.
- Going forward, each year will be added to the package and previous years can be accessed with this parameter.
- If the value provided via
data_year
is not available, the package will select the next year for which data exists.- For example, if data sets 2022 and 2023 are available and the user calls
us_map(data_year = 2019)
, 2022 will be used. - A warning is presented when this occurs to alert the user.
- For example, if data sets 2022 and 2023 are available and the user calls
- Further reading on the impetus for this change: major changes made to Connecticut counties in 2023.
- The old Connecticut counties are available in the 2021 data, 2022 and forward use the new planning regions.
- Improve python script and GitHub Actions workflow that download and process map shapefiles to be more flexible and support new
data_year
feature listed above. centroid_labels()
now accepts"state"
and"county"
as inputs for theregions
parameter likeus_map()
andfips_data()
.- Update package author email.
Released Friday, May 15, 2024.
- Update map data to use 2023 shape files.
Released Friday, March 8, 2024.
- Improve language in
DESCRIPTION
and minor documentation, see Issue #19.
alaska_bbox()
andhawaii_bbox()
now output correctsf
type (sfc_POLYGON
).
Released Sunday, February 4, 2024.
This update continues the sf
migration by setting the as_sf
parameter to default to the behavior of TRUE
. This parameter no longer has any effect, as explained below. The next phase will involve updating usmap
to no longer make use of this parameter, in which case it can be completely removed.
- The
as_sf
parameter is now deprecated and no longer has any effect.- As part of this removal, the default behavior for
us_map()
,centroid_labels()
, andfips_data()
is equivalent toas_sf = TRUE
which is to return their data as ansf
object (see0.2.0
release notes for more details). - This parameter will be completely removed in a future version but continues to exist for compatibility reasons.
- As part of this removal, the default behavior for
- Legacy
.csv
files containing mapping and FIPS data have been removed, greatly reducing package size.
Released Friday, January 12, 2024.
- Update map data to use 2022 shape files.
- Begin process of upgrading map data to use GeoPackage files instead of csv.
- Previously the files were created using now-retired packages
rgdal
,rgeos
, andmaptools
. - The new files can be accessed by passing
as_sf = TRUE
to theus_map()
andfips_data()
functions. - Once the upgrade is complete, this parameter will be removed and the new functionality will be the default.
- The new map files are smaller in size while maintaining the same resolution.
- The format of the data also allows for easier manipulation in the future using the
sf
package.
- Previously the files were created using now-retired packages
- Add scripts to perform automated map data updates, see Issue #5.
- The scripts will check for new shapefiles from the US Census Bureau twice a year and automatically update the data.
- The scripts can also be run manually as needed.
- Once data is updated a new
usmapdata
release will be created.
Released Monday, December 11, 2023.
- Add
fips_data
function to load raw FIPS data from included csv files.fips_data()
,fips_data("state")
, orfips_data("states")
load state FIPS codesfips_data("county")
orfips_data("counties")
load county FIPS codes
Released Saturday, October 21, 2023.
- Update package author email and website.
Released Wednesday, February 2, 2022.
- First release
- Contains the
us_map
function and associated data extracted from theusmap
package - Will allow future removal of data from
usmap
package so file size can be reduced greatly.