FieldTwin Vision

FieldTwin Vision is an integration in the FieldTwin platform that allows account administrators to upload and process the data captured by the remotely operated vehicles (ROVs) used for the critical inspection and maintenance of underwater assets, encompassing pipelines, wells, and other equipment.

The processed data can be accessed through the FieldTwin Designer part of the integration by any user of the account. It significantly enhances their ability to monitor, analyze, and make informed decisions.

Release Notes

The latest release notes for version 2.0 released on September 4th, 2025.

Installation

In FieldTwin Admin, go to Account Settings, then Integrations, and click Create New Tab. Set the following values:

Name:                           FieldTwin Vision
URL:                            https://ft-vision-frontenduser.TBD/
Account Settings URL:           https://ft-vision-frontendadmin.TBD/
Use GET verb:                   yes
Do not pass arguments in URL:   yes
Tab Display Position:           Module Panel (default)

Configuration

In FieldTwin Admin, go to Account Settings, then Integrations, FieldTwin Vision (or the name you entered in the installation above) and click Settings.

FieldTwin Vision Admin

In FieldTwin Vision Admin you will set up survey groups, manage video uploads and more.

Survey Groups tree view

This is where the account administrator can create new survey media groups and subgroups or edit and delete existing ones.

FieldTwin Vision Settings

The FieldTwin Vision settings are mainly used to save different column mapping options for the coordinates and comments files.
These are needed in order to successfully process the CSV files with coordinates or the Excel files with comments (available only through the FieldTwin Designer part of the integration).
Also, it is possible to set up the Azure Blob Storage information if survey files need to be uploaded from there.

To access the settings, click on the "FieldTwin Vision Settings" button.

Coordinates files column mapping and formats:

Comments files column mapping:

To add a new column mapping, click on the desired property field and input the new mapping.
To delete an existing mapping, either click on the X next to each mapping or just backspace with the keyboard.
Exiting the field saves the changes automatically.

Azure Blob Storage settings:

The SAS access level has two options:

• Single container - limits the access to only a single container
• Storage account (multi-container) - lists all containers within the connected storage account.

A Blob SAS URL or SAS token and storage account name are required in order to allow file sharing to the FieldTwin Vision integration.

If Single container access has been selected, an additional Container name field will appear under the Properties section, where the name of the container available for access should be entered

ROV Settings:

Adjusting the value for the Auto-linking distance field determines how close an asset must be to the ROV path to be eligible for auto-linking.

The ROV path color field changes the default path color used for the newly created subgroups.

Survey Groups tree view actions

The tree view actions can be seen here:

• add new main group.
• create survey groups in bulk.
• expand the main groups list when it is collapsed or collapse it when expanded.
• sort the groups alphabetically (A-Z) or (Z-A).

The search bar allows you to find any group or subgroup by its name.

At the bottom is a button for hiding the tree.

• shrink the horizontal size of the tree.

can be used to expand the tree back to its original size.

When adding a new main group, a popup will appear.

Next to every group, there is a hamburger menu, where you can:

• For the main groups - add a new subgroup, rename it or delete it.
  
  
• For the subgroups - move it to another main group, rename it or delete it.
  
  

Upon selecting a main group, the options for adding a new subgroup, renaming and deleting can also be accessed by this menu above the subgroups list.

• add new subgroup.
• rename the main group.
• delete the main group.

On the right side, there are options for sorting and searching the main group in order to find a specific subgroup.
The default sorting is by the subgroup names (A-Z), but you can change it to one of the following options:

• Newest First
• Name (A-Z)
• Name (Z-A)
• Start date
• End date
• Vendor

You can search by any of those parameters in the search bar.

Create a single new subgroup

To create a single new subgroup, select the "Add New Subgroup" option from the hamburger menu or click on the icon.
A new page will load to the right side of the tree view.

If you wish, you can change the group settings by entering or changing:

• A new subgroup name
  
• Start date
  
• End date
  
• Path Z-axis offset
  
• ROV path color
  
• Vendor
  
• Details
  
• Show in child projects
  

Note: It is necessary to link the subgroup to a project from the "Projects" dropdown, so it can appear in the FieldTwin Designer part of the integration.

After entering all the information about the new subgroup, click the "Save" button to save the changes.

Uploading survey files

For uploading survey files, there are three options:

1. Add files from Azure

If the Azure Blob Storage settings are properly configured and a valid SAS token is provided, you can click on the "Add files from Azure" button and a file explorer will open.

Select the needed survey files by clicking on the checkbox next to them and press the "Import selected files" button.

All files can be selected at once using the checkbox at the top.
Files added from an external source are uploaded, except for the videos. Their URL references are saved in the 'Media Files' tab.

2. Add video from URL

Click on the "Add video from URL" button and this popup will appear.

Enter a name and a valid URL for the video and click "Confirm"

The video file will appear in the "Media Files" tab.

3. Manual upload

You can either click on the file upload zone or drag and drop files to it.

After choosing the desired files, click on the "Upload All" button.

The files will be transferred to the "Uploaded files" section, where you can see their type, name, when they were uploaded, process them, download or delete them.

To make the uploaded video and CSV files usable by the FieldTwin Designer part of the integration, you need to process the videos and generate a survey path.

Initiate the video processing by clicking the "Process" button next to each video file.

A survey path can also be generated either from a CSV file or a Video file.

When either one of the buttons is clicked, a popup will appear. After a file is selected, clicking on Generate path will start the creation of the survey path.

When using the CSV file option, if the CSV file contains dates, but the format is missing from the FieldTwin Vision Settings, an informative popup will appear.

If the CSV file dates are valid, but they differ from the ones in the subgroup settings, a popup will appear, asking to update them automatically.

If the CSV file has columns that are required for the coordinates generation, but are missing from FieldTwin Vision Settings, this popup is displayed, asking for manual link.

After this, these missing columns will be automatically saved in the settings and the popup will not be shown again.

All processed files will appear in the "Media Files" tab, where you can see their type, name, updated date, and download or delete them.

The first processed video will automatically be set as a cover, meaning that frames from it will be used for the thumbnail of the subgroup.
If you have more than one processed video, a new option would appear, allowing you to set any video as the cover.

• set video as cover.
• delete file.
• download file.

Create survey groups in bulk

To create multiple survey groups at once, click on the button from the top of the tree view.

This will open a new dialog:

• navigates to the next page.
• closes the dialog and resets all settings and selections.

The group settings will be applied to all survey groups that will be created.

Selecting the Override with dates from the CSV files checkbox will automatically take the date from the survey path CSV file and pre-fill the Start date and End date fields.

In order for the newly created Survey groups to be visualized in the FieldTwin Designer part of the integration, they need to be linked to one or more projects. If all of them are going to be visualized in the same project(s), it is necessary to have those projects selected in the "Projects" dropdown. The created survey groups can also be linked after they have been created from their respective settings options.

Selecting the Send me an email after the bulk upload process is completed checkbox will send a notification to the email address that is set for your current user once the bulk process is fully complete.

Once all settings are configured, clicking the button will visualize the following page:

• navigates to the previous page.

Based on the SAS access level selection from the Azure Blob Storage section in FieldTwin Vision Settings page, either all folders or blob containers will be listed in the table.

Navigating through the folders will update the path at the top of the page:

Clicking on the name of the folder will navigate back to it. Additionally clicking the icon will navigate to the outermost (root) folder.

In addition the following buttons can be seen:

• navigates to the folder that was previously opened.
• navigates to the parent folder.

The field on the far right shows the number of currently selected folders from the Azure storage:

Clicking the button will clear all selected folders

Any number of folders can be selected. This happens by clicking the checkbox on the left of the folder name:

Once the desired folders are selected, clicking the button will visualize the following page:

All folders containing media files that are nested within the selected ones will become subgroups and the name of their parent folder will be used as a main group. They can be seen from the tree-view section on the left.

Next to every group, there is a hamburger menu.

Clicking on opens it and shows the options to rename or delete the corresponding group

Selecting the Rename action will open a new dialog from where the name of the group can be changed

In the main table visible on the right, if the selected subgroup contains only one video per channel, all files will be listed directly.

The file used for generating the ROV survey path can be changed by clicking the button visible on the end of each row:

Note: Generating the path from the video files can take longer, and depends on the length of the video.

If a subgroup contains multiple videos from the same channel, it is treated as a Chunked subgroup. In this case, file types are grouped by channel into separate accordion sections.

This action requires, the channel number in the file names to be represented by an underscore (_) or hyphen (-), followed by ch and a single digit (e.g., _ch1 or -ch1).

Additionally the indicator will appear at the top right.

The videos and coordinate files will be merged together, resulting in one long ROV survey path visualized in the FieldTwin Designer as well as a single video (per channel).

Each accordion can be collapsed using the button visible on the left of its name.

Clicking on will close the dialog and start the Survey group creation process.

A status indicator will appear at the top of the tree-view on the main page in yellow.

Note: The integration should not be closed until the survey groups have been created and the progress indicator turns green.

Once the indicator has turned green the survey group processing starts, and it is safe to close the integration.

Move a subgroup to another main group

To move a subgroup to another main group, select the "Move to..." option and choose the main group, where you want to move the current subgroup to from the dropdown input.
Click "Confirm" to complete the transfer.

Rename a group

To rename a group, select the "Rename" option from the hamburger menu or click on the icon next to the group's name, enter the new group name and click "Confirm".

Delete a group

To delete a subgroup, select the "Delete" option from the hamburger menu or click on the icon next to the group's name and approve the confirmation popup.

Note that deleting a main group will also delete all of the subgroups within it.

Main list of subgroups

Upon selecting a main group, a list of its contained subgroups will appear.
The list of subgroups contains three columns:

• Thumbnail, which is a set of images taken when the cover video was processed.
• Details, which are filled when creating each subgroup.
• Files, which shows the uploaded and media files of the subgroup.

Clicking on the name of any subgroup will change the current view from the main group list to the currently selected subgroup's page.

FieldTwin Vision User

The FieldTwin Vision User integration can be accessed through FieldTwin Designer.
To do so, click on "Layout", then "FieldTwin Vision" or however you have named the integration in the admin part.

Overall view

This is how the FieldTwin Vision User integration looks like.

Tree view

The tree view allows you to access all available main groups and subgroups for the current project.
These are the tree actions.

• expand the main groups list when it is collapsed or collapse it when expanded.
• sort the groups alphabetically (A-Z) or (Z-A).

Searching by name is available for any group within the tree.

If an asset in the Designer is located within the Auto-linking Distance from the ROV path, it will be automatically linked to that path and will show up in a new Auto-linked Media section.

Clicking on the media name from the tree view will load the path data.

At the bottom is a button for hiding the tree.

• shrink the horizontal size of the tree.

can be used to expand the tree back to its original size.

If the integration window is moved to a vertical view, the Survey Groups can be expanded using the button.

Main groups list

Upon selecting a main group, you will see its name and the number of contained subgroups.

Following the name, these two toggles can be seen:

• toggle on and off the virtual ROV paths in the viewport for all subgroups.
• toggle on and off all comments in the viewport for all subgroups.

In the middle, there are options for sorting the subgroups and searching for any of their properties.

The default sorting is by the subgroup names (A-Z), but you can change it to one of the following options:

• Newest First
• Name (A-Z)
• Name (Z-A)
• Start date
• End date
• Vendor

The subgroups are presented inside a table, each having a thumbnail from its cover video if available, details and ROV path actions.

The details include:

• Name of the subgroup.
• Created Date.
• Start Date.
• End Date.
• Vendor.
• Path Z-axis offset (m).
• Details.

The actions allow:

• toggle on and off the virtual ROV path in the viewport. The rendered path is also automatically zoomed in.
• zoom in on the ROV path in the viewport. Active only if the ROV path is rendered in the viewport.
• toggle on and off all comments in the viewport. Active only if there are comments.

When a ROV path is rendered in the viewport, an indicator is displayed next to the corresponding subgroup name in the tree-view on the left.

Subgroup view

Upon opening a subgroup, this screen will open.

Top view menu

In the top view menu, you can see the main group's name, the current subgroup's name and the subgroup's action icons.

• hover to view the detailed information about the subgroup.
• toggle on and off the virtual ROV path.
• zoom in on the ROV path in the viewport. Active only if the ROV path is rendered in the viewport.
• toggle on and off all comments in the viewport.
• link one or many selected objects in the viewport to this subgroup. Those objects will then appear in the "Linked objects" tab, where you can view and unlink them.
• generate coordinates for the subgroup by selecting a connection asset in the viewport and clicking on this icon. Note that you can only generate coordinates for the subgroup if you haven't already done so in the Admin part of the integration using a CSV file.
  
• remove coordinates generated from a connection asset.
• bring all opened PiP windows to focus.

Toggling on the ROV asset and path will display them on the viewport like this.
The ROV is moved to its coordinate position for each index of the video.

Clicking on the button for generating coordinates from a connection asset after selecting one will open a popup, which asks for a confirmation of the starting point of the inspection.

Clicking on "Generate coordinates" will trigger the generation.

After the subgroup coordinates are generated from a connection asset, the button for generating them will be replaced with a new button, which allows removing them.
Clicking on it will open a confirmation popup.

Video Controls

You can switch between all the processed videos within the subgroup by navigating to the desired one through this menu.

Underneath this menu is the video player. It is a default browser player, that you can use to play and pause the video or drag the slider to go to a specific time.
You can also mute and unmute it, change the playback speed, download it or choose to open it in picture-in-picture mode.

Below the video player, you can find the custom controls menu.

• hover to view the video name.
• enable or disable the Picture in Picture mode.
• add this video for a comparison view, that can be accessed by clicking on the "Compare" button in the top right corner.

If Picture in Picture mode is enabled, the video controls are moved to the newly opened window. The controls are also synced between all opened windows.

A yellow marker will also appear at the top right of the channel number, indicating that there is a PiP window opened for this channel.

Subgroup tabs

There are four tabs for each subgroup.

In the "Coordinates" tab you can find the processed CSV coordinates or the automatically generated ones.
They include the video index/timestamp, easting, northing, depth, date, time and comments.

The current video index is marked in orange color and it changes every second if the video is running.

On the right side of the Comments column is the current comment number and the total amount of comments for these coordinates, together with buttons to move to the next and previous comments.

• move to the previous comment.
• move to the next comment.

To the right is the menu for managing the comments.

• undo the last change made to the comments.
• import comments from an Excel file.
• remove all of the comments for the current video.

There are two options for adding comments.

1. Import from an Excel file.

Drop your Excel file on it and wait a few seconds for it to be uploaded and processed.
A new screen will be shown, asking you to select from which sheet to import the comments and which index is the header row of the table.

The start date and time will be prefilled with the first entry of the raw log table if available.
If the table doesn't contain all necessary columns, you will be asked to pick a column to map each missing one.
If the index column isn't found, you will be asked to specify the start date and time of the inspection.
Note that even the seconds are important in order to match the comments to the current coordinate index.

All missing columns will be saved for future use and you won't be asked to fill them again if your Excel table doesn't change.
After all of the columns have been verified, the "Import" button will activate and you can click it to finalize the comments import.

You will see all of the imported comments in the visualization by default.

1. Manual, by clicking on the icon for the desired index.

Enter the comment text in the newly opened input field. The priority of the comment can also be changed by clicking on the color indicator.

Clicking the icon will save the comment and will discard the changes.

After saving, the comment will be created and you will see the icons at the end change. The person who created/updated the comment will also be shown, as well as a time-stamp indicating when the action occurred.

• toggle the visibility of the comment inside the viewport.
  
• locate the comment inside the viewport.
  
• edit the comment.

If the comment is visible, a sphere with the selected priority color will be shown on its location inside the viewport.
Clicking on any of the comment spheres along the ROV path will make the current video and coordinates jump to this location.

Right clicking on any of the spheres opens a menu. Selecting the Create task option will open a new window from which a task can be created which will appear in the Workflow dashboard.

If a comment has a task linked to it, an additional icon will appear in the comment section.

In the "Raw log" tab you can find a table with all of the columns from the unprocessed CSV file. It highlights the current video index in orange color just like the coordinates tab.

If the raw log columns pointing to the easting, northing and depth contain values that differ more than 1000 meters from the previous valid value, they will be marked as invalid and the row will be skipped in the coordinates tab.

In the "Linked objects" tab you can see all of the linked objects to the current subgroup, locate them and unlink them.

• locate the linked object.
  
• unlink the object from the subgroup.

In the "Media files" tab you can see all of the processed video files, the coordinates file, and any other file that the administrator has uploaded.
Available is the file name, when it was created and updated, and an option to download it.

Linked media

Click on the "View linked media" button to enter the Linked media view.

There are two tabs inside - "Current selection" and "Current viewport".

1. Current selection
   When you select an object in the viewport that is linked to any of the available subgroups, you will see the subgroups and their videos appear on the screen.

Next to the subgroup's name, there are options to:

• go to the subgroup containing the linked media.
• unlink the subgroup from the selected objects objects.

Upon trying to unlink, a confirmation popup will appear.

Underneath each video player, there is an option to open the video in a popup:

• toggle the video popup.

Many popups can be opened at once and distributed to different monitors on full-screen, but there might be a performance issue when more than three videos are playing at the same time.

Switching between these buttons enlarges and shrinks the video size.

There is also an option to filter the subgroups by date.
A specific range can be selected by first clicking on the start date, then the end date.
Predefined ranges like last week, last month, last year, etc. are also available.

1. Current viewport
   Shows all of the linked subgroups and their videos to all objects that fit within the current viewport.

If you have moved the current viewport after opening this view, you will have to click on the icon in the top right corner to refresh the data and see the updated result.

Compare view

There are two modes for the Compare view:

1. Compare by Date & Time

At the top, you will see a synchronized player, where you can play, pause and stop all of the selected videos at once, and also jump to the next and previous comment from all videos.

• play all videos.
• pause all videos.
• stop all videos.
• move to the previous comment.
• move to the next comment.

For each video, you can see information about its name, date, current index/timestamp, easting, northing, depth and comment.
If the videos are playing, these current properties will update every second, allowing you to not only compare the pure videos, but also the comments for each index.

Underneath each video are icons for toggling the video popup and removing the video from the comparison.

• toggle video popup.
• remove the video from the comparison.

At the top right corner is the "Remove All" button, which will empty the comparison list.

1. Compare by Location

This comparison mode allows for a selection or a manual input of coordinates and a radius, which can be used to filter and show the videos that are located in this range radius.

Location actions:

• toggles the selection mode, which allows you to select an asset and automatically fill in the coordinates.
• finds the location center sphere.

Range radius actions:

• finds the radius sphere.
• toggles the radius sphere.

After manually inputting the location by entering the X, Y, and Z coordinates or using the automated selection tool, you should click on the "Filter" button and if there are any videos from this location, they will be shown.