Skip to content

I. Manual de Instalación Aplicación ReDs, Modo Desarrolador

Jump to bottom
Crisostomo Barajas edited this page Sep 6, 2023 · 9 revisions

Esta es una guía para instalar las dependencias necesarias para poder ejecutar la aplicación ReDs en modo desarrollador de forma correcta. Esta guía de instalación incluye el procedimiento de descarga del repositorio (git clone)

La siguiente guía incluye los siguientes pasos

  1. Instalación del ambiente Anaconda.
  2. Descarga del repositorio.
  3. Creación del entorno virtual en Anaconda, e instalación de dependencias.
  4. Instalación del ambiente integrado de desarrollo (IDE) PyCharm.
  5. Edición y ejecución del script launcher_window.py en PyCharm, con el entorno virtual creado.

Instalación paso a paso

La siguiente guía incluye la instalación del modo desarrollador de ReDs para los sistemas operativos Linux y Windows 10/11. De acuerdo al sistema operativo las instrucciones pueden variar, así:

1. Instalación de anaconda

  • Linux

Abrir una terminal Ctrl + Alt + T y seguir los siguientes pasos:

  1. Actualizar el administrador de paquetes local.
sudo apt-get update
  1. Descargar el archivo de instalación de anaconda
wget https://repo.anaconda.com/archive/Anaconda3-2021.05-Linux-x86_64.sh
  1. Instalar anaconda
bash Anaconda3-2021.05-Linux-x86_64.sh

Aquí se iniciará la configuración inicial en la terminal de la siguiente forma:

Welcome to Anaconda3 2021.05

In order to continue the installation process, please review the license
agreement.
Please, press ENTER to continue
>>>

Debe presionar ENTER, luego aceptar los términos escribiendo yes y presionar nuevamente Enter. Finalmente, se le dará una locación donde será instalado el programa, se recomienda dejar la ruta por defecto, entonces se presiona nuevamente Enter. Esto hará que finalmente anaconda sea instalada en el sistema operativo.

  • Windows

En este caso se puede instalar mediante la interfaz gráfica ingresando al sitio web de anaconda y descargando la aplicación para windows.

Una vez descargada, se de avanzar cliqueando en Next y aceptando los términos y condiciones.

Al llegar a la siguiente ventana es importante se se seleccione la primera opción, que genera la advertencia de abajo en rojo.

image

Finalmente, se presiona en Instalar y se espera hasta que anaconda queda instalado.

2. Descargar el contenido del repositorio

Para descargar (clonar) el contenido del repositorio es necesario establecer la ruta deseada donde se desea alojar la copia. Para este ejemplo alojaremos la copia del repositorio en la raiz de la unidad C:\. Para cambiar a la unidad C:\ usaremos la instrucción:

c:

Es posible que la consola se encuentre direccionada a alguna carpeta, como por ejemplo:

(base) C:\Windows\system32>

Use el comando cd.. tantas veces como sea necesario hasta que la consola apunte a la raíz de la unidad, así:

(base) C:\>

Una vez en la ruta deseada descargaremos el repositorio usando la instrucción

git clone https://github.com/carlosh93/9836_seismic_project.git

Esto creará una copia del repositorio en C:\9836_seismic_project

3. Creando un entorno virtual

  • En linux se debe abrir una nueva terminal Ctrl + Alt + T.
  • En windows se debe ingresar al menú de inicio y buscar Anaconda Prompt. Asegúrese de usar la opción "Abrir como administrador". Esta es una una terminal de Windows dedicada al entorno Anaconda.

Una vez abierta la terminal, use el comando cd.. tantas veces como sea necesario hasta que la consola apunte a la raíz de la unidad, así:

(base) C:\>

Ingrese al directorio donde se encuentra el repositorio, así:

cd 9836_seismic_project

Una vez se encuentre en el directorio del repositorio podemos crear el ambiente de manera automática usando las instrucciones contenidas en el archivo YML así, para windows o linux:

conda env create -f enviro_reds.yml
conda env create -f enviro_reds_linux.yml

Esto creará el ambiente 'reds' con todas las librerías necesarias para la correcta ejecución de ReDs. Como último paso se debe activar el ambiente reds con la instrucción

conda activate reds

Es necesario haber realizado la correcta creación del ambiente con las dependencias requeridas de acceder a los recursos principales para construir la aplicación ReDs.

4. Instalar PyCharm

PyCharm es un entorno de desarrollo integrado utilizado en programación informática, concretamente para el lenguaje de programación Python.

Esta aplicación se puede instalar de la misma manera en Linux o en Windows. Primero, se debe descargar la aplicación edición Community.

Una vez descargada, se abre el archivo y se debe avanzar presionando en Next y aceptando los términos y condiciones.

Cuando se llegué a la siguiente ventana, existen varias opciones a seleccionar, aquí se recomienda seleccionar la opción escogida en la ventana, las otras pueden ser opcionales.

image

Se avanza y finalmente se realiza la instalación presionando en Install.

4. Correr launcher_window.py en PyCharm con el entorno virtual creado

Ahora se debe abrir PyCharm y se observará el siguiente menú:

image

En este menú se debe abrir el proyecto que es el software de sísmica, siguiendo el orden:

  1. Seleccionar Open o Abrir.
  2. Seleccionar el folder donde se encuentran alojados todos los archivos del software.
  3. Seleccionar OK.

Esto permitirá abrir el software de sísmica. Ahora se debe agregar el entorno al proyecto cargado en PyCharm, para ello, se ingresa a File -> Settings.

image

Esto abrirá un nuevo menú donde se debe seleccionar a la izquierda, el botón donde aparece el nombre del proyecto abierto Project: 9836_seismic_project, y luego a la derecha, se presiona Python Interpreter.

image

Aquí se observar que no hay ningún interprete (el cual es el entorno virtual) asignado al proyecto que se acaba de abrir, por lo que seleccionamos en Add... para buscarlo y agregarlo.

image

Realizando nuevamente un seguimiento para cargar el entorno virtual, se hace lo siguiente:

  1. Seleccionar Conda Environment.
  2. Seleccionar Existing environment.
  3. Seleccionar el Interpreter (generalmente aparece por defecto al haber instalado previamente el entorno virtual con Anaconda Prompt.
  4. Presionar OK.

image

Si no conoce la ruta del ambiente reds, entonces puede averiguarla con la siguiente instrucción:

conda info --envs

Luego presionamos OK a todas las ventanas abiertas hasta volver a la interfaz principal de PyCharm y con esto el entorno virtual estaría listo, ahora falta ejecutar el archivo que permitirá ejecutar el software. Para ello, se siguen los siguientes pasos:

  1. Seleccionar Add Configuration....
  2. En el botón (+) selecciona Python.

ocho

Aquí se siguen los siguientes pasos:

  1. Seleccionar el icono que permitirá escoger el archivo a ejecutar.
  2. Seleccionar el archivo a ejecutar.
  3. Presionar OK.
  4. Presionar OK nuevamente.

Con esto el archivo estará listo para ser ejecutado.

Actualización: El archivo .py a ejecutar es run_ReDS.py, y se encuentra en la raiz del repositorio

image

Finalmente, presionamos en el botón de ejecución que se encuentra en la parte superior derecha de la interfaz de PyCharm y la aplicación será ejecutada.

Clone this wiki locally