geouy

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

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

Hidrology

Ways

Services

Orthophotos

Land Cover

Other functions:

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 (2020) “geouy: Geographic Information of Uruguay”. R package version 0.2.1 URL: https://github.com/RichDeto/geouy.

A BibTeX entry for LaTeX users is:

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