Movatterモバイル変換

happign

happign - IGN data from R

The goal of happign is to facilitate the use of Web Services and APIfrom the IGN (French National Institute of Geographic and ForestryInformation).happign allow downloading of :

• Shapefile via use of WFS service andAPIcarto ;
• Raster via use of WMS raster service

Context

Since January 1, 2021, the French National Institute for Geographicand Forestry Information (IGN) has opened access to their data on Frenchtopography, infrastructure, and terrain freely available. The opening ofIGN data under the Etalab 2.0 open license means free access and use forall.

To facilitate accessibility, IGN has implemented a set of APIs andWeb services based on OGC standards. Despite a well supplieddocumentation, the use of APIs and Web services remains complex to setup in R. Thehappign package has been created to make iteasier.

Rights of use for IGN data

Data fromIGNgeoservice website are free and available in open license accordingto the principle of theEtalab2.0 license since January 1, 2021. Other data complete the IGN’sopen data policy since June 1st, 2021. SCAN 25®, SCAN 100® and SCAN OACIdata are free to download or stream, but any professional or individualwishing to develop a commercial paper or digital offer for the generalpublic will have to pay a fee according to theGeneral Conditions ofUse.

Installation

You can install the released version of happign fromCRAN with:

install.packages("happign")

And the development version fromGitHub with:

# install.packages("devtools")devtools::install_github("paul-carteron/happign")

Vignettes

Package vignettes :

• Gettingstarted with happign : A brief intro to happign world ;
• happignfor foresters : A focus on possibilities offered by happign forforestry ;
• APIcarto : How to use all API Carto with happign ;

Future features

IGN offers other services. Their implementation in R is underdevelopment :

• Implement isochrone and isodistance calculation

Problems and Issues

• Please report any issues or bugs you may encounter on thededicated page ongithub.

System Requirements

happign requiresR v >= 4.1.0.

Why it’s calledhappign?

This project is - obviously - called happign; here’s why :

• “ign” stand for… IGN : the acronym of the institute ;
• “api” stand for… API : one of the interface used to retrieve thedata;
• and the addition of an “h” and another “p” for the pun with “happy”.Besides the fact that I love this kind of humor, the simplified use ofAPIs is a real source of happiness, trust me.

Also, for the most attentive to details, you can see on the logo agreen leaf stuck between the teeth of the charming smile. It is noneother than the leaf from the IGN logo.

Code of Conduct

Please note that the happign project is released with aContributorCode of Conduct. By contributing to this project, you agree to abideby its terms.