About electrical element data for ACP

Prev Next

Many factors influence how ACP routes conduit between a Source and Destination. Some of these factors come from Revit (such as category and part type), while others are introduced by ACP (such as Enabled status and ACP Surface Connectors).

This article outlines these variables and explains how each one affects the specific kinds of electrical elements within an ACP Project.


Revit categories

The element categories which may be used as a Source and Destination for each Raceway are Electrical Equipment and Electrical Fixtures.

  • Electrical Equipment

    • Typically used to represent items such as panels, transformers, and other primary electrical equipment.

    • These elements are identified using the Panel Name parameter.

  • Electrical Fixtures

    • Represents electrical components, including end-point devices such as junction boxes and receptacles, as well as access-point devices such as pull boxes.

    • These fixtures require unique identifiers through the ACP_E_Fixture_ID parameter for identification within ACP.

      • This is because they have no default parameter for identification.

Element identification

The parameters in the table below are used to identify Electrical Equipment and Electrical Fixtures in the Revit project for use in the ACP workflow.

Parameter

Applied Revit Category

Description

ACP_E_Fixture_ID

Electrical Fixture

A shared project parameter added to the Revit project during Initialization. This is used to identify electrical fixtures for use in the ACP workflow.

Panel Name

Electrical Equipment

A Revit-native parameter which exists in every Revit project. This is used by most electrical teams to identify each unique piece of electrical equipment. ACP uses this parameter similarly for its workflow.

ACP_C_Enabled

Electrical Equipment

Electrical Fixtures

A shared project parameter added to the Revit project during Initialization. If this parameter is set to Yes, the electrical elements will be included as part of the Electrical Model for ACP.

Excluded Geometry (Clearance)

Electrical Equipment and Electrical Fixtures are often modeled with additional geometry to represent required clearances, which prevent other trades from routing content through those areas. However, this clearance geometry can interfere with ACP’s ability to route conduit to the equipment.

To support accurate conduit routing, any geometry assigned to a Subcategory of either of these categories, containing the word Clearance in its name, is automatically excluded during ACP Import.

Because this adjustment only affects the ACP import, it has no impact on the Revit model itself or on coordination with other trades.


Element Connectors

There are two types of connectors used in the ACP conduit routing process: Revit Electrical Connectors and ACP Surface Connectors. Each is a distinct kind of element with its own function.

Revit Electrical Connectors

Any Revit family with an element intended to be a Source or Destination must have at least one Electrical Connector.

  • Revit Native elements added into loadable families within the family editor.  

Traditionally the electrical Connector controls all of the information for how the element will connect to and interact with the Revit Native Electrical Systems such as the system type (IE: Power, Switch, Data, Telephone, Fire Alarm, Nurse Call, Communication, Control, Security systems), Voltage, and Load. Because ACP does not utilize the Revit Electrical Systems, the properties of the Electrical Connector will in no way impact how the ACP interacts with the element.  

ERROR: Electrical connector missing in Equipment or Fixture family instance

When importing the Electrical Model, you will will encounter this error if any enabled electrical element does not contain an electrical connector.

Click here for steps to clear this error

  1. From the error details, copy the Revit Element ID flagged by ACP.

  2. In your Revit project, locate the element using the copied ID.

  3. Do either of the following to resolve the error:

    • Add a Revit-native Electrical Connector to the element’s family

    • Replace it with an element belonging to a family which already includes a valid electrical connector.

  4. After ensuring that the connector is correctly placed, re-import the Electrical Model.

Note: The electrical model is not successfully imported until the timestamp is present under the Import Active Revit Project button as shown.

Electrical Connector Location

The location of the Electrical Connector is used differently for Electrical Equipment and Electrical Fixtures.

  • Electrical Equipment - The location of the Revit Electrical Connector has no impact on the routing to these elements.

  • Electrical Fixtures - The location of the Revit Electrical Connector establishes the “Back Face” of the fixture. This controls which faces of the Electrical Fixture that may have conduit routed to it.

    • See the Electrical Fixtures section of this article for additional information on how this works.

ACP Surface Connectors

ACP generates Surface Connectors for each enabled electrical element, based on the faces eligible for conduit routing.

  • Determined by the element’s category and part type.

  • Visualized only in the ACP 3D viewers and are never added to or visible within the Revit project.

For more details on how surface connectors are placed for different elements, refer to the category and part type information in the Electrical Equipment and Electrical Fixture sections below.  

The ACP Surface Connector is entirely separate from the Revit-Native Conduit Connector , which is typically used to connect elements within the Revit conduit system. These Revit Native Conduit Connectors are not required within the manual conduit modeling workflow, and often introduce complications with conduit routing and element placement when used. As such, ACP does not utilize them to connect a source or destination into the Conduit Run, and Revit Conduit Connectors are not required on any electrical elements used as a source or destination in ACP.

If they are present, ACP will ignore them during conduit routing.


Clash-Free boxes

In order to create an easier Revit project setup process, ACP automatically applies a Clash-free Box to some enabled Electrical Equipment (based on part type), and all enabled Electrical Fixtures (based on connector location).

These boxes allow ACP conduit to penetrate through obstructions around the Source and Destination.
Below are key characteristics of Clash-Free boxes:

  • They are only ever applied to surfaces that have ACP Surface Connectors and are considered Routable.

    • Not all surface connectors will have Clash-Free boxes applied to them.

  • To maintain realistic routing, any Revit category with Structural in its name is excluded from these clash-free penetrations.

    • This prevents conduit from being routed through beams, columns, or other structural components when exiting a panel.

  • They are never visualized in Revit OR the ACP Viewer, but are respected during routings.  

    • This means you won’t see the boxes themselves, only their impact on how conduit is routed.

For more details on how clash-free boxes are placed for different elements, refer to the category and part type information in the Electrical Equipment and Electrical Fixture sections below.  

ACP_E_Target_Bottom_Face

In Revit models, underground areas are not reliably recognized as underground or occupied. Because they have few or no obstructions, ACP favors them and treats these regions as if they are available for routing. A Source or Destination with a Clash-Free box placed on the ground floor allows conduit to penetrate the floor slab above. Once ACP enters these areas, it routes underground as if it were overhead, ignoring proper underground conduit rules.

  • To control routing at the bottom of the Source/Destination, you can use the ACP_E_Target_Botton_Face parameter added to the Electrical Equipment in your Revit project during Initialization.

    • When unchecked, this parameter disables the Clash-Free Box on the bottom face and prevents any bottom-face connections.

Disabling the ACP_E_Target_Bottom_Face property ensures that conduit is not routed through the floor slab and ultimately underground unless explicitly intended.


Electrical Equipment breakdown

Electrical Equipment such as Panelboards, Transformers, and Switchboards each have specific rules for how and where conduit may be connected. To handle these differences, ACP references the Part Type parameter within the Electrical Equipment family. This parameter allows ACP to distinguish between different types of equipment and apply appropriate routing logic. Each part type is treated differently during the conduit routing analysis to reflect its unique connection requirements.


Panelboard & Other panels

Images are for reference only

Clash-Free Boxes are not visualized
in Revit or in the ACP Viewer.

For Panelboards and other panels, conduit connections may be made to the top, bottom, or sides of the panel.

Here’s how ACP configures these for routing:

  • ACP Surface Connectors are applied to the top, bottom, and two sides of the Panel.

  • A Clash-Free Box is applied to only the top and bottom faces of the Panelboard, extending 6’ out in each direction.

    • When the ACP_E_Target_Bottom_Face property is unchecked, the bottom face will be considered Not Routable, and the ACP Surface Connector for that face will not be generated.

Side-to-Side connections

Panelboards installed next to each other are typically connected in the field using a short side-to-side conduit(s), commonly referred to as a nipple. ACP is designed to recognize these panelboard placements and automatically create a connection, rather than routing conduit from the tops of the panels.

ACP determines if panels are side-by-side by first looking at the Space information in the Revit project, when no spaces are present in the Revit project, additional considerations are evaluated.

When spaces are modeled ACP identifies the boundaries of each space and ensures that side-to-side connections are only made between panelboards within the same space.

When no spaces are present: ACP identifies and creates a side-to-side connection between panelboards located within 30 feet of each other.

However, without space data, ACP cannot verify whether the panelboards are in the same room. As a result, it may create a side-to-side connection through a wall if the panelboards appear close in the model but are actually separated by a partition.

The Design Rule for Raceway Height ensures that all horizontal conduits maintain a minimum elevation above the finished floor. However, this can interfere with side-to-side connections. If the Raceway Height is set at or above the top of the panelboards, ACP will be unable to create a horizontal connection between them.

Example: If the tops of adjacent panelboards are at 6 feet (typical), and the Raceway Height constraint is set to 9 feet (also typical), ACP will not be able to route conduit horizontally between the panels at their sides.

Click here for the workaround

  1. Create a Scope for the Electrical Rooms.

    • Use spaces (if present) and the ACP_Area_Class parameter to group Electrical Rooms into a shared Scope.

    • If no spaces are present, use named scope boxes to define Electrical Room volumes.

  2. Create a separate Design Rule Constraint for each scope

  3. Assign each scope to its corresponding Design Rule Constraint.

  4. Set the Design Rule Constraint height lower than the top of the panels (e.g., 4 ft) to enable side-to-side connections.

See the article Assigning a Design Rule to a Scope for more information.


Switchboard

Images are for reference only

Clash-Free Boxes are not visualized
in Revit or in the ACP Viewer.

For Switchboards, conduit connections may be made to the top, bottom, and sides of the panel.

Here’s how ACP configures Switchboards for routing:

  • ACP Surface Connectors are only applied to the top and bottom of the Switchboard.

  • Clash-Free box is applied to the top and bottom faces of the Switchboard, extending 6’ out in each direction.

    • When the ACP_E_Target_Bottom_Face property is unchecked, the bottom face will be considered Not Routable, and the connector for that face will not be generated.

Because Clash-Free boxes do not allow for penetrations through structural elements, if your equipment pads are made from one of the structural categories it will block the Clash-Free box from allowing the penetration needed for routing. You may use a May Route Box to create the needed penetration.

  • No Side-to-Side connections allowed

    • This means their connections will not be impacted by the Raceway Height design rule.

Switchboard Sections

ACP looks for and identifies individual elements in order to route conduit between each Source and Destination. Switchboards are often modeled as one single element containing multiple sections of that gear. In order for the conduit to correctly terminate at each section you will need to provide a family instance for each section of the gear, and identify each with a unique name in the Panel Name property.

PRO TIP:

ACP can identify individual shared families nested within a main family. This allows you to use a shared family to simulate a conduit window for each section of equipment within a single family, and ACP will recognize and route to those instances.

Click to see conditions

  1. The nested family instances are set to Shared within the family parameters.

    • Shared families are treated as individual elements in the project, allowing them to be scheduled and assigned properties independently from the host family.

  2. They belong to the categories ACP supports (IE: Electrical Equipment or Electrical Fixtures)

  3. Each instance is manually selected within the Revit project and enabled using the ACP_C_Enabled parameter.

  4. Each instance is manually selected within the Revit project and given a unique name using the Panel Name parameter.

It’s up to you to decide whether this approach is more efficient than modeling each section as a separate family instance.


Transformer

Unlike other equipment, conduit does not terminate directly on any face of the transformer. Instead, conduit is routed to terminate near the transformer and then connected using flex conduit (also known as a whip).

Here’s how ACP configures Transformers for routing:

  • ACP Surface Connectors are created within an offset of 12 inches from the sides of the Transformer.

    • Conduits can then terminate:

      • Straight into the top or bottom of these ACP Surface Connectors

      • Or with a 90° turn into the side or back connectors.

ACP detects the transformer face closest to a wall and designates it as the Back Face. It then places the ACP Surface Connector on the two adjacent sides.

  • No Clash-Free box

    • Because conduit does not terminate directly on the equipment face, ACP does not Generate a Clash-Free Box on transformers.

    • The bottom connector can terminate conduit near a transformer’s base, but not when the transformer sits on a building pad, even with ACP_E_Target_Bottom_Face enabled.

      • To access the bottom connector as a termination point, the transformer must either be suspended in the air or a May Route Box must be used.

Side-to-Side connections

When spaces are modeled ACP identifies the boundaries of each space and ensures that side-to-side connections are only made between panelboards within the same space.

When no spaces are present: ACP identifies and creates a side-to-side connection between panelboards located within 30 feet of each other.

However, without space data, ACP cannot verify whether the panelboards are in the same room. As a result, it may create a side-to-side connection through a wall if the panelboards appear close in the model but are actually separated by a partition.

The Design Rule for Raceway Height ensures that all horizontal conduits maintain a minimum elevation above the finished floor. However, this can interfere with side-to-side connections. If the Raceway Height is set at or above the top of the panelboards, ACP will be unable to create a horizontal connection between them.

Example: If the tops of adjacent panelboards are at 6 feet (typical), and the Raceway Height constraint is set to 9 feet (also typical), ACP will not be able to route conduit horizontally between the panels at their sides.

Click here for the workaround

  1. Create a Scope for the Electrical Rooms.

    • Use spaces (if present) and the ACP_Area_Class parameter to group Electrical Rooms into a shared scope.

    • If no spaces are present, use named scope boxes to define Electrical Room volumes.

  2. Create a separate Design Rule Constraint for each scope

  3. Assign each scope to its corresponding Design Rule Constraint.

  4. Set the Design Rule Constraint height lower than the top of the panels (e.g., 4 ft) to enable side-to-side connections.

See the article Assigning a Design Rule to a Scope for more information.


Equipment Switch (Not Supported)

Because the Revit part type Equipment Switch does not include the default Panel Name parameter, it is not supported in the ACP workflow. To ensure conduit can be modeled to these devices, use the Other Panel part type for disconnects and similar switches.


Electrical Fixtures breakdown

The Electrical Fixtures category is typically used in Revit to represent access-point devices such as pull boxes, and end-point devices within the electrical systems such as junction boxes, receptacles, and other devices.

This also applies in the ACP workflow, where it’s most commonly used to represent a junction box (either a Home Run box or a larger pull box). These boxes have strict rules about which faces can connect to conduit. To accommodate this, ACP lets you control the assigned faces of the junction box based on the location of the Revit Electrical Connector.

  • ACP Surface Connectors are applied based on the Revit Electrical Connector location.

    • The face where the Revit Electrical Connector is placed is the Back Face of the box once placed in the project. The opposite face then becomes the Front Face, and each adjacent face is considered a Side Face.

      • The Back Face, and each Side Face are considered routable. ACP will apply ACP Surface Connectors to these faces.

Changing the Connector location within the family will reorient which faces are considered routable, and receive Surface Connectors and Clash-Free Boxes as shown.

  • Clash-Free boxes are also applied based on the Revit Electrical Connector location.

    • ACP applies a Clash-Free Box, which extends 12” out on each side, to each of face of the Electrical Fixture considered Routable (See above).

      • This prevents conduit routes to junction boxes accidently placed within other geometry (IE: Ducts, pipes, equipment, etc.) from failing to route.

Clash-Free boxes will only be placed on faces which have been assigned an ACP Surface Connector and are considered Routable.

PRO TIP:

ACP can route conduit to penetrate walls perpendicularly but will not route conduit within a wall. As a result, recessed electrical fixture elements (for example, end-device receptacles) will fail to route because their clash-free boxes do not extend far enough up the wall to reach the horizontal conduit rack above.

To enable routing to recessed Electrical Fixtures, place a May-Route box in the wall, starting at the fixture’s top face and extending up to the horizontal rack height. This gives ACP a clear routable path inside the wall.