Importing PV nomenclature: How can the nomenclature of the plant tracker be customised in the WebApp?

This tool can be used to improve fault traceability on solar assets, enabling more effective planning and execution of corrective interventions on site.

The goal is to import the project’s nomenclature for each tracker. This will be done using the data extracted from a KML file, which contains the nomenclature text associated with each coordinate.

Hints: You will most likely want to check the engineering files (DWG, PVsyst or the engineering design tool for your solar asset), as these contain the tracker nomenclature. These will be your source for creating the kmz/kml files for import. (Kmz files are simply “zip” files containing Kml files.)

Please note that you should use the nomenclature at tracker level and not string level.

Step 1: Select the “.PDF / .KML” overlay button on the top right corner as shown in figure 1.

Figure 1. Selecting the “.PDF / .KML” overlay button

Step 2: Brows your file from your source.

Figure 2. Example: Source from your Desktop

Step 3: Activate the button “Import Nomenclature”. You will see the kml file information displayed on your Volateq WebApp, as seen on Figure 3.

Figure 3. Nomenclature Import feature Setting Options - Activate the button “Import Nomenclature”

Step 4: Find the kml path. For this, you might want to “extract” the .kml file content as a text to search for the corresponding path.

The "dotted" path to the Tracker's name. In the example file below, this would correspond to:

Document.Folder.Placemark.ExtendedData .Data[name="Tracker name"].value

                        <?xml version="1.0" ... ?>
<kml xmlns="http://www.opengis....">
 <Document>
  <Folder>
  ...
   <Placemark id="0">
   ...
    <ExtendedData>
     <Data name="Tracker name">
      <value>T01-S41-T982-02</value>
      ...

A ".kmz" file is a zipped (compressed) ".kml" file. To open a KMZ file, extract it first, and then open the extracted KML file with a text editor.

Step 5: Paste the path you found on Step 4 and proceed to adjust the settings prior final import. Once you are done, click on PREVIEW.

Figure 4. Example of settings - THIS ARE NOT DEFAULT Settings - You might want to test the settings by clicking on Preview first

Settings:

Search strategy

distance_to_center: The distance between the center point of the KML tracker and the center point of the DT tracker.
distance_to_nearest_point: The shortest distance from the KML tracker’s center point to the nearest edge of the DT tracker.

Maximum distance:

No maximum distance set: Each KML tracker is mapped to exactly one DT tracker—the nearest one.
Maximum distance set: Each KML tracker is mapped to all DT trackers within the specified distance in meters.

Offset (N/S)

Offsets the latitude of each KML tracker’s center point by the given number of meters. Use positive values for north and negative for south.

Offset (E/W)

Offsets the longitude of each KML tracker’s center point by the given number of meters. Use positive values for east and negative for west.

Step 6: Verify tracker selection. If you did the correct setting on Step 5, all trackers might appear on green.

Check against a technical drawing, if the Nomenclature corresponds to technical project
Check if all trackers are green. if not all are green, go back to step 4.

Figure 5. Preview of nomenclature import

Step 7: If you are satisfied with your PREVIEW verification, click on RENAME #### TRACKERS and confirm by clicking on your pop-up on OK

Figure 6. Confirm Nomenclature import