The OpenAltaRica Platform

GETTING STARTED

Sumary
This document quickly presents the OpenAltaRica platform dedicated to MBSA (Model-Based Safety Assessment)
and based on the AltaRica 3.0 modeling language.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 1

© COPYRIGHT IRT SYSTEMX 2015-2017
 TABLE OF CONTENTS
1. PRELIMINARIES.............................................................................................................................................................. 3
2. INSTALLATION ............................................................................................................................................................... 3
1. WINDOWS OPERATING SYSTEM ................................................................................................................................................. 3
2. LINUX OPERATING SYSTEM ....................................................................................................................................................... 4
3. MACOS OPERATING SYSTEM ..................................................................................................................................................... 4

3. USES .............................................................................................................................................................................. 4
4. CREATE A NEW PROJECT........................................................................................................................................................... 6
5. CREATE A NEW ALTARICA 3.0 MODEL ........................................................................................................................................ 9
6. COMPILE AN ALTARICA 3.0 MODEL ......................................................................................................................................... 11
7. PERFORM A ‘STEPWISE’ SIMULATION ........................................................................................................................................ 14
8. PERFORM A FAULT TREE ASSESSMENT FROM AN ALTARICA 3.0 MODEL ........................................................................................... 18
9. PERFORM A STOCHASTIC SIMULATION ...................................................................................................................................... 24
10. OPEN AN EXISTING PROJECT ............................................................................................................................................... 30

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 2

© COPYRIGHT IRT SYSTEMX 2015-2017
1. Preliminaries
AltaRica 3.0 is the new version of the modeling language AltaRica dedicated to risk analysis (safety, reliability,
performance) of complex systems.
The OpenAltaRica platform provides several tools to perform such analyses. This platform is protected by French
laws and provided under a specific license. For any information or problem, see the OpenAltaRica forum or
contact us. Finally if ever, report a bug (if not available, see the OpenAltaRica forum or contact us).
This document presents the overall process to install and configure the OpenAltaRica platform. According to the
evolution of the platform, this document will change (a lot). Please check you are up to date for both this document
and the platform.

2. Installation
The OpenAltaRica platform is (will be ) available for Windows, Linux and macOS operating systems. The
following describes the entirely process to install the OpenAltaRica Platform on your operating system. For any
information or problem, see the OpenAltaRica forum or contact us.

To download and install the OpenAltaRica platform, go to the OpenAltaRica downloads page and download the
suited package according to your operating system.

1. Windows operating system

Extract the downloaded compressed file into the folder of your choice:
e.g. ‘C:\OpenAltaRica’
You can rename this extracted folder, e.g. ‘OpenAltaRica-v1.0.0’;
WARNING:
 ensure you have full "Read" and "Execute" permissions on this folder;
 ensure the absolute file system path to this folder (also including this folder) does not include spaces and
parenthesis;

The OpenAltaRica Platform directory contains several elements:

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 3

© COPYRIGHT IRT SYSTEMX 2015-2017
  The folder ‘AltaRicaWizard’, including the AltaRica 3.0 editor to design AltaRica 3.0 models;
 The folder ‘Tools’ including tools to perform analyses on AltaRica 3.0 models or other models (e.g. fault
trees);
 The file ‘Change.log’ providing information about modifications between the previous version and the
actual;
 The file ‘OAR-CGU-v1.0.pdf’ providing the terms of use (in French) for default Users.

Go to the directory ‘AltaRicaWizard’. The binary file ‘AltaRicaWizard.exe’ (or ‘AltaRicaWizard’ if

files’ extension are not shown) is the dedicated editor to design AltaRica 3.0 models.

2. Linux operating system

Coming soon!

3. macOS operating system

Coming soon!

3. Uses

Go to the directory ‘AltaRicaWizard’ and start the binary ‘AltaRicaWizard’

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 4

© COPYRIGHT IRT SYSTEMX 2015-2017
A new window opens, it is the dedicated editor to design AltaRica 3.0 models:

The first and important thing to remember is the help: Click on ‘Help’ and select ‘Help’.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 5

© COPYRIGHT IRT SYSTEMX 2015-2017
After launching this AltaRicaWizard, you can now use it.

4. Create a new project

To create a new project, follow these steps:
1. Click on ‘File’, select ‘New File or Project’ and ‘New Project’;

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 6

© COPYRIGHT IRT SYSTEMX 2015-2017
 2. A new window opens. Enter the name of your new project (e.g. ‘MyNewProject’), click on ‘Browse…’ to
define its location. The button ‘Create new directory’ must be clicked if you want to create the directory
according to the name of your project. Finally click on ‘OK’;

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 7

© COPYRIGHT IRT SYSTEMX 2015-2017
 3. The ‘Projects’ explorer part of the AltaRicaWizard contains the new project (e.g. ‘MyNewProject’). By
default, it contains nothing.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 8

© COPYRIGHT IRT SYSTEMX 2015-2017
 5. Create a new AltaRica 3.0 model
To create a new AltaRica 3.0 model into an existing project, follow these steps:
1. Into the ‘Projects’ explorer part of the AltaRicaWizard, right-click on your project (e.g. ‘MyNewProject’)
and select ‘Add new file to’;

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 9

© COPYRIGHT IRT SYSTEMX 2015-2017
 2. A new window opens. Edit the name of your model (e.g. ‘MyNewModel.alt’); you can create it into a sub-
directory (e.g. ‘ARModels’) and click on ‘Save’ (or ‘Enregistrer’);

3. Your new AltaRica 3.0 model is now created into your project and you can now edit it.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 10

© COPYRIGHT IRT SYSTEMX 2015-2017
 6. Compile an AltaRica 3.0 model
In order to be assessed, an AltaRica 3.0 model must be compiled (more precisely flattened). Click on ‘Tool’ and
select ‘Flattening’.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 11

© COPYRIGHT IRT SYSTEMX 2015-2017
A first static analysis is realized on your model and if no error, a new window opens. You can choose where the
flattened model is created (e.g. ‘GTSModels/MyNewModel.gts’). Then click on ‘Next’

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 12

© COPYRIGHT IRT SYSTEMX 2015-2017
The AltaRica 3.0 compiler is launched and if no error occurs, you can see ‘Compile AltaRica model: OK.’ into
the Console part of the AltaRicaWizard.
The flattened model is created and inserted within your project (e.g. ‘GTSModels/MyNewModel.gts’); it is a XML
file.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 13

© COPYRIGHT IRT SYSTEMX 2015-2017
In case of errors into your model, please refer to the AltaRica 3.0 language specification.

This compilation step can be realized when launching a specific assessment tool.

7. Perform a ‘stepwise’ simulation

Click on ‘Tool’ and select ‘Stepwise simulation’

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 14

© COPYRIGHT IRT SYSTEMX 2015-2017
A new window opens. The first part performs a compilation of your model (see part. 6); click on ‘Next’.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 15

© COPYRIGHT IRT SYSTEMX 2015-2017
The second part just shows information. Click on ‘Next’

A new window opens: it is a graphical interface for the stepwise simulator.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 16

© COPYRIGHT IRT SYSTEMX 2015-2017
You can select which information you want to be shown: variables, events, etc.
To fire a transition, just click on it (the orange square with the letter ‘ T’). If a transition can be fired, it’s value is
‘fireable’.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 17

© COPYRIGHT IRT SYSTEMX 2015-2017
 8. Perform a fault tree assessment from an AltaRica 3.0 model
Click on ‘Tool’ and select ‘Compilation into Fault Tree’

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 18

© COPYRIGHT IRT SYSTEMX 2015-2017
A new window opens. The first part performs a compilation of your model (see part. 6); click on ‘Next’.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 19

© COPYRIGHT IRT SYSTEMX 2015-2017
Into the second part, you can define where the file containing the fault trees is created (e.g.
‘FaultTrees/MyNewModel.opsa’). These fault trees are generated according Boolean observers defined into your
AltaRica 3.0 model (by default, one Boolean observer corresponds to one top event of a fault tree).
You can also directly launch the fault tree assessment tool by clicking the dedicated button. You have to choose the
top event you want to study into the observer part (and also the value).
Then click on ‘Next’.

A new window opens. It is the fault tree assessment user interface.

Into the ‘Files’ menu, you have to choose:
- The input file containing the fault trees from your ArtaRica 3.0 model (e.g.
‘FaultTrees/MyNewModel.opsa’).
- The command file for the fault tree assessment tool (e.g. ‘FaultTrees/MyNewModel.xfta’).

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 20

© COPYRIGHT IRT SYSTEMX 2015-2017
Into other menues (Minimal Cutsets, Probability & Importance Factors, etc.) you can choose indicators to compute
and which files to save results (e.g. ‘FaultTrees/Results.txt’ for minimal cutsets with Orders).
Then click on ‘Create’

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 21

© COPYRIGHT IRT SYSTEMX 2015-2017
Then into the ‘Calculations’ part, click on ‘Launch’.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 22

© COPYRIGHT IRT SYSTEMX 2015-2017
If everithing is OK, you have the following window:

Finally you can show the file(s) of results by openning it (them) with the menu: click on ‘File’, select ‘Open File
or Project’, ‘Open File’ and choose your file (e.g. ‘FaultTrees/Results.txt’).

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 23

© COPYRIGHT IRT SYSTEMX 2015-2017
 9. Perform a stochastic simulation
Click on ‘Tool’ and select ‘Stochastic simulation’

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 24

© COPYRIGHT IRT SYSTEMX 2015-2017
A new window opens. The first part performs a compilation of your model (see part. 6); click on ‘Next’.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 25

© COPYRIGHT IRT SYSTEMX 2015-2017
The second part allows you to define indicators (e.g. when the observer ‘oTE’ of the AltaRica 3.0 has the value
‘true’): click add and fill up into the new opened window.
You can choose where to save the file defining indicators for the stochastic simulation (e.g.
‘Stochastic/MyNewModel.idf’).
Then click on ‘Next’

The third part allows you to define where to create the stochastic simulator (e.g.
‘Stochastic/MyNewProject.exe’).
Then click on ‘Next’.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 26

© COPYRIGHT IRT SYSTEMX 2015-2017
The fourth part allows you to specify the number of simulations, the mission time and other information.
You can also specify the output file for the results (e.g. ‘Stochastic/results.csv’).
Then, click on ‘Next’.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 27

© COPYRIGHT IRT SYSTEMX 2015-2017
The fifth and last part just summarizes the differents previous elements. Click on ‘Next’ and the stochastic simulation
is launched.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 28

© COPYRIGHT IRT SYSTEMX 2015-2017
If everything is Ok, a specific new window opens. Click on ‘OK’.

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 29

© COPYRIGHT IRT SYSTEMX 2015-2017
The result of the simulation is printed into the defined file (e.g. ‘Stochastic/results.csv’). You can open it
with a specific spreadsheet tool (e.g. LibreOffice Calc, Microsoft Excel, etc.).

10. Open an existing project

Assuming you have an existing project (e.g. ‘MyNewProject’).
Follow these steps:
1. Click on ‘File’, select ‘Open File or Project’ and ‘Open Project’;

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 30

© COPYRIGHT IRT SYSTEMX 2015-2017
 2. A new window opens. Select the project you want to open (e.g. ‘MyNewProject’) and then click on ‘Open’
(or ‘Ouvrir’).

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 31

© COPYRIGHT IRT SYSTEMX 2015-2017
 3. The Projects explorer part of the AltaRicaWizard contains the opened project (e.g. ‘MyNewProject’).

ISX-OAR-2015-i0005-v3.0 The OpenAltaRica Platform – Getting Started PAGE 32

© COPYRIGHT IRT SYSTEMX 2015-2017