README.Rmd

---
output: github_document
---

<!-- README.md is generated from README.Rmd. Please edit that file -->

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

# COGiter <img src='man/figures/logo.png' align="right" height="139" />

<!-- badges: start -->
[![R-CMD-check](https://github.com/MaelTheuliere/COGiter/workflows/R-CMD-check/badge.svg)](https://github.com/MaelTheuliere/COGiter/actions)
[![Codecov test coverage](https://codecov.io/gh/MaelTheuliere/COGiter/branch/master/graph/badge.svg)](https://codecov.io/gh/MaelTheuliere/COGiter?branch=master)
<!-- badges: end -->

COGiter fournit des fonctions, des données et des fonds de carte pour permettre des analyses territoriales sur les collectivités françaises.

## Installation

Installer le package depuis [github](https://github.com/) ou [gitlab](https://gitlab.com)

``` r
remotes::install_github("MaelTheuliere/COGiter")
remotes::install_gitlab("dreal-datalab/COGiter")
```

## A propos

Ce package R vise à mettre à disposition : 

- les tables du COG 2021 de l'Insee en RData;
- une table de passage des COG historiques vers le COG millésimé 2021;
- les couche géomatiques correspondantes au COG 2021
- des fonctions d'aide à au passage de jeu de données vers le millésime du COG 2021

Le tout avec des règles de nommage identiques pour faciliter les appariements.

Le package [COGUGAISON](https://github.com/antuki/COGugaison) rempli en partie la même fonction et nous vous invitons à privilégier son utilisation. 
Ce présent package visant à répondre à des besoins spécifiques du [DREAL datalab Pays de la Loire](http://www.pays-de-la-loire.developpement-durable.gouv.fr/dreal-centre-de-service-de-la-donnee-r1957.html) et est par ailleurs non stabilisé.

## Les données sources

### Le COG Insee 2021

- https://www.insee.fr/fr/information/2560452

### Admin Express

- https://geoservices.ign.fr/documentation/diffusion/telechargement-donnees-libres.html#admin-express

## Description du package

Voir la [page de référence](https://maeltheuliere.github.io/COGiter/reference/index.html)

## Exemple d'usage

Voir la [vignette](https://maeltheuliere.github.io/COGiter/articles/cogiter.html)