user guidebook for model configuration - … guidebook for model... · plant design management...

Auteur : ORINOX Date : 16/10/2017

Réf. : OCWS/ OMR Configuration Guidebook Page : 1 sur 37

ORINOX SAS – 12 route des Fougerays – 44110 CHATEAUBRIANT – 02.40.07.23.40 - [email protected] SAS au capital de 176 023 € - RCS NANTES : 507 959 203 – NAF : 7112B – N°TVA Intracommunautaire : FR55507959203

USER GUIDEBOOK FOR

MODEL CONFIGURATION

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.111-1 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.

Revision Summary of changes and justifications

Editor Checker Approving Number Date

0 06/06/17 Creation of OCWS/OMR Guidebook Charly

PALMISANO Charlène

JOLYS Maxime

FOURREAU

A

B


Réf. : User guidebook for model configuration Page : 2 sur 37


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.

1.2. 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.




1.3. ICONS USED IN THIS GUIDEBOOK

Important point

Tips and tricks

Critical point

Soon coming




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.

2.2. WHAT IS OMR ? ORINOX Model Review (https://omr.orinox.com/), OMR, is one of the services of ORINOX Cloud Web Services. OCWS (https://ocws.orinox.com) 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.




2.3. HOW IT WORKS ?




2.4. REQUIRED ITEMS

A compatible device to use OMR

https://omr.orinox.com/

A computer, a smartphone or a tablet access to OCWS

https://ocws.orinox.com/

A target

https://omr.orinox.com/data/targets.pdf




3. REGISTRATION ON OCWS WEBSITE

- Go to the website OCWS: https://ocws.orinox.com

- Click on « Sign up ».

- Fill in the registration form, check “I agree to the OCWS Terms” and then click on « Continue ».

- An activation email message will be sent to the email address you provided. Once the email

opened, then click on « Activate my account ».

Your OCWS account is now activated!

https://ocws.orinox.com/




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.




- To finish, click on « Save ».

You created an organization!




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”.




- 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!




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.




You loaded your digital asset on OCWS!




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”.




- 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.




5. BASIC CONFIGURATION OF YOUR DIGITAL ASSET FOR OMR

In this part

• Introduction

• Target configuration

• Choice of target

• Adjusting the target

• Configuration of the sky and ground

The configuration of the project can only be done on the OCWS site.

5.1. 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.




- To get back at your project you should click on the Digital Assets button on the top of the

page




5.2. TARGET CONFIGURATION

- You have at your disposal 5 targets:

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: [email protected]

In the targets folder you can download the targets to .jpg and print them for use.

target_01 target_02 target_03

target_04 target_05




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.




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="40.000000 400.000000" />

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.




6. SHARING YOUR OMR DIGITAL ASSET

In this part

• Share for a manager

• Share for a viewer

- 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




6.1. SHARE FOR A MANAGER - To add a new Manager, click on "User Search" .

- Then a dialog box opens. Write the complete email 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.




- To remove a Manager, click on the button “Delete a manager” :




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”.




- Then a dialog box opens. Write the complete email 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.




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: [email protected]

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 ...




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.

7.4. 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: [email protected]




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




- You can modify colors and shaders on XML file.

- Activate the XML colors on the XML configuration:




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.




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:




- 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.




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"/>




- Here is a comparison of the information and their result in OMR:




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.




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 [email protected]

user guidebook for model configuration - … guidebook for model... · plant design management...

Documents