Population: Retrieve the demographic data with given month

PopulationR Documentation

Retrieve the demographic data with given month

Description

The function is used to download the demographic data of districts in Taiwan for the specific time. Level of districts include county, town, village, minimum statistical area (SA0), statistical area 1 (SA1), and statistical area 2 (SA2). The data is downloaded from Social Economic Geographic Information System (SEGIS) by Ministry of the Interior.

Usage

Population(district, time, age=F, out=F)

Arguments

district

Please fill in the district type. The valid input includes County, Town, Village, SA0 (minimum statistical area), SA1 (statistical area 1), SA2 (statistical area 2).

time

The time (year-month) of the data. The format of time should be YYYY-MM. Note that demographic data for 'County', 'Town', and 'Village' is updated every three months, only March, June, September, and December are provided. Data for 'SA0', 'SA1', and 'SA2' is updated half a year, only June and December are provided. If the argument is blank (NULL), the latest data will be retrieved.

age

If the population of each age (5-year-old interval) is required, please set TRUE.

out

If the result should be exported to the local, please fill in the directory. The default value is FALSE, which does not export the data.

Value

Columns definition of the results are summarized below.

H_CNT Number of household.
P_CNT Total population.
M_CNT Total male population.
F_CNT Total female population.

If age is set TRUE, then the column name would contain each age interval. For instance, column "A20A24_M_CNT" means "the population of male in age 20 to 24." Column "A60A64_F_CNT" represents "the population of female in age 60 to 64."

Author(s)

Maintainer: Chia Jung, Yeh chia-jung.yeh@sydney.edu.au

Examples

Population(district="County", time="2022-06")
Population(district="SA0", time="2022-06", age=T, out="./taiwan_SA0_population.csv")

ChiaJung-Yeh/NYCU_TDX documentation built on Aug. 28, 2024, 10:43 p.m.