.. _04_sensor_mapping:


Sensor Mapping
===================

The next step is the *sensor mapping*. It makes sure that SunPeek can understand the measurement data.
More specifically, it maps the datapoint names inside the measurement data to the sensor-channels that SunPeek uses
to compute virtual sensors and perform the Power Check method.


General idea
---------------------

As shown in the following picture, the main idea is to map the sensors (included in the measurement data) to the SunPeek channels.
In the depicted case (which matches the demo plant), we have a setup with only one collector array and the heat measurement in the primary circuit - using a flow sensor and flow and return temperatures.
(see also ISO 24194 and Guide to ISO 24194 for more information on required sensors).

.. figure:: ../_static/tutorial_04_mapping_idea.png


The mapping is done by selecting the correct sensor name from the dropdown (wich is generated based on the measurement data)
This is how the sensor mapping looks like

.. figure:: ../_static/tutorial_04_mapping_example.png


Note that the screen is split into two sections:
 1. **components** are shown on the left side (blue background).
    Each component corresponds to one part of the plant.
    There is always one component for the *plant level*
    and one or more components for the *array level* (depending on how many collectors you added in the Array configuration)
 2. **sensor slots** that are available for each component are shown on the right side (white background).
    Note that different types of components can have different slots (but all components of the same type have the same slots).




Note that some of the sensor channels are **optional**:
 - In some cases assigning sensors might allow you to compute *virtual sensors* - for example, thermal power based on flow and temperatures.
 - In other cases, additional sensors might lead to a increased accuracy of the Power Check results - for example, if wind speed is measured.
 - In other cases, additional sensor might lead to different insights - for example, if thermal power is available for collectors, the expected vs estimated ration can be checked also on collector level.


.. tip::

    Optional channels can be hidden by clicking on the HIDE OPTIONAL SLOTS button on the upper right. See Figure below

.. figure:: ../_static/tutorial_04_mapping_hide.png


Mapping: Plant sensors
---------------------

The *plant* part allows to map sensors that are related to the overall plant.
For example, this includes ambient information such as ambient temperature,
but also an overall *measured* thermal power to perform the Power Check method.

To assign sensor names from the measurement data to the channels, simply click on a input field and select the correct sensor (you can also filter by typing in the name).
If you are unsure about the meaning of the sensor slot, please check out the tooltip by hovering over the information symbol at the outer right of each slot.


In the case of the demo plant:
 - **Ambient temperature**: te_amb
 - **Inlet temperature**: te_in
 - **Outlet temperature**: te_out
 - **Volume flow**: vf
 - Note that the required thermal power is computed based on flow and return temperature and volume flow.


.. figure:: ../_static/tutorial_04_mapping_plant.png



Mapping: Array sensors
---------------------

The *array* part allows to map sensors that are related to the collector fields, as defined in the steps before.
For example, this includes information on the irradiance on the specific collectors, the temperature of the collectors, and (optionally) the power output.

To get to this section, you can either click on the NEXT button on the lower right of the screen, or click on the corresponding section on the left side of the page.

In the case of the demo plant:
 - **Inlet temperature**: te_in
 - **Outlet temperature**: te_out
 - **Global radiation input**: rd_gT
 - Note that we only used the absolutely required channels in this demo. However, the demo plant data also contains additional sensors which could be mapped as well to increase the accuracy of the results and enables other formulas of the ISO 24194.


.. figure:: ../_static/tutorial_04_mapping_array.png



Confirm
---------------------

If all required slots are assigned for all components (as shown by different status indicators) you can continue by clicking on the NEXT button.

.. figure:: ../_static/tutorial_04_final.png