wheretowork

Où travailler : Application interactive de planification systématique de la conservation

L'application Où travailler est un outil d'aide à la décision pour aider à prioriser les efforts de conservation de Conservation de la nature Canada. Il fournit une interface interactive pour mener des exercices systématiques de planification de la conservation et utilise des algorithmes d'optimisation mathématique pour générer des solutions.

Usage

L'application est disponible en ligne. Veuillez noter que vous devez utiliser Google Chrome pour que cela fonctionne.

Installation

L'application est disponible sous forme de service en ligne fourni par Conservation de la nature Canada. Si vous devez exécuter l'application sur votre propre ordinateur, vous pouvez l'exécuter à l'aide de l'environnement informatique statistique R, Docker ou Docker Compose.

Utiliser R

Pour utiliser cette méthode, vous devrez installer l’environnement de calcul statistique R. Une fois l'installation terminée, vous pouvez installer l'application à l'aide du code R suivant :

 if ( ! require( remotes )) install.packages( " remotes " )
remotes :: install_github( " NCC-CNC/ wheretowork " )

Vous pouvez ensuite utiliser le code R suivant pour démarrer l'application et l'ouvrir dans votre navigateur Web :

 wheretowork :: run_app()

Utiliser Docker

Pour utiliser cette méthode, vous devrez installer Docker Engine (voir ici pour les instructions). Après avoir terminé cette étape, vous pouvez installer l'application à partir du référentiel DockerHub. Plus précisément, veuillez utiliser la commande système suivante :

wheretowork :latest">

docker run -dp 3838:3838 --name wheretowork -it naturecons/ wheretowork :latest

Vous pouvez ensuite visualiser l'application en ouvrant le lien suivant dans Google Chrome : http://localhost:3838. Une fois que vous avez fini d'utiliser l'application, vous pouvez y mettre fin à l'aide de la commande système suivante. Notez que si vous ne fermez pas l'application une fois que vous avez fini de l'utiliser, elle continuera à s'exécuter en arrière-plan.

docker rm -f wheretowork

Utiliser Docker Composer

Pour utiliser cette méthode, vous devrez installer Docker Engine (voir ici pour les instructions) et Docker Compose (voir ici pour les instructions). Après avoir installé les deux programmes, vous pouvez installer l'application en clonant ce référentiel puis en utilisant les commandes système suivantes :

docker-compose pull
docker-compose up -d

Vous pouvez ensuite visualiser l'application en ouvrant le lien suivant dans Google Chrome : http://localhost:3838. Une fois que vous avez fini d'utiliser l'application, vous pouvez y mettre fin à l'aide de la commande système suivante. Notez que si vous ne fermez pas l'application une fois que vous avez fini de l'utiliser, elle continuera à s'exécuter en arrière-plan.

docker-compose down

Contribuer

L'application est une application Web Shiny développée à l'aide de l'environnement informatique statistique R. Plus précisément, il utilise le framework golem . Cela signifie que l'application est en fait un package R qui contient du code pour définir et lancer l'application (voir ici pour plus de détails). Les fichiers de code R (situés dans le répertoire ./R ) sont organisés selon les conventions de dénomination suivantes :

• app_* : Définit l'application web :
  • app_config.R : importe les paramètres de configuration.
  • app_global.R : Initialise l'application. Il effectue un travail similaire au fichier global.R dans les applications Shiny typiques.
  • app_server.R : définit la logique côté serveur (back-end) pour l'application. Il joue un rôle similaire au fichier server.R dans les applications Shiny typiques.
  • app_ui.R : définit l'interface utilisateur (fin de police) de l'application. Il joue un rôle similaire au fichier ui.R dans les applications Shiny typiques.
• server_* : définit les composants utilisés pour assembler la logique côté serveur pour l'application.
• ui_ * : définit les fonctions utilisées pour créer par programme des éléments HTML pour le front-end de l'application.
• class_* : Définit les classes de programmation orientée objet utilisées dans le back-end de l'application. Ces classes sont implémentées à l'aide du système de classes R6.
• fct_* : Définit les fonctions R utilisées dans le back-end de l'application. Ces fichiers contiennent du code utilisé pour effectuer des analyses et manipuler les classes.
• widget_* : Définit les widgets personnalisés utilisés par l'application. Ces widgets sont implémentés à l'aide du framework htmlwidgets .
• utils_* : Définit les fonctions utilitaires R utilisées dans le back-end de l'application.

Obtenir de l'aide

Merci d'avoir consulté cette application. Si vous rencontrez des défauts logiciels (par exemple, des plantages d'application, un comportement inattendu ou des fautes d'orthographe), n'hésitez pas à les publier sur le suivi des problèmes. Si vous avez des questions sur l'utilisation de cette application, veuillez contacter le Dr Richard Schuster ([email protected]) ou le professeur Joe Bennett ([email protected]).