.. raw:: html

    <style> .red {color:red} </style>

.. role:: red

============
Añadir Datos
============

Para optimizar la localización de las infraestructuras, Pathfinder necesita información espacial sobre la conveniencia de los diferentes lugares. Esta información geoespacial se toma de multiples conjuntos de datos en forma *vectorial* (*features*) y en formato *raster* (*imágenes*).

Eche un vistazo a nuestros :ref:`pasos recomendados para preparar datos <data_preparation>`.

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

.. _base_dataset_project_layers:

Datos Base y Capas de Proyecto
==============================

Pathfinder trabaja con datos en dos niveles:

* **Datos Base**: Estos conjuntos de datos (datasets) contienen los datos originales que serán usados en diferentes proyectos. Por ejemplo, podemos tener unos datos de "áreas protegidas" o un ráster de cobertura para todo el país, que queremos utilizar para diferentes áreas de estudio (diferentes proyectos).

  Los datos base pueden ser:

  * *Datos públicos*: Gilytics ha configurado estos datos para todos los usuarios de Pathfinder. Un ejemplo son los datos de `OpenStreetMap (OSM) <https://www.openstreetmap.org/>`_ para todo el mundo.

  * *Datos privados*: Son añadidos o conectados desde servicios remotos por los usuarios de Pathfinder y están disponibles para todos los miembros de la misma organización.

* **Capas de proyecto**: Los datos base se utilizan en un proyecto en la forma de una *capa*, donde son recortados con el *área* del proyecto. 

Por lo tanto, la información solo se puede añadir a un proyecto creando capas a partir de los conjuntos de datos base, sean públicos o privados.

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


.. _add_base_data:

Añadir Datos
============

En esta sección puede seguir uno 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?start=158" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
   </div>

Para añadir datos base privados para su uso en proyectos de su organización, utilice ĺa opción *Proyecto/Datos Base* en el menú superior. 

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

El diálogo de *Importar Datos* se abrirá:

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

Desde el :ref:`perfil de usuario <base_layers_profile>` pueden verse los datos base ya disponibles y también añadir nuevos datos.

.. _add_files:

Añadir Archivos
---------------

Por defecto, la pestaña **Archivos** está seleccionada en el diálogo para *Importar Datos*. Los formatos aceptados son:

* Datos vectoriales: shapefiles (todos sus archivos comprimidos en un solo .zip), ESRI Geodatabase (.zip), GPKG, GeoJSON y KML.

* Datos ráster: GeoTIFF files (.tif, .tiff, .geotiff).

Se pueden arrastrar y soltar sobre este diálogo los archivos a importar, o seleccionarlos. Es posible cargar varios archivos a la vez. La lista de archivos debe aparecer correctamente bajo del área de carga antes de que puedan ser subidos. Si un formato no está soportado, se mostrará un mensaje de alerta y el archivo no aparecerá en la lista.

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

Tras pulsar en el botón de *Subir*, los nuevos archivos serán subidos y almacenados en la base de datos de Pathfinder. Podrá seguir el progreso de esta tarea en el :doc:`Log de Procesos <processLog>`:

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

.. _add_WFS:

Añadir Servicios WFS
--------------------

..
  USE http://gw-geoportal-test.igac.gov.co/geoservices/agrologia/wfs in Colombia

Otra opción para añadir datos vectoriales a Pathfinder es usar un `Servicio Web de Features (WFS) <https://en.wikipedia.org/wiki/Web_Feature_Service>`_. Algunas organizaciones publican información en esta forma.

Seleccione la pestaña **WFS** en el diálogo de *Importar Datos* e introduzca la dirección Web del servicio que desea acceder. Entonces pulse el botón de *Listar Capas* para obtener una lista de los datos disponibles:

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

Puede escribir un texto para buscar las capas disponibles por nombre:

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

Pulse sobre la lista de capas para seleccionar qué datos crear a partir del servicio WFS:

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

Tras pulsar el botón de *Subir*, deberá verse una confirmación de que se creó el conjunto de datos base:

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

Cuando termine de añadir datos, pulse en **Cancelar** para cerrar el diálogo.


.. _layer_add: 

Añadir Capas al Proyecto
========================

Después de :doc:`crear o abrir un proyecto <project>`, es posible añadir capas en el :doc:`visor de proyectos <projectViewer>`.

.. note::
   *Los datos base no son visible en el proyecto hasta que no se añaden como una o más capas.*

Para añadir una nueva capa, utilice la opción *Proyecto/Nueva Capa*:

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

También puede usar el icono de *Nueva Capa* en la cabecera CAPAS del panel izquierdo:

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

En ambos casos, el diálogo de *Añadir Nueva Capa* se hará visible:

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

Si se ha importado un ráster con varias bandas, el usuario puede añadirlas como capas separadas al proyecto.

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

|

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


.. _layer_settings: 

Configurar Capas
----------------

El diálogo de *Añadir Nueva Capa* mostrará todos los datos base (públicos y privados) disponibles para añadir como capas al proyecto. Puede usar los botones de confirmación (checkboxes) para seleccionar uno o más de estos datos y crear nuevas capas.

.. note::
   Solo serán visibles los datos base cuya extensión intersecte el área del proyecto. Tenga en cuenta que si ya ha sido usado en otra capa del proyecto, aparecerá en la pestaña "Incluidas".

   Aunque la extensión de los datos base incluya el área del proyecto, es posible que no contenga ningún dato en este área.

Use la opción de *Buscar Capas* para encontrar con rapidez los datos que le interesan. Por ejemplo, busque "cables" para encontrar capas de cables entre los datos base.

.. image:: ./images/bufferSearchLayers.jpg
       :align: center
       :width: 80%

La configuración de las capas incluye las siguientes opciones (para ráster layers solo se require la Categoría):

* Para datos vectoriales, asignar un **filtro** que especifica los objetos que se añadirán a la capa, basándose en los valores de atributos o campos. Si no se especifica un filtro, se utilizarán todos los objetos de los datos base dentro del área del proyecto.

  Primero, pulse el botón de Definir en la columna Filtro. Entonces, en el diálogo para definir el filtro, seleccione el atributo que contiene la propiedad que le interesa, así como el operador (=, <, ...) y el valor para comparar. Es posible combinar varios filtros, como en el siguiente ejemplo, mediante el botón Añadir Filtro:

    .. image:: ./images/class_filter.jpg
       :align: center
       :width: 80%

  Repitiendo este proceso sobre los mismos datos base es fácil crear capas que utilizan diferentes objetos a partir de los datos originales.

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

  |

* Seleccionar el nombre de la **categoría** (grupo al que pertenecerá la capa) en la lista de la columna *Categoría*. 

  Las :ref:`categorías <organize_data>` son importantes para definir el peso relativo de diferentes grupos de capas para la opmización de los escenarios. Tanto el nombre como los miembros de la categoría pueden cambiarse más adelante.

* Seleccionar la opción de **buffering**: un anillo *único o múltiple*.

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

  Los *anillos de buffer* se utilizan para extender eĺ área de influencia de los datos originales.

  * En el modo de *anillo único*, la posición o frontera de los datos originales se extienden una cierta distancia, la *anchura del anillo*:

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

    |

  * En el modo de *anillos múltiples*, los datos originales se extienden con varios anillos a diferentes distancias, de manera que podamos asignar :ref:`diferentes resistencias <ring_resistances>` o costes a cada una de estas áreas. Normalmente, el primer anillo tendrá una resistencia más alta, y los más distantes tendrán resistencias progresivamente más bajas.

    El usuario  especifica la *anchura* de cada anillo, y sus distancias son sumadas (p. ej. si las anchuras son 100, 200, 300, las distancias al original serán 100, 300, 600...):

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

    Por defecto, pueden definirse hasta cuatro anillos. Pulse el botón *Añadir Anillo* si desea definir más:

    .. image:: ./images/bufferAddRing.jpg 
       :align: center
       :width: 15%


Si dispone de un proyecto que ya contiene la configuración correcta de las capas, puede copiarlas al proyecto actual, pulsando el botón *Copiar Configuración de Buffers de un Proyecto*:

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

Cuando el diálogo de selección sea visible, escoja el proyecto del que quiere copiar la configuración:

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

Una vez realizada la configuración de las capas, pulse el botón de *Procesar Capas* en la parte inferior derecha.

Puede seguir el progreso del procesado de capas en el :doc:`Log de Procesos <processLog>`:

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

Cuando se termine el proceso, las nuevas capas serán visibles en el panel izquierdo de Pathfinder.


.. _layer_preprocess: 

Cambiar la Configuración de Capas
=================================

La configuración de las capas puede cambiarse en cualquier momento mientras se trabaja en el proyecto. Es común hacerlo para cambiar el filtro de la capa, o el número de anillos o sus anchuras.

.. note::
   *Solo el dueño del proyecto (el usuario que lo creó) y los administradores de la compañía pueden cambiar la configuración de las capas*.

Los cambios en la configuración de las capas requieren que sean procesadas de nuevo a partir de los datos base. Para acceder a las propiedades de configuración en cualquier momento, use el menú *Project/Preprocesamiento de Capas*:

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

También puede realizar el acceso a estos datos desde el icono correspondiente en el panel de *Capas* del lado izquierdo:

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

La ventana que muestra la tabla con las capas del proyecto es muy similar al diálogo de Añadir Nueva Capa que hemos visto ya. Tras cambiar las propiedades de una o más capas, se seleccionarán automáticamente, de forma que cuando el usuario pulse el botón *Procesar Selección* button, estas capas serán reprocesadas:

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

Compruebe el log de procesos para ver cuándo termina el procesamiento de las capas y puede verificar visualmente sus resultados.


.. include:: footer.rst