rnaturalearth

saída
github_document

Terra Natural

Um pacote R para armazenar e facilitar a interação com dados de mapas do Natural Earth.

Este pacote fornece:

• acesso a um subconjunto pré-baixado de dados vetoriais do Natural Earth v4.1.0 (março de 2018) comumente usados ​​no mapeamento mundial

• fácil subconjunto por países e regiões

• funções para baixar outros dados vetoriais e raster do Natural Earth

• um fluxo de trabalho simples, reproduzível e sustentável de dados do Natural Earth para o rnaturalearth, permitindo a atualização à medida que novas versões são disponibilizadas

• esclarecimento das diferenças nos mapas mundiais classificados por países, estados soberanos e unidades do mapa

• consistência com as convenções de nomenclatura do Natural Earth para que os usuários do rnaturalearth possam usar a documentação do Natural Earth

• dados em formatos sf ou sv

O site Natural Earth estrutura dados vetoriais por escala, categoria e tipo. Eles determinam os nomes dos arquivos dos downloads. rnaturalearth usa essa estrutura para facilitar o download (como uma API).

Instale o rnaturalearth

Instalar a partir do CRAN:

install.packages( " rnaturalearth " )

ou instale a versão de desenvolvimento do GitHub usando devtools.

 devtools :: install_github( " ropensci/rnaturalearth " )

Os dados para suportar grande parte da funcionalidade do pacote são armazenados em dois pacotes de dados que você será solicitado a instalar quando necessário, caso não o faça aqui.

 devtools :: install_github( " ropensci/rnaturalearthdata " )
devtools :: install_github( " ropensci/rnaturalearthhires " )

Primeiro uso

Aqui, usando plot como uma maneira simples e rápida de plotar mapas. Os mapas também podem ser feitos com ggplot2 , tmap ou outras opções. Todas as funções de recuperação aceitam um argumento returnclass = "sf" para retornar objetos do pacote sf (Simple Features) ou returnclass = "sv" (SpatVector).

library( rnaturalearth )

# world countries
plot(ne_countries())
Warning : plotting the first 10 out of 168 attributes ; use max.plot = 168 to plot all 

 # uk
plot(ne_countries( country = " united kingdom " ))
Warning : plotting the first 9 out of 168 attributes ; use max.plot = 168 to plot all 

 # states, admin level1 boundaries
plot(ne_states( country = " spain " ))
Warning : plotting the first 9 out of 121 attributes ; use max.plot = 121 to plot all 

Vinheta introdutória

vignette( " rnaturalearth " , package = " rnaturalearth " )

Para baixar dados do Natural Earth que ainda não estão no pacote

Há muitos outros dados disponíveis no site Natural Earth. rnaturalearth possui funções para auxiliar no download desses dados.

Os dados disponíveis estão descritos nas duas tabelas abaixo e online aqui.

category   cultural 

category   physical 

Especifique a scale , category e type do vetor desejado como nos exemplos abaixo.

 # lakes
lakes110 <- ne_download( scale = 110 , type = " lakes " , category = " physical " )
plot( lakes110 )

# rivers
rivers50 <- ne_download(
  scale = 50 ,
  type = " rivers_lake_centerlines " ,
  category = " physical " ,
  returnclass = " sf "
)

library( ggplot2 )
library( sf )

ggplot( rivers50 ) +
  geom_sf() +
  theme_minimal()

Detalhes de diferentes definições e escalas de países

vignette( " what-is-a-country " , package = " rnaturalearth " )

Download reproduzível de dados do Natural Earth no pacote

Script usado para colocar dados nos pacotes de dados que os acompanham.

Erros nos dados?

Se você acredita que há um problema com os dados fornecidos pela Natural Earth, não informe aqui. Não somos responsáveis ​​pela precisão ou manutenção dos dados da Natural Earth. Para qualquer dúvida em relação a esses dados, entre em contato com a Natural Earth.

Agradecimentos

Obrigado a Lincoln Mullen pela inspiração da estrutura de código do USAboundaries, Hadley Wickham pelos comentários e sugestões, Bob Rudis pelas respostas às perguntas do stackoverflow sobre o download de dados do Natural Earth em R. A equipe do Natural Earth e Nathan Kelso por fornecer um recurso tão excelente.

Potencial trabalho futuro

Dados adicionais potenciais

• Pesquisa de sinônimos de país
  • dataframe com ISO3 e sinônimos de país
  • semelhante a https://github.com/AndySouth/rworldmap/blob/master/data/countrySynonyms.rda
• Pesquisa de regiões maiores do país
  • dataframe com ISO3 e adesão a diferentes agrupamentos regionais, por exemplo, continente, países menos desenvolvidos, etc.
  • semelhante a https://github.com/AndySouth/rworldmap/blob/master/data/countryRegions.rda

Potenciais funções adicionais

• facilitar a junção de dados do usuário às fronteiras do país

  • semelhante a https://github.com/AndySouth/rworldmap/blob/master/R/joinCountryData2Map.R
  • ... mas com um nome melhor
  • permissão semelhante de junção por códigos ou nomes ISO, com tentativa de correspondência de sinônimos
  • relatórios semelhantes de país juntando sucesso e fracasso

• facilitar a subdivisão por agrupamentos de países

  • por exemplo, países menos desenvolvidos, etc.