.. raw:: html

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

.. role:: red


===========================
What's New in Version 3.4.2
===========================

In addition to other improvements and bug fixes, these are the main new features of the latest Pathfinder release:

* :ref:`Layer data download <layer_data_3_4_2>`

* :ref:`Geoprocess results in Geopackage format <geopkg_3_4_2>`

* :ref:`Improved setup from existing project <project_cpy_3_4_2>`

* :ref:`Automated project thumbnails <thumbs_3_4_2>`

* :ref:`Raster classification geoprocess <raster_class_3_4_2>`

* :ref:`Corridor merge geoprocess <corridor_merge_3_4_2>`

* :ref:`Information security enhancements <security_3_4_2>`
 
Previous releases:

* :doc:`What's new in Pathfinder 3.4.1 <whatsNew3.4.1>`
* :doc:`What's new in Pathfinder 3.4 <whatsNew3.4>`
* :doc:`What's new in Pathfinder 3.3 <whatsNew3.3>`
* :doc:`What's new in Pathfinder 3.2 <whatsNew3.2>`
* :doc:`What's new in Pathfinder 3.1 <whatsNew3.1>`


.. _layer_data_3_4_2:

Layer data download
===================

In addition to :ref:`downloading a base dataset <download_source_data>` from the admin page (only available for admin users), any user can now :ref:`download the data of a specific project layer <export_layers>` in Pathfinder. This is usually more convenient, because it only includes the data within the project area.

This command can be found in the layer's side panel.

.. image:: ./images/LayerDownload.jpg
  :align: center

When clicked, it will download a zipped **Geopackage file** containing:

* For vector layers, a "original" and a "buffered" version of the data.

* For raster layers, a single raster with the data in the project area.

.. note::
   The download button will only be active for layers processed after this feature was introduced. To download previously existing layers, open the Project / Layer Preprocessing panel, select the layer, reprocess it and then reload the project. The download button should then be enabled.


.. _geopkg_3_4_2:

Geoprocess results in Geopackage format
=======================================

Now the georeferenced :ref:`results of Pathfinder geoprocesses <geoprocess_results>` are provided in two formats: GeoJSON and GeoPackage, for maximum interoperability with GIS software.

Results in both formats can be added as layers to the Pathfinder project or downloaded to the user's computer.

.. image:: ./images/geoprocessOutputDlg.jpg
  :align: center


.. _project_cpy_3_4_2:

Improved setup from existing project
====================================

When a new project is created, users can bring layers and their rings from an existing project. Now also the **category structure** of the existing project will be copied over to the new one.

In the project creation wizard, the :ref:`page to add new layers <initial_layers>` contains a button to copy the layer settings from another project:

.. image:: ./images/CopyBuffers.jpg
  :align: center

After clicking this button, the user can choose an existing project to copy layers, rings and categories from:

.. image:: ./images/CopyBuffers2.jpg
  :align: center

An information dialog will appear then to confirm:

.. image:: ./images/CopyBuffers3.jpg
  :align: center

After the process is completed, a dialog will show the list of the copied categories and layers:

.. image:: ./images/CopyProjectResults.jpg
  :align: center


.. _thumbs_3_4_2:

Automated project thumbnails
============================

In this new version, the projects get a default thumbnail created from the MapBox image for its area.

.. image:: ./images/landing.jpg
  :align: center

Admin users can :ref:`change this default thumbnail <thumbnail>` in the Projects section of the admin page.


.. _raster_class_3_4_2:

Raster classification geoprocess
================================

Two new :doc:`geoprocesses <runGeoprocesses>` have been added to Pathfinder with this release. 

The first one allows users to divide a raster area in different classes depending on the pixel value, outputing a list of datasets, one for each class, which can then be exported or added to the project.

.. image:: ./images/RasterClass1.jpg
  :align: center

The user can select:

* The raster to classify. It can be a resistance map (marked as [RM]), corridor ([COR]), project raster like the DEM or Slope, or a layer raster.

* The number of classes to create.

* The method to divide the raster area.

  - *Per value* divides the raster in classes so that each class covers the same value interval (i.e. if raster values range from 100 to 200 and we select 4 classes, each class will cover 1/4 of the range: class 1 will cover values from 100 to 124, class 2 from 125 to 149, etc.)

  - *Per area* divides the raster in N classes so that each class covers approximately 1/N of the total area.


There are three main uses for this process:

Calculate suitability zones from a Resistance Map
-------------------------------------------------

In an optimal siting analysis (for instance, finding best locations for photovoltaic plants, wind farms or electric substations) a resistance map is calculated, reflecting the overall suitability based on the project layers and their resistances.

A convenient way to present the siting process results is to extract a number of classes from the resistance map raster, representing more to less suitable areas.

The following image shows the original resistance map on the left, the result of the classification per value in five classes (center) and the classification per area (right).

.. image:: ./images/RasterClass2.jpg
  :align: center


Divide a corridor map into classes
----------------------------------

When a corridor map is calculated, users can select its width in terms of value or percentile. We can then further analyze and share the corridor by dividing it into vectorized classes near or farther from the optimal value.

The following image shows the original corridor on top, and the result of classifying it into three classes and adding them as new layers in the project (below).

.. image:: ./images/CorridorClass.jpg
  :align: center


Extract classes from a project or layer raster
----------------------------------------------

The geoprocess can also be used to classify one of the default project rasters (DEM or Slope), or any other raster added as a layer in the project.

In the image below, we can see the original slope map (top) and the result of classifying it into three classes based on the value.

.. image:: ./images/SlopeClass.jpg
  :align: center


.. _corridor_merge_3_4_2:

Corridor merge geoprocess
=========================

The second new geoprocess in 3.4.2 is implemented to merge multiple corridor maps and extract a portion of the merged corridor based on value.

Multiple scenario corridores can be selected to be merged, and a minimum value percentage (usually 0, to include the corridor centers) and a maximum value percentage can be selected.

.. image:: ./images/CorridorMerge1.jpg
  :align: center

The following image shows an example with two corridors (top and center). Their 50% lower ranges are merged into a single polygonal area, shown in yellow color in the bottom part.

.. image:: ./images/CorridorMerge.jpg
  :align: center


.. _security_3_4_2:

Information security enhancements
=================================

.. image:: ./images/ISO.png
  :align: center

In the process of obtaining the ISO 27001 Certification on Information Systems Security, we have implemented some improvements to increase the :doc:`security <dataSecurity>` of the Pathfinder system:

* `Cloud database encryption <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.Encryption.html>`_

* Automated threat detection with `AWS GuardDuty <https://aws.amazon.com/guardduty/>`_.

* Continuous automated vulnerability testing to detect potential weaknesses in third party and own components.

In addition, the :ref:`automatic session logout <automatic_logout>` after an inactivity period, introduced in previous versions, can now be customized by company. Contact Gilytics if you need to change this setting.


.. include:: footer.rst