How do I map data?

After connection to a data source, the data needs to be mapped for entities and signals.


After connecting to data, the data needs to be extracted and mapped to specific Entities and Signals.

Sources can be found in the Sources tab of the Navigation Panel. 

Video Example


After selecting the Data Layout, the user must map the data (indicate rows and columns for entities and signals.) 

Entity Mapping

The user starts with mapping entities. 

"Extract" the data from the file.

New Entities

If the data set is all new entities, meaning that they do not exist in PetroVisor yet, select "Map All to New Entities as" at the bottom right of the screen.

The user will be prompted to select the type of Entity.

Existing Entities

If the data set maps to already existing entities, select "Automatic."

After selecting options, select the green "Automatic."

Unmapped Items

After mapping data, the user can click the "Unmapped Items" button and see a list of items that are not mapped.

Manual Entity Mapping

If the user wants to map the data manually, select "Add."  

Note that this is not the green "Map to New Signal" button at the bottom of the screen.

Signal Mapping

After mapping the entity, the user selects signal tab.

Displayed will be a list of all the signals. 

The signals have an aggregation.   The aggregation is how the data is aggregated when there are multiple values for the same signal and time step.  It can be changed by clicking on the Aggregation button.

New Signal

To create a new signal (one that does not already exist in the Workspace), select, "Map to New Signal."

The user has to select specific information about the new signal and then "Create Signal."

The Name for the signal is all lowercase letters.  The user does not have the option to have uppercase letters.

Existing Signal

To map to an existing signal, select the signal name by clicking on it, then click on the existing signal from the list on the right.  Notice that there is a search feature to make it easier to find the signal.

Manual Signal Mapping

If the user wants to map the data manually, select "Add."  

The user will have to input information specific for the new mapping.


If the user doesn't want a specific signal or entity, select the data from the list and click Delete.

To delete all the mappings, select the drop-down menu and select Delete All

Add Mappings

Once the user has completed the mapping of the entities and signals, click "Add Mappings" button in the lower right corner of the screen.

Add Source

Select "Add Source."

The user will be prompted to Name the new source.

After the name, select "Save."

The new Source will be displayed in the Sources list.