This extension automates the process of updating electrical circuit data in Revit projects. It allows users to select electrical panels or systems and then applies predefined configurations to update circuit parameters, room information, and other related data. The extension logs warnings and messages and provides users with a summary of changes made during the process. It also supports automatic circuit numbering, copying data to schematic annotations, and customizable load name generation.
- Choose electrical panels or systems that need data updates.
- If no elements are preselected, follow the guidance to select the appropriate ones.
- Configure settings as needed.
- Run the extension to update data.
- Review summary and warnings.
- The extension iterates through the selected elements.
- Updates are applied according to user-defined configurations.
¶ Circuit and System Updates
- For each selected element:
- If a panel is selected:
- Process assigned electrical systems.
- If an electrical system is selected:
- Circuit parameters are updated based on predefined settings.
¶ Room Data and Control
- Extract room-related data from elements (room names, numbers).
- Update circuit parameters and control settings accordingly.
¶ Warnings and Messages
- Capture and log warnings and messages during updates.
- Inform users of potential issues or important notes.
¶ Summary and Results
- After updating all selected elements:
- Compile a summary of changes.
- Present users with a report detailing updates and warnings.
¶ Result Handling
- Return a result indicating success or failure.
- If warnings exist, consider the extension successful, but notify users of issues.
- Number of space names: This parameter sets the threshold for considering space names as distinct. When the number of unique space names surpasses this value, some space names might be omitted during updates.
- Phase with spaces: This input specifies the phase from which spaces will be selected for updates. If no phase is selected, the latest phase will be used.
- Space data parameter: Choose which parameter on the circuit the spaces should be written to.
- Update circuit number: Enabling or disabling this option dictates whether the extension will automatically update circuit numbers for both elements and electrical circuits during its execution.
- Space data: This choice affects the type of data that will be written to the circuit. You can select either space numbers or areas to include in the written data.
- Set element data: Here, you can define a set of parameter-value pairs that will be applied to the selected elements during the update process.
- Summarize on circuits: This feature gathers values from elements on a circuit and then copies a distinct list of these values to the parameter specified.
- Set circuit data: By setting up parameter-value pairs within this input, you can tailor data updates to electrical circuits specifically.
- Set panel data: The parameters defined here will be applied to the hosting panels of the circuits, allowing you to customize panel-related data updates.
- Circuit with one element: This input allows you to define parameter-value pairs that will be applied to circuits containing a single element.
- Circuit to row: In this configuration, you specify parameters within circuits and their corresponding counterparts in schematic rows. This enables data copying between the two.
- Circuit Load name: By selecting parameter names here, you establish the structure of the circuit load name based on these parameters.
- Control spaces: This parameter summarizes all spaces controlled by an element, which applies to both circuits and panels.
- Control spaces override: If you want to override the summarized space information parameter with a specific value, you can define it here.
- Panel schematics reference: This input specifies a parameter where the sheet number of a panel's schematic reference will be stored.
- Space name parameter: By selecting this parameter, you determine which parameter contains the space name information extracted from the selected spaces.
- Space number parameter: This input defines the parameter that holds the space number, which is extracted from the selected spaces.
- Space area parameter: Here, you define the parameter that will hold the space area information, extracted from the selected spaces.
- Schematic Panel Code: Reference to panel code on schematic sheets.
- Schematics Page Number: Reference to schematic page number.
- Summarize Separator: Choose a separator for summarizing data on circuits.
- Switch Room Number and Room Name: If this option is enabled, the room number and room name will be switched.
Parameter-value pairs are a way for the extension to know what information to update and where to get that information from. It's like a simple instruction system that helps the extension fill in the right data automatically.
¶ Key and Value
Each pair has a key and a value. The key is the parameter name to change. The value is what you want to change that thing to. It can be a direct word or a special code.
When you use special codes like { Panel.Panel Name }, the extension understands to find that information from somewhere else. For example, if you use { Panel.Panel Name }, the extension knows to take the name from the main panel hosting the current thing.
The extension knows where to find the data based on certain references:
Element: It gets data from the current thing being worked on.Host: It gets data from the host element.Project: It gets data from the overall project information.Room: It gets data from the room linked with the thing.Level: It gets data from the level associated with the hosting thing.
In simple terms, these pairs help the extension automatically update important information in your electrical circuit data using rules you set. It's a way to make things faster and accurate without manual work.
When selecting Area Code as the space data type, the extension handles the data as follows:
- For Area Code: The extension groups areas based on their names and includes area codes in the circuit data. The parameter used for the space data can be configured in the Area data parameter setting.
- Space data:
Area Code (instead of Room number)
- Space area parameter: Area Code
¶ Control Spaces and Override
The Control spaces setting refers to the parameter on the Revit circuit and panel elements that controls which rooms the circuit serves and the rooms the panel, in total, serves. When configuring this setting, specify the parameter that contains information about the rooms associated with the elements.
If you want to override the summarized space information parameter with a specific value, you can define it in the Control spaces override setting. This override allows you to provide a custom value that will be used instead of the summarized space information.
Example Configuration:
- Control spaces: Space Summary (This parameter will get the summarized list of space numbers.)
- Control spaces override: Space Summary Override (Optional: Override the summarized space information with a specific value from the selected parameter.)
Suppose you have a circuit with lights that serve rooms numbered from 100 to 105. This example demonstrates how the extension captures and controls room information on both the circuit and the panel element.
Result
When the extension runs on the circuit with lights in rooms 100 to 105:
-
The Control spaces parameter on the circuit will be populated with the information: 100, 101, 102, 103, 104, 105. This provides a comprehensive list of the rooms served by the circuit.
-
The Control spaces parameter on the panel will include the same room numbers, along with other circuits' rooms if applicable.
This configuration ensures that the extension accurately captures and controls the room information for both the circuit and the panel in your Revit project.
- Causes: Incorrect configuration, missing parameters, unsupported Revit version.
- Solution: Verify settings, ensure parameters exist, check Revit compatibility.
- Causes: Invalid parameter-value pairs, missing room/space data.
- Solution: Review summary report, correct configuration, ensure all required data is present.
- Resources: Extension FAQ
- Q: How do I set up parameter-value pairs?
- A: Use the configuration section to define keys (parameter names) and values (direct or dynamic codes).
- Q: Can I use area codes instead of room numbers?
- A: Yes, select "Area Code" as the space data type and configure the area data parameter.