Getting Started

Launching the Add-In

Once the Treble Revit Add-In is installed, you'll find it under the Add-Ins tab in Revit.

To launch the add-in:

1. Open Revit (2024, 2025, or 2026)
2. Open or create a Revit project with rooms you want to export
3. Go to the Add-Ins tab in the Revit ribbon at the top of the window
4. Click the "Export to Treble" button

The add-in will open as a wizard interface that guides you through the export process step by step.

Preparing Your Revit Model

Before exporting your model to Treble, following these preparation guidelines will help ensure the best results for acoustic simulation.

Save Your Document

Your Revit document must be saved before export. This is to make sure the correct model geometry gets uploaded. The add-in will warn you if your document has unsaved changes.

Room Tagging Best Practices

For optimal space identification and organization in Treble:

• Tag all rooms that you want to export with descriptive names
• Use consistent naming conventions (e.g., "Room 101", "Conference Room A", "Auditorium")
• Avoid special characters in room names that might cause issues with file naming
• Include room numbers if you want to maintain a connection to your architectural documentation

The add-in can work with untagged rooms, but tagged rooms with clear names make it much easier to identify and select the correct spaces during export and in the Treble web application.

Model Organization and Geometry

While Treble's space extraction is robust and can handle various model conditions:

• Enclosed volumes work best: Rooms with complete floor, ceiling, and wall boundaries are ideal for acoustic simulation
• Non-watertight geometry is acceptable: Small gaps or openings won't prevent space extraction, though fully enclosed spaces are preferred
• Coupled rooms are automatically merged: If you have acoustically connected spaces (e.g., a room with a large opening to an adjacent space), Treble will automatically merge them into a single space for simulation

note

Some rooms may not generate spaces suitable for acoustic simulations, particularly if they lack clear boundaries or are very irregular in shape. The Treble web application will show you which spaces were successfully extracted after upload.

Using Section Boxes for Large Models

Performance

For large models where you only want to export part of the building, using a 3D view with a Section Box can make the export much faster. The Section Box limits the scope of the export to a specific region, reducing file size, upload time, and processing time.

Creating a 3D View with a Section Box:

1. Create a new 3D view or open an existing one:
   • Go to View > 3D View > Default 3D View (or create a new 3D view)
2. Enable the Section Box:
   • In the Properties panel for the 3D view, find Extents
   • Check the Section Box option
3. Adjust the Section Box:
   • Click on the edges of the section box in the 3D view to select it
   • Drag the blue control grips to resize the box around the area you want to export
   • Use the arrow grips to move the entire section box
4. Verify the contents:
   • Make sure all rooms you want to export are fully contained within the section box
   • Rooms that are partially cut by the section box may not export correctly

When to Use Section Boxes:

• Large buildings: When you only need to analyze specific floors or zones
• Iterative design: When you're refining a particular area and want fast export cycles
• Focused analysis: When you want to isolate a specific set of rooms for acoustic study
• Performance optimization: When full model exports are taking too long

The add-in will detect which rooms are within the section box boundaries and present only those rooms for selection during the export process.