wheretowork

Dónde trabajar: aplicación interactiva de planificación de la conservación sistemática

La aplicación Dónde trabajar es una herramienta de apoyo a la toma de decisiones para ayudar a priorizar los esfuerzos de conservación de Nature Conservancy de Canadá. Proporciona una interfaz interactiva para realizar ejercicios sistemáticos de planificación de la conservación y utiliza algoritmos de optimización matemática para generar soluciones.

Uso

La solicitud está disponible en línea. Tenga en cuenta que debe utilizar Google Chrome para que funcione.

Instalación

La solicitud está disponible como un servicio en línea proporcionado por Nature Conservancy de Canadá. Si necesita ejecutar la aplicación en su propia computadora, puede ejecutarla utilizando el entorno informático estadístico R, Docker o Docker Compose.

Usando R

Para utilizar este método, deberá instalar el entorno informático estadístico R. Después de completar la instalación, puede instalar la aplicación usando el siguiente código R:

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

Luego puede usar el siguiente código R para iniciar la aplicación y abrirla en su navegador web:

 wheretowork :: run_app()

Usando ventana acoplable

Para utilizar este método, deberá instalar Docker Engine (consulte aquí para obtener instrucciones). Después de completar este paso, puede instalar la aplicación desde el repositorio de DockerHub. Específicamente, utilice el siguiente comando del sistema:

wheretowork :latest">

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

Luego podrá ver la aplicación abriendo el siguiente enlace en Google Chrome: http://localhost:3838. Una vez que haya terminado de usar la aplicación, puede finalizarla usando el siguiente comando del sistema. Tenga en cuenta que si no finaliza la aplicación una vez que haya terminado de usarla, continuará ejecutándose en segundo plano.

docker rm -f wheretowork

Usando Docker Compose

Para utilizar este método, deberá instalar Docker Engine (consulte aquí para obtener instrucciones) y Docker Compose (consulte aquí para obtener instrucciones). Después de instalar ambos programas, puede instalar la aplicación clonando este repositorio y luego usando los siguientes comandos del sistema:

docker-compose pull
docker-compose up -d

Luego podrá ver la aplicación abriendo el siguiente enlace en Google Chrome: http://localhost:3838. Una vez que haya terminado de usar la aplicación, puede finalizarla usando el siguiente comando del sistema. Tenga en cuenta que si no finaliza la aplicación una vez que haya terminado de usarla, continuará ejecutándose en segundo plano.

docker-compose down

Contribuyendo

La aplicación es una aplicación web Shiny desarrollada utilizando el entorno informático estadístico R. Específicamente, utiliza el marco golem . Esto significa que la aplicación es efectivamente un paquete R que contiene código para definir e iniciar la aplicación (consulte aquí para obtener más detalles). Los archivos de código R (ubicados en el directorio ./R ) se organizan utilizando las siguientes convenciones de nomenclatura:

• app_* : Define la aplicación web:
  • app_config.R : Importa ajustes de configuración.
  • app_global.R : Inicializa la aplicación. Realiza un proceso similar al archivo global.R en aplicaciones Shiny típicas.
  • app_server.R : define la lógica del lado del servidor (back-end) para la aplicación. Realiza una función similar al archivo server.R en aplicaciones Shiny típicas.
  • app_ui.R : define la interfaz de usuario (fuente final) para la aplicación. Realiza una función similar al archivo ui.R en aplicaciones Shiny típicas.
• server_* : define los componentes utilizados para ensamblar la lógica del lado del servidor para la aplicación.
• ui_ *: Define funciones utilizadas para crear mediante programación elementos HTML para el front-end de la aplicación.
• class_* : Define las clases de programación orientada a objetos utilizadas en el back-end de la aplicación. Estas clases se implementan utilizando el sistema de clases R6.
• fct_* : define las funciones de R utilizadas en el back-end de la aplicación. Estos archivos contienen código utilizado para realizar análisis y manipular las clases.
• widget_* : define los widgets personalizados utilizados por la aplicación. Estos widgets se implementan utilizando el marco htmlwidgets .
• utils_* : define las funciones de utilidad R utilizadas en el back-end de la aplicación.

Obteniendo ayuda

Gracias por revisar esta aplicación. Si encuentra algún defecto de software (por ejemplo, fallas de la aplicación, comportamiento inesperado o errores ortográficos), no dude en publicarlo en el rastreador de problemas. Si tiene alguna pregunta sobre el uso de esta aplicación, comuníquese con el Dr. Richard Schuster ([email protected]) o el Prof. Joe Bennett ([email protected]).