geouy logo logo

CRAN/METACRAN Version CRAN/METACRAN Total downloads CRAN/METACRAN downloads per month Project Status: Active – The project has reached a stable, usable state and is being actively developed. R build status AppVeyor build status Codecov test coverage DOI

geouy is an R package that allows users to easily access official spatial data sets of Uruguay. The package includes a wide range of geospatial datasets as simple features (sf), available at various geographic scales and for various years with harmonized attributes and projection (see detailed list below).

Installation

# From CRAN
  install.packages("geouy")
  library(geouy)
  
# Use the development version with latest features
  utils::remove.packages('geouy')
  devtools::install_github("RichDeto/geouy")
  library(geouy)

obs. If you use Linux, you need to install a couple dependencies before installing the libraries sf and geouy. More info here.

Basic Usage

load_geouy

The syntax of all geouy functions operate one the same logic so it becomes intuitive to download any data set using a single line of code. Like this:

secc <- load_geouy("Secciones")

Available datasets:

Administrative limits
Layer Productor Source Year Format
"Uruguay" "INE" MIDES 2011 wfs
"Areas administrativas" "SGM" SGM 2011 wfs
"Deptos" "INE" IDE 2011 wfs
"Dptos" "DINAMA" “MVOTMA” 2020 wfs
"Limites departamentales" "IGM" “IGM” 2011 wfs
"Departamentos" "IDE" “MIDES” 2011 wfs
"Secciones" "INE Censo" MIDES 2011 wfs
"Segmentos" "INE Censo" MIDES 2011 wfs
"Zonas" "INE Censo" MIDES 2011 wfs
"Secc MVD 2004" "INE" MIDES 2004 wfs
"Segm MVD 2004" "INE" MIDES 2004 wfs
"Segm URB INT 2004" "INE" MIDES 2004 wfs
"Zonas MVD 2004" "INE" MIDES 2004 wfs
"Zonas URB INT 2004" "INE" MIDES 2004 wfs
"Localidades pg" "INE Censo" MIDES 2011 wfs
"Localidades pt" "INE Censo" MIDES 2011 wfs
"Centros poblados pg" "SGM" SGM 2011 wfs
"Centros poblados pt" "SGM" SGM 2011 wfs
"Municipios" "IGM" IGM 2011 wfs
"CCZ" "INE" MIDES 2011 wfs
"Asentamientos irregulares" "PMB" MIDES 2014 wfs
"Barrios" "INE" MIDES 2011 wfs
"Balnearios" "MTOP" MTOP 2017 wfs
"Secciones catastrales" "DNC" MVOTMA 2013 zip
"Padrones rurales" "DNC" “MVOTMA” 2014 zip
"Padrones urbanos" "DNC" MVOTMA 2014 zip
"Secciones policiales" "MI" MVOTMA 2017 zip
Demography
Layer Productor Source Year Format
"LocHog11" "INE" IDE 2011 zip
"LocPobHom11" "INE" IDE 2011 zip
"LocPobMuj11" "INE" IDE 2011 zip
"LocViv11" "INE" IDE 2011 zip
Hidrology
Layer Productor Source Year Format
"Cuencas hidro N1" "DINAGUA" MVOTMA 2020 zip
"Cuencas hidro N2" "DINAGUA" MVOTMA 2020 zip
"Cuencas hidro N3" "DINAGUA" MVOTMA 2020 zip
"Cuencas hidro N4" "DINAGUA" MVOTMA 2020 zip
"Cuencas hidro N5" "DINAGUA" MVOTMA 2020 zip
"Cursos de agua navegables y flotables" "MTOP" MTOP 2019 wfs
"Lagunas publicas" "MTOP" MTOP 2019 wfs
"Ambientes acuaticos" "FREPLATA" MVOTMA 2009 zip
"Areas protegidas" DINAMA" MVOTMA 2015 zip
"Baniados" "DINAMA" MVOTMA NA zip
"Batimetria" "DINAMA" MVOTMA 2020 zip
Ways
Layer Productor Source Year Format
"Rutas" "IDE" MIDES 2017 wfs
"Calles" "IDE - UTE - IM" MIDES 2017 wfs
"Peajes" "MTOP" MTOP 2019 wfs
"Postes Kilometros" "MTOP" MTOP 2019 wfs
Services
Layer Productor Source Year Format
"Educación en Primera Infancia e Inicial" "CEIP" MIDES 2020 zip
"Jardines de infantes" "CEIP" MIDES 2020 zip
"Colegios privados N0a3" "CEIP" MIDES 2020 zip
"Escuelas con N3" "CEIP" MIDES 2020 zip
"Escuelas" "CEIP" MIDES 2020 zip
"Educacion especial" "CEIP" MIDES 2020 zip
"Educacion secundaria" "CEIP" MIDES 2020 zip
"UTU" "ANEP" MIDES 2020 zip
"Instituciones deportivas" "IDE" MIDES 2015 wfs
"Playas" "DINAMA¨ MVOTMA 2007 zip
Orthophotos
Layer Productor Source Year Format
"Grilla ortofotos urbana" "IDE" IDE 2019 wfs
"Grilla ortofotos nacional" "IDE" IDE 2019 wfs
Land Cover
Layer Productor Source Year Format
"Cobertura suelo 2000" "DINAGUA" MVOTMA 2000 zip
"Cobertura suelo 2008" "DINAGUA" MVOTMA 2008 zip
"Cobertura suelo 2011" "DINAGUA" MVOTMA 2011 zip
"Cobertura suelo 2015" "DINAGUA" MVOTMA 2015 zip
"CONEAT" "RENARE" “RENARE” NA wfs

which_uy()

Add to an sf object its spatial coincidence with one or more administrative units in Uruguay, generating the corresponding variables.

where_uy()

You get an sf object of one or more administrative units in Uruguay, according to a query by code or name in the layer.

add_geom()

This function allows you to add a geom variable with a code variable of “zona”, “barrio”, “localidad”, “segmentos”, “secciones” or “departamentos”.

geocode_ide_uy()

Allows geocoding directions using IDE_uy.

plot_geouy()

Plot a variable of your sf object with north and scale, set on a simple theme.

Other functions:

is.uy4326(): Test if an sf object match with Uruguay at crs = 4326. is.uy32721(): Test if an sf object match with Uruguay at crs = 32721. is.uy5381(): Test if an sf object match with Uruguay at crs = 5381. is.uy5382(): Test if an sf object match with Uruguay at crs = 5382.

Datasets

metadata

This dataset has the metadata of all vector geometries provided by geouy and detailed at the top

metadata_wms

This dataset has the metadata of all the raster services that will be provided by geouy, although the functions are still under development.

loc_agr_ine

This dataset allows you to aggregate Localidades INE by the aglomerations used by INE. An example of use can be:

loc <- which_uy(base, "Localidades pg") %>% 
    dplyr::left_join(loc_agr_ine, by = c("cod_Localidades pg" = "codloc"))

uy_deptos_grid and mvd_barrios_grid

Two datasets to use as geofacet grid dataset for departments of Uruguay and neighborhoods of Montevideo.

History

This package arises from the conjugation of own ideas with an eye on the region. It started as a part of the package where I work with @calcita at ech, and some geospatial service packages in the region mainly: geobr and chilemapas

This walk on the shoulders of giants, allows this package focused on this small country (my beautiful Uruguay), to have its own particularities although it tries to fit especially to geobr in its structure and with a view to complementing ech.

Community contributions es

This package intends to incorporate any function of general requirements that use the geographic data of Uruguay as a base. All contributions in this regard are welcome.

If you work with geographic data of Uruguay and want to add your function or data, we recommend that you read the following tips on how to collaborate:

To add your function:

- Fork of this repository
- Add your function as an `.R` file in the `R/` folder with the same name as the function
- Document it with `roxygen2` clarifying its functionality, parameters and an example of use. To see how it is documented to review another function in the same directory
- Remember at the end of the documentation you must add a # '@export
- Check that the types and values of your function parameters are fine (for example, you can look at `data-raw/metadata.R`
- Add the dependencies in the `DESCRIPTION` file 
- Check the package with devtools::check()
- If everything works fine, then make a pull request

To add geographic data to the load_geouy() function:

- Fork of this repository
- Identify the corresponding WFS service URL
- Add a record to the `metadata` file in the `data-raw/` directory, with the corresponding data.
- Also include this record in the corresponding table of the `README.md` file, with the corresponding format.
- If everything works fine, then make a pull request

Citation

To cite geouy in publications, please use:

Detomasi, Richard (2021) “geouy: Geographic Information of Uruguay”. R package version 0.2.5 URL: https://github.com/RichDeto/geouy.

A BibTeX entry for LaTeX users is:

@Misc{geouy,
  title = {geouy: Geographic Information of Uruguay},
  author = {Richard Detomasi},
  note = {R package version 0.2.5},
  year = {2021},
  url  = {https://github.com/RichDeto/geouy},
}