csodata quick start guide

2022-10-20

Introduction

This guide provides a basic overview of the use of the csodata package for new users. Install (if necessary) and load the package:

# # Install or update the package:
# install.packages("csodata")

library(csodata)

Table of Contents

A list of all the table available on the cso StatBank can be downloaded with cso_get_toc. You can search throught the title field using cso_search_toc. (A “Loaded cached toc” or “Loaded cached data” message indicates that the data was retrieved from the cache, instead of being downloaded again.)

toc <- cso_get_toc()
head(toc)
#>          LastModified
#> 1 2022-10-20 00:20:00
#> 2 2022-10-20 00:20:00
#> 3 2022-10-20 00:20:00
#> 4 2022-10-20 00:20:00
#> 5 2022-10-20 00:20:00
#> 6 2022-10-20 00:20:00
#>                                                                         title
#> 1         Wexford Population by Private Households, Occupied and Vacancy Rate
#> 2                                             Private Households 2011 to 2016
#> 3         Wicklow Population by Private Households, Occupied and Vacancy Rate
#> 4          Dublin Population by Private Households, Occupied and Vacancy Rate
#> 5 Population and Private Households Occupied and Percentage Vacant Households
#> 6                                                     Population 2011 to 2016
#>      id
#> 1 CD173
#> 2 E4018
#> 3 CD174
#> 4 CD175
#> 5 CD176
#> 6 E4019

Downloading Data

To download a dataset, use cso_get_data and include a table code from the table of contents.

tbl1 <- cso_get_data("PEA19")

Metadata can be also downloaded or displayed to console:

meta1 <- cso_get_meta("CDP06")
cso_disp_meta("CDP06")
#> Loaded cached data
#> *** METADATA ***
#> CSO Table = Annual Estimated Net Migration 1951 to 2011 per 1,000 of Average Population
#> Units = Number
#> Copyright = Central Statistics Office, Ireland
#> Time interval in data = Intercensal Period
#> Are these statistics experimental? -FALSE
#> Date last modified = 2020-10-30T11:00:00Z
#> Variables:
#> [1] "Intercensal Period" "Province or County" "Year"
#> 
#> Statistics:
#> [1] "Annual Estimated Net Migration 1951 to 2011 per 1,000 of Average Population"
#> 
#> Geographic Data:
#> [1] FALSE

Geographic Data

Geographic vector data in ESRI shapefile format can be downloaded for use in mapping. This is a map of county councils and other local authorities in Ireland, there are many other maps available.

shp <- cso_get_geo("County Councils")
#> Reading layer `2019_Local_Authorities' from data source 
#>   `C:\Users\orourkej\AppData\Local\Temp\Rtmp4ANOQh\2019_Local_Authorities.shp' 
#>   using driver `GeoJSON'
#> Simple feature collection with 31 features and 2 fields
#> Geometry type: MULTIPOLYGON
#> Dimension:     XY
#> Bounding box:  xmin: -10.68088 ymin: 51.41991 xmax: -5.996287 ymax: 55.44662
#> Geodetic CRS:  WGS 84

This data can be plotted using the leaflet package. Here we plot the outline of each region.


# install.packages("leaflet")
library(leaflet)


leaflet(shp) %>% 
  addTiles() %>% 
  addPolygons()

The data which has been cached locally can be manually cleared once we are done with it.

cso_clear_cache()