Abutment Designer
Complete user manual for placing bridge abutments at precise start and end stations along Corridors, Civil 3D Alignments, or 3D PolyLines — with a rich library of parametric .rfa families.
What is the Abutment Designer?
The Abutment Designer is an AutoBRIDGE substructure module that places parametric Revit abutment families (.rfa) at the start and end of a bridge alignment. Unlike the Pier Designer — which may place many intermediate piers at arbitrary stations — the Abutment Designer always targets exactly two positions: Abutment 1 (low chainage end) and Abutment 2 (high chainage end). Each can be independently enabled, positioned, skewed, and configured with its own set of structural parameters.
The Abutment Designer reads its alignment geometry from the same three source types as the rest of the AutoBRIDGE suite, ensuring consistent positioning regardless of whether your project uses a Corridor-based workflow, a live Civil 3D link, or a lightweight 3D PolyLine.
AutoBRIDGE Corridor
Reads the corridor polyline directly from Revit's linked CAD layer. Zero external dependency — works offline with an embedded AutoBRIDGE corridor.
Civil 3D Alignment
Links directly to an open Civil 3D document, choosing an Alignment and a Profile for precise 3D end-to-end abutment positioning.
3D PolyLine
Uses any 3D PolyLine on a selected CAD layer imported into Revit — ideal for survey-derived geometry or imported road models.
.rfa families. All Revit family benefits apply — schedules, tags, detail components, and material assignments are fully supported.
Full Form Layout
The Abutment Designer is a custom 1300 × 880 px borderless window with four horizontal zones. Below is a full annotated reconstruction of the entire form as it appears when opened.
Type: Default · .rfa Family
Zone Summary
| Zone | Height | Contents |
|---|---|---|
| A — Source Bar | 32 px | Alignment source selector + sub-controls (changes with source type selection) |
| B — Plan View + Abutment Panel | 55 % | Plan View canvas (84 %) · Abutment 1 & 2 positions + Ref. button (16 %) |
| C — Params + Preview | 38 % | Detect button + 4-tab parameter inputs (50 %) · Shape selector + 3D preview (50 %) |
| D — Run Bar | 7 % | Status hint · PLACE button |
Key Differences from Pier Designer
| Feature | Pier Designer | Abutment Designer |
|---|---|---|
| Number of placements | Many piers (unlimited schedule rows) | Exactly 2 — Abutment 1 & Abutment 2 |
| Position input | DataGridView schedule table | Two independent text fields per abutment |
| Enable/disable | Checkbox column in grid | Dedicated checkbox per abutment |
| Ref. Intersection | Per-pier, fills entire schedule | Single button fills both abutments (min = Ab1, max = Ab2) |
| Family type | Adaptive Component (2 adaptive points) | Standard Revit family (.rfa) |
| Parameter tabs | Pier Parameters / All Parameters | Section · Elevation · Wingwall · Footing · Other |
| Detect function | Detects deck soffit → Top_PierHead_Offset | Detects corridor Width (L/R) & Depth → applies to family params |
Choose the Alignment Source
The top-left combo box in the source bar determines where the form reads the abutment's 3D alignment geometry — i.e., the 3D path from which abutment positions are interpolated at their given chainages.
Open the Source dropdown
Click the leftmost combo box in the source bar. Three options appear: ▸ Corridor, ▸ Civil 3D Alignment, ▸ 3D PolyLine. The rest of the source bar changes instantly to show the relevant sub-controls.
Select the specific source item
Corridor mode: Pick the AutoBRIDGE corridor from the right combo.
Civil 3D mode: Choose the Civil 3D document → Alignment → Profile (three linked combos).
3D PolyLine mode: Choose the CAD layer then the specific PolyLine index.
Plan View updates automatically
As soon as a valid source is selected, the Plan View canvas draws the alignment path in blue (■) and the two abutment markers in cyan (■) at their current chainage values. Zooming and panning become active immediately.
Reading the Plan View
Zone B contains the Plan View — an interactive GDI+ canvas that shows the alignment path and both abutment positions in real time. Unlike the Pier Designer which has both Plan and Elevation tabs, the Abutment Designer focuses on a single plan view that clearly marks the start and end of the bridge.
Visual Elements
| Element | Color | Meaning |
|---|---|---|
| Alignment path | Blue ■ | The 3D alignment centreline projected onto the plan (XY) plane. Drawn from chainage 0 to end. |
| AB1 wall marker | Cyan ■ | Solid wall rectangle at Abutment 1 chainage, rotated by AB1 skew angle. Greyed out when the AB1 checkbox is unchecked. |
| AB2 wall marker | Cyan ■ | Solid wall rectangle at Abutment 2 chainage, rotated by AB2 skew angle. Greyed out when the AB2 checkbox is unchecked. |
| Span shading | Blue wash | Translucent fill between AB1 and AB2 marking the bridge span extent. |
| Chainage labels | Dim white | Station labels along the alignment shown at regular intervals. |
Mouse Controls
| Action | Effect |
|---|---|
| Scroll ↑↓ | Zoom in / out (×1.15 or ×0.87 per step) |
| Left-drag | Pan the viewport |
| Double-click | Reset view to default scale and centre |
Configuring Abutment Positions
The right panel of Zone B (16 % of the width) contains all placement controls for both abutments. It is divided into two sections — ABUTMENT 1 and ABUTMENT 2 — each with identical controls.
Control Reference
| Control | Description |
|---|---|
| Place Abutment 1 / 2 checkbox | Enables or disables placement of that abutment. When unchecked, the chainage and skew fields are greyed out and the abutment marker disappears from the Plan View. You can place either abutment independently. |
| Chainage (m) | Station along the alignment in metres, measured from the alignment start. Abutment 1 is typically at or near 0.000; Abutment 2 at the far end. Editing this field immediately moves the abutment marker on the Plan View. |
| Skew (°) | Angular rotation of the abutment family about its placement point. Positive values rotate counter-clockwise when viewed from above. The Plan View wall marker rotates visually to match. Abutment 2 is automatically mirrored 180° relative to Abutment 1 to face the correct direction. |
| ◈ Ref. Intersection → Both | Auto-calculates both abutment stations and skew angles from reference lines in the model. See the section below for full details. |
◈ Ref. Intersection → Both
This button provides a one-click shortcut when reference geometry already exists in the Revit model — for example, road edge lines or bridge end lines drawn as line elements in a named Group.
Click "Ref. Intersection → Both"
An input box appears asking for a Revit Group name. Enter the exact name of the group that contains the reference lines (straight line elements) representing the abutment back-wall or end-of-bridge positions.
Intersection calculation
AutoBRIDGE extracts all straight line elements from the group, then intersects each line with every segment of the alignment polyline using 2D pure-math geometry. Large Civil 3D easting/northing coordinates are centred before intersection to maintain floating-point precision.
Results assigned
All intersection hits are sorted by chainage. The hit with the smallest chainage → Abutment 1; the hit with the largest chainage → Abutment 2. The skew angle (signed deviation from perpendicular, range −90° to +90°) is computed and applied simultaneously.
Selecting an Abutment Shape
The right half of Zone C holds the shape selector and a live Revit 3D preview. Clicking ◈ Select Abutment Shape opens the Abutment Library — a card-grid browser that shows all .rfa families in the configured library folder.
Abutment Library Browser
When you click ◈ Select Abutment Shape, a separate library browser window opens. It displays all .rfa files found in the configured library folder as visual cards.
Library Folder
The default library path is:
Use the Change Location button in the browser toolbar to navigate to a custom library directory. The selected path persists for the session. Thumbnail images can be provided by placing a PNG file named after the family (e.g. Abutment_Standard.png) inside the ABUTMENTS\data\ subfolder. When no image is found, an auto-generated abutment silhouette is drawn.
What Happens After Selection
Once a family is selected, AutoBRIDGE opens the .rfa document in a background Revit session to:
- Read all editable family parameters and populate the four parameter tabs.
- Start a live Revit PreviewControl render in the preview panel.
- Enable the ⬡ Detect button and the PLACE button.
Detect Corridor Width & Depth
The ⬡ Detect button sits at the top of Zone C left, spanning the full width above the parameter tabs. It reads the corridor geometry at the abutment stations and automatically calculates the abutment's key dimensional parameters — saving significant manual measurement time.
What Detect Measures
| Measurement | Maps to Parameter | How it's calculated |
|---|---|---|
| Left Width | Left_Width | Distance from the alignment centreline to the left edge of the corridor at the abutment station, converted to millimetres. |
| Right Width | Right_Width | Distance from the alignment centreline to the right edge of the corridor at the abutment station, converted to millimetres. |
| Wall Height / Depth | Abutment_Wall_Height | Vertical distance from the top of deck surface to the calculated bottom reference elevation at the abutment station. |
Prerequisites
A valid alignment source must be selected and an abutment family must be loaded. The button is greyed out (disabled) until both conditions are met.
Click ⬡ Detect Corridor Width & Depth
AutoBRIDGE samples the corridor polyline at the current AB1 and AB2 chainage values (whichever abutments are enabled). It extracts the left/right edge offsets and the depth from the nearest corridor cross-section.
Review the results dialog
A confirmation message box shows the detected values for Left Width, Right Width, and Wall Height in millimetres. Review the values before applying. If the numbers appear incorrect, check that the corridor has cross-section data at or near the abutment chainages.
Click Apply
Clicking Apply writes the detected values directly into the matching family parameters — updating both the NumericUpDown controls in the parameter tabs and the open family document. The 3D preview refreshes automatically to reflect the new dimensions.
Left_Width or Right_Width, those values are silently skipped. Check the Elevation tab to confirm the parameters are present.
Configuring Abutment Parameters
The left half of Zone C shows the parameter tab control. Four predefined tabs organise the most common abutment parameters by structural component. An Other tab catches any remaining editable family parameters that do not match the predefined groups.
.rfa family. If the family does not contain a parameter, its row is omitted from the tab. Tabs with no matching parameters are hidden entirely.
Tab Reference
Section
Controls the cross-sectional geometry of the abutment body and bearing seat.
- Abutment_Wall_Height — overall wall height (mm)
- Abutment_Wall_Width — wall thickness (mm)
- Backwall_Gap — gap behind the backwall (mm)
- Backwall_Height — backwall parapet height (mm)
- Backwall_Width — backwall thickness (mm)
- Bearing_Seat_Height — step height of the bearing shelf (mm)
- Bearing_Seat_Width — bearing shelf width (mm)
- Bearing_Seat_Section_Slop — bearing seat slope angle (°)
- Top_Elevation_Slop — top face slope angle (°)
Elevation
Controls the bridge-width geometry — how far the abutment extends left and right of the centreline.
- Left_Width — distance left of CL (mm)
- Right_Width — distance right of CL (mm)
- Top_Backwall_Left_Superelevation — left superelevation (°)
- Top_Backwall_Right_Superelevation — right superelevation (°)
- Bearing_Seat_Slop — bearing seat cross-slope (°)
Wingwall
Controls the geometry of both left and right wingwalls independently.
- Wingwall_Left_Bottom_Length (mm)
- Wingwall_Left_End_Height (mm)
- Wingwall_Left_Top_Length (mm)
- Wingwall_Left_Width — wall thickness (mm)
- Wingwall_Right_Bottom_Length (mm)
- Wingwall_Right_End_Height (mm)
- Wingwall_Right_Top_Length (mm)
- Wingwall_Right_Width — wall thickness (mm)
Footing & Other
Footing parameters (e.g. Footing_Width, Footing_Depth) appear here if defined in the family. The Other tab collects any remaining editable numeric parameters not matched by the four predefined groups — alphabetically sorted.
- Footing_Width (mm) — if present in family
- Footing_Depth (mm) — if present in family
- Footing_Toe (mm) — if present in family
- Footing_Heel (mm) — if present in family
- …any other editable family parameters → Other tab
Editing Parameters
Each parameter is shown as a label above a NumericUpDown control. Parameters are displayed in a 2-column grid layout. Changing a value immediately writes it to the open family document and queues a preview refresh — the 3D preview in Zone C right updates within a moment to reflect the new shape.
Placing the Abutments
Once source, shape, and parameters are configured, click the PLACE button in Zone D. AutoBRIDGE executes a single Revit transaction that creates family instances for each enabled abutment.
Confirm the status bar
The status bar at the bottom reads: "Select source · choose Abutment shape · configure · PLACE". Verify the source type and shape name are correct before proceeding. The PLACE button is only active when both a source and a family are loaded.
Click PLACE
AutoBRIDGE opens a named Revit transaction "AutoBRIDGE — Place Abutments". For each enabled abutment (AB1 and/or AB2) the form interpolates the 3D position on the source alignment at the specified chainage, then loads and places the .rfa family at that point.
Family orientation & skew
Abutment 1 is placed with its default orientation facing away from the bridge span. Abutment 2 is placed facing the opposite direction (180° rotated) so both abutments face inward toward each other. The skew angle is then applied on top of this base orientation for both abutments.
Parameters are written to instances
Every parameter currently shown in the parameter tabs (and modified from its default) is written to the newly placed family instance using Parameter.Set(). The family overwrite handler ensures the most recent parameter values are used even if the family was already loaded in the project.
Transaction committed
Both abutments (or whichever were enabled) are placed in a single undo-able transaction. A confirmation summary is shown. Use Ctrl+Z in Revit to undo the entire placement in one step.
.rfa file.
End-to-End Workflow
Open AutoBRIDGE → Abutment Designer
In Revit, launch AutoBRIDGE from the Add-Ins tab. Select Abutment Designer from the module list. The 1300 × 880 px borderless form opens centred on screen.
Choose alignment source type
Use the top-left combo: Corridor (AutoBRIDGE polyline), Civil 3D Alignment (live link), or 3D PolyLine (CAD layer). Fill in sub-controls. The Plan View draws the alignment path immediately.
Set Abutment 1 & 2 positions
In the right panel, enter the Chainage (m) and Skew (°) for each abutment. Enable/disable each with its checkbox. Use ◈ Ref. Intersection → Both for automatic calculation from reference group lines.
Verify the Plan View
Confirm both wall markers appear at the correct positions on the alignment. The blue shaded span area should cover the full bridge length. Zoom and pan as needed.
Select abutment shape
Click ◈ Select Abutment Shape. Browse the library, pick an .rfa family. The parameter tabs populate and the 3D preview loads.
Run Detect (optional)
Click ⬡ Detect Corridor Width & Depth to auto-fill Left_Width, Right_Width, and Abutment_Wall_Height from the corridor geometry. Review and confirm in the dialog.
Adjust parameters manually
Browse the Section, Elevation, Wingwall, and Footing tabs. Edit any parameter — the preview refreshes to show the result in real time.
Click PLACE
Verify the status bar. Click the cyan PLACE button. AutoBRIDGE places the enabled abutments in a single Revit undo transaction named "AutoBRIDGE — Place Abutments".
All Parameters Reference
Section Tab
| Parameter | Default | Unit | Description |
|---|---|---|---|
Abutment_Wall_Height | 5000 | mm | Total height of the main abutment wall from bottom to bearing seat |
Abutment_Wall_Width | 1500 | mm | Wall thickness (longitudinal direction) |
Backwall_Gap | 50 | mm | Gap between the backwall and the bridge deck/expansion joint |
Backwall_Height | 1000 | mm | Height of the backwall parapet above the bearing seat level |
Backwall_Width | 500 | mm | Backwall thickness |
Bearing_Seat_Height | 400 | mm | Step height of the bearing shelf above the wall top |
Bearing_Seat_Width | 1200 | mm | Bearing shelf depth (longitudinal) |
Bearing_Seat_Section_Slop | 0 | ° | Cross-slope of the bearing seat surface |
Top_Elevation_Slop | 0 | ° | Slope of the abutment top face to match road grade |
Elevation Tab
| Parameter | Default | Unit | Description |
|---|---|---|---|
Left_Width | 5000 | mm | Extension of the abutment left of the centreline (as-placed) |
Right_Width | 5000 | mm | Extension of the abutment right of the centreline (as-placed) |
Top_Backwall_Left_Superelevation | 0 | ° | Left-side superelevation applied to the top of the backwall |
Top_Backwall_Right_Superelevation | 0 | ° | Right-side superelevation applied to the top of the backwall |
Bearing_Seat_Slop | 0 | ° | Longitudinal slope of the bearing seat (to match road profile) |
Wingwall Tab
| Parameter | Default | Unit | Description |
|---|---|---|---|
Wingwall_Left_Bottom_Length | 3000 | mm | Length of the left wingwall at its base |
Wingwall_Left_End_Height | 2000 | mm | Height at the free end of the left wingwall |
Wingwall_Left_Top_Length | 2500 | mm | Length of the left wingwall at its top |
Wingwall_Left_Width | 500 | mm | Thickness of the left wingwall |
Wingwall_Right_Bottom_Length | 3000 | mm | Length of the right wingwall at its base |
Wingwall_Right_End_Height | 2000 | mm | Height at the free end of the right wingwall |
Wingwall_Right_Top_Length | 2500 | mm | Length of the right wingwall at its top |
Wingwall_Right_Width | 500 | mm | Thickness of the right wingwall |
Keyboard & Mouse Reference
| Action | Control | Effect |
|---|---|---|
| Zoom in / out | Scroll ↑↓ on Plan View | Scales view ×1.15 or ×0.87 per step |
| Pan | Left-drag on Plan View | Shifts the viewport offset |
| Reset view | Double-click on Plan View | Returns to scale = 1, offset = 0, centred |
| Move window | Left-drag on title bar or form background | Drags the borderless window using WinAPI caption drag |
| Quick-select library | Double-click a card in the browser | Selects family and closes the library dialog immediately |
| Undo all placements | Ctrl+Z in Revit | Reverts the entire "AutoBRIDGE — Place Abutments" transaction |
Troubleshooting
| Symptom | Likely Cause | Fix |
|---|---|---|
| Plan View is blank after selecting source | No polylines on selected layer, or corridor not linked | Check the corridor link in Revit Manage Links; verify the CAD layer name matches exactly |
| Civil 3D combos are empty | Civil 3D document not open | Open the DWG in the AutoCAD session before launching the form |
| PLACE button is greyed out | Source not loaded or abutment family not selected | Both source and a valid .rfa family must be loaded before the button activates |
| Detect button is greyed out | No family loaded yet | Select an abutment shape first using ◈ Select Abutment Shape |
| Parameter tab shows only "Other" | Family param names do not match predefined groups | Check the family parameter names match the expected naming convention (e.g. Left_Width, not LeftWidth) |
| Abutment 2 faces wrong direction | Family's default orientation is not centred on the insertion point | Check the .rfa insertion point and rotate the family definition 180° if needed |
| Ref. Intersection finds no hits | Group lines do not cross the alignment, or group name is incorrect | Verify the group name in Revit's group manager; check lines extend across the alignment in plan |
| 3D preview is empty after shape selection | Family document failed to open | Verify the .rfa is a valid Revit family file and is not corrupt or locked |
| Detect gives unexpected width values | Abutment chainage is outside the corridor extent | Check that the chainage values fall within the corridor's defined range; try adjusting chainage by 0.1 m |