Mapping assistant

To facilitate Calculation, validation and synchronisation, you'll need to map Hysopt components and pipes to real-world 3D model Revit components and pipes. For example such as a P&ID radiator symbol with a Revit family radiator.

The mapping assistant is a tool that will guide you in :

creating new mappings manually
suggesting new mappings, based on classification and topology of components
walking through all mapped elements between the Hysopt model and the Revit model

The mapping assistant has 3 modes, an information bar and advanced options:

Map manually

In the mode Map manually, you can map component, pipes and zones manually. You do this by selecting elements in the Hysopt BIM Syncer canvas and a Revit view.

Map

By clicking map, you will map the displayed elements.

How to map a component?

Select a component in Hysopt, select a component in Revit, or vice versa. Map them.

How to map a zone/space?

Select a zone in Hysopt, select a space in Revit, or vice versa. Map them.

How to map pipes?

You can map all the pipe segments (pipes, fittings, …), but we advice to just map one pipe segment of a branch in Hysopt with one pipe segment of the corresponding branch in Revit.

How to map a group of elements eg. BIM object that corresponds with multiple Hysopt elements?

Just multiselect all the components in Hysopt or Revit, e.g. like in following movie :

Details

Details are a way of providing more information about an element in the system. They can help to identify and describe the element more precisely.

Details give you the following information about the element:

Nr number: how many elements are mapped
ID identifier: the unique identifier of the element

Hysopt ID: an Hysopt ID is unique identifier for a Hysopt element

C#: canvas number
B#: basecircuit number
Z#: zone number
P#: pipe number

Revit element ID: Is a decimal number (int) that identifies an element in a Revit project. It is unique in that same project, but not among several models. Its length may vary depending on the number of elements in a model, but rarely exceeds 8 digits. (more information on selecting Revit elements by ID https://help.autodesk.com/view/RVTLT/2024/ENU/?guid=GUID-2B1CC22C-CB1F-45DA-B57B-62C36013D9E0 )

Type: type of the element

Pipe
Zone
Component
internal pipe (pipe within a basecircuit)

Location: where is the element located

Supply: element is located in the hydronic supply
Return: element is located in the hydronic return
Both: element is connected to the hydronic supply and return
External: element is not connected to the hydronic system. It is not a part of the hydronic system.
Unknown: location of the element is unknown

Family: name of the Revit family

Show suggestions

Show suggestions is a tool that helps you to map the components, pipes and zones of your models. It works by analysing the data and finding the best matches for each element. Hysopt BIM syncer uses the system topology and the classification for finding matches. If the mapping assistant cannot find any suggestions for an element, you will have to map it manually. This will also help the mapping assistant to learn from your input and improve its suggestions for other elements.

Refresh

To see updated suggestions, you need to press the refresh button. This will trigger a new search and display new suggestions for your mapping task.

Map

By clicking map, you will map the displayed elements.

Map all

By clicking map all, you will map all the suggested mappings and trigger a new search to new suggestions for your mapping task.

Navigate < >

With the navigate buttons, you can navigate through the suggestions.

Probability

The mapping assistant assigns a probability to each suggestion, which indicates how likely it is that the suggestion is correct. The higher the probability, the more confident the mapping assistant is about the suggestion. You can find the probability in the information bar. A way to improve the quality of your suggestions is to use the probability threshold in advanced options. The workflow is to start with a high probability and lower this when the mapping assistant is not able to find any suggestions.

Show Mappings

Unmap

The unmap button allows you to remove the association between elements that have been previously mapped. This is useful if you want to correct a mapping error.

Navigate < >

With the navigate buttons, you can navigate through the mapped elements.

Information bar

Map manually messages

Select an element in both your Hysopt model as Revit model to start mapping.

Show suggestion messages

Please press the refresh button to obtain mapping suggestions.

[suggestion #/#] [Probability #%] Hysopt element of the type {Hysopt component name} and BIM element of type {BIM element type} have the same classification.

Show mappings messages

Advanced

Automatically navigate to objects

The option ‘automatically navigate to objects’ means that when a mapping suggestion or a confirmed mapping is shown in the mapping assistant, both your Hysopt and Revit view will zoom in and focus on that element, and also highlight it for better visibility. This can help you to quickly identify the elements in both applications. To enable this feature, you need to check the checkbox for 'automatically navigate to objects' in the mapping assistant.

Minimal suggestion probability

This means that you can specify a minimum value for the probability of suggestions, and only those that meet or exceed this value will be displayed. For example, if you set the probability threshold to 80, you will only see suggestions that have at least 80% probability of being correct or relevant.

Remove all

Remove all the implemented mappings. In a pop-up window, you need to confirm that you really want to remove all mappings.

Highlight all

Highlight all implemented mappings.