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

ISO ETA062609M19  Berkeley, California, USA 

   

Version 9  June 2009 

 

Copyright 
Copyright  Computers and Structures, Inc., 1978‐2009  All rights reserved.    The CSI Logo® and ETABS2000® are registered trademarks of Computers and Structures, Inc. Watch &  LearnTM is a trademark of Computers and Structures, Inc. Revit® is is a registered trademark of Autodesk.   

The computer program SAP2000® and all associated documentation are proprietary and  copyrighted products. Worldwide rights of ownership rest with Computers and Structures, Inc.  Unlicensed use of these programs or reproduction of 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) 649‐2299  e‐mail: info@csiberkeley.com (for general questions)  e‐mail: support@csiberkeley.com (for technical support 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 and ETABS V9.6.0, 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.

                                                  Revit® Structure 2009 

    

ETABS® 

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

                                                                    

                                 

4

          Equivalent ETABS sections will be  automatically created and mapped with _f  appended to the floor section name.          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. All columns  will be automatically broken at story levels.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.     Equivalent ETABS sections will be  automatically created and mapped with _f  appended to the floor section name.      Geometry. cardinal points. transferred to ETABS. offsets.    Model Element  Action     Creation of…  Grids    Materials    Frames        Concrete Sections    Walls    Wall Properties      Supported Notes                Equivalent ETABS materials will be  automatically created in ETABS. and end  releases.     Joint restraint will be created in ETABS  wherever a footing occurs in Revit                               All families that are loaded in ETABS will be  made into Auto‐Select Lists in ETABS  Frame Sections  Steel Sections  Floors  Slabs Properties    Deck Properties    Footings                Point Loads  Line Loads  Area Loads  Load Cases  Load Combos  ETABS Auto Select Lists  5 .

 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. If any of the remaining two is  zero then it will be filled with the first non‐zero value. ETABS breaks it into number of segments to get the  suitable curvature. these three  values (for 3 different directions) cannot be zero in ETABS.Grids  The following Grid attributes are being created in ETABS:   Grid Name: Same grid name will be used in the ETABS grid bubble. If first value is  zero then ETABS default value will be used. In ETABS units of weight is being calculated by dividing the unit weight to  gravitational constant (g). If any of the remaining two is zero then it will be filled  with the first non‐zero value. These three values (for 3 different  directions) cannot be zero in ETABS.  6 . If  first value is zero then ETABS default value will be used.  These three values (for 3 different directions) cannot be zero in ETABS. Unit weight cannot be zero in ETABS.    Damping Ratio: This value is not in used in current version of ETABS. In case of orthotropic material.   Curved Grid: In case of curved grid.   Grid Points: The start and end points are used to define the general grid line in ETABS. 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). If Revit material is defined as Isotropic then ETABS will calculate this value on the  basis of Young’s Modulus and Poisson Ratio. If first value is zero then  ETABS default value will be used. Steel and others   Young’s Modulus: Revit Youngs’s modulus is used to fill the ETABS material Young’s  modulus (E).     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. 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). 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).    Thermal Expansion Coefficient: Revit thermal expansion coefficient is used to fill the  ETABS material thermal expansion coefficient (Alpha). If any of the remaining two is zero then it will be filled with the first non‐zero  value. If first value is zero then ETABS default value will be  used. These three values (for 3 different directions) cannot be zero in ETABS.

    ETABS always give the warning and writes .  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’.            Only those materials which are linked with the floor or frame in the Revit model are  imported into ETABS.  Resistance Calculation Strength: Revit Resistance Calculation strength is used to fill the  ETABS material f’c factor.    Frames  Bending Reinforcement: Revit bending reinforcement is used to fill ETABS material (if  type is concrete) main reinforcement ‘Fy’. Default value will be used if it is defined as zero in Revit.  Shear Reinforcement: Revit shear reinforcement is used to fill ETABS material (if type is  concrete) shear reinforcement ‘Fy’.  Lightweight: Revit lightweight tag is used to identify the lightweight concrete material in  ETABS.  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. Default value will be used if it is defined as Zero in  Revit. Default value will be used if it is defined as zero in Revit. User has control over how the curve is  broken up by defining the minimum length and minimum angle size. ETABS converts the Revit family to ETABS auto selection list. Default value will be used if it is defined as zero in Revit.  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. ETABS will always fix them at the both ends  7 . If the frame is a column. All curves in Revit frame  will be converted in to number of segments.  Steel Reduction Factor: This value is not in used in current version of ETABS.   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’.wrn file in case of using any default value while  importing the materials from Revit.   Frame Curves: ETABS does not support curved frame objects. Default value will be used if it is defined zero  in Revit.

   Beam Insertion point: In Revit.except for the bottom end of base story. the ETABS will try to create  these sections parametrically. Column offsets are exported  into ETABS from Revit if rigid link is being used for either column end.   Column Insertion Point and End Offset: The default cardinal point for columns (mid  center) is chosen when we bring model from Revit to ETABS. To see  the effect of rigid offset in ETABS.  If these parameters are not defined then default cardinal point (Top Center) is choosen.    ETABS follow mapping of sections in following steps:  8 . beams or brace end torsion cannot be released. If it is not found in the existing database.    Frame Sections  Mapping of Revit frame section attributes depend upon the type. view the model in extruded view. This is being done to ensure structure stability.    ETABS first tries to find the name of the section from it database. then both of these parameters are  defined as 0 in the above equations.   Orientation Angle: Same angle is used for defining the line orientation along with its local  1‐axis in ETABS.   Rigid Link: It is being imported and used to define the end offsets in the ETABS. 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.   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. Most steel sections can be  mapped automatically.  Similarly.

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

 some special characters for inch  and feet representation will be changes to ‘in’ or ‘ft’ as shown in fig 3.PRO  files then ETABS check if it is a Revit Structure parametric section.    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 .      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. However. In case that it is a  parametric section ETABS will create an equivalent setion and use the same Revit  Structure family caption  the section name.

 the user can fix the mapping by  using the use ‘Add.PRO file which  is not in the .    5) The user has the option to save a mapping file such that user defined mapping can be  reused on subsequent imports. However. due  to prefix/suffix incompatibility.. 2 ETABS initially maps ‘RHS150x100x5’ to the ETABS  default section property (shown in red color). A sample mapping file is shown in fig 4.PRO file sections. For Revit Structure families with ‘Universal Columns’ or  ‘Universal Beams’ category ETABS handles this by changing suffix to prefix while import. In Fig.     11 .PRO file list.’ button to map that Revit Family section to an appropriate ETABS  section.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 .

 SX. DEPTH  H1. SY. D. SY. SLAB DEPTH. A  B.  DEPTH  B. IY. A  B. SY. A  B. SX. SEAT  H1. SY. SX. D. A  B.  The parameters list is given for concrete and wood structural families in the following table. H  B. IY. IY. SX. TEE WIDTH. H  WIDTH. SX. IX. A  B. H CHAMFER  WIDTH. IX. H  B  B  B. STEM  WIDTH. SX. D. IX. SY.    Member Type  CONCRETE  COLUMNS        CONCRETE  FRAMING          WOOD  COLUMNS          WOOD  FRAMING              DIMENSION LUMBER‐ COLUMN  GLULAM‐SOUTHERN PINE‐ COLUMN  GLULAM‐WESTERN SPECIES‐ COLUMN  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  Family Name  CONCRETE‐RECTANGULAR‐ COLUMN  CONCRETE‐ROUND‐COLUMN  CONCRETE‐SQUARE‐ COLUMN  PRECAST‐RECTANGULAR  COLUMN  PRECAST‐DOUBLE TEE  Parameters  B. IY. H  PRECAST‐INVERTED TEE  PRECAST‐L SHAPED BEAM  PRECAST‐RECTANGULAR  BEAM  PRECAST‐SINGLE TEE    12 . H. IY. D. SY. D. IX. B. D. SY. SY. D. IY. SX. IY. SY. SLAB  DEPTH. IX. IX. SX. SX. H. IX. A  B. IX. IY. A  B. IX. A  B. SEAT  B. IX. SY. A  B. IY.  STEM WIDTH. B. SX. D. IY. A  B. D. D.

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

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

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

 All  curves in this opening will be converted into number of segments.    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 ‐ THICKNESS       Layer Materials: ETABS gets the material of each layer.In this example. Same layer will be used to define material of ETABS deck section. 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.  Floor Span Direction: Same span direction will be used in ETABS for the decks.  Ramp: All 4 noded inclined slabs are imported as ramp elements in ETABS. A default  direction will be used if no span direction is defined in Revit. Same layer will be assigned to the  Slab or Deck section.   16 . which will give the  suitable curvature for the area boundary. 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.   Floor Opening (Regular or Irregular): Openings defined in Revit by  “Modeling>Opening>Vertical Opening” are being imported in ETABS from Revit.

   Wall Openings: These are imported as openings in walls (vertical planes). In  ETABS.   Fx.   Location: Used to define the point of application of the load. 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. width. Length and Thickness: For rectangular cases. for details  please check openings in walls. Mz: All forces and moments are applied in global direction in Revit  and transferred in the similar manner to ETABS.   Start and End point Location: Is used to define the start and end point of the line load. ETABS locates the all columns within the rectangular area  and these columns will be restrained      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. My. the Shaft Opening is defined as a 3D shaft having upper and lower limits (or offset  elevations from upper and lower story levels).    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. for  details please check Shaft Opening. will be restrained. which are located in this area.   Width. In ETABS all  columns.   Shaft Openings: These are imported as openings in floors (horizontal planes). Fy. In case of a lateral line  17 . In this case. length and thickness are  being defined.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. Mx.     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.    Shafts  In Revit. In ETABS the shaft is imported as horizontal  openings in all stories level which lies between the upper and lower limits of 3D Shaft. Fz.

 The non‐uniform surface load is not supported in ETABS. ETABS will convert it in to equivalent uniform  area load. LoadZ: All loads are applied in global direction in Revit and transferred in  the similar manner to ETABS. In  case of Revit non‐uniform surface load.  it will not be processed in the ETABS analysis. It should be noted  that each curve is used as straight line in ETABS.   LoadX.  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.    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.   Points: Points will be used to define the geometry of the loading area. Otherwise. users must check that no line load should overlap more than one beam. Mx.   Load Case Category: It is used to define the load case type in ETABS. Fy.  Fx. The mapping is  shown in the following table:        Revit Structure Load  Case Category  Dead  Live  Wind  Snow  Roof Live  Accidental  Temperature  Seismic        Load Combos  ETABS Load Case Type  Dead  Live  Wind  Snow  Live  Other  Other  Quake  18 . My.   load. Mz: All forces and moments are applied in global direction in Revit  and transferred in the similar manner to ETABS. Fz. LoadY.

  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.  19 .    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 load combination attributes are being imported from Revit to ETABS:   Load Combination Name: The same name will be used for ETABS Load Combination  Name. The following names are reserved and Load Combinations will not be added in  ETABS if same name is used in Revit.   Load Case Factor: The same load case factors will be used for the corresponding load  cases in the ETABS load combination.

       Concrete Sections  Equivalent ETABS sections will be automatically  created and mapped. transferred to ETABS. offsets. All columns will  be automatically broken at story levels.      Geometry. All columns will be  20 . cardinal points.       Walls  Walls will be automatically meshed at window  and door openings.      Model Element  Action     Creation of…  Grids    Materials    Frames  Supported Notes                Equivalent ETABS materials will be automatically  created in ETABS.  Materials    X  All material parameters will updated.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. and end    X  releases.       Wall Properties  Equivalent ETABS sections will be automatically  created and mapped.       Footings  Joint restraints will be created in ETABS  wherever a footing occurs in Revit.    Frame Sections            Will be automatically mapped to ETABS database  Steel Sections  sections.    Floors            Slabs Properties  Equivalent ETABS sections will be automatically  created and mapped. offsets.       Deck Properties  Equivalent ETABS sections will be automatically  created and mapped.    Point Loads         Line Loads         Area Loads         Load Cases         Load Combos            Updating of…       Grids       Coming soon. and end  releases. updated in ETABS.  Frames  Geometry. cardinal points.

    21 .  Floor geometry will be updated accordingly.  Wall section parameters will be updated.                             Deleting of…                    Frame Sections  Steel Sections  Concrete Sections  Walls  Wall Properties  Floors  Slabs Properties  Deck Properties  Point Loads  Line Loads  Area Loads  Load Cases  Load Combos     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. 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. If you use “selection only” update feature.  Slab section parameters will be updated.  Slab section parameters will be updated.    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.  Point load values will be updated accordingly.    Coming soon.automatically broken at story levels.

    Frames        Concrete Sections    Walls    Wall Properties    Floors    Slabs Properties     Deck Properties                 Frame Sections  Steel Sections                Geometry.  Equivalent Revit Structure deck sections will be  automatically created and mapped.  Action  Creation of…    Model Element     Grids  Materials  Supported    Coming soon.  Equivalent Revit Structure sections will be  automatically created and mapped.   See NOTE 1 below.  Joint restraints will be created in Revit  Structure.      Footings      Point Loads           22 . Only deck  width parameter will be created.  All floors and openings in floors will be  automatically created and mapped.  All wall geometry. Will be loaded if not already loaded. It’s the only  parameter that Revit Structure API allows us to  update.    Will be mapped to equivalent Revit Structure  sections.  Equivalent Revit Structure slab sections will be  automatically created and mapped. and openings will be created  in Revit Structure.       Notes     Concrete and Steel materials are being  imported from ETABS to Revit.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. The only  limitation is Revit model should have one  default concrete and one default steel  material for duplication. offsets and cardinal  points all created in Revit Structure. end releases.  Equivalent Revit Structure wall sections will be  automatically created and mapped with  corresponding material property. otherwise material  will be created in Revit but their parameters  will not be updated.

rfa  Precast‐Single Tee. If CSIxRevit cannot easily map the names.rfa  Circular  Concrete‐Round‐Column.    Columns  ETABS  Revit Family  Rectangular  Concrete‐Rectangular‐Column.rfa  Square  Concrete‐Square‐Column. 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    Beams and Braces  ETABS  Rectangular  L  T        Revit Family  Concrete‐Rectangular Beam. See corresponding  table below for mapping of ETABS sections to Revit families.Line Loads          Area Loads  Load Cases  Load Combos              Equivalent Revit Structure point line loads and  trapezoidal line loads will be created.            Note 1 – To facilitate in the mapping of concrete sections.rfa  Precast‐L Shaped Beam.rfa  23 . it may help if you have the various  Revit Structure sections already loaded before you import your ETABS model into Revit  Structure. then you can set the mapping at the time of  import.

 It’s the only  parameter that Revit Structure API allows us to     update. offsets and cardinal  points all created in Revit Structure. and openings will be created in     Revit Structure.                      Frames        Concrete Sections    Walls    Wall Properties    Floors    Slabs Properties    Deck Properties  Frame Sections  Steel Sections                Footings  Point Loads  Line Loads  Area Loads  Load Cases  Load Combos  24 .          Will be mapped to equivalent Revit Structure  sections.  You will see the material definition without any  parameters associated with it. Will be loaded if not already loaded.          Equivalent Revit Structure point line loads and  trapezoidal line loads will be created.     Geometry.  Equivalent Revit Structure slab sections will be  automatically created and mapped.     All wall geometry.  Equivalent Revit Structure wall sections will be  automatically created and mapped with     corresponding material property. end releases.     Equivalent Revit Structure deck sections will be  automatically created and mapped.     Material is created but Revit Structure API  doesn’t allow updating of creating of parameters. Only deck  width parameter will be created.  Joint restraints will be created in Revit Structure.   See NOTE 1 at end of previous section.    Action  Creation of…    Model Element     Grids  Materials  Supported Notes        Coming soon.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.     Equivalent Revit Structure sections will be  automatically created and mapped.  All floors and openings in floors will be     automatically created and mapped.

 you are given the choice to bring the  wall back as a single element or as the meshed  elements in ETABS.  Changes in deck thickness will be updated.Updating of…     Grids    Materials    Frames              Coming soon. it will delete the  geometry in Revit Structure and create a new  frame with new geometry.  Changes in wall thickness will be updated. offsets and cardinal  points all created in Revit Structure. Column and Brace section assignments  will be updated.  Changes in slab thickness will be updated.   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. If frames were  meshed in ETABS.  Changes in slab material will not be updated. however section parameters  themselves will not 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.  Changes in wall material will not be updated. If floors were  meshed in ETABS.   Beam.    Beam. end releases. Column and Brace section assignments will  be updated. If coordinate  geometry is changed in ETABS.        Frame Sections  Steel Sections  Concrete Sections             Walls       Wall Properties    Floors          Slabs Properties    Deck Properties             25 .  Changes in deck material will not be updated. you are given the choice to  bring the floor back as a single element or as the  meshed elements in ETABS. you are given the choice to  bring the frame back as a single element or as the  meshed elements in ETABS. If walls were meshed  in ETABS.  Steel and Concrete materials are being updated  Geometry.  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.

     Coming soon. Workaround is to create  new Combo and import.                    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.      Point Loads  Line Loads  Area Loads  Load Combos                 Revit API doesn’t allow updating of existing load  combination equations. deletion of items is not  supported. If you use “selection only” update feature.      26 .

 from the Revit Structure  menu select. and the objects in the  model are counted. Tools>External Tools>Export to Update Existing ETABS Model.  If you would like to update an existing ETABS model. All  connectivity must be ensured in the Revit Structure analytical model before exporting to ETABS  to ensure connectivity. from the Revit Structure menu  select. Click the Start button. Tools>External Tools>Export to Create New ETABS Model. The Send Model to CSI Software dialog box will look as  follows:    27 . 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 following steps describe how to send your Revit Structure analytical model to ETABS:    1.    2. If you would like to create a new ETABS model.

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

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

 Level data is not editable at this stage. Below is a screen shot of all of the levels  imported in this model:    30 .    The bottom section of the box is general controls that ETABS will use when  importing the Revit Structure model. Sometimes certain values in Revit were not defined. You can fix these problems by clicking the  “Edit” button next to element. 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.    Any property that might have a default value or zero value will show up as a  warning in the dialogue box. To see the various Levels that were brought in from Revit Structure click the  Show button. The length tolerance is the tolerance that will  be used by ETABS to create connectivity when created the finite element model  for analysis.    7. 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 ETABS import gives you the opportunity to fix those problems parametrically  before your ETABS model is created.

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

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

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

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

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

 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. the new ETABS floor section will appear in the drop  down box. The Floor Section Mapping box will  be shown:        Similar to other section mapping. you can select the ETABS floor section that the  Revit Structure Floor gets mapped to. After  adding the deck or slab. click on the row that you are interested  in and then click the Edit button.10. By default an equivalent ETABS floor  section will be created and mapped.  To see the Revit Structure Floor Sections that were imported. You will then see the Floor Section Mapping  Details box below:    36 .    To see the Floor Section Mapping details. please select the  “Edit” button next to “Total Floor Sections”.

 If any field has a zero value. 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. you can do so here.    11. Revit Structure decks and slabs  can have many layers. ETABS does it best at mapping the parameters. please select the  “Edit” button next to “Total Floor Sections”. If you need  to make changes to the mapping. The Floor Section Mapping box will  be shown:    37 .    If you would like to change any of the data in the fields.  we highlight it in red to make sure you check it.

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

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

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

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

 you will see the “Floor Section  Mapping” dialogue box below:    42 .    Similarly if you click the “Floor Sections” button.    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.

 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 .    Similarly.    This dialog box gives you the opportunity to make any changes to the mapping of  ETABS floor sections to Revit Structure sections. if you click the “Wall Sections” button.

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

 floors and walls. 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.  45 . 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. select the “OK” button and your ETABS  model will be imported. it  was meshed into 5 pieces. The “Object  Mapping” dialog box below will then appear:        In the Revit Structure model. When coming back into Revit Structure. The same methodologies can be applied to meshed beams.  braces.frame sections for the entire length of that column. but in ETABS.    Once you have set up all of your mapping.

log is created. This file will list any errors or  omissions encountered when generating the EXR file. a file with the extension . The first few lines of the .    Reviewing the Log File (. The . which should be identical to ensure that no  misinterpretation of data occurs.log)   Every time a model is sent from Revit Structure to ETABS or from ETABS to Revit  Structure.log file also lists the build numbers for  CSIxRevit2009 and Revit Structure.log file will have the following  format (the actual data may be different):    CSixRevit2009 Revit API Build = 20070810_1700  Current Revit Version = 2009  Current Revit Build = 20070810_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. and therefore.  46 . should be checked  each time an exchange of data is performed.

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

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

Sign up to vote on this title
UsefulNot useful