Awesome
<!-- README.md is generated from README.Rmd. Please edit that file. --> <!-- The code to render this README is stored in .github/workflows/render-readme.yaml --> <!-- Variables marked with double curly braces will be transformed beforehand: --> <!-- `packagename` is extracted from the DESCRIPTION file --> <!-- `gh_repo` is extracted via a special environment variable in GitHub Actions -->ColOpenData <img src="man/figures/logo.svg" align="right" width="200"/>
<!-- badges: start --> <!-- badges: end -->ColOpenData is a package designed to access curated and wrangled Colombian demographic, geospatial, climate and population projections data, retrieved from various open Colombian data sources. The package addresses the challenge of scattered Colombian data across multiple web sources by providing functions that enable users to select and load desired datasets without the need for extensive data acquisition processes. Additionally, the tidy data structure offered for demographic and climate data facilitates analysis and visualization.
ColOpenData is developed at Universidad de Los Andes as part of the Epiverse-TRACE program.
Installation
You can install the CRAN version of ColOpenData with:
install.packages("ColOpenData")
#> Installing package into 'C:/Users/ASUS/AppData/Local/Temp/RtmpsZxXrB/temp_libpath22f054e24b80'
#> (as 'lib' is unspecified)
#> package 'ColOpenData' successfully unpacked and MD5 sums checked
#>
#> The downloaded binary packages are in
#> C:\Users\ASUS\AppData\Local\Temp\RtmpQNeHEm\downloaded_packages
You can also install the development version of ColOpenData from GitHub with:
# install.packages("pak")
pak::pak("epiverse-trace/ColOpenData")
Quick Overview
ColOpenData contains data from two public data sources: The National Administrative Department of Statistics (DANE), and the Institute of Hydrology, Meteorology and Environmental Studies (IDEAM). The available data is divided in four categories:
-
Demographic: Demographic and Socioeconomic data presents information from the National Population and Dwelling Census (CNPV) of 2018. The CNPV data corresponds to the most recent census available to date and the information is presented as an answer to three questions: How many are we?, Where are we? and How do we live?
-
Geospatial: This data is retrieved from the National Geostatistical Framework (MGN), which includes maps and a summarized version of the 2018 CNPV, aggregated to spatial geometries. The data is available at different aggregation levels including: Blocks, Urban and Rural Sections, Urban and Rural Sectors, Urban Areas, Municipalities and Departments.
-
Climate: Climate data is recovered from backup information provided by IDEAM, containing historical data from the first station in the country (January 1st 1920) until May 31st 2023. This backup includes temperature, precipitation, sunshine duration, wind direction, among others.
-
Population projections: Population Projections data contains the population projections and back projections from 1950 to 2070, considering the post COVID-19 update, which was calculated based on the results of 2018 CNPV.
Documentation and vignettes are available for the modules in the user vignettes.
Related R Packages
Similar R packages are offered for international communities, allowing the user to download census, geospatial and climate data.
- cancensus: Canada
- censobr: Brazil
- chilemapas: Chile
- geobr : Brazil
- georAr: Argentina
- geouy: Uruguay
- tidycensus: US
- geofi: Finland
- climate
Lifecycle
This package is currently experimental, as defined by the RECON software lifecycle. Therefore, this is a functional draft and can be tested outside of the development team. However, it still may change over time.
Contributions
Contributions are welcome via pull requests.
Code of Conduct
Please note that the ColOpenData project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.
Funding
This work is part of the TRACE-LAC research project funded by the International Research Centre (IDRC) Ottawa, Canada.[109848-001-].