Edit a meter

Modifying a meter mainly allows you to configure the way in which data can be displayed and calculated in dashboards. It is also possible to manually modify the raw data contained in the meter, and to add comments and documents.

To make any changes to a meter, go to the Meters area and click on the meter you wish to modify. The Meter details pane will appear.

Configuring a meter

All the changes you can make to configure a meter can be found in the "Information" tab.

 

Defining a name

The Name field is a free text field. By default, the name is identical to the Source ID.

To change the meter name, click on the current name, then edit the text.

It is possible to customise the meter icon. By default, the icon is . To change it, click on the "Icon" button (the button may look different, depending on the changes that have already taken place). A box appears, allowing you to select the icon of your choice. To reset the icon, click "Delete".

To change the colour of the icon, click on the "Colour" button and select the colour from the predefined colours or by entering the hexadecimal code. To reset the colour, click "Clear".

Once the name and icon have been changed, click "Save" at the bottom right. The changes will apply and the icon will appear next to the meter name.

Difference between the Name and the Source ID

The Name and the Source ID are two different fields. The Name is purely indicative and has the function of making the meters easily identifiable by the user. The Source ID is used during the data integration phase in the Energiency platform, and is used to distinguish between different data streams and to recognise these streams in the event that new data is regularly integrated. Unlike the Name, the Source ID is not modifiable from the platform as this could have consequences for the transmission and integration of data into the platform. If you wish to change the Source ID, please contact your Energy Manager.

Add a description

The Description field is a free text area. By default, the field is empty.

To add a description, click on the text box then write the text.

Finally click on "Save"bottom right.

Choose a unit

There is a predefined list of units that can be assigned to a meter. To choose a unit, click on the Unit field to bring up the drop-down list.

Use the mouse wheel to scroll down the list, or write directly to search for a unit.

Once you have found the unit, click on it to select it.

Finally click "Save" at the bottom right.

NB: if a unit cannot be found in the list, this means that it does not exist on the platform. To create a new unit, you must have administrator rights.

Defining the data format

The data format corresponds to the nature of the meter data, and is used to tell the platform how to process this data.

There are three data formats:

• Numeric : the data are numbers, with or without decimals.
• Categorical : the data are character strings, text.
• Index : the data are index readings. For display and calculations, the platform will automatically use the difference values between two consecutive data points. In the event of a decrease in value between two consecutive data points, the meter is considered to have been reset to zero.

To set the data format, click on the Data format field and then click on the format corresponding to the meter data.

Finally click "Save" at the bottom right.

Defining the aggregation function

The aggregation function defines how the data is aggregated. For example, when the meter contains data with a frequency (also known as a "time step") of 1 point per minute and we want to have a measurement interval of 1 hour (see next section), we need to define whether we want the sum of the 60 points, or their average, or their maximum, etc.

The possible aggregation functions are as follows:

• Average: the aggregated value is equal to the average of the points. This function is generally used for power, flow, temperature, etc.
• Sum: the aggregated value is equal to the sum of the points. This function is generally used for energy, volume, quantity, etc.
• Median: the aggregate value is equal to the median value of the points.
• Minimum: the aggregate value is equal to the minimum value of the points.
• Maximum: the aggregate value is equal to the maximum value of points.
• Count: the aggregate value is equal to the number of points.

NB: the Aggregation function field is not available when the Data format is Categorical or Index. Aggregation calculations do not apply to text values. As for index meters, they are necessarily aggregated by summing.

To define the faggregation function, click on the Aggregation function field and then click on the desired function.

Finally click "Save" at the bottom right.

Define measurement interval

The measurement interval is used to define the meter's time step, in other words the time frequency of the data points displayed by the meter. The smallest possible interval is 10 seconds, the largest is 1 year.

This measurement interval may be different from the raw data interval. For example it is possible to choose a measurement interval of 1 hour, even if the meter contains raw data with a point every 10 minutes. In this case, the meter will display one value per hour, and this value will be the aggregation of the 10-minute points (value calculated according to the Aggregation function presented in the previous section).

Many orders of magnitude are possible for the measurement interval: Years, Months, Days, Hours, Minutes, Seconds and Discontinuous data. For each order of magnitude, it is possible to choose the number from a predefined list. Discontinuous datacorresponds to a variable interval: the meter will display a value for each raw data encountered.

To change the measurement interval, in the Measurement interval field first click on the order of magnitude to display the list, and click on the desired order of magnitude. Then click this time on the number to display the predefined list, if necessary uuse the mouse wheel to scroll down the list, and click on the desired number.

To finish, click "Save" at bottom right.

NB: the predefined lists of numbers offer the most frequent intervals (for example Days range from 1 to 30, as it is rare to view data with an interval of 34 days). To date, it is not possible to create custom intervals.

Edit data correction settings

Additional parameters can be used to dynamically process meter data. To access these parameters, click on the Data correction field.

Time shifting

• Shift: allows you to temporally shift the data displayed by the meter. For example, with a shift of 4 hours, the actual data from 04:00 will be displayed at 08:00.

Without Shift With Shift = 4 hours

To add a shift, the procedure is the same as for Measurement interval (see previous section). Cfirst click on the Shift field to display the list of orders of magnitude, then click on the desired order of magnitude. Then click this time on the number to display the predefined list, if necessary uuse the mouse wheel to scroll down the list, and click on the number you want.

• Offset: allows you to temporally offset the data aggregation time steps. For example, with an offset of 4 hours, when aggregating data at time step 1 day, it is the data between 04:00 and 04:00 the next day that will be aggregated. Unlike Shift, the original dates of the points are displayed as they are. Note that when a graph displays data from several meters, the offset of the first meter is used for the aggregation shift.

Without Offset With Offset = 4 hours

To add an Offset, click on the Offset field. A box appears allowing you to define the Offset value in terms of Days, Hours and Minutes. To do this, click on the numbers to display the drop-down lists and select the desired values.

You can also choose the Offset sign by clicking on the icon to the left of the frame, the sign then becomes .

Gap filling

For index meters, a gap in the data can be filled by interpolating between the start and end values of the gap.

Example :

 

Filtering

Filtering automatically ignores values outside the high and low limits.

• Lower limit: allows you to define a threshold below which, raw data values will be ignored. On index meters, the limit applies to the difference between two successive values (readings), on aggregated data (not raw data).
• Upper limit: allows you to define a threshold above which, raw data values will be ignored. On index meters, the limit applies to the difference between two successive values (readings), on aggregated data (not raw data).

Transformation function

Data transformation enables the coefficients of an affine function to be applied to all meter data.

This can be useful, for example, for converting received pulses into units of energy, or for correcting a meter offset.

Example: for a data X with a value of 100, by applying the coefficients "a = 10" and "b = 2000", the value displayed will then be 10*X + 2000 = 3000.

Once the settings have been defined, click "Save" at bottom right.

Add and delete a comment

Comments allow you to note down or exchange with other users any important information or new events related to a meter.

To do this, go to the "Comments" tab.

To add a new comment, click in the text box at the bottom of the page and write your comment. You can bold, italicise or underline the text using the corresponding icons. To publish your comment, click "Send".

To delete a comment, click the button to the right of the comment, then click "Delete".

A message then appears asking for confirmation: click "Delete item".

Edit raw data

The "Raw data" tab allows you to view the data as it has been integrated into the Energiency platform. The points and their dates are not affected in any way by the meter configuration. However, it is possible to modify this data directly from the platform.

Add data

To add a data point, click on the "Add a point" at the top right.

The following window appears:

Click on the Data date field to open a calendar.

To set a date, click on the corresponding day. At the top of each calendar, you can click on the period displayed to change the order of magnitude (month/year/decade) and use the horizontal arrows to change the period.

To define the time, at the bottom of each calendar you can click on the "Select time" button. Then click on the vertical arrows to change the hour, minutes and seconds, or click on the numbers to display a predefined list allowing you to quickly select the hour, minutes and seconds.

Once you have set the date and time, click outside the calendar to make it disappear.

Then click on the Quantity field (which designates the value of the point), and write the number corresponding to the value of the point you want to create. Then click "Add".

The dot now appears among the other data (boxed in red below).

Modify data

To modify a datum, you need to change the value of the point. To do this, hover your mouse cursor over the value in the Quantity column so that the symbol appears. Click on the symbol.

The value becomes editable. Write the new value then click outside the text box to validate.

To finish, click "Save" at bottom right. The new value appears with the status Active (it can be modified again), while the old value remains visible but with the status Deleted (it can no longer be modified or retrieved).

NB: data points whose status is Deleted appear indicatively in order to keep a history of changes, but they are inactive and are no longer used in the display and calculations of meter data.

Delete data

Warning: any deletion of a data point is permanent. However, simply add a new point with the same date and value to replace the deleted point.

To delete a point, click on the box to the left of the date. It is also possible to select several points, by clicking each time on their box .

A "Delete selected points" button appears, click it.

A message then appears asking for confirmation: click "Delete item".

The item thus deleted remains visible but with the status Deleted.

NB: data points whose status is Deleted appear indicatively in order to keep a history of changes, but they are inactive and are no longer used in the display and calculations of meter data.

Add/modify/delete a document

In the "Documents" tab, it is possible to add documents relating to the meter (calibration certificate, etc).

Add a document

To add a document, click on "Send a document" and select the desired document, or drag and drop the document. The document appears and can now be viewed by all users with access to the meter.

NB: the maximum accepted file size is 10 MB.

The document will also appear in the Documents area of the platform.

Renaming a document

It is possible to change the name of the document. To do this, click on the button, then on "Rename".

A Rename a document window appears. Click on the Name field and edit the text. When finished, click "Save".

The document name is then updated.

Deleting a document

To delete a document, click on the button, then on "Delete". Please note: there is no message to ask for confirmation, the document is immediately deleted.

The document will also be deleted from the platform's Documents area.