/jpops

Provides a Data Set on the Population in Japan

Primary LanguageROtherNOASSERTION

jpops

(Sorry, English version of README is not availavle for now.)

CRAN status Lifecycle: experimental

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)

国勢調査

人口等基本集計 (2005~2020)

男女別総数

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"))