USER GUIDEBOOK FOR MODEL CONFIGURATION

Size: px

Start display at page:

Download "USER GUIDEBOOK FOR MODEL CONFIGURATION"

Marjory Boyd
5 years ago
Views:

USER GUIDEBOOK FOR MODEL CONFIGURATION Number Revision Date Summary of changes and justifications 0 06/06/17 Creation of OCWS/OMR Guidebook A Editor Checker Approving Charly PALMISANO Charlène JOLYS

1 USER GUIDEBOOK FOR MODEL CONFIGURATION Number Revision Date Summary of changes and justifications 0 06/06/17 Creation of OCWS/OMR Guidebook A Editor Checker Approving Charly PALMISANO Charlène JOLYS Maxime FOURREAU B This document is the intellectual property of ORINOX and is exclusively intended for use by customers who have accepted the terms and conditions of OCWS and OMR. Under Article L of the Intellectual Property Code, no text or element of the document may be reproduced, modified, or disseminated in any way without prior authorization. Any reproduction, even partial, whatever its use, must be the subject of a request to ORINOX. Réf. : OCWS/ OMR Configuration Guidebook Page : 1 sur 37

2 1. INTRODUCTION In this part Presentation of the guidebook Glossary Icons used in this guidebook 1.1. PRESENTATION OF THE GUIDEBOOK This configuration guidebook is intended for OMR and OCWS users. This configuration guidebook is intended for all those using the management and creation of Digital Assets in OCWS and its visualization in OMR. This guidebook introduces the configuration and use of OCWS to store, share, distribute and customize its Digital Asset. All the features described in this guidebook as well as all the screen impressions were realized in June 2017 under Windows 10 and Android. This guidebook may evolve with improvements to OCWS and OMR GLOSSARY Term Definition ORINOX Engineering Center Digital Asset The Digital Asset is a set of data (3D model, hierarchization, links...) resulting from a project. OCWS Web platform for data storage and management. OMR 3D visualization and review application. Target Image used in augmented reality detected by OMR and which displays on it a 3D model. RVM RVM file is an AVEVA Plant Design Management System Model. AVEVA's Plant Design Management System (PDMS) is the most popular 3D design system using 'data centric' technology for managing projects (also used by e3d). FBX It s used to ensure interoperability between digital content creation applications. Augmented Reality Augmented reality is the superposition of reality and elements (sounds, 2D, 3D, videos, etc.) calculated by a real-time computer system. It s most often used on tablet or smartphone. Gyroscopic effect Allows you to directly measure angles of inclination, in this case for a tablet or a smartphone. Réf. : User guidebook for model configuration Page : 2 sur 37

3 1.3. ICONS USED IN THIS GUIDEBOOK Important point Tips and tricks Critical point Soon coming Réf. : User guidebook for model configuration Page : 3 sur 37

4 2. CONTEXT In this part What is digitalization? What is OCWS? What is OMR? How it works? Required items 2.1. WHAT IS DIGITALIZATION? The Digital Asset is the digital twin as a network of contextualized information which captures and enhance the data of any industrial asset and project. In other words, the digitalization refers to the conversion from the physical asset (with 3D models, technical documents, drawings, images, etc.) into its digital twin. The Digital Asset contains information and describes the whole lifecycle of the asset from design, engineering, procurement, construction, commissioning, operations, maintenance, revamping and decommissioning. This approach to the Digital Asset creates an integrated framework of reliable information, supporting and improving at the same time in decision-making, safety and performance. It unifies information that runs through every system, populates every application, and is embedded in every documents and models. It removes barriers to information flows and provides access to that information, both for capital project execution and asset life cycle management. To conclude, the digitalization empowers your entire teams with information that they share and they trust to support the collaboration and the decision-making at the right time. This approach makes it possible to streamline the overall execution of the project, simplifying commissioning, start-up and transfer, minimizing the risks of overruns and increasing operational reliability WHAT IS OMR? ORINOX Model Review ( OMR, is one of the services of ORINOX Cloud Web Services. OCWS ( is a web-based platform for storing and managing your Digital Asset data and an innovative solution to access, edit and view engineering data of your project from the best class softwares (AVEVA, PTC Plus, LFM, OMR). OMR is a digital asset viewing and review application, available on multiple device and OS: smartphone, tablet, Hololens, Occulus, HTC Vive or touch screen, compatible with ios, Android and Windows. OMR is designed to be connected to your Digital Asset via your OCWS account. It is easy to deposit on this platform a file. rvm or.fbx, directly from the preferred design software. Our platform captures the tags and technical information (1D / 2D / 3D) of your Digital Asset. Réf. : User guidebook for model configuration Page : 4 sur 37

5 2.3. HOW IT WORKS? Réf. : User guidebook for model configuration Page : 5 sur 37

6 2.4. REQUIRED ITEMS A computer, a smartphone or a tablet access to OCWS A compatible device to use OMR A target Réf. : User guidebook for model configuration Page : 6 sur 37

7 3. REGISTRATION ON OCWS WEBSITE - Go to the website OCWS: - Click on «Sign up». - Fill in the registration form, check I agree to the OCWS Terms and then click on «Continue». - An activation message will be sent to the address you provided. Once the opened, then click on «Activate my account». Your OCWS account is now activated! Réf. : User guidebook for model configuration Page : 7 sur 37

4. CREATING A DIGITAL ASSET In this part Creating an organization Creating a digital asset Upload your digital asset Convert your model to an OMR package 4.1.

8 4. CREATING A DIGITAL ASSET In this part Creating an organization Creating a digital asset Upload your digital asset Convert your model to an OMR package 4.1. CREATING AN ORGANIZATION - Before creating your Digital Asset, you need to create your organisation. - Once connected to OCWS website, click on the menu «Organizations». - First create a new organization by clicking on «Create an organization». - First, fill in the required fields with the mandatory name of your organization. You can add your company logo (1000x500px), click on Choose File select your file and click on Open. If you have a pro account in OCWS it s your company logo which is displayed in OMR. Réf. : User guidebook for model configuration Page : 8 sur 37

9 - To finish, click on «Save». You created an organization! Réf. : User guidebook for model configuration Page : 9 sur 37

10 4.2. CREATING A DIGITAL ASSET - To create a new Digital Asset, click on «Digital Asset» in the toolbar. - Then, click on Create a new Digital Asset. Réf. : User guidebook for model configuration Page : 10 sur 37

11 - Fill in the required fields Full name, Trigram and Description of the project. You can add also a picture which appears only on this page, click on Choose File, select your picture and click on Open. - To finish, click on «Validate» You created your digital asset! Réf. : User guidebook for model configuration Page : 11 sur 37

To import files, click on «Browse», select your file and click on Open.

12 4.3. UPLOAD YOUR OMR DIGITAL ASSET - On the same page, click on «Go to details». You reach this page: - You can now import RVM and FBX format files. To import files, click on «Browse», select your file and click on Open. - Then click on Upload, the file loads. Réf. : User guidebook for model configuration Page : 12 sur 37

13 You loaded your digital asset on OCWS! Réf. : User guidebook for model configuration Page : 13 sur 37

4.4. CONVERT YOUR MODEL TO AN OMR PACKAGE - Once the file is fully loaded, right-click on the imported RVM/FBX file, «OMR Tools», and «Convert to OMR package».

14 4.4. CONVERT YOUR MODEL TO AN OMR PACKAGE - Once the file is fully loaded, right-click on the imported RVM/FBX file, «OMR Tools», and «Convert to OMR package». You can also convert your RVM of FBX file by clicking directly on the button Convert to an OMR package. Réf. : User guidebook for model configuration Page : 14 sur 37

is converted, a folder will be created with the following details: You may now use OMR on

15 - During the conversion, notifications will appear at the bottom right. The request is sent The conversion is started The conversion is completed - Once the file is converted, a folder will be created with the following details: You may now use OMR on your device to visualize your digital asset. Réf. : User guidebook for model configuration Page : 15 sur 37

5. BASIC CONFIGURATION OF YOUR DIGITAL ASSET FOR OMR Introduction Target configuration Choice of target Adjusting the target Configuration of the sky and ground In this part The configuration of the

16 5. BASIC CONFIGURATION OF YOUR DIGITAL ASSET FOR OMR Introduction Target configuration Choice of target Adjusting the target Configuration of the sky and ground In this part The configuration of the project can only be done on the OCWS site INTRODUCTION - Click on the digital asset configuration XML file, to see the details: If you make changes in the XML file, don t forget to save these changes with the "Save" button. Réf. : User guidebook for model configuration Page : 16 sur 37

17 - To get back at your project you should click on the Digital Assets button on the top of the page Réf. : User guidebook for model configuration Page : 17 sur 37

18 5.2. TARGET CONFIGURATION - You have at your disposal 5 targets: target_01 target_02 target_03 target_04 target_05 Please respect the syntax of target names mentioned above. It is also possible to associate your models with custom targets. For further information please contact us at the following address: digitalization@orinox.com In the targets folder you can download the targets to.jpg and print them for use. Réf. : User guidebook for model configuration Page : 18 sur 37

19 5.3. CHOICE OF TARGETS The default target is the "target_01". - In the XML file, you can change the target among the 5 available. If you want to use target_02, replace target_01 by target_02 in the target part This should give this line: <target name = "target_02" /> - Then in the associations section perform the same operation This should give this line: <association target = "target_02" model = "pof" /> - Once the changes are made click on "Save". The pre-centering of the model on the target is done automatically unless you specify the postition. Réf. : User guidebook for model configuration Page : 19 sur 37

20 5.4. ADJUSTING THE TARGET - When you try to see your model on a target in augmented reality you notice that your model is bigger or smaller than the target? It s because the model has been imported at real size and need to be reduced to appear properly on the target. - Head to the.xml file where you can configure your target, have a look at the line which begins with <ImageTarget name It is this line that you have to modify to resize your model. - You should enter the size of your 3D model to make him appear at the best scale for your target. In our example for a model of 40 meter we set the line at: <ImageTarget name="marqueur_unity" size=" " /> Réf. : User guidebook for model configuration Page : 20 sur 37

21 GROUND By default, ground is not activated. Available grounds: Tar Grass Water - To add a ground, you must activate the line corresponding to the ground that is just below the line corresponding to the sky: <! - - <ground name = "Tar" /> - ->. - To activate this line remove the parts in red: <! - <ground name = "Tar" /> ->. This gives: <ground name = "Tar" /> to display the bitumen. If you want to display grass, replace the word Tar with the word Grass. - Once the changes made click on "Save". To deactivate the sky and the ground, comment1 the line like this (add the elements in red):  1 This means that you disable the line without deleting it. The advantage is a faster reactivation of the element. Réf. : User guidebook for model configuration Page : 21 sur 37

First come back in the Project Management by clicking Edit Project.

22 6. SHARING YOUR OMR DIGITAL ASSET Share for a manager Share for a viewer In this part - You can now share your project with other OMR users. First come back in the Project Management by clicking Edit Project. - At the bottom of the page, you can share your project with two levels of authorization: MANAGERS VIEWERS Réf. : User guidebook for model configuration Page : 22 sur 37

If the user is already registered on OCWS, his name will be automatically displayed.

23 6.1. SHARE FOR A MANAGER - To add a new Manager, click on "User Search". - Then a dialog box opens. Write the complete address. If the user is already registered on OCWS, his name will be automatically displayed. - Then click "Add a manager" to add this user. And click on Validate. - The new manager is added. Réf. : User guidebook for model configuration Page : 23 sur 37

24 - To remove a Manager, click on the button Delete a manager : Réf. : User guidebook for model configuration Page : 24 sur 37

- Replace the old group name with the new, and click on Save : - Your group is renamed - You can remove a group by clicking on Delete a

25 6.2. SHARE FOR A VIEWER To add a new user as a Viewer, you must add him in a group. The viewer group is created by default. - You can rename it by clicking on Edit a Team. - Replace the old group name with the new, and click on Save : - Your group is renamed - You can remove a group by clicking on Delete a Team. - You can also add a new group by clicking on Add a Team. - Then, to add a new user as Viewer, click on the concerned group. It will open a new window and click on User Search. Réf. : User guidebook for model configuration Page : 25 sur 37

- Then a dialog box opens. Write the complete email address.

displayed. - Then click "Add a viewer" to add this user.

26 - Then a dialog box opens. Write the complete address. If the user is already registered on OCWS, his name will be automatically displayed. - Then click "Add a viewer" to add this user. And click on Validate. - The new manager is added. Réf. : User guidebook for model configuration Page : 26 sur 37

7. ADVANCED CONFIGURATION OF YOUR DIGITAL ASSET FOR OMR 7.1. MULTI-EXPORTER The multi-exporter is not yet available, it will be soon in another document.

27 7. ADVANCED CONFIGURATION OF YOUR DIGITAL ASSET FOR OMR 7.1. MULTI-EXPORTER The multi-exporter is not yet available, it will be soon in another document. This tool will allow to export the RVM, the tags and the layers of a project, it will be compatible with the products Aveva PDMS and Aveva E3D. However, you can request it via an optional service. For further information please contact us at the following address: digitalization@orinox.com 7.2. TAGS - Tags are digital asset data associated with a specific object. They also include external links to object-specific data servers (AVEVA Net) and websites. In OMR you will be able to select an item and display an information window that will return to data links, websites etc... Réf. : User guidebook for model configuration Page : 27 sur 37

28 7.3. LAYERS - Layers are data that allow an object to be associated with elements of a Digital asset sharing common properties. In OMR, you will be able to display or dismiss the desired parts of a model TEXTURING MULTI-EXPORTER - Use multi-export to define which objects are with which color group The multi-exporter is not yet available, it will be soon in another document. This tool will allow you to export the RVM, the tags, the layers and colors of a project, it will be compatible with the Aveva PDMS and Aveva E3D products. However, you can request it via an optional service. For further information please contact us at the following address: digitalization@orinox.com Réf. : User guidebook for model configuration Page : 28 sur 37

29 COLORS - You can choose between 16 available colors: These 16 colors are available in 4 specific shaders: - Load the color XML file into your package Réf. : User guidebook for model configuration Page : 29 sur 37

30 - You can modify colors and shaders on XML file. - Activate the XML colors on the XML configuration: Réf. : User guidebook for model configuration Page : 30 sur 37

31 7.5. USING THE LIBRARY STATIC MODELS - You can use elements of the library available in the package. Models available in the library: ANIMATED MODELS The library is prone to modifications. Réf. : User guidebook for model configuration Page : 31 sur 37

32 ACTIVATION OF THE LIBRARY ON THE CONFIGURATION FILE - You can find these items in the library.asset folder, they are categorized by items. - It only remains to activate the line of the library in the configuration XML: - Which gives this: Réf. : User guidebook for model configuration Page : 32 sur 37

33 - To add library templates to the scene, configure the library XML file: - Below a description of the line corresponding to the crane model. We observe that propname corresponds to the model's file, proppath corresponds to its path and posx, posy, posz to its position in the scene to be defined. To adjust its position in the scene, please refer to the chapter 7.5 Walktrough mode. Réf. : User guidebook for model configuration Page : 33 sur 37

34 TAG S MODEL - You can also add information about the library template in the same way as tags. The information lines are deactivated at start, remove the comments to reactivate them. - To put a sentence in the info window put this line template: If you don t want it to return to a web site this will give this: <item type="photo" path="documents" designation="photo.jpg"/> Réf. : User guidebook for model configuration Page : 34 sur 37

35 - Here is a comparison of the information and their result in OMR: Réf. : User guidebook for model configuration Page : 35 sur 37

36 7.6. MULTI-MODEL When a model is converted, it automatically creates a project (a model = a project). If you want to add one or more templates in the same project, you must transfer the elements of the package in question to the original package (the one originally created). - Repeat Chapter 4.3 and 4.4, to load and convert an RVM or FBX file. This gives a package like the previous one (except the models that are different). - Right click on the imported file and go to OMR tools then click on Add to OMR package and choose the package. - This will convert the model and include it in the selected package. - Here the new model (FTN) was converted and it was added in the file of the model. - The ftn template is also included in the xml file, this added a target. - This added the settings of the ftn model, as well as its association with the new target. Réf. : User guidebook for model configuration Page : 36 sur 37

37 You have now all the keys to use OCWS and OMR properly, thank you for using our service. If you have any question, feel free to contact us at Réf. : User guidebook for model configuration Page : 37 sur 37

USER GUIDEBOOK FOR TABLET AND SMARTPHONE

USER GUIDEBOOK FOR TABLET AND SMARTPHONE Number Revision Date Summary of changes and justifications 0 06/06/17 Creation of OCWS/OMR Guidebook A 29/05/18 B Activation of teleport in cardboard model Editor