Properties Extraction & Mapping Tool

The Properties Extraction and Mapping Tool allows you to quickly extract hidden parameters and properties (e.g., Location - X,Y,Z Coordinates) from the model and inject them into existing or new instance parameters.

Core Features

• Extract inaccessible properties/parameters from the model elements and inject them into new or existing instance shared parameters
• Find the hidden properties/parameters in whole model, current view or current selection
• Find the hidden properties/parameters by category/subcategory
• Support properties/parameters: Location Points (Project Base Point, Revit Internal Origin, Survey Point), Connectors, GUID/UniqueID, Flipped face orientation, etc. This point will be explained in more detail in the next section.

Table of contents

1. ‘Select Parameters’ tab
   1. Elements selection and filtering options
   2. Properties/parameters selection and filtering options
   3. Step by step
2. ‘Create Parameters’ tab
   1. Step by step
3. Supported Properties/Parameters
4. Profiles
   1. What’s saved in the profile
   2. Create Profiles
   3. Import Profiles
   4. Export Profiles
   5. Delete Profiles

‘Select Parameters’ tab

Use this tab to select the properties/parameters to be mapped.

Elements selection and filtering options

This tool comes with a variety of features to help you to quickly select the elements that you want to extract properties/parameters from.

• Whole Model, Active View, and Current Selection
• By Category/Subcategory using the tree view.
• Search bar

Properties/parameters selection and filtering options

This tool comes with a variety of features to help you to quickly select the properties/parameters that you want to extract from the model elements.

• By property/parameter type (e.g., all location properties) and name (e.g., Location Point - XYZ coordinates) using the tree view.
• Search bar

Step by step

_{Note: the version on the image may not reflect the latest version of the application.}

1. Click radio buttons to collect the elemnts from the Whole Model, Active View, or Current Selection.

2. Use the checkboxes from the tree view to select specific categories/subcategories or use the checkbox in the table header to select all categories/subcategories.

3. Use the checkboxes from the tree view to select specific properties/parameters to be mapped.

4. Click on the ‘Map and Extract’ button to move to the ‘Create Parameters’ tab and start the mapping and extraction process.

‘Create Parameters’ tab

Use this tab to map and extract the properties/parameters into new or existing shared instance parameters.

Step by step

_{Note: the version on the image may not reflect the latest version of the application.}

1. Use the checkboxes from the table view to select specific properties/parameters to be mapped.

2. Select the type of parameter you want to create (default or text).

3. Select the ‘Group Under’. The default value is ‘Other’.

Remarks:
By selecting text you can also set the units and rounding in the bottom-left of the window. 

1. Select the destination parameter or create new parameter on the fly.
   • use the dropdown list to select any shared instance parameter available in the model.
   • to create a new parameter, use the ‘+’ button, name the parameter and then click on the save button.
2. Click on the ‘Extract’ button to extract and inject the values in the target parameters.

Supported Properties/Parameters

Properties/parameters available:

• Location Points
  • Bounding Box Coordinates: retrieves specific coordinates for the points of the box that circumscribes all geometry of the model element.
  • Point-based Family Instance: retrieves the location point coordinates (XYZ), which is also the insertion point of the family.
  • Line-based Family Instance: retrieves the location point coordinates from specific points in the insertion line of a family instance like pipes, etc.

Remarks:
The 'Bounding Box Coordinates' property returns a bounding box parallel to the cardinal coordinate axes in a project space. So, it does not correspond to the element’s coordinate system and is not necessarily the smallest circumscribing box possible, as the smallest box is not necessarily aligned with the cardinal axes.

• Connectors: retrieves the location point coordinates for the connectors associated with the model elements.

• Other parameters/properties:

  • Element ID: retrieves a value that is used as a unique identifier for an element within a single project.
  • GUID: retrieves a Revit element’s UniqueId, which is used to identify it universally, not only within a single project.
  • Flipped Face Orientation: returns a yes/no value as per the face orientation of the families.
  • Flipped Hand Orientation: returns a yes/no value as per the hand orientation of the families.
  • Mirrored: returns a yes/no value as per the mirror status of the family.
  • Flipped Orientation: returns a yes/no value as per the orientation status of the wall.

Remarks:
The 'Flipped Face Orientation', 'Flipped Hand Orientation', and 'Mirrored' properties are useful for objects like doors and windows for determining the handle/swing direction.

• Fabrication Parameters/Properties: retrieves some common useful hidden parameters related to the dimensions of the fabrication part. Some examples, include:
  • Diameter(Hanger Rod/Pipe etc.)
  • Rod Extn
  • Left/Right Extensions
  • And multiple other similar useful parameters.

Profiles

What’s saved in the profile

The following settings are saved in the profiles.

• The selection in the ‘Select Parameters’ tab
• The mapping set up in the ‘Create Parameters’ tab

Create Profiles

The profiles feature make it easy to save your settings and reuse them later. It is also a handy way for BIM Managers to create standard rules and share them across the organization.

Steps:

_{Note: the version on the image may not reflect the latest version of the application.}

1. Click on the top-right dropdown to open the profiles list.
2. Click on the text input and name the profile (give it a meaningful name because this is the name that will show up in the profiles list)
3. Click on the save button to save profile.

Import Profiles

The profiles feature make it easy to import existing profiles (e.g., profiles from a shared location).

Steps:

_{Note: the version on the image may not reflect the latest version of the application.}

1. Click on the top-right dropdown to open the profiles list.
2. Click on the ‘Import’ button.
3. Choose if you want to override the current list of profiles or if you want to append the profiles to your current list.
4. Select the profiles file to be imported.

Export Profiles

The profiles feature make it easy to export your current list of profiles.

Steps:

_{Note: the version on the image may not reflect the latest version of the application.}

1. Click on the top-right dropdown to open the profiles list.
2. Click on the ‘Export’ button.
3. Select the folder location and filename.

Delete Profiles

Steps:

_{Note: the version on the image may not reflect the latest version of the application.}

1. Click on the top-right dropdown to open the profiles list.
2. Click on the dustbin icon next to the profile you want to delete from the list.
3. Click ‘Yes’ to confirm and delete the profile.