=======================
Proyectos en Pathfinder
=======================

Acceso
======

Para entrar en la aplicación, deberá introducir el nombre y contraseña de su usuario en la ventana de login.

.. image:: ./images/login.jpg
    :align: center
    :width: 40%

Si ha activado la :ref:`Autenticación de Dos Factores <tfa_login>`, un paso adicional requerirá que introduzca el código de 6 dígitos generado en este momento por la aplicación móvil de autenticación que se haya registrado:

.. image:: ./images/tfa04.jpg 
  :align: center
  :width: 40%

.. note::
   Según su :doc:`perfil de usuario <userFunctions>`, tendrá diferentes permisos en Pathfinder.


.. _automatic_logout:

Cierre de sesión automático
===========================

Para mantener la seguridad de Pahfinder, se realiza un cierre de sesión automático cuando el usuario ha estado inactivo durante un largo período (30 minutos). Esto previene accesos inapropiados si el usuario ha dejado la sesión abierta.

Al volver a Pathfinder tras un largo período de inactividad, se verá brevemente una notificación de que el token de autorización ha expirado y entonces la aplicación mostrará la página de login.

.. image:: ./images/token_expired.jpg 
  :align: center
  :width: 40%

|

.. image:: ./images/token_expired_login.jpg 
  :align: center
  :width: 40%

.. note::
   *Inactividad* significa que el usuario no realiza ninguna operación de lectura/escritura en Pathfinder, tales como abrir un proyecto, añadir datos, cambiar la visibilidad de un resultado o capa de datos, cambiar cualquier propiedad, ejecutar procesos... Simplemente seleccionar la pestaña de Pathfinder o navegar por el mapa no cuentan como actividad.

   Contacte con Gilytics si desea cambiar el período de inactividad por defecto.

.. note::
   Si observa un bucle de refresco en la página de login tras el cierre automático de sesión, cierre la pestaña del navegador web y acceda a Pathfinder desde una nueva pestaña.

Abrir un proyecto
=================

Una vez tenga acceso a Pathfinder verá la lista de proyectos existentes en su cuenta. En cuentas de prueba gratuita, encontrará aquí los proyectos con los que puede probar la aplicación. En otros casos, esta lista puede estar inicialmente vacía.

.. image:: ./images/landing.jpg
    :align: center
    :width: 90%

Cada organización puede elegir entre el **sistema de permisos por defecto** basado en roles (en este caso todos los usuarios de la compañía tienen acceso a todos los proyectos) o un sistema de **permisos por proyecto**. En este segundo caso, los administradores de la organización deciden :ref:`qué usuarios tienen acceso a cada proyecto <per_project_access>`.

.. note::
   Los proyectos que no son accesibles al usuario no serán visibles en la lista de proyectos.

Para abrir un proyecto existente, simplemente pulse sobre el recuadro con su nombre.


.. _create_project:

Crear un nuevo proyecto
=======================

.. note::
   Los :doc:`usuarios <userFunctions>` no administradores no pueden crear nuevos proyectos. Solicite a su administrador que lo haga.

Para esta sección, puede seguir el primero de nuestros `videotutoriales <https://youtube.com/playlist?list=PLrVlZ2pkufZFeFMOWmDbO2NjOof-woZcV>`_:

.. raw:: html

   <div style="text-align:center">
   <iframe width="560" height="315" src="https://www.youtube.com/embed/_cW-JCM-qKs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
   </div>

Para crear un proyecto, use el botón de *Nuevo Proyecto* en la página o el comando del mismo nombre en el menú superior de *Proyectos*. En ambos casos se abrirá el wizard de Nuevo Proyecto.

.. image:: ./images/newProject.jpg
    :align: center
    :width: 90%

Propiedades básicas
*******************

En el primer paso del wizard, los usuarios deben especificar las siguientes propiedades:

* El **nombre** del proyecto.

* Una **descripción** opcional, que se mostrará en el diálogo de :ref:`Información del Proyecto <project_information>`.

* Las **categorías** iniciales del proyecto. Cada proyecto debe tener al menos una cateogría. Una categoría ("General") se habrá añadido ya por defecto, pero el usuario puede crear más escribiendo sus nombres y pulsando sobre el botón *Añadir categoría*. 

  Se usan las :ref:`categorias <organize_data>` para agrupar capas con temas o atributos similares (por ejemplo, áreas protegidas, infraestructuras existenes, medio físico, datos sociales, etc.). Más adelante es posible crear nuevas categorías y mover las capas de una a otra.

Una vez se han introducido todas las propiedades, pulse el botón *Siguiente* para ir al próximo paso.

.. _project_resolution:

Área, resolución y puntos del proyecto
**************************************

En este paso el usuario define el área del proyecto, la región donde se realizarán las simulaciones. Puede especificarse de dos formas:

* Dibujando el área a mano sobre el mapa<.

* Importando el área desde un archivo.

.. image:: ./images/projectArea.jpg
    :align: center
    :width: 75%


Dibujar el área del proyecto
----------------------------

Si desea dibujar el área del proyecto, pulse sobre el rectánculo *Dibujar Área*. La vista de mapa aparecerá.

Pulse sobre el botón de *Dibujar Área* y seleccione qué tipo de geometría desea utilizar (Círculo, Rectángulo o Polígono). Para áreas de tipo Círculo o Rectángulo, necesitará pulsar primero, luego arrastrar el ratón y pulsar una segunda vez. Para el área de tipo Polígono, pulse en múltiples lugares para definir el área y entonces haga un doble click para insertar el último punto y cerrar el polígono.

También es necesario en este punto definir la *resolución del proyecto*. Esta resolución será la utilizada para construir el mapa de resistencia y los corredores, y afectará a la precisión de los puntos utilizados en la ruta óptima. Dependiendo del tamaño del área del proyecto, puede existir un :ref:`límite para la resolución mínima <max_area>`.

.. image:: ./images/projectAreaDraw.jpg
    :align: center
    :width: 90%

.. note::
   *Es posible que vea un mensaje de advertencia mencionando que el tamaño del área es demasiado grande para la resolución especificada. También verá un mensaje bajo el valor de la resolución. En este caso, dibuje un área más pequeña o incremente el tamaño de la resolución en metros hasta que el mensaje de advertencia desaparezca.*

.. image:: ./images/resolutionError.jpg
    :align: center
    :width: 30%


Importar el área del proyecto
-----------------------------

Si el área del proyecto ya está definida en un archivo que contiene *coordenadas geográficas* en longitud y latitud (sistema de coordenadas WGS84 o EPSG:4326), puede importar este archivo pulsando en el recuadro de *Importar Área* o en el botón de Importar junto al botón de *Dibujar Área*:

.. image:: ./images/import.jpg
    :align: center
    :width: 10%

En ambos casos, aparecerá un diálogo donde podrá arrastras el archivo desde un gestor de archivos, o pulsar para encontrarlo en su computadora. Los formatos aceptados son Geojson, KML y Shapefile (comprimida como .zip).

.. image:: ./images/projectAreaImport.jpg
    :align: center
    :width: 50%


.. _project_points: 

Puntos del proyecto
-------------------

Tras definir el área del proyecto, puede especificar también los puntos Inicio y Final para el cálculo de rutas. Estos puntos también pueden asignarse o cambiarse más tarde para el proyecto utilizando la opción de menú *Proyecto/Editar Puntos de Proyecto*.

Los puntos Inicio y Final pueden también :ref:`cambiarse para cada escenario <scenario_points>`.

Como el área de proyecto, los puntos Inicio y Final pueden especificarse manualmente sobre el mapa, o importarse desde un archivo que *contenga un solo punto en coordenadas WGS84*. Puede escoger estas opciones pulsando sobre el botón con su nombre, o el botón de importación a la nube.

.. image:: ./images/startPoint.jpg
    :align: center
    :width: 20%

Después de que los puntos se dibujan o importan, aparecen como pins en el mapa.

.. image:: ./images/projectAreaDone.jpg
    :align: center
    :width: 75%

Finalmente, pulse en *Guardar y Salir* para terminar la edición y regresar al wizard.


.. _initial_layers:

Añadir capas iniciales
----------------------

En la siguiente página del wizard, el usuario puede añadir capas al proyecto a partir de los **Datos base**, conjuntos de datos compartidos por todos los usuarios de Pathfinder (como las capas de OpenStreetMap) o por todos los miembros de la compañía.

Si su usuario tiene permisos de administración, podrá añadir más adelante nuevos datos base y también crear nuevas capas en el proyecto una vez se ha creado, así que este paso es opcional.

Si desea añadir algunas capas iniciales ahora, vea cómo :ref:`definirlas <layer_settings>`.

.. image:: ./images/addLayers.jpg
    :align: center
    :width: 90%

También es posible copiar la lista de capas, anillos y estructura de categorías desde otro proyecto, utilizando el siguiente botón:

.. image:: ./images/CopyBuffers.jpg
  :align: center
  :width: 25%

Tras pulsar este botón, el usuario puede escoger un proyecto existente para copiar su lista de capas, anillos y categorías:

.. image:: ./images/CopyBuffers2.jpg
  :align: center
  :width: 50%

Aparecerá entonces un diálogo para confirmar la operación:

.. image:: ./images/CopyBuffers3.jpg
  :align: center
  :width: 60%

Una vez el proceso se ha completado, un diálogo muestra la lista de las categorías y capas que se han copiado:

.. image:: ./images/CopyProjectResults.jpg
  :align: center
  :width: 60%

Tras seleccionar algunas capas (o ninguna), pulse el botón de *Procesar*. El :doc:`Visor de Proyecto <projectViewer>` aparecerá. 

.. image:: ./images/projectViewer.jpg
    :align: center
    :width: 90%

*Los datos pueden requerir un tiempo para ser procesados*. Puede seguir el progreso de la preparación de los datos en el :doc:`Log de Procesos <processLog>`.

A continuación, puede :doc:`explorar <projectViewer>` o :doc:`añadir más datos <addData>` a su proyecto Pathfinder.


.. _default_rasters:

Capas raster por defecto
========================

Cuando se crea un proyecto, un **modelo digital del terreno (DEM/MDT) y un mapa de pendientes (slope)** se crean automáticamente a partir de :ref:`fuentes de datos abiertas <dem_source>` y se añaden al proyecto como capas por defecto.

El mapa de pendientes por defecto proporciona el valor de la pendiente en *grados*.

.. image:: ./images/raster_defaults.jpg
    :align: center
    :width: 60%

Estas capas utilizan datos públicos que proporcionan una resolution de 30m de elevación para todo el globo. Si lo desea, puede :doc:`cargar <addData>` sus propios datos ráster para el MDT y la pendiente del proyecto.


.. _project_information:

Información del proyecto
========================

La información interna del proyecto se puede ver desde el menú Proyecto:

.. image:: ./images/projectDescriptionMenu.jpg
  :align: center
  :width: 25%

El diálogo de Información nuestra:

* El *propietario* del proyecto: el usuario que creó el proyecto (también puede ser asignado por un administrador).
* La *fecha de creación* del proyecto.
* El número de *capas* y *escenarios* usado por el proyecto. Sus capas son las mismas para todos los usuarios, pero los escenarios pueden variar.
* *Anchura, altura, resolución y área* del ráster del proyecto. Estos parámetros dan información sobre la extensión, tamaño y escala del proyecto. Cuando más grande sea la anchura y altura del ráster, más tiempo tomarán los procesos de las capas y resultados. 
* El nombre e ID del *systema de coordenadas* interno del proyecto. Todos los datos de Pathfinder son internamente proyectados a un `sistema de coordenadas UTM <https://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system>`_. Su zona UTM y `código EPSG <https://epsg.org>`_ se muestran aquí. Cuando se exportan los caminos del proyecto, una de las copias utiliza este sistema de coordenadas.
* La *miniatura* del proyecto, que se muestra también en la página de Proyectos de Pathfinder.
* Si se ha escrito, la *description* del proyecto aparecerá bajo la miniatura.

.. image:: ./images/projectDescription.jpg
  :align: center
  :width: 90%

Para cambiar la miniatura por defecto, que muestra un mapa, mueva el ratón sobre la imagen y pulse el botón para seleccionar una nueva de su disco local.

.. image:: ./images/uploadThumbnail.jpg
  :align: center
  :width: 40%


.. _delete_project:

Borrar un proyecto
==================

Algunas licencias de Pathfinder pueden tener limitado el número de proyectos, or el espacio de almacenamiento. Los proyectos alojados en la nube puede borrarse mediante la opción de menú *Delete project*:

.. image:: ./images/projectMenu.jpg
    :align: center
    :width: 25%

Se mostará una advertencia antes de borrar el proyecto.

.. image:: ./images/projectDeleteWarning.jpg
    :align: center
    :width: 75%

Tenga en cuenta que si borra el proyecto, los resultados de sus simulaciones también serán eliminados. Es aconsejable :doc:`exportar los resultados del proyecto <export>` antes de borrarlo.

.. note::
   Los :doc:`usuarios <userFunctions>` no administradores no pueden borrar proyectos. Solicite a su administrador que lo haga.


.. include:: footer.rst