Family Mapping Examples

In this section, we demonstrate some examples that describe how the different mapping options are used.

Note that if you select a data file next to Based on Revit data, you can preview the results of your mapping.

The number 1 is shown next to the Browse button. The number 2 is shown on the Panel tab, indicating the mapping results from the selected file..

Figure 1: Preview Mapping Results

Use Default Mapping

The default mapping is the simplest mapping option. EasyPower uses default mappings to determine the mapping values.

In the example show below, the selected switchboard is mapped to a bus type of switchboard, and the values for Bus Type, Bus Rating and Bracing are determined by the default settings. The switchboard "MSB" has been selected in the Preview list, so the default values for the switchboard appear in the column.

On the Family Mappings tab, a switchboard is selected. On the related Bus tab, the mapping methods are highlighted.

Figure 2: Switchboard Set to Use Default Mapping

Determining How Default Mappings are Derived

The EasyPower program determines the default mappings. To learn how the default mapping is derived, click Default Value. The program displays a message that describes the default mapping, similar to the one shown below.

The number 1 is shown over the Use default option. The number 2 is shown over the Default Value button. The number 3 is shown on the Default Mapping dialog box.

Figure 3: Default Mapping Message

If you want different values, use one of the other mapping options to override the default settings.

Map Revit Values

You can map to Revit values. You can select the Revit parameter and specify which Revit values to associate with each EasyPower value. You can have multiple values for each parameter. This effectively enables you to map a single Revit parameter into more than one value. This option is only available when the corresponding EasyPower value is part of a list.

In this example, for the panelboard, the mapping for the Service Type is set to map to Revit values.

On the Family Mappings tab, a panelboard is selected. In the Panel tab, the Mapping Method for Service Type is highlighted and shown as Map Revit value.

Figure 4: Panelboard Using Revit Values for the Service Type

Click Set Mappings to see the parameter and the associated Revit values. In this case, for the Revit parameter Distribution System, there are several Revit values associated with various EasyPower phase and wire configurations.

The Relate Revit values to EasyPower values dialog box is shown for the Distribution System parameters.

Figure 5: Mapping Revit Values for the Distribution System Parameter

You can add additional values the to the Revit parameter by clicking Add New, typing a new Revit Value, and then selecting the EasyPower Value from the list.

Use Revit Parameter

You can select to use a specific Revit parameter and map it to an EasyPower field.

In the example below, the EasyPower field Enclosure is mapped to the Revit parameter named Enclosure. The result in the preview for 2lP-1 is NEMA-1.

The Panel tab is shown. The Enclosure Field is set to Use Revit parameter, and the result is NEMA 1.

Figure 6: Use Revit Parameter Example

Similarly, the Short Circuit Rating is also mapped to the Revit parameter Short Circuit Rating. In this case, the EasyPower units are in kA, but the mapped units are set to amps.

The Panel tab is shown with the Short Circuit Rating highlighted. The Mapped Units are set to "A" for amps.

Figure 7: Use Revit Parameter Example, with Units

Enter a Value

In this example, the configuration for the various EasyPower fields have been set by entering a value for each.

The Two Winding Transformer tab is shown, with numerous fields set to the Enter a value option. The Configure column shows the value, and the Preview column displays the result.

Figure 8: Entering Values

When you enter a value, you can select from a list or to manually type a value.

Lua Script

In this example, a Lua script is used to display the "Mounting" parameter as defined in Revit for the EasyPower field.

On the Bus tab, the number 1 is shown next to Lua Script. The number 2 is shown next to Edit Script. The number 3 is shown over the Edit mapping script dialog box.

Figure 9: Edit Lua Mapping Script Example 1

In this example, a Lua script is used to display the "Busbar Material" parameter as defined in Revit for the EasyPower field.

The Edit mapping script dialog box is shown.

Figure 10: Edit Lua Mapping Script Example 2

For additional examples, including using shared Lua functions within Lua scripts, see Lua Scripts.

More Information