Documentation Index

Fetch the complete documentation index at: https://docs.augmenta.ai/llms.txt

Use this file to discover all available pages before exploring further.

About Sources and Destinations

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).

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.

Excluded Geometry

Clearance Subcategory

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.

Fine Detail Level

Electrical Elements such as Electrical Equipment and Electrical Fixtures, are imported into ACP at the detail level of Medium, to allow for accurate detection of connectors, and avoid importing small internal components that could interfere with routing.

Any geometry in the Electrical Equipment and Electrical Fixtures set only to the detail level set only to Fine will automatically be excluded from the Electrical Model import in ACP.


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

Panel Name

Electrical Equipment

A Revit-native parameter which exists in every Revit project.  Used to identify each unique piece of electrical equipment.

ACP_E_Fixture_ID

Electrical Fixture

A shared project parameter added to the Revit project during Initialization. Used to identify electrical fixtures for use in the ACP 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 seen as a potential source and/or destination in the ACP Electrical Model.


ACP Surface Connector

Diagram showing directional indicators and values for MP-2 in four directions.ACP enforces realistic physical constraints when connecting electrical elements to the rack. Conduit may terminate only on the ACP Surface Connectors  generated by ACP on select faces of the element depending on its Category and Part Type.

ACP Surface Connectors are visualized in the Model Viewer once you’ve imported your Electrical Model into your Interactive Study in ACP. By default, ACP Surface Connectors appear as yellow transparent boxes attached to the element’s face(s).

Each ACP Surface Connector has a Target in the middle where conduit may terminate. Targets are the purple arrows protruding out of ACP Surface Connectors. To easily identify which element the Target is for, especially for electrical elements placed close together, each one is labeled with the associated element ID and a number indicating the face it’s attached to.

Number

Face

[0]

Top

[1]

Right

[2]

Left

[3]

Bottom

The ACP Surface Connector is entirely different from the Revit-native Conduit Connector typically used to connect elements within the Revit conduit system. These Revit-native Conduit Connectors are ignored in the ACP conduit modeling workflow as they may introduce complications in conduit routing.

PRO TIP:

To make ACP Surface Connectors more visible in the Model Viewer, you can use the color selector and transparency toggle in the View Controls panel for Surface Connectors to change its color and transparency.


Electrical Equipment

Electrical Equipment such as Panelboards & Other Panels, 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.

Diagram showing directional arrows and labels indicating various MP-2 positions around a rectangle.For Panelboards and other panels, conduit connections may be made to the top, bottom, and both sides of the panel.

3D model with labeled points indicating various reference positions and dimensions.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).

ACP Surface Connectors are generated 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 front or side connectors.

The Targets of a transformer are as follows.

Number

Transformer Side

Face

[0]

Right

Top

[1]

Right

Front

[2]

Right

Side

[3]

Right

Bottom

[4]

Left

Top

[5]

Left

Front

[6]

Left

Side

[7]

Left

Bottom

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.

Diagram showing two SWB indicators with arrows pointing up and down.For Switchboards, conduit connections may be made to the top and bottom of the panel.

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 provided the following.

  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.

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.

Because segments connect to the center of each routable face, side-to-side connections between Sources and Destinations in ACP may require turns , t may be easier to create side-to-side connections once the conduit has been exported into your Revit project. For a more accurate Status on your Conduit Schedule, and to easily reference which raceways need to be connected in Revit, deactivate the raceway requiring side-to-side connections. 

Diagram illustrating MDP-1 values with directional arrows indicating different positions.Bottom face connections

To control routing at the bottom of an Electrical Equipment, you can use the ACP_E_Target_Bottom_Face parameter added to your Revit project during Initialization.

  • When unchecked, this parameter disables the ACP Surface Connector on the bottom face, preventing any bottom-face connections.


Electrical Fixtures

In Revit, the Electrical Fixtures category typically represents access-point devices like pull boxes and end-point devices like junction boxes and receptacles.

In the ACP workflow, this category is most often used for junction boxes, whether a Home Run box or a larger pull box. Junction boxes have strict rules about which faces can connect to conduit. ACP lets you control which faces have ACP Surface Connectors based on the location of the Revit Electrical Connector.

  • 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.

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 Electrical 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.