Engineers invest significant time building data rich 3D models for analysis and design. While the level of detail put into these models varies based on project complexity and objectives, they are nonetheless useful beyond a single engineer’s computer. Unfortunately, though, they are often used only for analysis and then discarded, or visited again only when absolutely needed. What if each engineering analysis model you develop could be used for collaboration, review, and exchange during the entire course of the project and beyond? This is the spirit of Bentley iTwins.
In November 2020, Bentley’s Engineering Simulation software products (STAAD, SACS, AutoPIPE, RAM) started to be integrated with Bentley iTwin Services. This will allow users to do more with the models they build in these applications without any disruption to the way the software is currently used. Further, this value will grow significantly over time. The most visible and immediate change you will notice in the software applications is a new add-in called iTwin Services. This will be presented as an in-product sidebar and common to all Engineering Simulation products that interact with the iTwin. This add-in will ‘house’ all the iTwin-enabled capabilities these applications offer.
Figure 1 - iTwin Services, available as in-product sidebar within any Engineering Simulation products that interacts with iTwin Services.
The in-product sidebar can be launched via the iTwin Services button in the ribbon or file menu (see Table 1). All Engineering Simulation software products expose the launching of the in-product sidebar via iTwin Services button.
Table 1 - iTwin Services button in Engineering Simulation products
STAAD.Pro Physical Modeler
RAM Structural System
There will be multiple categories of functionality eventually offered under iTwins Services. The first is iTwin Design Review. This service allows a model created in an analytical desktop application to be converted into a point of collaboration hosted in the web that can be shared with any team member or stakeholder on a project.
With the release of iTwin Analytical Synchronizer V12, certain products (namely STAAD) has included Synchronizer capability. This service allows the user to:
Figure 2 - iTwin Design Review, select the highlighted option (Design Review) within the sidebar to get started Design Review. STAAD and other early adopters have also included Synchronizer functionality.
Bentley iTwin Design Review is a collaborative service hosted on the web that allows two or more interested parties to communicate with one another in the context of a 3D model or, more accurately, an iTwin.
The iTwin Services Add-in within the desktop application publishes the analysis model to an iTwin Design Review session, and therefore into an intuitive point of collaboration that facilitates review of design work in progress (see Figure 3).
Figure 3 - A model as presented in-product (STAAD) and corresponding iTwin Design Review session in the browser with coordination discussion.
The web-based interface (accessible with a web browser) of Design Review offers a set of commands for navigating, viewing from different perspectives, isolating key elements, and clipping views.
Several review tools are included with the service:
Figure 4 - Commands in Design Review for measurement and view control
In addition to review tools, iTwin Design Review crucially offers the ability to review and comment with your participants at points of interest in the model. Comment threads can be assigned statuses (Resolved, Open etc.) and Disciplines. Discussions can be directed specifically at a participant using @mentions. Just type @ before their name and select from the menu that appears. They receive a notification with a link, which they can go directly to the point in the conversation where they were mentioned.
Many aspects of iTwin Design Review are particularly relevant to engineering analysis workflows. Project managers or other stakeholders in a project may not be skilled in, or have access to, the analytical software used by engineers to analyze and design a structure. These individuals may instead have a practice of reviewing a set of 2D drawings or a BIM model that is disconnected from the engineering analysis models. In this case, the reviewer may not have a complete understanding of the assumptions used by the designers. iTwin Design Review can therefore help project managers catch incorrect assumptions or errors during the design phase before it becomes a construction problem.
Some of the practical applications of this technology to the traditional engineering review and collaboration process include:
Figure 5 - Select Design Review under iTwin Services
Figure 6 - Application requests access. Click Allow to grant the necessary rights to proceed.
Figure 7 - iTwin Design Review authentication splash screen and subsequent loading page. Click Home to return to iTwin Services page.
Once the access token is granted and completed loading, the main iTwin Design Review page is shown and is divided into 4 sections as shown below.
Figure 8 – iTwin Design Review Main User Interface Overview
Header: Displays currently logged in user as well as the iTwin Design Review logo (clicking the logo would take you back to the initial splash screen).
New Session: Click on New Session to launch New Session form. This is the first step to prepare the conversion of your model to an iTwin Design Review Session (see 2.2.3 Creating a New Session).
Previous Session: Displays a thumbnail of the last iTwin Design Review Session that you have accessed in the web browser. Click Open Last session to view iTwin Design Review Session in your default browser. Note that this is provided for information but may be related to a completely different model or project.
Sessions List: Displays a flat list of your iTwin Design Review sessions. The Session List view can be searched and filtered by tags. Tags are added during iTwin Design Review session creation process. The sessions list would initially be prefiltered to your current file Tag (usually the currently opened file name). This is so that the sessions list would be most relevant to your currently opened file. Remove the session Tag by clicking the “x” next to the filtered tags to view all you design review sessions.
Click to access sessions filter dropdown – this allows you to further filter on currently active file tag or to toggle between filtering on Open vs Closed Sessions. Sessions that you create are by default Open, so that it can be interacted on. Sessions that are no longer relevant can be optionally “Closed” to not clutter your sessions list.
Each iTwin Design Review Session (see Figure 9) is shown as a list item in the Sessions List.
Figure 9 - A iTwin Design Review session list item with legend key
A: Displays the iTwin Design Review Session Name along with the status of the session. Click on the Session Name to open the session in the default browser. Chrome, Firefox or the new Edge browser (based on Chromium) is recommended for the best design review experience.
Indicates that the session is currently being converted online.
Indicates the session is ready to be accessed.
Indicates there was an error in the session creation process.
B: Supplementary information regarding the session.
Indicates the number of comments for this session. A mouse hover over this icon would show the comment subject titles in this session.
Indicates the creation date of this session. Hovering of this icon would reveal a more detailed timestamp.
Shows the assigned Tag(s) to this session. Clicking any of the Tag(s) would filter all sessions to the selected Tag.
C: Displays the user initials of participants of this session. Hovering over each initial would reveal the full name of participants. Clicking the “+” icon allows you to Add or Remove participants (see Figure 10). Auto suggested list of participants (from your organization) would display as you type into the Add Participants field. You can also add external participants to your design review session.
Figure 10 - Edit Session Participants Dialogue
D: Displays when the session was last modified (relative to the current date/time).
E: Thumbnail of the session. When you first create a session, this would be a blank placeholder. The thumbnail of the design review session is automatically retrieved from the view extracted from the first comment entered in the iTwin Design Review session.
F: More Actions. (see Figure 11)
Figure 11 - Session List Item - More Actions.
Launch Session: Will navigate to the iTwin Design Review session with your default browser. This is an alternative method to access to the iTwin Design Review session to directly clicking the underlined session name.
Edit Tags: Present you with the opportunity to edit the tags assign to the session
Export Comments: Exports all comments from the design review session to a temporary XLS file. Your default XLS viewer would then automatically open this downloaded file (usually Microsoft Excel). To keep a local copy for your reference, perform a “Save-As” action within Microsoft Excel.
Close Session: Click Close to Close the Session. A Closed Session can no longer be commented on and won’t appear in the sessions list unless Close Session visibility is toggled on.
Click “Create Session” in New Session block (Figure 8) to launch Create New Session form.
For below steps Refer to Figure 12 for the elements on Create New Session form.
Figure 12 - Create new session form
Step 1: Session Name - The name of the session will be suggested based on the name of the model. However, note that this should be unique (amongst All Open Sessions) and as such if a session has been initiated with the name of the model already, then an alternative name should be provided.
Step 2: Define any tags. (Optional)The name of the model is provided as a suggested tag, but any others can be added to help in getting collections of sessions at a later stage.
Step 3: Session Participants - (Optional) Define additional participants. Clearly the power and benefit of a design review session comes from the collaborative effort of working with colleagues. They can be identified at this time or any time later once the session has been initiated.
Step 4: Session Settings – (Optional) Product specific settings on HOW a session is to be created (e.g include loads, rebars, etc..).
Step 5: Next – Clicking ‘Next’ will then start the process of building the Design Review model from your model and push it into the iTwin Design Review service. The desktop conversion process may take a few minute to process, once the desktop conversion has completed you will be informed of this via an info message (Figure 13). At this stage, the process is purely online, therefore you can continue to work in your product while the conversion takes place online. Your session is “ready” when you see an info message per (Figure 14) or a green tick next to your session list item
Figure 13 - Successful upload message
Figure 14 - Successfully created session message - with hyperlink to the created review session
Once completed, the Session is marked with a tick and by clicking on the session, the iTwin Design Review session would launch in your default web browser where discussions and feedback can be solicited from your Session Participants (i.e Design Team/Project Members). The session is now ready to add one or more comments which can become discussion threads with others in the design team that can be used to assist in progressing the project.
Figure 15 - A Successfully created session with a ready status green check mark next to session name. Click directly on the Session Name to launch Design Review in the default web browser.
Additionally, note that notification that the design review session is ready will be reported in Connection Client and/or Email.
Figure 16 - Connection Client Notification
Figure 17 - Design Review Session is Ready email message as presented in Microsoft Outlook
Your invited participants would similarly be notified through Connection Client and email message (Figure 18).
Figure 18 - Collaboration request email automatically sent by iTwin Design Review to all Session Participants.
Figure 19 - iTwin Design Review session in the web browser
Figure 20 –Comment and markup of proposed solution in an iTwin Design Review session in the web browser.
Figure 21 - Comment reflected within Product itself (info tip when hovered over comment icon)
For a general guide on the iTwin Design Review service, see:- https://communities.bentley.com/products/digital-twin-cloud-services/itwin-services/w/itwin-design-review-wiki
The Synchronizer functionality under iTwin Services as presented in the Applications sidebar allows the user to synchronize their work to their Sync Model. The Sync Model could be either a local file based repository (*.ism.dgn) or to a Federated Cloud-based repository (iModel). The Sync model contains the layers of change and stores who change what and when.
Figure 22 - Select Synchronizer to Sync your work with the rest of the project team.
Figure 23 - Synchronizer screen; (A)Select Local to synchronize your application changes to a File (B)Select iModel to synchronize to a Federated Cloud Based Digital Twin.
Figure 24 - Synchronizer Main User Interface Overview
Figure 25 - Sync Changes Section
Header clicking the Synchronizer logo in header takes you back to the Synchronizer Screen (Figure 23).
Sync Location – Displays the location that you are Syncing your changes to. For a file-based sync, this would be the file path to the selected file repository (*.ism.dgn). For an iModel sync, this would be the location of the selected Project/iModel/model. Clicking the link allows you to edit the link location.
Sync Changes Pane – Per Figure 25
A – Change Management Visibility Toggle (click to toggle between show/hide Change management) – this controls whether iTwin Analytical Synchronizer would present itself during change management.
B – Sync Settings side pane – click to edit sync settings. Settings control how and what items would be synchronized. When clicked a settings pane will slide out.
C – Pull Changes – clicking it would initialize a Pull Changes operation. Your current application file would be compared to the incoming model and merged.
D – Push Changes – clicking it would initialize a Push Changes operation. Changes in your application file would be compared to your outgoing model and merged.
Design History List – A flat list of the layers of change in your sync model (as designated by Sync Location) is reflected in Design History List. The listed items differ slightly between a File based Sync and iModel Sync.
A Local file Sync can be setup to point to a New Blank Repository or and Existing Repository with data.
Click A – New to Create a new blank repository (*.ism.dgn)
Click B – To Select an Existing repository (*.ism.dgn)
Click C to finalize your selection.
Figure 26 - Setup Local Sync Dialogue
To push new model or model updates to a local repository, use the following procedure.
Do the following…
create a new repository for synchronizing
Click New. Select the folder and type a file name for the ISM repository. Click OK.
select an existing repository
Click Select. Navigate to and then select the repository file name. Click OK.
5.Tip: If you have previously synchronized the model with an ISM repository, then the previous repository is already selected.
6. You should now see a status "Ready to establish link".
7. Click Next. The Synchronizer panel opens.
8. (Optional) Click Sync Settings to edit the ISM options.
Here you can change the synchronization settings from their default values (which are set in the Options dialog).
9. Select Push Changes. The iTwin Analytical Synchronizer application opens.
10. (Optional) Review and accept changes in the iTwin Analytical Synchronizer application as needed.
11. Click OK. The dialog closes and a toast notification displays the summary of the synchronization action.
The ISM repository is created.
To push updates from the STAAD.Pro Physical Modeler model to the repository, simply repeat this process.
To create a new physical model or to pull changes from an existing ISM repository, use the following procedure.
The iTwin Analytical Synchronizer application closes. A toast notification displays the progress of the synchronization operation.
As part of Bentley’s iTwin Services, iTwin Hub is a cloud service that enables alignment, accountability, and accessibility of infrastructure digital twins. It is the control center for iModels, responsible for coordinating concurrent access as well as maintaining a timeline of change – a record of who-changed-what-and-when.
This means the Engineers model (and subsequent changes) can now be part of the wider team. iModels (containing the Engineers model and models from other disciplines) can be viewed and collaborated upon in the web browser. Features include (but not limited to): viewing of model in browser, measurements, issues resolution, clash detection, geolocations, data visualization and version comparison
Figure 27 - Synchronizer sidebar listing the changes committed to iModel from STAAD - Structure. Sample Model Warehouse Structure.
Figure 28 - Display of the Preliminary Named Version of this iModel in iTwinHub
Figure 29 - Changes and Named Versions reflected in iModel Manager
iModels are located within a Project. Prior to Synchronizing your changes to an iModel – iModel and Projects must be created beforehand. The Registering of a Project and creation of an iModel occurs in the browser in your CONNECT portal.
Check with your administrator on whether you have the necessary rights to Register a Project.
Navigate to https://connect.bentley.com/Admin/ProjectRegister and fill in the Project Registration page to register your project. Project Registration page can also be reached via the Register Project button in the Assign Project dialog (Figure 30) in your application
Figure 30 - Assign Project Dialogue - Click Register Project and follow the prompts to have a
Figure 31 - CONNECT Portal
Check with your administrator on whether you have the necessary rights to both Create and Modify an iModel.
In the web browser, navigate to your Project page (located in the header see Figure 31). Select your Project (Figure 32) and click iModel Manager (Figure 33).
Figure 32 - List of Projects accessible in CONNECT Portal
Figure 33 - List of services of the selected Project. Click iModel Manager
Figure 34 - Under iModel Manager - Click Create iModel and follow prompt
Follow the 1 -2 -3 wizard to select your (1)Project, (2)iModel and (3)Model. Your Sync Model is actually a model within an iModel. This setup allows multiple applications utilizing Synchronizer to have their models appear side by side the in same iModel.
Figure 35 - 1-2-3 wizard for Project/iModel/Model selection. Click next progresses to the next step
1 -Select Project Step
A Click the Globe icon to navigate to the Project home page in the browser
B Search to filter project list
C Click Caret to Select the Project and navigate to next step
D Click Next to select the highlighted Project and navigate to next step
2 -Select iModel Step
E Click Caret to Select the iModel and navigate to next step
F Click Next to select the highlighted iModel and navigate to next step
3 -Select Model Step
G Click New to create a new model – dialogue would pop up for you to fill in a Model Name and description.
H Click the Globe to navigate to iModel page in the webrowser.
I Edit the currently selected Model
J Delete the selected Model
K Click Next to select the highlighted model to finish off the model selection wizard
For a New blank Sync Model - On successful completion of Selecting the Model – the contents of your application file would be initially pushed.
Refer to Table 2 for Synchronization actions. If Show Change Management is turned on, iTwin Analytical Synchronizer would appear. Click Update within iTwin Analytical Synchronizer and fill in the commit message (a message that describes what’s changed). Optionally tick “Major Change” to promote this changeset as a Named Version
Table 2 - Sync Changes Operation for iMOdel
(Optional) optionally confirm the objects and properties that constitute the changeset in ITwin Analytical Synchronizer.
Toggle Show/Hide Change Management
(Optional) Modify Sync settings from Default.
Click Sync Settings
send the current Application data to the iModel
Click Push Changes
retrieve the analytical data from the iModel
Click Pull Changes
Figure 36 - Sync to iModel Main interface
If necessary, Click the “Synced to” link to reassociate your Sync model.
Design History lists all the layers of change in the current iModel (not just your Sync model). As you progress, there are certain changes that are more significant than others. These are termed Named Versions– these are significant points in the timeline of your iModel.
Named Changes can be created on iModel Manager in the browser or directly in the Change item listed under Design History.
Refer to Figure 37
A -Click dropdown to select between listing all Changes or only Named Versions.
B – Name of the change set, if Design History list is filtered to show Named Versions only, this will show
C – Click the Add Named Version flag to promote your current change set to be a Named Version
D – Date/Time that the change was made
E – The user that made the change
Figure 37 - Design History listing all changes as well as Named Versions
The items shown in Figure 37 are reflected in iModel Manager in the web browser.
Figure 38 - Changes mirror in-product sidebar and visible in iModel Manager. Click View to see a particular Named Version in the Web Browser
Named Versions of the iModel can be viewed in the browser by clicking the View button (Figure 38).
Figure 39 – The specific Named Version of this iModel is visible in the web browser.