(Sorry, English version of README is not availavle for now.)
jpopsは日本国内で行われた人口に関する統計調査のデータを提供するRパッケージです。
一部のデータの取得はe-StatのAPIを経由して行います。APIを利用するためのapplication idは各自で取得してください。
パッケージは現在CRANには登録されていません。次のコマンドを実行してインストールをしてください。
install.packages(
"jpops",
repos = c(mm = "https://uribo.r-universe.dev", getOption("repos")))
- 必要なデータを参照するための関数を提供します。
- 一部のデータの取得はe-Stat
APIを経由して行いますが、パッケージ内でキャッシュ機能を利用できます。
これによりデータの再取得にかかる時間を短縮できます。
- キャッシュ先のフォルダは
rappdirs::user_cache_dir("jpops")
で確認できます。
- キャッシュ先のフォルダは
- データをtidyな状態で提供します。
- 調査時期によって異なる列名をパッケージ内で統一します(例.
性別を
gender
、地域はarea
、年齢はage
)。これにより複数年を跨いだデータの分析が容易になります。 - 元データが表形式ソフトのファイルで提供されている場合、適切な範囲を選択した状態でデータを読み込みます。
- 調査時期によって異なる列名をパッケージ内で統一します(例.
性別を
library(jpops)
男女別総数
Sys.setenv("ESTAT_TOKEN") <- "{取得したapplication id}"
get_jinkou(2020, appid = Sys.getenv("ESTAT_TOKEN"))
# 2回目以降のデータ取得はキャッシュを利用して高速化できます。
# この時appid引数の入力は必須ではありません
get_jinkou(2020, cache = TRUE)
# キャッシュを利用せずAPI経由でデータを再取得するには cache = FALSE を指定します
get_jinkou(2020, appid = Sys.getenv("ESTAT_TOKEN"), cache = FALSE)
男女・年齢別
get_jinkou_age(2020, appid = Sys.getenv("ESTAT_TOKEN"))