data.world r

data.world-r

Le package data.world est le principal package R permettant de travailler avec des ensembles de données sur data.world.
Grâce à ces packages, les utilisateurs peuvent :

• Interroger et joindre des ensembles de données
• Choisissez entre SQL et SPARQL
• Publier des informations
• Utilisez l'API REST de data.world (via le package dwapi inclus)

Commencer

Pour commencer, chargez la bibliothèque et consultez la vignette quickstart .

library( data.world )
vignette( " quickstart " , package = " data.world " )

Voici un exemple simple :

 intro_ds <- " https://data.world/jonloyens/an-intro-to-dataworld-dataset "

sample_query <- data.world :: qry_sql(paste0(
  " SELECT t.Name, t.Height, s.AssistsPerGame " ,
  " FROM DataDotWorldBBallTeam as t " ,
  " JOIN DataDotWorldBBallStats as s ON t.Name = s.Name " ,
  " ORDER BY s.AssistsPerGame DESC " ))

data.world :: query( sample_query , dataset = intro_ds )

Notez que dataset est un paramètre requis par la plupart des fonctions et peut être fourni sous deux formats :

1. URL : "https://data.world/jonloyens/an-intro-to-dataworld-dataset"
2. Chemin : "jonloyens/an-intro-to-dataworld-dataset"

Informations sur la publication

Pour votre commodité, ce package vous permet de publier des informations sur des projets de données sans quitter R Studio.

À l’aide du menu « Compléments » de R Studio, recherchez DATA.WORLD > New insight .

Le complément capturera automatiquement le tracé actif dans la vue tracé de R Studio et vous donnera la possibilité de choisir rapidement le projet et de saisir le titre et la description pour votre aperçu.

Installation

Pour installer directement depuis GitHub :

 devtools :: install_github( " datadotworld/data.world-r " , build_vignettes = TRUE , ref = " main " )

Remarque : vous devrez installer le package devtools pour R pour exécuter la commande précédente. Si ce n'est pas déjà installé, vous pouvez l'installer depuis CRAN en utilisant la commande :

install.packages( " devtools " )

Configuration

Tout d'abord, les utilisateurs doivent obtenir un jeton d'authentification API à l'adresse : https://data.world/settings/advanced

IMPORTANT : Pour votre sécurité, n'incluez pas votre jeton d'authentification API dans un code destiné à être partagé avec d'autres.

La configuration peut être fournie sous 3 formes :

• Via le fichier de configuration
• Via des variables d'environnement
• Au moment de l'exécution

Les fichiers de configuration constituent la méthode de configuration la plus pratique. Une fois enregistrée, la configuration sera automatiquement restaurée lorsque data.world sera chargé.

Depuis la console R :

 saved_cfg <- data.world :: save_config( " YOUR API TOKEN " )
data.world :: set_config( saved_cfg )

Pour des options de configuration supplémentaires, voir ?set_config

Suivant

Consultez la vignette quickstart et query ainsi que la documentation du package ( ?data.world ).

 > vignette("quickstart", package = "data.world")
> ?data.world

Remarques

Nous avons supprimé le package de CRAN et recommandons de l'installer directement depuis Github.