wheretowork

Wo arbeiten: Interaktive Anwendung zur systematischen Naturschutzplanung

Die „Where To Work “-Anwendung ist ein Entscheidungshilfetool, das dabei hilft, Naturschutzbemühungen für die Nature Conservancy of Canada zu priorisieren. Es bietet eine interaktive Schnittstelle zur Durchführung systematischer Naturschutzplanungsübungen und nutzt mathematische Optimierungsalgorithmen zur Generierung von Lösungen.

Verwendung

Der Antrag ist online verfügbar. Bitte beachten Sie, dass Sie Google Chrome verwenden müssen, damit es funktioniert.

Installation

Der Antrag ist als Online-Dienst der Nature Conservancy of Canada verfügbar. Wenn Sie die Anwendung auf Ihrem eigenen Computer ausführen müssen, können Sie sie mit der statistischen Rechenumgebung R, Docker oder Docker Compose ausführen.

Mit R

Um diese Methode verwenden zu können, müssen Sie die statistische Rechenumgebung R installieren. Nach Abschluss der Installation können Sie die Anwendung mit dem folgenden R-Code installieren:

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

Anschließend können Sie die Anwendung mit folgendem R-Code starten und in Ihrem Webbrowser öffnen:

 wheretowork :: run_app()

Mit Docker

Um diese Methode verwenden zu können, müssen Sie die Docker Engine installieren (Anweisungen finden Sie hier). Nachdem Sie diesen Schritt abgeschlossen haben, können Sie die Anwendung aus dem DockerHub-Repository installieren. Konkret verwenden Sie bitte den folgenden Systembefehl:

wheretowork :latest">

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

Sie können die Anwendung dann anzeigen, indem Sie den folgenden Link in Google Chrome öffnen: http://localhost:3838. Nachdem Sie die Anwendung nicht mehr verwendet haben, können Sie sie mit dem folgenden Systembefehl beenden. Beachten Sie, dass die Anwendung im Hintergrund weiter ausgeführt wird, wenn Sie sie nicht beenden, nachdem Sie sie nicht mehr verwendet haben.

docker rm -f wheretowork

Verwenden von Docker Compose

Um diese Methode verwenden zu können, müssen Sie Docker Engine (Anweisungen finden Sie hier) und Docker Compose (Anweisungen finden Sie hier) installieren. Nach der Installation beider Programme können Sie die Anwendung installieren, indem Sie dieses Repository klonen und dann die folgenden Systembefehle verwenden:

docker-compose pull
docker-compose up -d

Sie können die Anwendung dann anzeigen, indem Sie den folgenden Link in Google Chrome öffnen: http://localhost:3838. Nachdem Sie die Anwendung nicht mehr verwendet haben, können Sie sie mit dem folgenden Systembefehl beenden. Beachten Sie, dass die Anwendung im Hintergrund weiter ausgeführt wird, wenn Sie sie nicht beenden, nachdem Sie sie nicht mehr verwendet haben.

docker-compose down

Mitwirken

Bei der Anwendung handelt es sich um eine Shiny-Webanwendung, die mithilfe der statistischen Rechenumgebung R entwickelt wurde. Insbesondere wird das golem -Framework verwendet. Dies bedeutet, dass es sich bei der Anwendung praktisch um ein R-Paket handelt, das Code zum Definieren und Starten der Anwendung enthält (weitere Einzelheiten finden Sie hier). Die R-Codedateien (im Verzeichnis ./R ) sind nach den folgenden Namenskonventionen organisiert:

• app_* : Definiert die Webanwendung:
  • app_config.R : Importiert Konfigurationseinstellungen.
  • app_global.R : Initialisiert die Anwendung. Es verhält sich ähnlich wie die global.R Datei in typischen Shiny-Anwendungen.
  • app_server.R : Definiert die (Back-End-)serverseitige Logik für die Anwendung. Sie erfüllt in typischen Shiny-Anwendungen eine ähnliche Rolle wie die Datei server.R .
  • app_ui.R : Definiert die (Font-End-)Benutzeroberfläche für die Anwendung. In typischen Shiny-Anwendungen erfüllt sie eine ähnliche Rolle wie die Datei ui.R
• server_* : Definiert Komponenten, die zum Zusammenstellen der serverseitigen Logik für die Anwendung verwendet werden.
• ui_ *: Definiert Funktionen, die zum programmgesteuerten Erstellen von HTML-Elementen für das Front-End der Anwendung verwendet werden.
• class_* : Definiert objektorientierte Programmierklassen, die im Back-End der Anwendung verwendet werden. Diese Klassen werden mithilfe des R6-Klassensystems implementiert.
• fct_* : Definiert R-Funktionen, die im Back-End der Anwendung verwendet werden. Diese Dateien enthalten Code, der zur Durchführung von Analysen und zur Bearbeitung der Klassen verwendet wird.
• widget_* : Definiert benutzerdefinierte Widgets, die von der Anwendung verwendet werden. Diese Widgets werden mithilfe des htmlwidgets Frameworks implementiert.
• utils_* : Definiert Dienstprogramm-R-Funktionen, die im Back-End der Anwendung verwendet werden.

Hilfe bekommen

Vielen Dank, dass Sie sich diese Anwendung angesehen haben. Wenn Sie auf Softwarefehler stoßen (z. B. Anwendungsabstürze, unerwartetes Verhalten oder Rechtschreibfehler), können Sie diese gerne im Issue-Tracker veröffentlichen. Wenn Sie Fragen zur Verwendung dieser Anwendung haben, wenden Sie sich bitte an Dr. Richard Schuster ([email protected]) oder Prof. Joe Bennett ([email protected]).