Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Utilisation de l'API dans R / Package dédié ? #62

Closed
tbesse-oeb opened this issue Jun 9, 2021 · 5 comments
Closed

Utilisation de l'API dans R / Package dédié ? #62

tbesse-oeb opened this issue Jun 9, 2021 · 5 comments

Comments

@tbesse-oeb
Copy link

Je me demandais si parmi les utilisateurs de l'API certains utilisaient R pour extraire les données et faire leurs analyses ou leurs traitements de données.

Je me disais que le développement d'un package R dédié à l'interrogation des API serait utile, à moins que ce soit déjà le cas ?

Peut-être que d'autres seraient intéressés par le partage de "recettes" de codes ou par le développement d'un package ?

@tvilmus
Copy link
Collaborator

tvilmus commented Jun 11, 2021

Bonjour,
Nous exposons un exemple très simple d'appel Hub'Eau avec R :

https://github.com/BRGM/hubeau/blob/master/code_examples/Trac%C3%A9%20d'une%20chronique%20pi%C3%A9zom%C3%A9trique%20avec%20R.ipynb

Au BRGM, nos hydrogéologues sont plusieurs à voir développé des routines R autour de Hub'Eau. Ces routines ne sont pour l'instant pas publiables en l'état mais nous travaillons sur la production de 2-3 exemples R partageables et utilisables par tous, que nous publierons sur la page https://github.com/BRGM/hubeau/tree/master/code_examples

@DDorch
Copy link
Contributor

DDorch commented Aug 4, 2021

J'ai commencé à écrire un package pour interroger les APIs Hub'eau. Il est composé d'une fonction générique d'interrogation valable quelque soit l'API et l'opération et une fonction par API x operation qui met en forme le résultat sous forme de data.frame.

Le dépôt est ici: https://gitlab.irstea.fr/in-wop/hubeau

Une site de documentation du package est automatiquement mis à jour ici: http://in-wop.g-eau.fr/hubeau/

Pour l'instant, je ne me suis attaqué qu'aux API "Prélèvements en eau" et "Indicateurs des services". Je peux prioriser l'implémentation d'autres API et opération en fonction de la demande. Si vous voulez participer activement au développement du package, je peux aussi envisager de migrer le dépôt sur le compte github de mon institut: https://github.com/inrae

@DDorch
Copy link
Contributor

DDorch commented Aug 6, 2021

Le développement du package avance vite... Malgré quelques bugs de l'API (voir #72, #74).

J'ai créé un miroir sur https://github.com/inrae/hubeau et la documentation est désormais hébergée sur https://inrae.github.io/hubeau/

La liste des API et opérations associées actuellement gérées par le package sont listées ici: https://inrae.github.io/hubeau/reference/hubeau.html

@tbesse-oeb
Copy link
Author

Bravo pour ce travail, je suis intéressé pour contribuer à ce package. N'hésitez pas à me dire ce qui vous serait utile (développement, tests ?). Je vais commencer par le tester de mon côté.

@DDorch
Copy link
Contributor

DDorch commented Aug 18, 2021

N'hésitez pas à me dire ce qui vous serait utile (développement, tests ?).

Merci! Dans un premier temps, ce serait bien d'avoir un retour sur "l'expérience utilisateur" pour savoir si la documentation est assez claire et si les messages d'erreur sont assez clairs pour qu'un utilisateur lambda puisse l'utiliser.

N'hésitez pas à poster des tickets sur le dépôt github du package.

@tvilmus tvilmus closed this as completed Jul 5, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants