ColOpenData

A package that acquires and wrangles Colombian socioeconomic, geospatial and climate data.
https://github.com/epiverse-trace/colopendata

Category: Climate Change
Sub Category: Climate Data Access and Visualization

Keywords

climate colombia data-package demographics maps r r-package

Keywords from Contributors

routing

Last synced: about 14 hours ago
JSON representation

Repository metadata

ColOpenData is a package that acquires and wrangles Colombian socioeconomic, geospatial and climate data

• Host: GitHub
• URL: https://github.com/epiverse-trace/colopendata
• Owner: epiverse-trace
• License: other
• Created: 2023-09-12T20:41:31.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-02-26T20:30:08.000Z (about 2 months ago)
• Last Synced: 2025-04-20T09:04:31.397Z (7 days ago)
• Topics: climate, colombia, data-package, demographics, maps, r, r-package
• Language: R
• Homepage: https://epiverse-trace.github.io/ColOpenData/
• Size: 22.9 MB
• Stars: 10
• Watchers: 3
• Forks: 1
• Open Issues: 4
• Releases: 0
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS.md
  • License: LICENSE
  • Citation: CITATION.cff

README.Rmd

          ---
output: github_document
---











```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```

# **ColOpenData** 



[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/license/mit) [![R-CMD-check](https://github.com/epiverse-trace/ColOpenData/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/epiverse-trace/ColOpenData/actions/workflows/R-CMD-check.yaml) 
[![Codecov test coverage](https://codecov.io/gh/epiverse-trace/ColOpenData/branch/main/graph/badge.svg)](https://app.codecov.io/gh/epiverse-trace/ColOpenData?branch=main) 
[![Lifecycle: stable](https://img.shields.io/badge/lifecycle-stable-brightgreen.svg)](https://lifecycle.r-lib.org/articles/stages.html#stable)
[![CRAN status](https://www.r-pkg.org/badges/version/ColOpenData)](https://CRAN.R-project.org/package=ColOpenData)
[![CRAN downloads](https://cranlogs.r-pkg.org/badges/ColOpenData)](https://cran.r-project.org/package=ColOpenData)



**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](https://www.uniandes.edu.co:443/es) as part of the [Epiverse-TRACE program](https://data.org/initiatives/epiverse/).

## Installation

You can install the CRAN version of ColOpenData with:

```{r eval=FALSE, include=TRUE}
install.packages("ColOpenData")
```

You can also install the development version of ColOpenData from [GitHub](https://github.com/) with:

```{r eval=FALSE, include=TRUE}
# install.packages("pak")
pak::pak("epiverse-trace/ColOpenData")
```

## Quick Overview

**ColOpenData** contains data from two public data sources: Departamento Administrativo Nacional de Estadística (DANE), and Instituto de Hidrología, Meteorología y Estudios Ambientales (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](https://epiverse-trace.github.io/ColOpenData/).

### Similar R Packages

Similar R packages are offered for international communities, allowing the user to download census, geospatial and climate data.

-   [cancensus](https://mountainmath.github.io/cancensus/): Canada
-   [censobr](https://ipeagit.github.io/censobr/): Brazil
-   [chilemapas](https://github.com/pachadotdev/chilemapas/): Chile
-   [geobr](https://ipeagit.github.io/geobr/) : Brazil
-   [georAr](https://github.com/PoliticaArgentina/geoAr): Argentina
-   [geouy](https://github.com/RichDeto/geouy): Uruguay
-   [tidycensus](https://walker-data.com/tidycensus/): US
-   [geofi](https://ropengov.github.io/geofi/): Finland
-   [climate](https://bczernecki.github.io/climate/)

### Disclaimer

ColOpenData stores and distributes open data originally obtained from Departamento Administrativo Nacional de Estadística (DANE), and Instituto de Hidrología, Meteorología y Estudios Ambientales (IDEAM). It is important to note that the data retrieved from these sources has been processed, transformed, and adapted to meet the functional requirements of this package. These modifications may result in changes to the structure, format, or content of the original data, and as such, the data provided by this package does not represent the official datasets as maintained by IDEAM or DANE.
The development of this package is completely independent of these institutions, 
and neither IDEAM, DANE, nor any other Colombian government body endorses, 
sponsors, or is involved in the creation or maintenance of this package. 
Consequently, they bear no responsibility for the data as presented within this 
package. Furthermore, the authors of the ColOpenData assume no liability for any
outcomes resulting from the use or misuse of the data provided. The user is 
solely responsible for how they utilize the data, and any conclusions drawn, 
analyses performed, or actions taken based on this data are the user's 
responsibility. This package and its authors make no claims to represent or act 
on behalf of IDEAM, DANE, or any other official entity.

### Lifecycle

This package is currently *stable*, as defined by the [RECON software lifecycle](https://www.reconverse.org/lifecycle.html). Therefore, this is a functional package and it is documented and tested. However, it still may change over time.


### Contributions

Contributions are welcome via [pull requests](https://github.com/epiverse-trace/ColOpenData/pulls).

### Code of Conduct

Please note that the ColOpenData project is released with a [Contributor Code of Conduct](https://github.com/epiverse-trace/.github/blob/main/CODE_OF_CONDUCT.md). 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-].

        

Citation (CITATION.cff)

# --------------------------------------------
# CITATION file created with {cffr} R package
# See also: https://docs.ropensci.org/cffr/
# --------------------------------------------
 
cff-version: 1.2.0
message: 'To cite package "ColOpenData" in publications use:'
type: software
license: MIT
title: 'ColOpenData: Download Colombian Demographic, Climate and Geospatial Data'
version: 0.3.0
abstract: Downloads wrangled Colombian socioeconomic, geospatial, population and climate
  data from DANE and IDEAM. It solves the problem of Colombian data being issued in
  different web pages and sources by using functions that allow the user to select
  the desired database and download it without having to do the exhausting acquisition
  process.
authors:
- family-names: Tavera-Cifuentes
  given-names: Maria Camila
  email: [email protected]
  orcid: https://orcid.org/0009-0007-1610-4583
- family-names: Otero
  given-names: Julian
  email: [email protected]
  orcid: https://orcid.org/0009-0006-0429-7747
repository-code: https://github.com/epiverse-trace/ColOpenData
url: https://epiverse-trace.github.io/ColOpenData/
contact:
- family-names: Tavera-Cifuentes
  given-names: Maria Camila
  email: [email protected]
  orcid: https://orcid.org/0009-0007-1610-4583
keywords:
- climate
- colombia
- data-package
- demographics
- maps
- r
- r-package
references:
- type: software
  title: 'R: A Language and Environment for Statistical Computing'
  notes: Depends
  url: https://www.R-project.org/
  authors:
  - name: R Core Team
  institution:
    name: R Foundation for Statistical Computing
    address: Vienna, Austria
  year: '2024'
  version: '>= 3.3.0'
- type: software
  title: checkmate
  abstract: 'checkmate: Fast and Versatile Argument Checks'
  notes: Imports
  url: https://mllg.github.io/checkmate/
  repository: https://CRAN.R-project.org/package=checkmate
  authors:
  - family-names: Lang
    given-names: Michel
    email: [email protected]
    orcid: https://orcid.org/0000-0001-9754-0393
  year: '2024'
  doi: 10.32614/CRAN.package.checkmate
- type: software
  title: config
  abstract: 'config: Manage Environment Specific Configuration Values'
  notes: Imports
  url: https://rstudio.github.io/config/
  repository: https://CRAN.R-project.org/package=config
  authors:
  - family-names: Allaire
    given-names: JJ
    email: [email protected]
  year: '2024'
  doi: 10.32614/CRAN.package.config
- type: software
  title: dplyr
  abstract: 'dplyr: A Grammar of Data Manipulation'
  notes: Imports
  url: https://dplyr.tidyverse.org
  repository: https://CRAN.R-project.org/package=dplyr
  authors:
  - family-names: Wickham
    given-names: Hadley
    email: [email protected]
    orcid: https://orcid.org/0000-0003-4757-117X
  - family-names: François
    given-names: Romain
    orcid: https://orcid.org/0000-0002-2444-4226
  - family-names: Henry
    given-names: Lionel
  - family-names: Müller
    given-names: Kirill
    orcid: https://orcid.org/0000-0002-1416-3412
  - family-names: Vaughan
    given-names: Davis
    email: [email protected]
    orcid: https://orcid.org/0000-0003-4777-038X
  year: '2024'
  doi: 10.32614/CRAN.package.dplyr
- type: software
  title: magrittr
  abstract: 'magrittr: A Forward-Pipe Operator for R'
  notes: Imports
  url: https://magrittr.tidyverse.org
  repository: https://CRAN.R-project.org/package=magrittr
  authors:
  - family-names: Bache
    given-names: Stefan Milton
    email: [email protected]
  - family-names: Wickham
    given-names: Hadley
    email: [email protected]
  year: '2024'
  doi: 10.32614/CRAN.package.magrittr
- type: software
  title: rlang
  abstract: 'rlang: Functions for Base Types and Core R and ''Tidyverse'' Features'
  notes: Imports
  url: https://rlang.r-lib.org
  repository: https://CRAN.R-project.org/package=rlang
  authors:
  - family-names: Henry
    given-names: Lionel
    email: [email protected]
  - family-names: Wickham
    given-names: Hadley
    email: [email protected]
  year: '2024'
  doi: 10.32614/CRAN.package.rlang
- type: software
  title: sf
  abstract: 'sf: Simple Features for R'
  notes: Imports
  url: https://r-spatial.github.io/sf/
  repository: https://CRAN.R-project.org/package=sf
  authors:
  - family-names: Pebesma
    given-names: Edzer
    email: [email protected]
    orcid: https://orcid.org/0000-0001-8049-7069
  year: '2024'
  doi: 10.32614/CRAN.package.sf
- type: software
  title: stringdist
  abstract: 'stringdist: Approximate String Matching, Fuzzy Text Search, and String
    Distance Functions'
  notes: Imports
  url: https://github.com/markvanderloo/stringdist
  repository: https://CRAN.R-project.org/package=stringdist
  authors:
  - family-names: Loo
    given-names: Mark
    name-particle: van der
    email: [email protected]
    orcid: https://orcid.org/0000-0002-9807-4686
  year: '2024'
  doi: 10.32614/CRAN.package.stringdist
- type: software
  title: tidyr
  abstract: 'tidyr: Tidy Messy Data'
  notes: Imports
  url: https://tidyr.tidyverse.org
  repository: https://CRAN.R-project.org/package=tidyr
  authors:
  - family-names: Wickham
    given-names: Hadley
    email: [email protected]
  - family-names: Vaughan
    given-names: Davis
    email: [email protected]
  - family-names: Girlich
    given-names: Maximilian
  year: '2024'
  doi: 10.32614/CRAN.package.tidyr
- type: software
  title: utils
  abstract: 'R: A Language and Environment for Statistical Computing'
  notes: Imports
  authors:
  - name: R Core Team
  institution:
    name: R Foundation for Statistical Computing
    address: Vienna, Austria
  year: '2024'
- type: software
  title: ggplot2
  abstract: 'ggplot2: Create Elegant Data Visualisations Using the Grammar of Graphics'
  notes: Suggests
  url: https://ggplot2.tidyverse.org
  repository: https://CRAN.R-project.org/package=ggplot2
  authors:
  - family-names: Wickham
    given-names: Hadley
    email: [email protected]
    orcid: https://orcid.org/0000-0003-4757-117X
  - family-names: Chang
    given-names: Winston
    orcid: https://orcid.org/0000-0002-1576-2126
  - family-names: Henry
    given-names: Lionel
  - family-names: Pedersen
    given-names: Thomas Lin
    email: [email protected]
    orcid: https://orcid.org/0000-0002-5147-4711
  - family-names: Takahashi
    given-names: Kohske
  - family-names: Wilke
    given-names: Claus
    orcid: https://orcid.org/0000-0002-7470-9261
  - family-names: Woo
    given-names: Kara
    orcid: https://orcid.org/0000-0002-5125-4188
  - family-names: Yutani
    given-names: Hiroaki
    orcid: https://orcid.org/0000-0002-3385-7233
  - family-names: Dunnington
    given-names: Dewey
    orcid: https://orcid.org/0000-0002-9415-4582
  - family-names: Brand
    given-names: Teun
    name-particle: van den
    orcid: https://orcid.org/0000-0002-9335-7468
  year: '2024'
  doi: 10.32614/CRAN.package.ggplot2
- type: software
  title: knitr
  abstract: 'knitr: A General-Purpose Package for Dynamic Report Generation in R'
  notes: Suggests
  url: https://yihui.org/knitr/
  repository: https://CRAN.R-project.org/package=knitr
  authors:
  - family-names: Xie
    given-names: Yihui
    email: [email protected]
    orcid: https://orcid.org/0000-0003-0645-5666
  year: '2024'
  doi: 10.32614/CRAN.package.knitr
- type: software
  title: leaflet
  abstract: 'leaflet: Create Interactive Web Maps with the JavaScript ''Leaflet''
    Library'
  notes: Suggests
  url: https://rstudio.github.io/leaflet/
  repository: https://CRAN.R-project.org/package=leaflet
  authors:
  - family-names: Cheng
    given-names: Joe
    email: [email protected]
  - family-names: Schloerke
    given-names: Barret
    email: [email protected]
    orcid: https://orcid.org/0000-0001-9986-114X
  - family-names: Karambelkar
    given-names: Bhaskar
  - family-names: Xie
    given-names: Yihui
  year: '2024'
  doi: 10.32614/CRAN.package.leaflet
- type: software
  title: rmarkdown
  abstract: 'rmarkdown: Dynamic Documents for R'
  notes: Suggests
  url: https://pkgs.rstudio.com/rmarkdown/
  repository: https://CRAN.R-project.org/package=rmarkdown
  authors:
  - family-names: Allaire
    given-names: JJ
    email: [email protected]
  - family-names: Xie
    given-names: Yihui
    email: [email protected]
    orcid: https://orcid.org/0000-0003-0645-5666
  - family-names: Dervieux
    given-names: Christophe
    email: [email protected]
    orcid: https://orcid.org/0000-0003-4474-2498
  - family-names: McPherson
    given-names: Jonathan
    email: [email protected]
  - family-names: Luraschi
    given-names: Javier
  - family-names: Ushey
    given-names: Kevin
    email: [email protected]
  - family-names: Atkins
    given-names: Aron
    email: [email protected]
  - family-names: Wickham
    given-names: Hadley
    email: [email protected]
  - family-names: Cheng
    given-names: Joe
    email: [email protected]
  - family-names: Chang
    given-names: Winston
    email: [email protected]
  - family-names: Iannone
    given-names: Richard
    email: [email protected]
    orcid: https://orcid.org/0000-0003-3925-190X
  year: '2024'
  doi: 10.32614/CRAN.package.rmarkdown
- type: software
  title: spelling
  abstract: 'spelling: Tools for Spell Checking in R'
  notes: Suggests
  url: https://ropensci.r-universe.dev/spelling
  repository: https://CRAN.R-project.org/package=spelling
  authors:
  - family-names: Ooms
    given-names: Jeroen
    email: [email protected]
    orcid: https://orcid.org/0000-0002-4035-0289
  - family-names: Hester
    given-names: Jim
    email: [email protected]
  year: '2024'
  doi: 10.32614/CRAN.package.spelling
- type: software
  title: testthat
  abstract: 'testthat: Unit Testing for R'
  notes: Suggests
  url: https://testthat.r-lib.org
  repository: https://CRAN.R-project.org/package=testthat
  authors:
  - family-names: Wickham
    given-names: Hadley
    email: [email protected]
  year: '2024'
  doi: 10.32614/CRAN.package.testthat
  version: '>= 3.0.0'

---

Owner metadata

• Name: Epiverse-TRACE
• Login: epiverse-trace
• Email:
• Kind: organization
• Description:
• Website: https://epiverse.org
• Location:
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/101338582?v=4
• Repositories: 17
• Last ynced at: 2023-03-06T22:51:50.116Z
• Profile URL: https://github.com/epiverse-trace

---

GitHub Events

Total

• Issues event: 7
• Watch event: 3
• Delete event: 6
• Issue comment event: 6
• Push event: 41
• Pull request review comment event: 1
• Pull request review event: 6
• Pull request event: 11
• Create event: 7

Last Year

• Issues event: 7
• Watch event: 3
• Delete event: 6
• Issue comment event: 6
• Push event: 41
• Pull request review comment event: 1
• Pull request review event: 6
• Pull request event: 11
• Create event: 7

---

Committers metadata

Last synced: 6 days ago

Name	Email	Commits
jd-otero	j****o@o****m	110
jd-otero	B****n@2****9	43
M. Camila Tavera-Cifuentes	8****i	31
GitHub Action	a****n@g****m	12
Chris Hartgerink	c****s@l****g	1

Committer domains:

• libscie.org: 1
• github.com: 1

---

Issue and Pull Request metadata

Last synced: 1 day ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/epiverse-trace/colopendata

---

---

---

Package metadata

• Total packages: 1
• Total downloads:
  • cran: 260 last-month
• Total dependent packages: 0
• Total dependent repositories: 0
• Total versions: 3
• Total maintainers: 1

Score: 9.813015649372053