RISA-Revit Link User's Manual
RISA-Revit Link User's Manual
RISA-Revit Link User's Manual
User's Manual
Copyright 2014 by RISA Technologies, LLC All rights reserved. No portion of the contents of
this publication may be reproduced or transmitted in any means without the express written
permission of RISA Technologies, LLC.
We have done our best to ensure that the material found in this publication is both useful and
accurate. However, please be aware that errors may exist in this publication. RISA Technologies, LLC makes no guarantees concerning accuracy of the information found here or in
the use to which it may be put.
Table of Contents
Table of Contents
Introduction
Materials
33
Boundary Conditions
33
Loads
34
License Agreement
Shape Mapping
35
Material Mapping
36
Link Information
37
Compatibility Information
Download Links
Version Information
Workflow
35
Examples
Getting Started
10
16
RISA Parameters
21
Tagging Beams
24
Loading Tags
24
Procedure
24
Technical Support
28
29
Floors/Levels
29
Grids
29
Beams
29
Columns
31
Braces
31
Walls
32
In-Place Families
32
Footings
32
Decks/Slabs
33
Introduction
Introduction
Revit has spread the BIMconcept (Building Information Modeling) to the structural community, and RISA is in
full support of this new wave of structural design workflow. For this reason, RISATechnologies has been an
Autodesk Authorized Developer for many years. This means that the RISA developers are given full access to
Revit's behind-the-scenes code, as well as advanced alpha and beta copies of new releases. This version of the
RISA-Revit link represents an evolution of many previous versions of the link, and makes every effort to make
the transition between RISA and Revit seamless, robust, and thorough.
Revit Computer
1. Ensure that Revit is installed, and that the version matches that shown on the Version Information page.
2. Open Revit and click on the Communication Center button
. This button can be found along the top toolbar, in the upper-right corner. Ensure that no product updates are available. If product updates are listed
as available then install them.
3. Download the latest RISA-Revit Link from the RISA website:http://risa.com/partners/prt_revit.html
4. Close Revit (if it is currently open) and run the installer. Once the installation is complete you are ready
to begin using the RISA-Revit Link.
Introduction
1. Launch RISA-3D, and go to the Help menu. Click on 'Check for Update'. If an update is available then download and install it.
2. Repeat Step 1 for RISAFloor if applicable.
License Agreement
END-USER LICENSE AGREEMENT FOR RISA TECHNOLOGIES, LLC SOFTWARE
The RISA-Revit Link software product (SOFTWARE PRODUCT) includes computer software, the associated media,
any printed materials, and any electronic documentation. By installing, copying or otherwise using the
SOFTWARE PRODUCT, you agree to be bound by the terms of this agreement. If you do not agree with the terms
of this agreement RISA Technologies, LLC is unwilling to license the SOFTWARE PRODUCT to you. In such event
you must delete any installations and destroy any copies of the SOFTWARE PRODUCT and return the SOFTWARE
PRODUCT to RISA Technologies, LLC within 60 days of purchase for a full refund.
Copyright by RISA Technologies, LLC. All rights reserved. The SOFTWARE PRODUCT is protected by United
States copyright laws and various international treaties. All rights not specifically granted under this agreement
are reserved by RISA TECHNOLOGIES, LLC.
1. SOFTWARE LICENSE. The SOFTWARE PRODUCT is licensed, not sold. All right, title and interest is and remains
vested in RISA TECHNOLOGIES, LLC. You may not rent, lease, or lend the SOFTWARE PRODUCT. You are specifically granted a license to the use of this program on no more than one CPU at any given time. The Network
Version of the SOFTWARE PRODUCT is licensed for simultaneous use on a certain maximum number of network
stations that varies on a per license basis. As part of the license to use the SOFTWARE PRODUCT, the program
user acknowledges the reading, understanding and acceptance of all terms of this agreement. The SOFTWARE
PRODUCT may not be reviewed, compared or evaluated in any manner in any publication without expressed written consent of RISA Technologies, LLC. You may not disassemble, decompile, reverse engineer or modify in any
way the SOFTWARE PRODUCT. If the SOFTWARE PRODUCT was purchased at a discounted price for educational
purposes it may in no event be used for professional design purposes. The terms of this license agreement are
binding in perpetuity.
2. DISCLAIMER. We intend that the information contained in the SOFTWARE PRODUCT be accurate and reliable,
but it is entirely the responsibility of the program user to verify the accuracy and applicability of any results
obtained from the SOFTWARE PRODUCT. The SOFTWARE PRODUCT is intended for use by professional engineers
and architects who possess an understanding of structural mechanics. In no event will RISA Technologies, LLC or
its officers be liable to anyone for any damages, including any lost profits, lost savings or lost data. In no event
will RISA Technologies, LLC or its officers be liable for incidental, special, punitive or consequential damages or
professional malpractice arising out of or in connection with the usage of the SOFTWARE PRODUCT, even if RISA
Technologies, LLC or its officers have been advised of or should be aware of the possibility of such damages.
RISA TECHNOLOGIES' entire liability shall be limited to the purchase price of the SOFTWARE PRODUCT.
3. LIMITED WARRANTY. RISA Technologies, LLC warrants that the SOFTWARE PRODUCT will operate but does
not warrant that the SOFTWARE PRODUCT will operate error free or without interruption. RISA Technologies
sole obligation and your exclusive remedy under this warranty will be to receive software support from RISA
Technologies, LLC via telephone, email or fax. RISA Technologies, LLC shall only be obligated to provide support
for the most recent version of the SOFTWARE PRODUCT. If your version of the SOFTWARE PRODUCT is not the
most recent version RISA Technologies, LLC shall have no obligation to provide support in any form. Except as
Introduction
stated above the SOFTWARE PRODUCT is provided without warranty, express or implied, including without limitation the implied warranties of merchantability and fitness for a particular purpose.
4. PROTECTION DEVICE. In the event the SOFTWARE PRODUCT requires the use of a PROTECTION DEVICE to
operate, you are specifically prohibited from attempting to bypass the functionality of the PROTECTION DEVICE
by any means. A lost or stolen PROTECTION DEVICE will not be replaced by RISA Technologies, LLC.
5. TERMINATION. RISA Technologies, LLC may terminate your right to use the SOFTWARE PRODUCT if you fail to
comply with the terms and conditions of this agreement. In such event you must delete any installations and destroy any copies of the SOFTWARE PRODUCT and promptly return the SOFTWARE PRODUCT to RISA Technologies.
6. CHOICE OF LAW. By entering into this Agreement in accordance with Paragraph 1, above, you have agreed to
the exclusive jurisdiction of the State and Federal courts of the State of California, USA for resolution of any dispute you have relating to the SOFTWARE PRODUCT or related goods and services provided by RISA Technologies, LLC. All disputes therefore shall be resolved in accordance with the laws of the State of California, USA
and all parties to this Agreement expressly agree to exclusive jurisdiction within the State of California, USA. No
choice of law rules of any jurisdiction apply.
"RISA" as applied to structural engineering software is a trademark of RISA Technologies, LLC.
Version Information
Version Information
Link Information
RISA-Revit 2015 Link v2 (Version 13.1)
Compatibility Information
Product
Required Version
Revit/Revit Structure
RISA3D
RISAFloor
Download Links
Revit/Revit Structure
http://risa.com/partners/prt_revit.html
www.autodesk.com
RISA3D
Contact RISA
RISAFloor
Contact RISA
RISA-Revit Link
Workflow
Workflow
There are a variety of options for workflow between RISA and Revit. Before using the RISA-Revit Link it is best
to understand what these are, and how they can best be used for your project.
Starting in Revit
This is the most common workflow. Remember that the goal of the Revit model is to represent the physical
model as accurately as possible, whereas the goal of the RISA model is to represent the analytical model as
accurately as possible. There are many circumstances where physical arrangements are better represented in
different ways from each other.
A Revit model may have a very complex physical arrangement that can be greatly simplified for structural analysis. By starting in Revit you can model these physical complexities, and assign an analytical arrangement for
RISA to use. If you instead start in RISA, the link will create members in Revit, but it will create them with the
most basic physical geometry, since it does not know your intentions for details.
Take the detail shown below for example. On the left is the Revit representation of a column and beam. On the
right is the RISA representation. The connection details shown in Revit are necessary for construction drawings,
however in RISA a simple 'fixed' connection is sufficient to give an accurate analysis.
A proficient Revit user can assemble a structure in Revit as fast as a proficient RISAuser can assemble a structure in RISA. Therefore, especially if the architect has already started a Revit model, it may be fastest to generate a model first in Revit which uses the architect's model as a template.
Workflow
Starting in RISAFloor
This is the second most common workflow. RISAFloor and Revit are very similar in their scope, in that they are
both designed around building-type structures which have floors, roofs, and gridlines. This is as opposed to some
industrial structures which do not fit this profile. Most users who start in RISAFloor do so for the following reasons:
1. There is no Revit model from the architect, or the structural analysis must be underway prior to its availability.
2. Your proficiency in RISAFloor modeling exceeds that of Revit modeling, so you can create a building model
much faster by working within RISAFloor.
There are many users who prefer to start the model in RISAFloor, just be aware that after importing to Revit for
the first time your Revit model may need some massaging in order to be ready for construction documentation.
Any RISA-3D elements that are present in the RISAFloor model (from RISAFloor-3D integration) will automatically be transferred over to Revit.
Starting in RISA-3D
It is less common that RISA-3D and Revit would be linked together without also using RISAFloor. While RISA-3D
does link with Revit, it is not constrained by some of the limitations that both Revit and RISAFloor have with
regards to structure type. Revit is a Building Information Modeling program, so some structures which RISA-3D
is well suited for (tanks, bridges, oil platforms, etc) do not fit Revit's mold of clearly defined floor levels and
grids. Since the creation of RISAFloor, and due to its complete integration with RISA-3D, it is rare that RISA-3D is
used on its own for building modeling purposes.
Workflow
Certain RISA properties are not mapped to Revit, such as unbraced lengths. These properties are not modified by
the RISA-Revit Link, so they will always remain as whatever they have been set to in RISA.
RISAFloor beam and column sizes (when members are set to be optimized)
Number of composite studs
Beam camber
Beam end reactions
With other element properties such as a beam's location or material, the Link performs a sophisticated comparison using the RISAmodel and the Exchange File to determine what has changed between the RISAmodel as
it currently exists, and what was exported to RISA during the last Revit to RISA export. This optimizes the import
process and prevents the Link from making unintended modifications to existing Revit elements, resulting in
much faster transfers if few changes were made within the RISAmodel.
This differs from the RISA-Revit 2012Link and older versions of the RISA-Revit Link where the properties of all
of the Revit elements were updated from the RISAmodel, even when nothing had been changed in the RISA
model.
Examples
The examples below can help illustrate typical workflow and Link behavior in a way that is easy to understand.
Workflow
In previous versions of the RISA-Revit Link, the changes made in Step 6 would have been undone. This is
because the export from Revit to RISA always overwrote everything in the RISA model, as opposed to
bringing over only the changed elements.
Workflow
Getting Started
Getting Started
Prior to using the features of the RISA-Revit Link it is advisable to learn the proper workflow procedures outlined in the previous chapter. Also, ensure that the link has been installed on the Revit computer.
Click on the Add-Ins tab, and then click on the Export to RISAbutton.
10
Getting Started
11
Getting Started
RISA Products
Click on the logo of a RISAproduct in order to specify which one the Revit model should be exported to.
Note:
l
RISAFloor models contain a RISA-3D model embedded within them. By exporting to RISAFloor you are also
exporting RISA-3D information to the RISAFloor model. You can access this 3D-only information by using
the Director tool within RISAFloor.
Main Options
Launch Program exports an Exchange File to the specified destination, then launches the RISA program and automatically imports that Exchange File into the RISAprogram. This feature will not work if RISA is not installed on
the Revit Computer.
Write to File exports an Exchange File to the specified destination. This option is required for use if RISAis not
installed on the Revit computer. To load the exchange file as a model in RISA go to File\Import\AutodeskRevit
Exchange File.
Export Selected Items Only exports only the elements currently selected in the Revit Model.
Coordinate Base Point specifies which Revit base point will be used to establish an origin (0,0,0) for coordinates
in the RISAmodel. Choosing "Project" means that the "Project Base Point"will be used as the origin for all three
global axes. Choosing "Survey/Shared" means that the "Survey Point" will be used. Survey Points are typically
used with the Shared Coordinates feature in Revit, which allows a common coordinate system to be used across
multiple Revit models.
It is important to choose one of the two base points, and maintain the use of that base point throughout all transfers back and forth. To see the location of both points in the Revit Model look under the Architecture Filter List
in the Visibility/Graphic Overrides, under the Site category.
Orient to True North allows the export of Revit models to RISAusing "True North" as the vertical plan direction, as opposed to "Project North". Revit allows a discrepancy between True North as dictated by surveying
and "Project North" (Plan North) such that floor plans are not shown as skewed on drawings. If a structure is
exported to RISA using True North then it is unlikely that the framing will align with RISA's Global Axes, which
makes the generation of lateral loads difficult.
12
Getting Started
Export Options
Redesign Members is a RISAFloor specific option. In RISAFloor a Shape Group may be assigned to members
(beams, columns, etc) from which the program will automatically choose an optimum size. An example of a Shape
Group would be "Wide Flange", as opposed to an explicit Shape such as "W24x55"
When this box is checked the RISA-Revit Link will ignore the explicit member size specified in the Revit model,
and instead assign a corresponding shape group to the member in RISAFloor. This means that the member size
in Revit will be ignored, and that RISAFloor will optimize the member size.
Walls specifies whether walls (and their openings) should be exported to the RISA model.
Footings & Boundary Conditions specifies whether footings, and boundary conditions should be exported to the
RISA model. These footings are created as RISAFoot footings within the RISA-3D model. At this time RISAFoundation is not supported in the RISA-Revit Link.
Loads specifies whether loads should be exported to the RISA model from Revit.
Load Combinations specifies whether load combinations should be exported to the RISA model from Revit.
Slabs and Openings specifies whether the slab edges, opening edges, and decks are to be created in RISAFloor
based on their geometry in the Revit model. Because RISAhas more limitations on slab edge geometry than
Revit, the Link may modify the slab edges to be compatible with RISAFloor. These modifications may be transmitted back to Revit when importing from RISA, so it may not be advisable to keep this option checked when
returning to Revit.
Project Grids specifies whether Revit project grids should be exported to the RISA model.
Link to Revit Analytical Model controls whether the Analytical Model or the Physical Model from Revit is exported to RISAFloor. RISA-3D always uses the Analytical Model.
File Names
Exchange File Name designates the name of the Exchange File that will be created by the Link. Browse to a target folder in which this file will be created, or browse to an existing Exchange File that is to be updated.
The Exchange File acts an intermediary between RISA and Revit. It contains data that is not stored in either the
RISA or Revit files. This data allows the link to keep track of both models to ensure that they are linked correctly.
If you already have an Exchange File for the current project then be sure to specify that same file (as opposed to
specifying a new one). The new information will be merged into the existing Exchange File.
Base File Name designates the name of the base file (RISAmodel file) that will be created from the exchange
file. By default this will be given the same name and placed in the same location as the exchange file. Browse to
a target folder in which this file will be created, or browse to an existing base file that is to be updated.
13
Getting Started
Advanced Options
Element Prefix specifies the prefix to applied to all RISA element names. For example, with the "REV_" prefix
member M1 will be created in RISA with the name "REV_M1".
Merge Tolerance specifies a tolerance below which the RISA-Revit Link will automatically connect elements that
are very close to each other. This is especially useful in the case of beams that (accidentally) only nearly intersect in the Revit model.
Footing Tolerance specifies a tolerance below which the RISA-Revit Link will automatically connect footings
that are very close to columns. RISArequires footings to fall directly beneath columns, so any footing not associated with a column will be ignored.
Round Joint Coordinates causes the Link to round the joint coordinates to the nearest 1/8" during export. This
eliminates some issues that RISA's finite element mesher has with the extreme precision (1/256") that Revit
uses.
The Optimized Export Process override allows you to turn off the intelligence of the Link which updates only
changed elements during each export. When this box is checked the Link will export all of the Revit elements to
RISA, regardless of whether they were changed since the last import from RISA.
The Export Verification is a process whereby the Link verifies whether the export will encounter any issues
prior to exporting. Disabling this option will cause the Link to export without warning the user of any potential
issues.
Export Process
Click OK to begin the export process. A progress bar will be shown during this process.
Once the export process is complete a Report window will pop up which provides any error messages related to
the export, along with a summary of elements exported.
14
Getting Started
Errors will be grouped together by type. Use the +/- buttons to expand the trees and read each error. It is best
to correct problems with the Revit model which generate errors before moving forward with the RISA model.
If the Launch Program option was selected during export then the RISAprogram will automatically be launched.
If Write to File was selected then you must import the exchange file into RISA. Launch the relevant
RISAprogram, and Import the AutodeskRevit Exchange File using the File Menu.
After importing the Exchange File, RISA automatically creates a corresponding base (model) file in the same
folder as the exchange file.
15
Getting Started
If the exchange file was created successfully, an export confirmation dialog appears.
Note:
l
The default Exchange File import/export directory can be set using the Tools > Preferences menu of the
RISA program.
Open Revit if it is not already open, and either open an existing model or create a new model into which the
RISAmodel will be imported.
Once the Revit model is ready for RISAImport, be sure to save the model
16
Getting Started
17
Getting Started
Import Options
Merge Tolerance specifies a tolerance below which the RISA-Revit Link will automatically connect elements that
are very close to each other. This is especially useful in the case of beams that (accidentally) only nearly intersect in the Revit model.
Coordinate Base Point specifies which Revit base point will be used to establish an origin (0,0,0) for insertion of
the RISAmodel. Choosing "Project" means that the "Project Base Point"will be used as the origin (0,0,0) for all
three global axes of the RISAmodel. Choosing "Survey/Shared" means that the "Survey Point" will be used. Survey Points are typically used with the Shared Coordinates feature in Revit, which allows a common coordinate
system to be used across multiple Revit models.
It is important to choose one of the two base points, and maintain the use of that base point throughout all transfers back and forth. To see the location of both points in the Revit Model look under the Architecture Filter List
in the Visibility/Graphic Overrides, under the Site category.
Orient to True North allows the import of RISA models to Revitusing "True North" as the vertical plan direction, as opposed to "Project North". Revit allows a discrepancy between True North as dictated by surveying
and "Project North" (Plan North) such that floor plans are not shown as skewed on drawings. Most RISAmodels
are laid-out along the Global X and Y axes, which would typically correspond with the plan-horizontal and planvertical directions in Revit. Such models should be imported to "Project North".
File Names
Exchange File Name designates the name of the Exchange File that will be loaded by the Link. Browse to the
folder in which this file exits.
Base File Name designates the name of the base file (RISAmodel file) that is linked to the exchange file.
18
Getting Started
Advanced Tab
Clear BIMIDs is useful for changing which Revit model your RISA model is linked to. Once a RISAmodel is linked
with a Revit model, the Link stores the BIM IDs (tags which relate RISAmembers to Revit members) within the
RISA model. If this RISA model is then linked to a different Revit model, it still contains associations to the original Revit model, which can cause problems with the new Revit model. Clearing these IDs allows the RISA model
to correctly link with the new Revit model.
Set all beams' Horizontal Projection to Centerline is used in models where beams are placed very close to
other elements (such as beams or walls) whereby Revit automatically snaps the beam's analytical line to align
with the other element. Using this option effectively disables that auto-snapping feature, and maintains correct
analytical geometry. This option will set all beams to have a centerline horizontal projection though, so any
intentional horizontal projections within the Revit model will also be reset.
Do not use optimized import process exists for advanced troubleshooting purposes. This bypasses the smart
comparison of what changed between the RISA model and the Revit model and instead forces a wholesale geometric update of the Revit model from the RISAmodel, regardless of whether any items have changed since the
last transfer.
Use default shapes allows the RISA-Revit Link to choose a default member shape when the correct shape information cannot be determined from the mapping file. These default shapes are shown in purple in the import summary window.
The Import Verification is a process whereby the Link verifies whether the import will encounter any issues
prior to importing. Disabling this option will cause the Link to import without warning the user of any potential
issues.
The Correct Alignment option is only available when importing to a new (blank) Revit model. Revit has been
known to incorrectly imports member geometries from certain RISA models (not RISA's fault) causing the alignment of some members to be slightly off. This can result in members that were connected to each other in the
RISA model to be unconnected in the Revit model. This option fixes those alignment issues, but is unchecked by
default because it slows down the import process.
Shape Library Options allows you to specify which Revit libraries are used to load shapes when importing from
RISA. When the Link searches for a shape to be loaded into the Revit model it will look at these libraries in
sequential order.
The Imperial and Metric library paths are set in the Revit File Locations defaults. You can also specify a path to
a custom library (by checking the Use Custom Library box), which the Link will use if it cannot find the shapes in
the Revit libraries.
When using custom libraries you must browse to a folder which has subfolders titled Structural Columns and
Structural Framing.Those folders must then have material-specific folder names, which contain the custom families. This folder hierarchy matches the Revit default folder hierarchy.
Import Process
Click OK to begin the import process. A progress bar will be shown during this process.
19
Getting Started
Once the import process is complete a Report window will pop up which provides any error messages related to
the export, along with a summary of elements added, modified, or deleted.
Errors will be grouped together by type. Use the +/- buttons to expand the trees and read each error. It is best
to correct problems with the RISA model which generate errors before moving forward with the Revit model.
After the import is complete a new view is created in the Revit model. It is a 3D view titled RISAImport Summary. This view shows the entire model color coded, new elements colored green, modified elements colored yellow, and unchanged elements colored black.
20
RISA Parameters
RISA Parameters
In order to make the mapping of element properties more complete, RISA has the capability to add parameters
to Revit elements. These parameters do not exist by default in a Revit model which has been created from
scratch, but they can be enable (and disabled)with the RISAParameters button:
The button icon shows the current status, whether the RISAParameters are turned on or off. Below is a list of
all of the parameters that are created by the Link:
Composite (Yes/No)
This parameter affects Analytical Beams. When it is enabled it maps to the "Composite"option on the Hot Rolled
Tab of the Beams spreadsheet in RISAFloor, and controls whether the beams will be designed as composite members in RISAFloor. This parameter has no impact on RISA-3D.
Member Labels
For beams, columns, and braces the Analytical Element has RISA member label information imported from RISA.
This does not export back to RISA, and these labels are overwritten with each import from RISA.
21
RISA Parameters
22
RISA Parameters
23
Tagging Beams
Tagging Beams
Beams within the Revit model contain parameters (member data such as beam size, camber, end reactions, etc)
that can be displayed on framing plans. This information is automatically transferred from RISA models. The
RISA-Revit Link comes with several useful tags to display this information.
The directions below explain how to tag all of the beams in a framing plan at once. Specific tags may be omitted
from this process if desired.
Loading Tags
If you have not already done so, load the RISAtags into your Revit model. To do so, click on the Insert tab, and
click on the Load Family button.
Procedure
Ensure that the Revit model has had a RISAmodel imported, and that end reactions were also imported (if applicable). The tagging process much be done for each framing plan separately, so open the first relevant framing
plan.
Click on the Annotate tab within Revit, and then click on the "Beam Annotations" button:
The Beam Annotation Dialog will open. If the beams already have tags you may want to check the box "Remove
existing beam tags...", which will replace the existing tags with the new RISA tags. Choose between the "Level
beams in plan"and "Sloped beams in plan" tabs as applicable.
24
Tagging Beams
Loading Tag #1
Click on the Load Tag button
Choose the "Structural Framing Tag" radio button, then click in the "Type" dropdown and choose RISAStart Reactions.
25
Tagging Beams
Loading Tag #2
Repeat the procedure for Tag #1, loading the Beam Size tag instead.
Loading Tag #3
Repeat the procedure for Tag #1, loading the RISAEnd Reactions tag instead.
Loading Tag #4
Repeat the procedure for Tag #1, loading the RISAStart Moments tag instead.
Loading Tag #5
Repeat the procedure for Tag #1, loading the Studs and Camber tag instead.
Loading Tag #6
Repeat the procedure for Tag #1, loading the RISA End Moments tag instead.
Applying Tags
The framing tags should now be shown as below:
26
Tagging Beams
Click OK in the "Beam Annotations"dialog, and the tags will automatically be applied to the beams. Each tag is
an individual element that may be deleted or moved as necessary.
27
Technical Support
Technical Support
Technical support is an important part of the RISA-Revt Link. There is no charge for technical support for all
licensed owners of the current version of RISA-3D and/or RISAFloor.Technical support is very important to the
staff at RISA Technologies. We want our users to able to reach us when they are having difficulties with the Link.
However, this service is not to be used as a way to avoid learning the program or learning how to perform structural modeling in general.
Hours:6am to 5pm Pacific Time, Monday through Friday
Before contacting technical support, please do the following:
1. Search the Help File or User's Manual. Most questions asked about the RISA-Revit Link are already
answered there. Use the table of contents or index to find specific topics and appropriate sections. We go
to great lengths to provide extensive written and online documentation for the link. We do this in order to
help you understand the link and make it easier to use.
2. Visit our website: http://risa.com/partners/prt_revit.html. Ensure that you have the latest version of the
RISA-Revit Link. The version number that you are currently running can be viewed at the top of the
import/export dialogs within Revit.
3. Within RISA-3D or RISAFloor click on the Help Menu and select Check for Updates. Occasionally there are
known issues which get corrected in periodic updates released by RISA.
4. Look at your analytical model in Revit to see if anything is wrong with it. Nine times out of ten the errors
that occur during transfer are due to incorrect analytical models.
5. Take a few minutes to experiment with the problem to try to understand and solve it.
Please be prepared to send us your Revit model. If the file size exceeds 5MB then it must beuploaded to our website. You can contact support via e-mail for instructions on how to upload your model to the website. Please
relinquish your worksets, and make sure that all relevant worksets including Levels &Grids are set to active
prior to sending the Revit model. If possible, please send the Central model.
E-Mail: support@risa.com
This method is the only way to send us a model you would like help with.Make sure you tell us your name, company name, RISAKey ID(go to Help\About), phone number, and give a decent problem description.Make sure to
specify which program you are integrating with, and whether you are using the "Export Selected Items Only"
option.
Phone Support: (949) 951-5815
Feel free to call, especially if you need a quick answer and your question is not model specific and therefore
doesnt require us to look at your file.
28
Level/Floor Name
Elevation
RISA-3D beams and braces (including RISA-3D models embedded within RISAFloor) create Revit levels when
transferred.
Note:
l
l
l
l
RISAFloor does not support negative floor elevations. Revit levels with an elevation below 0'-0" are not
transferred to RISAFloor.
Revit Level names may not exceed 32 characters.
No two Level names in Revit may be the same.
No two Floor names in RISAFloor may be the same.
Grids
Project Grids in RISAFloor and RISA-3D are transferred to Revit as Grids. Revit Grids are transferred to
RISAFloor and RISA-3D as Project Grids. The following properties are supported:
l
l
Grid Name
Grid Position
Note:
l
RISAFloor and RISA-3D grids are not assigned start/end elevations as they are in Revit. Therefore they
are always imported to Revit at 0'-0" elevation.
RISAFloor and RISA-3D grids are not assigned start/end locations in plan as they are in Revit. Therefore
they are always extended to the furthest perpendicular grid lines.
RISAFloor and RISA-3D do not support angled or radial grids. Therefore they are ignored when exported
from Revit. Angled and radial grids are also ignored during the process of importing from RISA to Revit.
Beams
Beams within RISAFloor and Members assigned to Type "Beam"in RISA-3D are both transferred to Revit as Structural Framing Beams. Revit Structural Framing Beams are transferred to RISAFloor as Beams, and to RISA-3D as
Members assigned to Type "Beam".
The following properties are supported:
l
l
l
l
l
l
Rotation Angle
Material
Beam Size
Start/End Releases
Gravity/Lateral Flag
Location
Mapping
The Mapping File is used to match RISA Shape names with Revit Family Instance names. When exporting to RISA3D or RISAFloor, if a matching shape name cannot be found in the mapping file then the beam is created as a
29
Sloped Beams
RISAFloor only supports sloped beams at the top Floor. Any sloped beams on Revit Levels below the top Level
will be flattened (end offsets set to zero) when transferred to/from RISAFloor.
RISAFloor does not support negative elevation offsets for beams. Any Revit Beam with a negative end offset will
be reset to have zero offset when transferring to/from RISAFloor.
Revit beams must be assigned to a Reference Level in Revit. Sloped beams in RISA-3D are assigned to a Revit
Level at their lower end. The higher end is assigned a corresponding End Offset from the Reference Level.
End Releases
RISAFloor only supports "Pinned" or "Fixed"end releases. If the end releases of a Revit Beam do not correspond
with standard Pinned or Fixed releases then the link chooses the closest match when transferring to RISAFloor.
The Revit end releases in this circumstance are not affected when transferring back to Revit.
Composite/Camber
All RISAFloor beams are created as Composite when transferred from Revit. Both segmented and uniform studs
are transferred back to Revit as beam properties. Beams that are assigned Camber in RISAFloor have their camber transferred to Revit as a beam property. The RISAFloor model must be solved, and the results must be saved
in order to transfer the studs and camber chosen by RISAFloor during solution.
End Reactions
Beam end reactions are transferred to Revit from both RISA-3Dand RISAFloor.
The reactions from RISAFloor are determined from the Load Combinations spreadsheet- Design tab- Connection
column. RISAFloor will run each load combination and will send to Revit the maximum reactions found with the
Connection checkbox turned on.
Reactions transferred from RISA-3D are envelope values determined from the load combinations. The values are
exact shear and moment values determined from Load Combinations, so if Strength-Level Load Combinations
(e.g. 1.2D + 1.6L) are used in RISA-3D then the end reactions sent to Revit will be at strength level.
30
Cantilevers
A cantilever beam must be drawn as two elements to transfer from Revit to RISAFloor. Both the cantilever portion and the backspan portion must have a "Cantilever Moment"assigned to the ends which connect to the supporting column or wall at the cantilevered end.
The two elements are created as one cantilever beam within RISAFloor, so they share the same properties, and
the properties of both Revit elements are updated when importing from RISAFloor.
Outriggers
An outrigger beam will be drawn into Revit as a single element to transfer into RISAFloor. The beam must have
a "Cantilever Moment"assigned to the end which connects to the supporting column. The link automatically
recognizes this an outrigger and will assign it as one in RISAFloor.
Columns
Column Stacks within RISAFloor and Members assigned to Type "Column"in RISA-3D are both transferred to
Revit as Structural Columns. Revit Structural Columns are transferred to RISAFloor as Column Stacks, and to
RISA-3D as Members assigned to Type "Column".
The following properties are supported:
l
l
l
l
l
Rotation Angle
Material
Column Size
Gravity/Lateral Flag
Location
Note:
l
Gravity Columns from Revit are automatically created as Lateral in RISA-3Dand RISAFloor if they share a
node with any lateral elements.
RISAFloor Only: Columns in Revit spanning multiple levels should be created as individual members at
each floor, rather than continuous columns spanning multiple levels. Splices can be adjusted in RISAFloor
and exported back to Revit in order to get an accurate column stack model.
Braces
Members assigned to Type "V-Brace"in RISA-3D are transferred to Revit as Structural Framing Braces. Revit
Structural Framing Braces are transferred to RISA-3D as Members assigned to Type "V-Brace".
31
Rotation Angle
Material
Brace Size
Start/End Releases
Location
Braces transferred to/from RISAFloor are handled in the integrated RISA-3D model within the RISAFloor model.
For that reason they are not visible in RISAFloor directly, however they can accessed using the Director tool.
RISAFloor braces are treated the same as RISA-3D Braces.
Horizontal Braces follow the same guidelines as Beams.
Each end of a Vertical Brace must be assigned to a different level. When transferring to Revit these levels are
automatically created for each brace. This may result in a large number of levels being created in the case of
vertical braces used as latticework.
Walls
WallPanels within RISA-3D and RISAFloor are transferred to Revit as Structural Walls. Revit Structural Walls
are transferred to RISA-3D and RISAFloor as Wall Panels. Additionally, vertical plate elements within RISA3Dare transferred to Revit as Structural Walls. The following properties are supported:
l
l
l
l
The Structural Usage parameter within Revit determines whether the wall is exported to RISA as Gravity or Lateral. A Structural Usage of "Shear" or "Combined" results in a lateral wall in RISA. Any other Structural Usage
(other than "Not for Analysis) results in a Gravity will in RISA.
Note:
l
l
l
Non-rectangular walls within Revit are created as rectangular in RISA using the smallest possible bounding rectangle.
Wall materials are not mapped.
Walls with columns embedded within them are split at the columns when transferring from Revit to
RISAFloor.
When a wall is split by the Link, be sure not to rename the wall in RISA. Otherwise the wall will not
return to Revit, as the splitting function uses the wall name to keep track of the split pieces.
Only Wall Opening Elements are transferred from Revit to RISA. Openings defined as "Window Opening",
"Door Opening", and wall profile line sketches are all ignored.
In-Place Families
Structural members that are grouped together in Revit, or part of a higher level Family are transferred using
the link, and are treated as independent elements.
Footings
Footings defined in RISA-3D using RISAFoot are transferred to Revit as Isolated Foundation elements. Isolated
Foundation elements in Revit are transferred to RISA-3D as RISAFoot footings. Only footings that occur directly
32
Note:
l
l
Decks/Slabs
Decks defined in RISAFloor are transferred to Revit as Floor/Roof Elements. Floor/Roof Elements in Revit are
transferred to RISAFloor as Decks.
Slab Edges are created in RISAFloor based on the overhang of Revit Floor/Roof Elements. RISAFloor Slab Edges
are not transferred to Revit. Closed-circuits of perimeter beams are used to determine slab edge circuits.
Slab Openings in RISAFloor are transferred to Revit as Floor Opening Elements. Floor Opening Elements in Revit
are transferred to RISAFloor as Slab Openings.
The following properties are supported:
l
l
l
l
l
l
Note:
l
l
l
For Revit Floor/Roof elements which do not have edges parallel to perimeter beams, the Link creates
RISAFloor Slab Edges which are parallel to the perimeter beams.
Deck self weights are not linked to Revit, and must be defined in Deck Definitions in RISAFloor.
Default decks are ignored by the Link
Materials
RISAMaterials assigned to Beams, Columns, and Braces are transferred into Revit. Revit Materials assigned to
Beams, Columns, and Braces are transferred into RISA. Walls are assigned to General Materials. The Mapping
File is used for transferring materials between RISA and Revit. The following material types are supported:
l
l
l
l
l
Boundary Conditions
Boundary conditions assigned to Joints in RISA-3D are transferred to Revit as Boundary Conditions. Boundary conditions assigned to elements in Revit are created at Joints in RISA-3D.
Translations, rotations, and spring stiffnesses are supported. Pinned boundary conditions are automatically
applied to the bottom of column stacks transferred to RISA-3D.
33
Loads
Note:
l
Only loads applied in Global Directions are supported. All others are ignored.
Point Loads
Point and Joint loads defined within RISA-3D and RISAFloor are transferred to Revit as Point Loads. Point Loads
in Revit are transferred to RISA-3D and RISAFloor as Point or Joint loads, depending on whether the load falls on
a member or a joint.
Line Loads
Distributed Loads defined within RISA-3D and RISAFloor are transferred to Revit as Line Loads. Line Loads in
Revit are transferred to RISA-3D and RISAFloor as distributed loads.
Note:
l
Revit Line Loads which span multiple members will be broken down into multiple distributed loads when
transferred to RISA-3D.
Area Loads
Area Loads defined in RISA-3D and RISAFloor are transferred to Revit as Area Loads. Area Loads defined in Revit
are transferred to RISA-3Dand RISAFloor as Area Loads.
Note:
l
Revit Area Loads which are defined by more than 4-points are ignored by the Link when transferring to
RISA-3D.
Each Revit Area Load is given its own Area Load definition within RISAFloor. Identical area loads are
lumped into one Definition.
Revit only allows one load case per load. Therefore when importing RISAFloor into Revit, only one load
magnitude will be transferred from a given Area Load Definition. The load chosen will be the first
encountered in the following order:LL, DL, OL1, etc..
Load Cases/Categories
Load Cases and Categories are mapped between RISAand Revit using the Mapping File.
Load Combinations
The transfer of Load Combinations between RISA and Revit is limited due to inherent differences in how the programs handle them.
Note:
l
l
l
34
The "State" flag within Revit maps to the "Service"flag within RISA-3D
The "Type" flag within Revit maps to the "Solve" flag within RISA-3D
RISA-3D only supports load combination nesting up to one level deep. Any further nesting will be ignored
by the Link.
Shape Mapping
The Shapes tab consists of three columns: RISA ShapeName, REVIT ShapeName, and ShapeType. There are
many shapes already mapped in the file that is installed. Additional shapes may be added, and existing shapes
may be changed.
The Link looks for shape names from this tab of the spreadsheet. If they are not found, it looks for shape names
that are identical between RISAand Revit, and maps them automatically.
For automatic concrete shape mapping the general conventions must be followed for naming in Revit. For
example, rectangular concrete shapes must be named in the format 'a x b' and circular shapes must be named in
the format ' c" '. a, b, and c are the width, depth and diameter respectively. It is important to note that Revit
stores rectangular concrete shape names as width x depth whereas RISA stores these names as depth x width.
This behavior is being accounted for by the Link.
The following Shape Types should be used in the Shape Mapping File.
Hot Rolled
WF_SHAPE
Wide Flange
TUBE_SHAPE
Tube
PIPE_SHAPE
Pipe
CHANNEL_SHAPE
Channel
WT_SHAPE
WT
DBL_L_SHAPE
Double L
SNGL_L_SHAPE
Single L
RECT_SHAPE
BAR_SHAPE
TAP_WF_SHAPE
Rectangular
Bar
Tapered Wide Flange
Wood
NDS_SHAPE
Rectangular
NDS_ROUND_SHAPE
Round
Concrete
CRECT_SHAPE
Rectangular
CRND_SHAPE
Round
CL_SHAPE
L Shape
CT_SHAPE
T Shape
Joists
KJOIST_SHAPE
K Joist
35
LH Joist
DLHJOIST_SHAPE
DLH Joist
SLHJOIST_SHAPE
SLH Joist
KCSJOIST_SHAPE
KCS Joist
JOISTGIRDER_SHAPE
Joist Girder
WOOD_JOIST_SHAPE
Aluminum
Wood Joist
AL_WF_SHAPE
Wide Flange
AL_Z_SHAPE
Zee Shape
AL_T_SHAPE
Tee Shape
AL_PL_SHAPE
Solid Rectangle
AL_L_SHAPE
Single Angle
AL_CS_SHAPE
Cee Shape
AL_ROUNDTUBE_SHAPE
Round Tube
AL_RECTTUBE_SHAPE
Rectangular Tube
Cold-Formed Steel
CU_SHAPE
Cee Shape
CS_SHAPE
ZU_SHAPE
Zee Shape
ZS_SHAPE
HU_SHAPE
Hat Shape
Material Mapping
The Materials tab consists of three columns: RISA MaterialName, REVIT MaterialName, and MaterialType.
There are many materials already mapped in the file that is installed. Additional materials may be added, and
existing shapes may be changed.
Revit to RISA
If the mapping for a particular Revit material exists in the Mapping File, it is mapped over the RISA material
name mentioned on the spreadsheet. The material properties are preserved in RISA, and are not overwritten.
If a material match is not found in the mapping file, the Revit material name is sent to RISA. Material properties
are created based on Revit material properties during the initial transfer, and are not overwritten thereafter
regardless of changes made to the RISAmaterial properties.
RISAto Revit
If the mapping for a particular RISA material exists in the Mapping File, it is mapped over the Revit material
name mentioned on the spreadsheet. The material properties in Revit are updated to the RISAmaterial properties.
If a material match is not found in the mapping file, the RISA material name is sent to Revit. Material properties
are created based on RISA material properties during the initial transfer.
Available Material Types in RISA
36
CONCRETE_MATL
HOT_ROLLED_STEEL_MATL
NDS_WOOD_MATL
Note:
l
l
l
l
Revit to RISA
The Load Case of every load that is transferred from Revit to RISA is mapped using the mapping file. If no mapping for a given Revit Load Case is present then the load will be transferred to RISAFloor under the OL4 category. RISA-3D does not have this limitation, so it will create new Load Cases using the Revit names.
The LoadCaseType is used to distinguish whether the load should be applied to the RISAFloor model, or to the
RISA-3D model embedded within RISAFloor.
RISAto Revit
The Load Case of every load that is transferred from RISA to Revit is mapped using the mapping file. If no mapping for a given RISA Load Case is present then a new Load Case will be created in Revit using the RISA Load
Case name.
Available Load Cases in RISAFloor
DL PreComp
DL PostComp
LL-Non
Live Load
LL-Reduce
LLS-Non
LLS-Reduce
RLL-Non
RLL-Reduce
SL
Snow Load
SLN
RL
Rain Load
OL1
Other Load 1
OL2
Other Load 2
OL3
Other Load 3
OL4
Other Load 4
Dyn Mass
Dynamic Mass
VLL
Vibration Load
Note:
37
38
Index
Index
A
Annotate 24
F
B
File Names 13, 18
Base File Name 13, 18
Floors 29
Beam Annotations 24
Footing Tolerance 14
Beam Size 26
Footings 32
Beams 29
BIM ID 19
Boundary Conditions 33
Braces 31
Getting Started 10
Grids 29
Camber 30
Cantilevers 31
Horizontal Projection 19
Columns 31
Composite 30
Import Options 18
Import Process 19
D
Data Exchange 29
Decks 33
Design Lists 30
Importing 16
In-Place Families 32
Install 1
L
Launch Program 12
Levels 29
Element Prefix 14
End Reactions 30
End Releases 30
Exchange File Name 13, 18
Export Options 13
Main Options 12
Export Process 14
Mapping 29
Index
Mapping Files 35
Materials 33
Merge Tolerance 14, 18
Version 4
Outriggers 31
Phone Support 28
Website 1
Workflow 5
Write to File 12
R
Reactions 18
Redesign Members 13
RISA End Moments 26
RISA End Reactions 26
RISA Parameters 21
RISA Products 12
RISA Start Moments 26
Round-Tripping 6
S
Shape Groups 30
Shape Library Options 19
Slab Perimeters and Openings 18
Slabs 33
Slabs and Openings 13
Sloped Beams 30
Structural Framing Tag 25
Studs and Camber 26
Support E-Mail 28
T
Tagging Beams 24
Technical Support 28
ii