Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Tweaks to map_data()/fortify.map()` #6218

Merged
merged 6 commits into from
Dec 10, 2024
Merged

Conversation

teunbrand
Copy link
Collaborator

This PR aims to fix #3816, close #5469 and fix #3717.

With regards to #3816, this PR checks off the last bullet that fortify.map() is deprecated.
WIth regards to #5469, this PR makes the issue obsolete, since we have deprecated all the functions we were considering putting up for adoption.
With regards to #3717 this PR fixes the mislinked map_data(map) argument.

Copy link
Member

@yutannihilation yutannihilation left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for addressing this issue! Looks good in general.

R/fortify-map.R Outdated
Comment on lines 90 to 92
if (!inherits(map_obj, "map")) {
return(fortify(map_obj))
}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you know when maps::map() returns a non-map object? Maybe we should just ignore, or raise an error rather than forwarding to fortify()?

map <- c("county", "france", "italy", "nz", "state", "usa", "world", "world2")
vapply(
  map,
  \(x) class(maps::map(x, region = ".", exact = FALSE, plot = FALSE, fill = TRUE)),
  FUN.VALUE = character(1L)
)
#> county france  italy     nz  state    usa  world world2 
#>  "map"  "map"  "map"  "map"  "map"  "map"  "map"  "map"

Created on 2024-12-10 with reprex v2.1.1

Copy link
Collaborator Author

@teunbrand teunbrand Dec 10, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If a user passes the namesonly = TRUE option, the maps::map() function does not return a non-map object.
Currently we throw the default error message, which will continue to be the case with this PR.

x <- maps::map(namesonly = TRUE, plot = FALSE)
str(x)
#>  chr [1:1627] "Aruba" "Afghanistan" "Angola" "Angola:Cabinda" "Anguilla" ...

ggplot2::map_data("world", namesonly = TRUE)
#> Error in `fortify()`:
#> ! `data` must be a <data.frame>, or an object coercible by `fortify()`,
#>   or a valid <data.frame>-like object coercible by `as.data.frame()`.
#> Caused by error in `.prevalidate_data_frame_like_object()`:
#> ! `dim(data)` must return an <integer> of length 2.

Created on 2024-12-10 with reprex v2.1.1

Happy to throw a more custom error message if you think that is more appropriate!

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, I didn't know this, thanks.

Happy to throw a more custom error message if you think that is more appropriate!

IMHO, throwing an error is preferable because we can avoid unnecessary fortify().

How about something like `maps::map()` didn't return a map object. Did you pass some unusual options to `map_data()`? ? I think this is a corner case, so I don't think it needs to be very user-friendly.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Alright, now throwing the following error:

devtools::load_all("~/packages/ggplot2/")
#> ℹ Loading ggplot2
map_data("world", namesonly = TRUE)
#> Error in `map_data()`:
#> ! `maps::map()` must return an object of type <map>, not a character
#>   vector.
#> ℹ Did you pass the right arguments?

Created on 2024-12-10 with reprex v2.1.1

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The error looks good to me!

@teunbrand
Copy link
Collaborator Author

Thanks for the review!

@teunbrand teunbrand merged commit 4dedb82 into tidyverse:main Dec 10, 2024
13 checks passed
@teunbrand teunbrand deleted the docs_maps branch December 10, 2024 10:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
2 participants