ETABS® and Revit® Structure 2009/2010/2011 Data Exchange Documentation

ISO ETA062609M19 Rev. 2 Berkeley, California, USA

Version 2011 February 2011

Copyright
Copyright © Computers and Structures, Inc., 1978-2011 All rights reserved. The CSI Logo® and ETABS® are registered trademarks of Computers and Structures, Inc. Watch & LearnTM is a trademark of Computers and Structures, Inc. Revit® is a registered trademark of Autodesk. The computer program ETABS and all associated documentation are proprietary and copyrighted products. Worldwide rights of ownership rest with Computers and Structures, Inc. Unlicensed use of the program or reproduction of the documentation in any form, without prior written authorization from Computers and Structures, Inc., is explicitly prohibited. No part of this publication may be reproduced or distributed in any form or by any means, or stored in a database or retrieval system, without the prior explicit written permission of the publisher. Further information and copies of this documentation may be obtained from:
Computers and Structures, Inc. 1995 University Avenue Berkeley, California 94704 USA Phone: (510) 649-2200 FAX: (510) 845-4096 e-mail: info@csiberkeley.com (for general questions) e-mail: support@csiberkeley.com (for technical questions) web: www.csiberkeley.com

2

DISCLAIMER
CONSIDERABLE TIME, EFFORT AND EXPENSE HAVE GONE INTO THE DEVELOPMENT AND TESTING OF THIS SOFTWARE. HOWEVER, THE USER ACCEPTS AND UNDERSTANDS THAT NO WARRANTY IS EXPRESSED OR IMPLIED BY THE DEVELOPERS OR THE DISTRIBUTORS ON THE ACCURACY OR THE RELIABILITY OF THIS PRODUCT. THIS PRODUCT IS A PRACTICAL AND POWERFUL TOOL FOR STRUCTURAL DESIGN. HOWEVER, THE USER MUST EXPLICITLY UNDERSTAND THE BASIC ASSUMPTIONS OF THE SOFTWARE MODELING, ANALYSIS, AND DESIGN ALGORITHMS AND COMPENSATE FOR THE ASPECTS THAT ARE NOT ADDRESSED. THE INFORMATION PRODUCED BY THE SOFTWARE MUST BE CHECKED BY A QUALIFIED AND EXPERIENCED ENGINEER. THE ENGINEER MUST INDEPENDENTLY VERIFY THE RESULTS AND TAKE PROFESSIONAL RESPONSIBILITY FOR THE INFORMATION THAT IS USED.

3

Introduction
This document describes how to exchange Building Information Modeling (BIM) data between Revit Structure 2009/2010/2011 and ETABS 9.7.2 or later, a three-dimensional physical object based analysis and design package developed specifically for building type structures, including commercial, residential, healthcare and educational facilities. CSiXRevit supports four different workflows: 1) Exporting from Revit Structure to create new ETABS model 2) Exporting from Revit Structure to update an existing ETABS model 3) Importing from ETABS to create a new Revit Structure model 4) Importing from ETABS to update an existing Revit Structure model. The flow of information is idealized in the schematic below:

Export from Revit Structure to create a new ETABS model. Export from Revit Structure to update an existing ETABS model.

ETABS® Revit® Structure

Import from ETABS to create a new Revit Structure model. Import from ETABS to update an existing Revit Structure model.

4

transferred to ETABS. cardinal points. Equivalent ETABS sections will be automatically created and mapped with _f appended to the floor section name. Equivalent ETABS sections will be automatically created and mapped with _f appended to the floor section name. and end releases. Geometry. Action Creation of… Model Element Grids Materials Frames Supported Notes Equivalent ETABS materials will be automatically created in ETABS. Will be automatically mapped to ETABS database sections Equivalent ETABS sections will be automatically created and mapped Walls will be automatically meshed at window and door openings Equivalent ETABS sections will be automatically created and mapped with _w appended to the wall section name. offsets. Frame Sections Steel Sections Concrete Sections Walls Wall Properties Floors Slabs Properties Deck Properties Footings Point Loads Line Loads Area Loads Load Cases Load Combos ETABS Auto Select Lists All families that are loaded in ETABS will be made into Auto-Select Lists in ETABS 5 . All columns will be automatically broken at story levels. Fixed joint restraint will be created in ETABS wherever a footing occurs in Revit.Supported Workflows Exporting from Revit Structure to create a new ETABS model The chart below specifies details about data that is transferred into ETABS when exporting from Revit to create a new ETABS model.

If first value is zero then ETABS default value will be used. For the Isotropic material only first value will be used for all other directions • Poisson Ratio: Revit Poissons Ratio is used to fill the ETABS material Poissons Ratio (u). These three values (for 3 different directions) cannot be zero in ETABS. If first value is zero then ETABS default value will be used. If any of the remaining two is zero then it will be filled with the first non-zero value. If any of the remaining two is zero then it will be filled with the first non-zero value. In case of orthotropic material. these three values (for 3 different directions) cannot be zero in ETABS. These three values (for 3 different directions) cannot be zero in ETABS. • Thermal Expansion Coefficient: Revit thermal expansion coefficient is used to fill the ETABS material thermal expansion coefficient (Alpha). For the Isotropic material only first value will be used for all other directions • Unit Weight: Revit unit weight is used to fill the ETABS material unit weight (w) and unit mass (m). ETABS breaks it into number of segments to get the suitable curvature.Grids The following Grid attributes are being created in ETABS: • Grid Name: Same grid name will be used in the ETABS grid bubble. For the Isotropic material only first value will be used for all other directions • Shear Modulus: Revit Shear Modulus is used to fill the ETABS material Shear Modulus (G). If any of the remaining two is zero then it will be filled with the first non-zero value. 6 . Unit weight cannot be zero in ETABS. • Damping Ratio: This value is not in used in current version of ETABS. If first value is zero then ETABS default value will be used. Materials The following material attributes are being created in ETABS: • Material Name: Same name will be used in ETABS • Material Type: Revit material type is used to identify the ETABS material types namely Concrete. If Revit material is defined as Isotropic then ETABS will calculate this value on the basis of Young’s Modulus and Poisson Ratio. In ETABS units of weight is being calculated by dividing the unit weight to gravitational constant (g). If it defined zero in Revit then ETABS default value will be used. If any of the remaining two is zero then it will be filled with the first non-zero value. Steel and others • Young’s Modulus: Revit Youngs’s modulus is used to fill the ETABS material Young’s modulus (E). If first value is zero then ETABS default value will be used. • Grid Points: The start and end points are used to define the general grid line in ETABS. These three values (for 3 different directions) cannot be zero in ETABS. • Curved Grid: In case of curved grid.

User has control over how the curve is broken up by defining the minimum length and minimum angle size. ETABS will always fix them at the both ends 7 . • Old Revit Wall Openings (Regular or irregular • Frame Section: ETABS imports the currently assigned section to the frame in Revit along with the whole family. Tensile Strength: Revit tensile stress is used to fill ETABS material (if type is steel) ultimate stress ‘Fu’. Lightweight: Revit lightweight tag is used to identify the lightweight concrete material in ETABS. Behavior: Revit behavior tag is used to identify the isotropic or orthotropic materials in ETABS Concrete Compression: Revit concrete compression is used to fill ETABS material (if type is concrete) ‘F’c’. ETABS always give the warning and writes . Shear Reinforcement: Revit shear reinforcement is used to fill ETABS material (if type is concrete) shear reinforcement ‘Fy’. If the frame is a column. Resistance Calculation Strength: Revit Resistance Calculation strength is used to fill the ETABS material f’c factor. Default value will be used if it is defined as Zero in Revit. All curves in Revit frame will be converted in to number of segments. Default value will be used if it is defined as zero in Revit. Default value will be used if it is defined zero in Revit. Frames The following frame attributes are being imported from Revit to ETABS: • Frame Points: All frame points are used to define the same geometry of the frames in ETABS. Only those materials which are linked with the floor or frame in the Revit model are imported into ETABS. Shear Strength Reduction: This value is not in used in current version of ETABS Yield Stress: Revit yield stress is used to fill ETABS material (if type is steel) yielding stress ‘Fy’. • Frame Releases: All frame releases defined in Revit are imported into ETABS as line objects releases. • Frame Curves: ETABS does not support curved frame objects.• • • • • • • • • • Bending Reinforcement: Revit bending reinforcement is used to fill ETABS material (if type is concrete) main reinforcement ‘Fy’. ETABS converts the Revit family to ETABS auto selection list. Default value will be used if it is defined as zero in Revit.wrn file in case of using any default value while importing the materials from Revit. Steel Reduction Factor: This value is not in used in current version of ETABS. Default value will be used if it is defined as zero in Revit.

• Beam End Offset: Vertical offset are being defined in Revit for any end of the beam with following parameters o Vertical Projection o Reference Level o Z-Direction Offset Value (Geometry Offset) o Start Level Offset o End Level Offset ETABS calculates the vertical beam offset of END I and END J by using the following equations: o END I vertical Offset = Reference Level Elevation – Analytical Level Projection Elevation + Geometry Offset + Start Level Offset o END J vertical Offset = Reference Level Elevation – Analytical Level Projection Elevation + Geometry Offset + End Level Offset If vertical projection or Reference level is not defined. This is being done to ensure structure stability. beam insertion point is defined by the following two parameters o z-Direction Justification o Lateral Justification ETABS calculates the coressponding cardinal point on the basis of these two parameters. ETABS follow mapping of sections in following steps: 8 . view the model in extruded view. If it is not found in the existing database. • Beam Insertion point: In Revit. ETABS first tries to find the name of the section from it database. the ETABS will try to create these sections parametrically. beams or brace end torsion cannot be released. To see the effect of rigid offset in ETABS. then both of these parameters are defined as 0 in the above equations. Similarly. If these parameters are not defined then default cardinal point (Top Center) is choosen.except for the bottom end of base story. • Column Insertion Point and End Offset: The default cardinal point for columns (mid center) is chosen when we bring model from Revit to ETABS. Column offsets are exported into ETABS from Revit if rigid link is being used for either column end. Most steel sections can be mapped automatically. • Rigid Link: It is being imported and used to define the end offsets in the ETABS. Frame Sections Mapping of Revit frame section attributes depend upon the type. • Orientation Angle: Same angle is used for defining the line orientation along with its local 1-axis in ETABS.

If it finds a match then that section is mapped.PRO databases by section name comparison. 2) In the next step ETABS try to map Revit Structure family sections to a section in the ETABS’ . The user is given the option to add/remove or change the search order of . In Figure 1 below: ‘UC203x203x46’ section is loaded from ‘BSShapes.Profile’ .PRO files during the import of the Revit Structure model.1) ETABS will first try to map Revit Structure family sections to the currently loaded ETABS database by section name comparison. Fig 1: Import of sections from . If it finds the same name then we use that section with its all geometric cross sectional properties. We always remove the blank spaces and always and ignore upper/lower cases dissimilarities while names comparison. All geometric cross sectional properties will be used from ETABS section.PRO files 9 .

some special characters for inch and feet representation will be changes to ‘in’ or ‘ft’ as shown in fig 3. Fig 3: Mapping of Revit Structure Parametric Frame families 4) In the case that the Revit Structure family section is not parametrically defined then we import this section with the same name (Revit Structure family caption) and map it to an ETABS default section properties.Fig 2: Adding /Removing of Pro files while Revit Structure model Import 3) If a Revit Family section cannot be mapped to an ETABS section from any of the . The user has the option to add a new parametric 10 . In case that it is a parametric section ETABS will create an equivalent section and use the same Revit Structure family caption as section name. However.PRO files then ETABS check if it is a Revit Structure parametric section.

In Fig.’ button to map that Revit Family section to an appropriate ETABS section..PRO file list. 11 . due to prefix/suffix incompatibility. the user can fix the mapping by using the use ‘Add. 5) The user has the option to save a mapping file such that user defined mapping can be reused on subsequent imports. For Revit Structure families with ‘Universal Columns’ or ‘Universal Beams’ category ETABS handles this by changing suffix to prefix while import.PRO file sections.PRO file which is not in the . A sample mapping file is shown in fig 4. However.section as a replacement section or to load a new section from any other . Fig 4: Section mapping file 6) Some European family names do not map with ETABS European . 2 ETABS initially maps ‘RHS150x100x5’ to the ETABS default section property (shown in red color).

SY. D. D. SY. A B. Member Type CONCRETE COLUMNS Family Name CONCRETE-RECTANGULARCOLUMN CONCRETE-ROUND-COLUMN CONCRETE-SQUARECOLUMN PRECAST-RECTANGULAR COLUMN PRECAST-DOUBLE TEE Parameters B. IY. SLAB DEPTH. SX. A B. IX. D. A B. IY. SLAB DEPTH. SY. IX. A B. H. IX.The parameters list is given for concrete and wood structural families in the following table. IX. SY. IX. A B. H WIDTH. SX. SX. SX. SEAT H1. D. DEPTH B. SY. IX. H CHAMFER WIDTH. IX. SEAT B. SX. H B B B. A B. D. A B. IY. IY. IY. IY. IX. STEM WIDTH. H B. SX. IY. D. IY. TEE WIDTH. SY. D. IX. D. IY. A B. SX. D. SY. D. A B. SY. SX. H CONCRETE FRAMING PRECAST-INVERTED TEE PRECAST-L SHAPED BEAM PRECAST-RECTANGULAR BEAM PRECAST-SINGLE TEE WOOD COLUMNS WOOD FRAMING DIMENSION LUMBERCOLUMN GLULAM-SOUTHERN PINECOLUMN GLULAM-WESTERN SPECIESCOLUMN PSL-PARALLEL STRAND LUMBER-COLUMN TIMBER-COLUMN DIMENSION LUMBER GLULAM-SOUTHERN PINE GLULAM-WESTERN SPECIES LVL-LAMINATED VENEER LUMBER TIMBER OPEN WEB JOIST PLYWOOD WEB JOIST 12 . IX. H. SX. SX. B. A B. B. SY. DEPTH H1. IY. SY. STEM WIDTH.

User has to manually assign it opening after import. ETABS only choose one layer which has the maximum thickness when we export data from Revit to ETABS. The material of the wall with the maximum wall thickness will be used.In-place family members In Revit. All irregular shapes will be converted to an equivalent mesh (by using tessellation in vertical plane) of vertical elements having four nodes only. User has control over how the curve is broken up by defining the minimum length and minimum angle size. In this case ETABS breaks the Revit walls in to four noded walls. ETABS is reading the floor layer information and will treat the floor as deck if more than one layer is present in the floor. only one material is assigned to ETABS wall section property. • Number of Layers: In Revit. ETABS breaks the curved walls of Revit in to small segments to keep the required curvature of the walls. different layers may be defined within a floor. However. Floors The following floor attributes are being imported from Revit to ETABS: • Floor Points: All floor points are used to define the geometry of the floor in ETABS • Floor Curves: ETABS does not support curves in area objects. In Revit wall may be defined as contentious having more than 4 points. • Wall Thickness: Revit wall has different layers. having different thickness and material properties. which will give the suitable curvature for the area boundary. wall openings may be drawn using “Modeling>Opening>Wall Opening”. However. In older versions. • Wall material: All the materials assigned to different layers of a Revit wall are exported to ETABS. inplace family members are imported into ETABS as a frame member including its family and corresponding frame section. 13 . ETABS treats the opening loop same like wall loop. walls are stored as loops (including the curves) of points. Users have the option in ETABS to change the material if necessary. All the curves in Revit floor will be converted into number of segments. • Old Revit Wall Openings (Regular or irregular shapes): In Revit. • Wall Openings (Regular rectangular shape): In new Revit version. • Wall Curve: Curved walls are not supported in ETABS. This opening entity is transferred to ETABS as an opening in walls. Walls The following wall attributes are being imported from Revit to ETABS: • Points: All points are being transferred from Revit to ETABS. ETABS wall has 3 to 4 nodes. there was no tag for the loop for opening. Otherwise floor will be treated as a slab.

If the floor is a deck. Below is an example of how Revit Deck parameters are mapped to ETABS Deck Section parameters. Revit Deck Family 14 . its section property is defined by the maximum thickness of the layers.• Layer Thickness: ETABS imports the thickness of each layer.

ETABS Deck Parameters ETABS Deck Section 15 .Revit Deck Parameters vs.

THICKNESS Layer Materials: ETABS gets the material of each layer. • • • • 16 . All curves in this opening will be converted into number of segments. Floor Span Direction: Same span direction will be used in ETABS for the decks. Same layer will be used to define material of ETABS deck section. Same layer will be assigned to the Slab or Deck section. Floor Opening (Regular or Irregular): Openings defined in Revit by “Modeling>Opening>Vertical Opening” are being imported in ETABS from Revit. A default direction will be used if no span direction is defined in Revit. there are following two layers in the Revit Deck section 1) Concrete – cast-in-place (Thickness = 5”) 2) Metal – Deck (Thickness = 0 ) Layer 2 is linked with a deck profile which has following properties • • • • • HR WR RR SR THICKNESS Here is the procedure that CSiXRevit uses to fill ETABS deck section properties • We select a layer which has maximum thickness and treat it as overall thickness of section. • Slab Depth tc = overall thickness of section – HR • Deck Depth hr = HR • Rib Width wr = WR • Rib Spacing Sr = SR • Composite Deck Studs diameter = RR • Composite Deck Stud height (hs) = over all thickness of section . A default material will be used if no material is defined in Revit. Users have the option in ETABS to change the material of the different layer if necessary. which will give the suitable curvature for the area boundary.In this example. Ramp: All 4 noded inclined slabs are imported as ramp elements in ETABS.

• Width. In case of a lateral line 17 . Fz. ETABS locates the all columns within the rectangular area and these columns will be restrained. for details please check openings in walls. In this case. Footings The following footing properties are being imported from Revit to ETABS: • Points: All the points defining the shape of the footing will be imported. Point Loads The following point load attributes are being imported from Revit to ETABS: • Load Case Name: Is used to set the corresponding load case number in ETABS. Mx. • Start and End point Location: Is used to define the start and end point of the line load. which are located in this area. • Wall Openings: These are imported as openings in walls (vertical planes). Line Loads The following line load attributes are being imported from Revit to ETABS • Load Case Name: Is used to set the corresponding load case number in ETABS. if a line load is carrying the gravitational load and it is overlapping more than one beam then it will be distributed to the corresponding beams. the Shaft Opening is defined as a 3D shaft having upper and lower limits (or offset elevations from upper and lower story levels). In ETABS all columns.Openings The following openings are being imported from Revit to ETABS • Vertical Openings: These are imported as opening in floors (horizontal planes) for details check openings in floors. will be restrained. Mz: All forces and moments are applied in global direction in Revit and transferred in the similar manner to ETABS. Note: Only rectangular footings will be processed. • Fx. width. In ETABS the shaft is imported as horizontal openings in all stories level which lies between the upper and lower limits of 3D Shaft. length and thickness are being defined. My. • Shaft Openings: These are imported as openings in floors (horizontal planes). Fy. In ETABS. for details please check Shaft Opening. Shafts In Revit. Length and Thickness: For rectangular cases. • Location: Used to define the point of application of the load.

Mz: All forces and moments are applied in global direction in Revit and transferred in the similar manner to ETABS. • Load Case Category: It is used to define the load case type in ETABS. In case of Revit non-uniform surface load.• load. users must check that no line load should overlap more than one beam. Area Loads The following area load attributes are being imported from Revit to ETABS • Load Case Name: Is used to set the corresponding load case number in ETABS. ETABS will convert it in to equivalent uniform area load. Otherwise. Fx. Fy. It should be noted that each curve is used as straight line in ETABS. • LoadX. Mx. Load Cases The following load case attributes are being imported from Revit to ETABS: • Load Case Name: The same name will be used for ETABS Load case name except ‘Rvt-‘ will be added at the start of the name. The non-uniform surface load is not supported in ETABS. The mapping is shown in the following table: Revit Structure Load Case Category Dead Live Wind Snow Roof Live Accidental Temperature Seismic ETABS Load Case Type Dead Live Wind Snow Live Other Other Quake Load Combos 18 . LoadZ: All loads are applied in global direction in Revit and transferred in the similar manner to ETABS. Fz. • Points: Points will be used to define the geometry of the loading area. LoadY. it will not be processed in the ETABS analysis. My.

ETABS Auto Select Lists ETABS will automatically create Auto-select lists based on Revit family types that are loaded in the current Revit model being exported to ETABS. The following names are reserved and Load Combinations will not be added in ETABS if same name is used in Revit. 19 .The following load combination attributes are being imported from Revit to ETABS: • Load Combination Name: The same name will be used for ETABS Load Combination Name. o DCON o DSTL o DWAL o DCMPC o DCMPS o DCMPD • Load Cases: The same load cases list will be used in ETABS to define the Load Combination. • Load Case Factor: The same load case factors will be used for the corresponding load cases in the ETABS load combination.

cardinal points. offsets. transferred to ETABS. Equivalent ETABS sections will be automatically created and mapped. Frame Sections Steel Sections Concrete Sections Walls Wall Properties Floors Slabs Properties Deck Properties Footings Point Loads Line Loads Area Loads Load Cases Load Combos Updating of… Grids Materials Frames X X All material parameters will be updated. Action Creation of… Model Element Grids Materials Frames Supported Notes Equivalent ETABS materials will be automatically created in ETABS. offsets.Exporting from Revit Structure to update an existing ETABS model The chart below specifies details about data that is transferred into ETABS when exporting from Revit to update and existing ETABS model. Geometry. and end releases. Equivalent ETABS sections will be automatically created and mapped. Equivalent ETABS sections will be automatically created and mapped. Will be automatically mapped to ETABS database sections. All columns will be 20 . Joint restraints will be created in ETABS wherever a footing occurs in Revit. Equivalent ETABS sections will be automatically created and mapped. updated in ETABS. Geometry. and end releases. cardinal points. All columns will be automatically broken at story levels. Walls will be automatically meshed at window and door openings.

Slab section parameters will be updated. Point load values will be updated accordingly. Wall section parameters will be updated.automatically broken at story levels. If you use “selection only” update feature. Floor geometry will be updated accordingly. deletion of items is not supported. IMPORTANT NOTE: Deletion of elements when updating a model will only work if you are sending the ENTIRE model. Slab section parameters will be updated. 21 . Parameters for frames sections will be updated Wall geometry will be updated accordingly. Line load values will be updated accordingly Area load values will be updated accordingly Load Combos will be updated accordingly. Frame Sections Steel Sections Concrete Sections Walls Wall Properties Floors Slabs Properties Deck Properties Point Loads Line Loads Area Loads Load Cases Load Combos Deleting of… Grids Frames Walls Floors Point Loads Line Loads Area Loads Load Cases Load Combos X X X X X X X X X X X X Frame section assignments will be updated.

Walls Wall Properties Floors Slabs Properties Deck Properties 22 . The only limitation is Revit model should have one default concrete and one default steel material for duplication. Frames Frame Sections Steel Sections Concrete Sections Geometry. All floors and openings in floors will be automatically created and mapped. Footings Point Loads Joint restraints will be created in Revit Structure. See NOTE 1 below. Action Creation of… Model Element Grids Materials Supported Notes Concrete and Steel materials are being imported from ETABS to Revit. and openings will be created in Revit Structure.Importing from ETABS to Create a new Revit Structure Model The chart below specifies details about data that is transferred from ETABS into Revit Structure to create a new Revit Structure model. end releases. Equivalent Revit Structure slab sections will be automatically created and mapped. All wall geometry. Equivalent Revit Structure deck sections will be automatically created and mapped. Only deck width parameter will be created. offsets and cardinal points all created in Revit Structure. Will be loaded if not already loaded. Will be mapped to equivalent Revit Structure sections. otherwise material will be created in Revit but their parameters will not be updated. Equivalent Revit Structure wall sections will be automatically created and mapped with corresponding material property. Equivalent Revit Structure sections will be automatically created and mapped.

rfa Concrete-Square-Column. Columns ETABS Rectangular Square Circular Beams and Braces ETABS Rectangular L T Revit Family Concrete-Rectangular-Column. See corresponding table below for mapping of ETABS sections to Revit families. it may help if you have the various Revit Structure sections already loaded before you import your ETABS model into Revit Structure.rfa 23 . then you can set the mapping at the time of import. If CSiXRevit cannot easily map the names.Line Loads Area Loads Load Cases Load Combos Equivalent Revit Structure point line loads and trapezoidal line loads will be created.rfa Precast-L Shaped Beam. Note 1 – To facilitate in the mapping of concrete sections. If you would like CSiXRevit to be able to create equivalent Revit members of families you must load at least one member of the family for CSiXRevit prior to import.rfa Precast-Single Tee.rfa Concrete-Round-Column.rfa Revit Family Concrete-Rectangular Beam.

Will be loaded if not already loaded. Walls Wall Properties Floors Slabs Properties Deck Properties Footings Point Loads Line Loads Area Loads Load Cases Load Combos 24 . Equivalent Revit Structure wall sections will be automatically created and mapped with corresponding material property. material definition will not have any parameters associated with it. Joint restraints will be created in Revit Structure. Equivalent Revit Structure deck sections will be automatically created and mapped. Equivalent Revit Structure sections will be automatically created and mapped. Only deck width parameter will be created. offsets and cardinal points all created in Revit Structure.Importing from ETABS to Update an Existing Revit Structure Model The chart below specifies details about data that is transferred from ETABS into Revit Structure when updating an existing Revit Structure model. and openings will be created in Revit Structure. All wall geometry. Equivalent Revit Structure slab sections will be automatically created and mapped. Geometry. end releases. Equivalent Revit Structure point line loads and trapezoidal line loads will be created. However. See NOTE 1 at end of previous section. Action Creation of… Model Element Grids Materials Frames Frame Sections Steel Sections Concrete Sections Supported Notes Material is created. Will be mapped to equivalent Revit Structure sections. All floors and openings in floors will be automatically created and mapped.

you are given the choice to bring the floor back as a single element or as the meshed elements in ETABS. Beam. end releases. Changes in wall thickness will be updated. If you would like to bring changes in parameters back to Revit from ETABS create a new section with the desired parameters in ETABS and assign the new section to the frame. Frame Sections Steel Sections Concrete Sections Walls Wall Properties Floors Slabs Properties Deck Properties 25 . Changes in floor geometry will only be updated if the floor was not meshed when brought into ETABS and a 1:1 ratio between Revit Structure floor and ETABS floor exists. you are given the choice to bring the wall back as a single element or as the meshed elements in ETABS. Changes in deck material will not be updated. If floors were meshed in ETABS. Column and Brace section assignments will be updated. If walls were meshed in ETABS. Changes in slab thickness will be updated. If coordinate geometry is changed in ETABS. Changes in deck thickness will be updated. Beam. Changes in wall geometry will only be updated if the wall was not meshed when brought into ETABS and a 1:1 ratio between Revit Structure wall and ETABS wall exists. Changes in wall material will not be updated. If frames were meshed in ETABS. however section parameters themselves will not be updated. it will delete the geometry in Revit Structure and create a new frame with new geometry. offsets and cardinal points all created in Revit Structure. you are given the choice to bring the frame back as a single element or as the meshed elements in ETABS.Updating of… Grids Materials Frames Steel and Concrete materials are being updated Geometry. Column and Brace section assignments will be updated. Changes in slab material will not be updated.

If you use “selection only” update feature.Point Loads Line Loads Area Loads Load Combos Updating of existing load combination equations is not supported. deletion of items is not supported. Deleting of… Grids Frames Walls Floors Point Loads Line Loads Area Loads Load Cases Load Combos IMPORTANT NOTE: Deletion of elements when updating a model will only work if you are sending the ENTIRE model. Workaround is to create new Combo and import. 26 .

The current file name is listed.Procedures Exporting from Revit Structure to Create/Update a New/Existing ETABS Model IMPORTANT NOTE: CSiXRevit only exports the analytical model of Revit Structure. The Send Model to CSI Software dialog box will look as follows: 27 . If you would like to update an existing ETABS model. The following steps describe how to send your Revit Structure analytical model to ETABS: 1. from the Revit Structure menu select. All connectivity must be ensured in the Revit Structure analytical model before exporting to ETABS to ensure connectivity. 2. If you would like to create a new ETABS model. Tools>External Tools>Export to Update Existing ETABS Model. Click the Start button. and the objects in the model are counted. from the Revit Structure menu select. Tools>External Tools>Export to Create New ETABS Model.

Once you have made your selections.EXR. The file will be given the extension. 28 . select the elements that you would like to send to ETABS. click OK and your will be asked to create a file name. . Once you click OK. you will get the Export Options dialog box shown below. From the box below. 3.If you are only interested in sending selected objects only. please make sure that the check box at the bottom of the dialog box is checked.

5.EXR file. Now go open a session of ETABS.EXR file you would like to import. 6. and then select your . If you would like to create a new ETABS model from your Revit Structure model. By default ETABS it will create a new model based on your . You will then see the screen below: 29 . please open the ETABS model that you would like to update. File>Import>Revit Structure .exr file. If you would like to update an existing ETABS model. From the menu select.4. you should not have any other model open.

7. The bottom section of the box is general controls that ETABS will use when importing the Revit Structure model. Level data can be edited once the model is brought into ETABS. The units selected here will be used as the default units of the ETABS model.The top section of this dialog box is where you can see and organize how all of your Revit Structure elements get mapped to ETABS elements. To see the various Levels that were brought in from Revit Structure click the Show button. Level data is not editable at this stage. You can fix these problems by clicking the “Edit” button next to element. The length tolerance is the tolerance that will be used by ETABS to create connectivity when created the finite element model for analysis. Below is a screen shot of all of the levels imported in this model: 30 . Any property that might have a default value or zero value will show up as a warning in the dialogue box. The ETABS import gives you the opportunity to fix those problems parametrically before your ETABS model is created. Sometimes certain values in Revit were not defined. The Minimum Curve length and Angle are controls given to the user so they can control how a curve gets broken up into straight line segments.

The Material Mapping dialogue will be shown: 31 .8. To see the Revit Structure material properties that were imported. please select the “Edit” button next to “Total Materials”.

there are only 2 Materials that were brought in. An ETABS material will be created with the same name as the Revit Structure material name. The Material Mapping Details box below will then be shown: 32 . A combo box will appear with all of the existing ETABS materials currently in ETABS model. you can do so by clicking on the ETABS material name. If you would like to create a new material property to map your Revit Structure material to. The ETABS Add Material dialogue box will appear. If you would like to map the Revit Structure Material to something other than the ETABS material that has been created. To see the mapping of material parameters select the Material property and click “Edit”. please click “Add”.In this model.

The Frame Section Mapping box will be shown: 33 .On the left hand side you can see all of the properties of the Revit Structure material. and you will see the change reflected on the ETABS material property on the right hand side. 9. On the right hand side you can see how they have been mapped to an ETABS material. To see the Revit Structure Frame Sections that were imported. You can see the units in the Revit Database Units by clicking the check box at the bottom. You can change any of the parameters in the Revit Structure material. please select the “Edit” button next to “Total Frame Sections”.

When ETABS imports the Revit Structure data. If you click on any row on that column. and the Revit Structure Material. If there is a section that you do not see there that you would like to add to list. and the final column tells you how the section was mapped or created. it first tries to match the Revit Structure section name to an ETABS Section name. The fourth column is the ETABS section that the Revit Structure Section was mapped to. you can do so by clicking the “Add” button the right hand side. If you would like specify which ETABS database it searches you can do so by clicking the “.Pro Files dialogue box will be shown: 34 . it will then search all of the ETABS database .Pro Files” button on the right hand side. the Revit Structure Section Family Name. It will map it to the first section name that matches.The first three columns show the Revit Structure section name. I it cannot find it there. It will do so by first searching through the loaded ETABS database sections. The . you will see that a combo box will drop down that includes all of the section properties that are currently loaded in the current ETABS model. The only column that is editable is the ETABS Section column.Pro files.

You can add or remove a profile from the ETABS search by checking or unchecking its checkbox in the list. If would like to change the order in which ETABS searches the . If you would like to save the mapping that you have created.Pro File button”. But for most concrete sections will create the sections parametrically. If ETABS cannot create a section mapping by name. 35 . If you would like to add a new .Pro files from the ETABS installation directory will be selected by default.Pro files. To see how Revit Sections properties are mapped. you can export the mapping file by clicking the “Export Mapping File” button.Pro file.All of the . Similar to the Material Mapping. Likewise.Pro Files up and down in the list. you can edit details about the Frame section details mapping by selecting the row. and clicking the “Edit” button. if you would like to import a mapping file that you have created in the past. it will then try to create the section parametrically. you can do so by moving the . you can do so by clicking the “Import Mapping File” button. please see the section under “Supported Workflows” called “Exporting from Revit Structure to create a new ETABS model”. you can do so by clicking on the “Add . For most steel sections ETABS will be able to find a match.

To see the Revit Structure Floor Sections that were imported. By default an equivalent ETABS floor section will be created and mapped. the new ETABS floor section will appear in the drop down box. After adding the deck or slab. please select the “Edit” button next to “Total Floor Sections”. you can select the ETABS floor section that the Revit Structure Floor gets mapped to. To see the Floor Section Mapping details. You will then see the Floor Section Mapping Details box below: 36 .10. click on the row that you are interested in and then click the Edit button. The Floor Section Mapping box will be shown: Similar to other section mapping. If you would like to create a new deck or slab section you can do so by using the buttons on the right hand side.

Revit Structure decks and slabs can have many layers. please select the “Edit” button next to “Total Floor Sections”. If any field has a zero value.If you would like to change any of the data in the fields. you can do so here. 11. you can edit them on the left hand side and see how the data is mapped. To see the Revit Structure Floor Sections that were imported. we highlight it in red to make sure you check it. If you need to make changes to the mapping. The Floor Section Mapping box will be shown: 37 . ETABS does it best at mapping the parameters.

By default an equivalent ETABS wall section will be created and mapped. the new ETABS floor section will appear in the drop down box. You will then see the Wall Section Mapping Details box below: 38 . To see the Wall Section Mapping details.Similar to other section mapping. After adding the wall. you can select the ETABS wall section that the Revit Structure Wall gets mapped to. click on the row that you are interested in and then click the Edit button. If you would like to create a wall section you can do so by using the buttons on the right hand side.

from the Revit Data Overview/Controls box. you can edit them on the left hand side and see how the data is mapped. you can do so here.If you would like to change any of the data in the fields. If any field has a zero value. we highlight it in red to make sure you check it. 39 . Once you are satisfied with the way you have set up the mapping parameters. If you need to make changes to the mapping. 12. select the OK button and your ETABS model will be created. ETABS does it best at mapping the parameters. Revit Structure walls can have many layers.

4. please first open a Revit Structure template that you would like to import your ETABS model into. Please select either to create a new or update an existing model. and only would like to send those selections. Select the File > Export > Revit . 3. 2. To create a shared parameter file in Revit Structure 2009/2010/2011.Importing from ETABS to Create/Update a New/Existing Revit Structure Model IMPORTANT NOTE: Before importing any . Once you have edited.EXR File… within ETABS to display the Export File For Revit dialog box shown below. Now go open up a session of Revit Structure.EXR file into Revit Structure please be sure that you have a Shared Parameter file defined in Revit Structure. CSiXRevit uses the Shared Parameter file as a place to store pertinent data. You just need to create a blank shared parameter file so CSiXRevit has a place to write data to. save the ETABS file by selecting the File > Save…. If you have selected parts of the model. analyzed and designed your structure in ETABS. It isn’t necessarily required. If you would like to create a new Revit Structure model from your ETABS model. The following steps describe how to export your ETABS analytical model to create or update a Revit Structure model: 1. go to File>Shared Parameters. please check the box accordingly below. but the import will come in much 40 .

brace. 41 . From the menu select. please first open your Revit Structure model that you would like to update. Under “Mapping Options”. deck. slab and wall families that you would like ETABS sections to map its sections to prior to importing. 5. Tools>External Tools>Import to Create New Revit Structure Model from ETABS.EXR file that you would like to import. column. Tools>External Tools>Import to Update Existing Revit Structure Model from ETABS. From the Revit Structure menu select. Select the .EXR file. you can control exactly what ETABS elements you would like to import into your Revit Structure model.cleaner if you load all of the beam. the following screen will be displayed: On left hand side. If you have new sections that you defined in ETABS the import will come in much cleaner if you load all of the beam. slab and wall families that you would like ETABS sections to map its sections to prior to importing. column. after you have selected your . CSiXRevit will then try to load families that are not already loaded. Select the . If you would like to update an existing Revit Structure model. if you click the “Frame Sections” button. deck. Whether you are created a new Revit Structure model or updating an existing Revit Structure mode. You will see the Frame Section Mapping dialog box.EXR file that you would like to import. brace.

This dialog box gives you the opportunity to make any changes to the mapping of ETABS sections to Revit Structure sections. All of the Revit Structure column beam and brace families that are currently loaded will show up in drop down boxes. Similarly if you click the “Floor Sections” button. you will see the “Floor Section Mapping” dialogue box below: 42 .

This dialog box gives you the opportunity to make any changes to the mapping of ETABS floor sections to Revit Structure sections. All of the Revit Structure floor families that are currently loaded will show up in drop down boxes. you will see the “Wall Section Mapping” dialogue box below: 43 . if you click the “Wall Sections” button. Similarly.

there will be instances in which the 1:1 mapping of Revit Structure elements to ETABS elements will be lost because elements in ETABS were meshed. When it is designed. and have CSiXRevit create new instances which were meshed in ETABS. For this situation the user has two options: 1. All of the Revit Structure wall families that are currently loaded will show up in drop down boxes. When updating a Revit Structure model from an ETABS model. if we have a column in Revit Structure that runs from the ground floor to the top floor as one single element.This dialog box gives you the opportunity to make any changes to the mapping of ETABS wall sections to Revit Structure sections. that column will be broken at every floor level. 2. When this column (that is now meshed in ETABS) is being imported back into Revit Structure. the user has the option to 1) delete the original and have CSiXRevit create column with the varying sections or to 2) select one of the frame sections 44 . In the case of option #2. To keep the existing elements as they were and use object mapping to guide the import. For example. it might have different sections assigned to each segment of the column. when it is imported into ETABS. there can be situations in which the user has to make some decisions. To delete the existing Revit Structure Elements.

The “Object Mapping” dialog box below will then appear: In the Revit Structure model. the user has the option to choose which section they would like to assign to the entire length of the column. Column ID (186711) spans 5 floors. The same methodologies can be applied to meshed beams. select the “OK” button and your ETABS model will be imported. braces. but in ETABS. 45 . Once you have set up all of your mapping. it was meshed into 5 pieces. When coming back into Revit Structure. They can do this by selecting deselecting the corresponding checkbox on the right hand side of the dialog box and then clicking the “Objects” button under Mapping Options.for the entire length of that column. floors and walls.

46 . The first few lines of the . a file with the extension . should be checked each time an exchange of data is performed.log file also lists the build numbers for CSiXRevit and Revit Structure.Reviewing the Log File (. This file will list any errors or omissions encountered when generating the EXR file. and therefore.log) Every time a model is sent from Revit Structure to ETABS or from ETABS to Revit Structure. The .log is created.log file will have the following format (the actual data may be different): CSiXRevit Revit API Build = 20100326_1700 Current Revit Version = 2011 Current Revit Build = 20100326_1700 It is the “Build =” numbers that should be the same – having the same Version numbers but different Build numbers does not guarantee data consistency. which should be identical to ensure that no misinterpretation of data occurs.

Set(Int32 value) at CSiXRevit.Unable to set the releases for the member. Warning (1) .modImportAndExport. FamilyInstance& Element) 3.Known Limitations 1. Windows Vista: Users must run as administrator (ETABS. If Revit is not run as administrator then there is a possibility that CSiXRevit will not able to open .exe).Revit. If the user updates the material property of a wall. Directly sending data to ETABS may not work if Revit is not run as administrator. 47 . 5. Revit Structure floors which are grouped together may be treated as openings while importing model into ETABS. Also openings which are not inside any wall or floor cannot be imported into Revit. While importing ETABS model as new Revit model. In this case. It is recommended to break the openings if it is not completely inside the wall or floor before importing. 2.Parameter. deck or slab property in ETABS and then bring it back to Revit. This is because sometimes the end releases in Revit Structure are marked as Read-only. Workaround is to create a new wall. Source = RevitAPI Message = Operation is not valid due to the current state of the object.UpdateOneFrameEndReleases(rvtLines OneLine. that change will not be brought back into Revit Structure. will be imported. 6. Sometimes updates to cardinal points in ETABS are not updated in Revit because the z-justification and offset parameters are Read-only.log file. deck or slab in ETABS.. Stack trace = at Autodesk. 4. ETABSIO and Revit. CSiXRevit will not able to write any warning in the log file and all warning messages will be displayed on the screen time to time. Sometimes updates to end release conditions in ETABS are not updated in Revit. only those openings which lie completely within a wall or floor.

8.PRO files are present in ETABS folder.7. Import of European and Chinese steel sections from Revit to ETABS are possible if their corresponding . 48 . It is recommended to avoid double byte characters for Revit Structure Families for entities attached with analytical model. ETABS will not support double byte characters in definition of frame and shell sections.

Sign up to vote on this title
UsefulNot useful