wheretowork

Tempat Bekerja: Aplikasi perencanaan konservasi sistematis yang interaktif

Aplikasi Where To Work adalah alat pendukung keputusan untuk membantu memprioritaskan upaya konservasi untuk Nature Conservancy of Canada. Ini menyediakan antarmuka interaktif untuk melakukan latihan perencanaan konservasi sistematis, dan menggunakan algoritma optimasi matematis untuk menghasilkan solusi.

Penggunaan

Aplikasi ini tersedia online. Harap dicatat bahwa Anda harus menggunakan Google Chrome agar dapat berfungsi.

Instalasi

Aplikasi ini tersedia sebagai layanan online yang disediakan oleh Nature Conservancy of Canada. Jika Anda perlu menjalankan aplikasi di komputer Anda sendiri, Anda dapat menjalankannya menggunakan lingkungan komputasi statistik R, Docker, atau Docker Compose.

Menggunakan R

Untuk menggunakan metode ini, Anda perlu menginstal lingkungan komputasi statistik R. Setelah selesai instalasi, Anda dapat menginstal aplikasi menggunakan kode R berikut:

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

Anda kemudian dapat menggunakan kode R berikut untuk memulai aplikasi dan membukanya di browser web Anda:

 wheretowork :: run_app()

Menggunakan Docker

Untuk menggunakan metode ini, Anda perlu menginstal Docker Engine (lihat petunjuk di sini). Setelah menyelesaikan langkah ini, Anda dapat menginstal aplikasi dari repositori DockerHub. Secara khusus, silakan gunakan perintah sistem berikut:

wheretowork :latest">

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

Anda kemudian dapat melihat aplikasinya dengan membuka tautan berikut di Google Chrome: http://localhost:3838. Setelah Anda selesai menggunakan aplikasi, Anda dapat menghentikannya menggunakan perintah sistem berikut. Perhatikan bahwa jika Anda tidak menghentikan aplikasi setelah selesai menggunakannya, aplikasi akan terus berjalan di latar belakang.

docker rm -f wheretowork

Menggunakan Docker Tulis

Untuk menggunakan metode ini, Anda perlu menginstal Docker Engine (lihat di sini untuk petunjuknya) dan Docker Compose (lihat di sini untuk petunjuknya). Setelah menginstal kedua program, Anda dapat menginstal aplikasi dengan mengkloning repositori ini dan kemudian menggunakan perintah sistem berikut:

docker-compose pull
docker-compose up -d

Anda kemudian dapat melihat aplikasinya dengan membuka tautan berikut di Google Chrome: http://localhost:3838. Setelah Anda selesai menggunakan aplikasi, Anda dapat menghentikannya menggunakan perintah sistem berikut. Perhatikan bahwa jika Anda tidak menghentikan aplikasi setelah selesai menggunakannya, aplikasi akan terus berjalan di latar belakang.

docker-compose down

Berkontribusi

Aplikasi ini adalah aplikasi web Shiny yang dikembangkan menggunakan lingkungan komputasi statistik R. Secara khusus, ia menggunakan kerangka golem . Ini berarti bahwa aplikasi tersebut secara efektif merupakan paket R yang berisi kode untuk mendefinisikan dan meluncurkan aplikasi (lihat di sini untuk lebih jelasnya). File kode R (terletak di direktori ./R ) disusun menggunakan konvensi penamaan berikut:

• app_* : Mendefinisikan aplikasi web:
  • app_config.R : Mengimpor pengaturan konfigurasi.
  • app_global.R : Menginisialisasi aplikasi. Ia melakukan hal yang mirip dengan file global.R di aplikasi Shiny pada umumnya.
  • app_server.R : Mendefinisikan logika sisi server (back-end) untuk aplikasi. Ia melakukan peran yang mirip dengan file server.R dalam aplikasi Shiny pada umumnya.
  • app_ui.R : Mendefinisikan antarmuka pengguna (font-end) untuk aplikasi. Ia melakukan peran yang mirip dengan file ui.R di aplikasi Shiny pada umumnya.
• server_* : Mendefinisikan komponen yang digunakan untuk menyusun logika sisi server untuk aplikasi.
• ui_ *: Mendefinisikan fungsi yang digunakan untuk membuat elemen HTML secara terprogram untuk front-end aplikasi.
• class_* : Mendefinisikan kelas pemrograman berorientasi objek yang digunakan di back-end aplikasi. Kelas-kelas ini diimplementasikan menggunakan sistem kelas R6.
• fct_* : Mendefinisikan fungsi R yang digunakan di back-end aplikasi. File-file ini berisi kode yang digunakan untuk melakukan analisis dan memanipulasi kelas.
• widget_* : Mendefinisikan widget khusus yang digunakan oleh aplikasi. Widget ini diimplementasikan menggunakan kerangka htmlwidgets .
• utils_* : Mendefinisikan fungsi utilitas R yang digunakan di back-end aplikasi.

Mendapatkan bantuan

Terima kasih telah memeriksa aplikasi ini. Jika Anda menemukan cacat perangkat lunak (misalnya aplikasi mogok, perilaku tidak terduga, atau kesalahan ejaan), jangan ragu untuk mempostingnya di pelacak masalah. Jika Anda memiliki pertanyaan tentang penggunaan aplikasi ini, silakan hubungi Dr. Richard Schuster ([email protected]) atau Prof. Joe Bennett ([email protected]).