From 060d12809a3030f554322fd8c83829e5e7d1f0ba Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?V=C3=ADctor=20Julio=20Rinc=C3=B3n-Parra?= Date: Tue, 16 Jul 2024 18:16:40 -0500 Subject: [PATCH] Create README.Rmd --- tutorials/user_manual/Run_pipeline/README.Rmd | 39 +++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 tutorials/user_manual/Run_pipeline/README.Rmd diff --git a/tutorials/user_manual/Run_pipeline/README.Rmd b/tutorials/user_manual/Run_pipeline/README.Rmd new file mode 100644 index 000000000..dd40a9c31 --- /dev/null +++ b/tutorials/user_manual/Run_pipeline/README.Rmd @@ -0,0 +1,39 @@ +--- +title: "Ejecución de pipeline" +author: + - name: "Rincon-Parra VJ" + email: "rincon-v@javeriana.edu.co" +affiliation: "Instituto de Investigación de Recursos Biológicos Alexander von Humboldt - IAvH" +output: + #md_document: + github_document: + md_extension: +gfm_auto_identifiers + preserve_yaml: true + toc: true + toc_depth: 6 +--- + +Las órdenes de servidor ejecutadas en Bon in a Box se organizan a partir de códigos individuales conocidos como `single script`. Estos códigos corresponden a bloques de código diseñados para realizar tareas específicas de principio a fin. Cada `single script` está diseñado para recibir ciertos parámetros y argumentos como entradas, procesar estas entradas mediante el código interno y luego generar salidas específicas basadas en el procesamiento realizado. + +Para ejecutar un `single script`, basta con oprimir el botón `Single script run` en la parte superior izquierda de la interfaz de Bon in a Box. Una vez allí, la interfaz mostrará una barra de selección donde están todos los scripts disponibles. + +![](README_figures/selectinput_scinglecsript.png) +Al seleccionar el script de interés en la barra, la interfaz mostrará en primera línea una descripción de lo que hace ese script, una línea titulada `Code`, una linea `See` con un enlace donde hay una descripción detallada del codigo seleccionado, y una linea con la ruta del archivo del código a ejecutar. + +Dicha ruta corresponde a la dirección interna del codigo dentro del repositorio clonado (ej. `scripts/Filter_data/Filter_data.R` corresponde a maquina local en `C:\Repositories\biab-2.0\scripts\Filter_data\Filter_data.R`). Asimismo, los `inputs` referentes a rutas de archivos deben hacer referencia a rutas internas del servidor, de lo contrario, los códigos no podrán cargar los archivos. Por esta razón, todos los archivos que se utilicen como `inputs` deben estar obligatoriamente dentro de la carpeta del repositorio para que el servidor pueda leerlos correctamente. Para mayor información sobre rutas relativas consulte el [tutorial para Cargar archivos en el servidor de Bon in a Box](../load_files_server). + +Con el script de interes seleccionado, en la parte central, la plataforma mostrará un cuadro `Input form` con campos de autollenado para las entradas `inputs` o argumentos requeridos para la ejecución del código. Estas entradas son las variables que le pasas a la función para que ésta las utilice en su ejecución y que son necesarias para que el codigo pueda realizar su tarea. Cada `input` tiene un nombre, un espacio para completarse, y una descripción de lo que debería especificar. Por defecto, estos códigos traen unas entradas predeterminadas, pero deben acomodarse según los objetivos del usuario. + +Una vez definidos los `inputs` , basta con oprimir `Run script` en la parte inferior del `Input form`. + +![](README_figures/inputform_scinglecsript.png) + +Una vez ejecutado, la interfaz mostrará los resultados como listas desplegables. Cada una con la descripción general del resultado y la ruta relativa dentro del folder del repositorio donde se almacenó. Dichas rutas pueden buscarse en la máquina o descargar una copia del resultado directamente haciendo click sobre el hipervínculo de la ruta. Sumado a esto, si se expande la lista haciendo click en el símbolo `+`, la interfaz mostrará una vista previa del resultado. + +![](README_figures/output_singlescript.png) + + + + + +