rnaturalearth

出力
github_document

ナチュラルアース

Natural Earth マップ データを保持し、そのデータとの対話を容易にする R パッケージ。

このパッケージは以下を提供します:

• 世界地図で一般的に使用される Natural Earth v4.1.0 (2018 年 3 月) ベクトル データの事前にダウンロードされたサブセットへのアクセス

• 国や地域ごとに簡単にサブセット化

• 他の自然地球ベクトルおよびラスター データをダウンロードする関数

• Natural Earth データから rnaturalearth へのシンプルで再現可能かつ持続可能なワークフローにより、新しいバージョンが利用可能になったときに更新できるようになります

• 国、主権国家、地図単位ごとに分類した世界地図の違いを明確にする

• Natural Earth の命名規則との整合性。これにより、rnaturalearth ユーザーは Natural Earth のドキュメントを使用できるようになります。

• sfまたはsv形式のデータ

Natural Earth の Web サイトでは、ベクトル データをスケール、カテゴリ、タイプごとに構造化しています。これらにより、ダウンロードのファイル名が決まります。 rnaturalearth は、(API のように) ダウンロードを容易にするためにこの構造を使用します。

rnaturalearth をインストールする

CRAN からインストールします。

install.packages( " rnaturalearth " )

または、devtools を使用して GitHub から開発バージョンをインストールします。

 devtools :: install_github( " ropensci/rnaturalearth " )

パッケージ機能の多くをサポートするデータは 2 つのデータ パッケージに保存されており、ここでインストールしないと、必要に応じてインストールするように求められます。

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

初めての使用

ここでは、マップをプロットする簡単で迅速な方法としてplot使用します。マップは、 ggplot2 、 tmap 、またはその他のオプションを使用して作成することもできます。すべての取得関数は引数returnclass = "sf"を受け入れて、パッケージsf (Simple features) または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 

紹介のビネット

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

まだパッケージに含まれていない Natural Earth データをダウンロードするには

Natural Earth の Web サイトでは、他にも豊富なデータが入手できます。 rnaturalearthこれらのデータのダウンロードを支援する機能があります。

入手可能なデータは、以下の 2 つの表とオンラインのこちらに概要が記載されています。

category   cultural 

category   physical 

以下の例のように、必要なベクトルのscale 、 category 、 type指定します。

 # 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()

さまざまな国の定義とスケールの詳細

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

Natural Earth データをパッケージに再現可能にダウンロード

付属のデータ パッケージにデータを取得するために使用されるスクリプト。

データに誤りがありますか?

Natural Earth が提供するデータに問題があると思われる場合は、ここで報告しないでください。私たちは、Natural Earth データの正確性や保守については責任を負いません。このデータに関する懸念がある場合は、Natural Earth までお問い合わせください。

謝辞

USAboundaries からコード構造のインスピレーションを得た Lincoln Mullen、コメントとプロンプトをくれた Hadley Wickham、R への Natural Earth データのダウンロードに関するスタックオーバーフローの質問に答えてくれた Bob Rudis、Natural Earth チーム、そしてこのような素晴らしいリソースを提供してくれた Nathan Kelso に感謝します。

将来の仕事の可能性

潜在的な追加データ

• 国の同義語の検索
  • ISO3 および国の同義語を含むデータフレーム
  • https://github.com/AndySouth/rworldmap/blob/master/data/countrySynonyms.rda に類似
• 国のより大きな地域の検索
  • ISO3 を使用したデータフレームと、大陸、後発開発途上国などのさまざまな地域グループのメンバーシップ。
  • https://github.com/AndySouth/rworldmap/blob/master/data/countryRegions.rda に類似

追加機能の可能性

• ユーザーデータの国境への結合を容易にする

  • https://github.com/AndySouth/rworldmap/blob/master/R/join CountryData2Map.R に類似
  • ...しかし、もっと良い名前が付いています
  • 同様に、ISO コードまたは名前による結合を許可し、同義語の照合を試みます
  • 加盟国の成功と失敗に関する同様の報告

• 国グループごとのサブセット化を容易にする

  • 例えば後発開発途上国など。