study manager release notes

7/27/2019 Study Manager Release Notes

1/43

Study Manager v6.7 Release Notes 1

Study ManagerRelease Notes for Version 6.7

DNV SOFTWAREPalace House, 3 Cathedral Street, London SE19DE, UK

www.dnvsoftware.com

Copyright Det Norske Veritas. All Rights Reserved.No reproduction or broadcast of this material is permitted without the express written consent of DNV.

[email protected] for more information


2/43


Study Manager 6.7 Release Notes

Contents

STUDY MANAGER .......................................................................................4

Overview....................................................................................................................................... 4Study Manager licensing............................................................................................................... 5

How to........................................................................................................... 6Create, save and edit Study Manager files.................................................................................... 6

Creating a Study Manager file ...................................................................................................... 6

Saving a Study Manager file......................................................................................................... 7

Editing a Study Manager file ........................................................................................................ 8

Import PSU/PSC files ................................................................................................................... 9

Use raster images in Study Manager........................................................................................... 12

Red bordered raster images......................................................................................................... 12

Duplicate raster images............................................................................................................... 14

Adding new raster images........................................................................................................... 15

Use GIS external connections ..................................................................................................... 16

Red bordered GIS external connections...................................................................................... 16

Duplicate external connections ................................................................................................... 16

Adding new external connections............................................................................................... 17

Set up preferences ....................................................................................................................... 18

Installation group ........................................................................................................................ 19

General group ............................................................................................................................. 20

Graph group ................................................................................................................................ 22

Map group................................................................................................................................... 23

Risk Group.................................................................................................................................. 24

Deal with combination factors .................................................................................................... 25

Imported combinations ............................................................................................................... 25

Run rows with more combinations........................................................................................... 27

Creating new combinations......................................................................................................... 28

Selecting combinations ............................................................................................................... 28

View results................................................................................................................................. 29

FN curves.................................................................................................................................... 30

Risk contours .............................................................................................................................. 32

Risk transects .............................................................................................................................. 34

Reports ........................................................................................................................................ 36

Create a new study template..................................................................................................... 37

Making the Most of the Documentation...................................................... 41

Study Manager 6.7 Compiled Help............................................................................................. 41Study Manager 6.7 Installation Notes ......................................................................................... 41


3/43


Study Manager 6.7 Release Notes .............................................................................................. 41

For System Administrators: Technical Notes ............................................ 42System Requirements.................................................................................................................. 42

Temporary folders....................................................................................................................... 42

Sentinel Driver ............................................................................................................................ 42

Setting Up and Managing Studies ............................................................... 43Managing Study Folders ............................................................................................................. 43

Memory Management ................................................................................................................. 43


4/43

Study Manager v6.7 Release Notes 4 Study Manager

STUDY MANAGER

Overview

Study Manager is a new tool designed to combine risk results from various Phast Risk and/or SAFETI

NL files, provided they have been saved with results.

This new tool will allow:

monitoring the risks from various closely located installations without the need of one large

study

large studies to be broken down into smaller more manageable studies

summing up of individual and societal risk results in the form of risk contours and FN curves

graphical and tabular results to be displayed

users to determine when out of date data is being manipulated

This tool does NOT

run risk calculations

show individual or societal risk ranking reports

show combined risk contours for studies spaced too far apart

support the Extended Risk Reporting Tool


5/43

Study Manager v6.7 Release Notes 5 Study Manager

Study Manager licensing

Study Manager is a new product within the SAFETI family, and as such it has its own license as well

as being compatible with Phast Risk.

A Study Manager license may be requested using the DNV Software License Wizard from the start

menu

The Wizard will go through all necessary steps to request a license with the final step being an email

sent to [email protected]

Details on the various Wizard steps can be found in the Study Manager Installation Notes.


6/43

Study Manager v6.7 Release Notes 6 How To

How to

Create, save and edit Study Manager files

Study Manager allows for risk results from various studies to be combined. In order to work with

Study Manager, a Study Manager Study (SMS) must be used.

The SMS will have the same file extension options as Phast Risk files, so it can be saved as a PSU or

PSC file. Since the file extensions remain the same, it is important to have descriptive names for the

Study Manager files or to place Study Manager files in a separate location

Creating a Study Manager file

Once Study Manager is opened, files can be created by selecting File > New from the menu. A new

file will be created with a default tree structure as seen below.


7/43


Saving a Study Manager file

Files can be saved by selecting File > Save as from the menu

SMSs can be saved in either PSU or PSC format. The only difference between the file formats is that

PSC files are compressed and will take up less space on the hard disk (or media in use). If PSC files

are renamed they will not work within Study Manager.


8/43


Editing a Study Manager file

There are limitations to the editing that can be done to SMSs. Since the purpose of the tool is to

combine risk results it would not be effective to allow certain activities. Consequently, within SMSs

users:

cannot rename folders

can change the order of the folders in the study tree by selecting the desired folder and

pressing the Ctrl key and the arrow up/down key simultaneously

can change the order of items within a folder by selecting the desired folder and pressing the

Ctrl key and the arrow up/down key simultaneously

can delete unwanted items within a folder

can delete folders no longer wanted in the SMS

can only drag/drop raster images within the study tree

PSU files created using the Study Manager cannot be opened in Phast Risk or SAFETI NL.

These files can only be opened and edited within Study Manager.

Likewise, Phast Risk & SAFETI NL studies cannot be opened in Study Manager.


9/43


Import PSU/PSC files

The only method for getting results into the SMS is importing Phast Risk/SAFETI NL PSU/PSC files.

Files can be imported by selecting File > Import and then choosing the desired file.

Upon import ALL run rows with risk results within the PSU/PSC study will be imported so it is up tothe user to remove any unwanted data after import is complete. It is recommended that run rows not

used within Study Manager be removed after import is complete in order to keep the file size down to

a minimum.

Run rows with up to date risk results will be displayed in blue text. If there are run rows in the

original PSU/PSC file with risk results that are not up to date, the run row will be imported into Study

Manager but the text will be in black to signal that these results are out of date.

Please note that if a run row is red (has errors) in the original PSU/PSC file then it will be imported

and displayed in red text in Study Manager. Users will have no access to the actual errors or why the

original calculation failed from Study Manager.

If there are any run rows in the original PSU/PSC file that DO NOT have risk results, they will NOT

be imported into Study Manager and the message box will state what run rows were omitted due tomissing results, as shown on the image below

If the Phast Risk/SAFETI NL PSU file has no risk results, the following message will appear

Please note a Phast Risk/SAFETI NL PSU/PSC file can have no risk results even if the run rows are

blue in Phast Risk/SAFETI NL. To ensure risk results are present and available for importing into


10/43


Study Manager, check the Options>Preferences>Risk General Tab to ensure that the Model and

Diagnostic Control group box has the various options set to Run.

The imported file will be displayed as a new folder in the study tree and the folder contents will be thevarious existing run rows with risk results in the PSU/PSC file. The folder name is the full path of the

imported PSU/PSC file and this cannot be modified. The name of the run rows cannot be modified

either.

If a PSU/PSC file is nested in various levels, it will not be possible to see the entire path & filename

on the study tree. When hovering the mouse over the folder name (tool tip) the full path & filename

will always be displayed as seen below. However, it is recommended to keep the paths as short as

possible as these will also be displayed in graphs and reports and they may not show fully on theavailable space if they are too long.

Once files are imported into Study Manager, a record of the date & time the study was last modified iskept in order to notify the user of the status of the data being manipulated when compared to the

moment of import of the file.

There are three status notification icons (shown in the dialog below):

1. The original PSU/PSC file remains unaltered since the time the data was imported into Study

Manager. This is represented as a normal folder as shown by folder

T:\02_66AllResults.PSU in the image below

2. The original PSU/PSC file is no longer available in the folder where it was initially imported.

The file may have been moved, deleted, renamed, etc. and it no longer has exactly the same

path & name as before. This is represented as a red folder as shown by folder

T:\03_66AllResultsDayOnly.PSC in the image below


11/43


3. The original PSU/PSC file has been altered since it was imported into Study Manager. The

file may have been altered in Phast Risk/SAFETI NL or perhaps it has been overwritten with

an earlier version than the imported one. This is represented as a red folder with a clock on

it as shown by folder T:\11_654_AllResults.PSC in the image below


12/43


Use raster images in Study Manager

Study Manager uses the available existing raster images to display results.

Red bordered raster images

When a PSU/PSC file is imported the absolute paths to the associated raster images are imported. It

is possible that the raster images will be red bordered upon import:

Red borders on the raster images could be caused by the image not being located where the PSU/PSC

file indicates.


13/43


This can be resolved by double clicking on the raster image with the red border and then clicking on

browse to browse for the correct raster image path

Another option is to move the raster image to the path shown in the dialog above.


14/43


Duplicate raster images

When PSU/PSC files are imported, it is possible that the SMS may end up with duplicate raster

images. Users have option for the management of raster images upon import via the Options >

Preference > General menu.


15/43


In the Preferences dialog, there are tick boxes to determine whether or not raster images will be

imported and also if they are imported whether or not duplicates are excluded

Adding new raster images

Raster images can be added to Study Manager studies in the same manner as they are added to Phast

Risk & SAFETI NL via the map tab by selecting Insert > Raster Image from the menu and then

browsing for the appropriate file.


16/43


Use GIS external connections

Study Manager uses the available existing GIS external connections to display results.

Red bordered GIS external connections

When a PSU/PSC file is imported the absolute paths to the associated external connections are

imported. It is possible that the external connections will be red bordered upon import.

Red borders on the external connections are caused by the files not being located where the PSU/PSC

file indicates.

This can be resolved by double clicking on the external connection with the red border and then

editing the Location, so that it has the correct path.

Another option is to move the external connection files to the location shown in the dialog.

Duplicate external connections

When PSU/PSC files are imported, it is possible that one may end up with duplicate external

connections. Users have option for the management of external connections upon import via the

Options > Preference > General menu.


17/43


In the Preferences dialog, there are tick boxes to determine whether or not feature classes will be

imported and also if they are imported whether or not duplicates are excluded

Adding new external connections

External connections can be added to Study Manager studies in the same manner as they are added to

Phast Risk & SAFETI NL via the map tab by selecting Insert > External Connection from the menu

and then selecting the appropriate file.


18/43


Set up preferences

In order to manage Study Manager studies, a set of preferences has been made available via the

Options > Preferences menu.

The preferences have been grouped into Installation, General, Graph, Map and Risk. These groups

will be further explained below. Explanations will be given when the options are new to Study

Manager; if the features were already present in Phast Risk or SAFETI NL this will be referenced but

not explained in this document


19/43


Installation group

This group contains the Startup, File Locations, Output & Autosave tabs with the same features as

Phast Risk & SAFETI NL. No new features are present in this preference group


20/43


General group

The general group is comprised of Import, Default Style & Miscellaneous tabs. The Import tab is new

to Study Manager where as the Default Style and Miscellaneous tabs are present in Phast Risk and

SAFETI NL. The Miscellaneous tab has some options removed.

Import tab

The items here relate to the actions to take place when importing raster images and external

connections.

Users have the option whether they want to import raster images and external connections or not.

Users also have the option whether they want to allow duplicates of raster images and external

connections or not.


21/43


Default Style tab

This tab indicates the default styles for the items being displayed on the maps.

The settings here WILL NOT affect contours and FN curves, but WILL affect Features, Grids, Risk

Grids & Images. Please note that images only use the translucency setting.


22/43


Graph group

The only tab present in this group is the Contours tab which is identical to the tab in Phast Risk &

SAFETI NL and has exactly the same function as before


23/43


Map group

The tabs in Study Manager are a subset of the tabs present in Phast Risk & SAFETI NL. The tabs

present here are Scale Bar, Display, Feature(Initial), Grid Squares, Grid, Risk Grid & Image and they

all have exactly the same options and function as in Phast Risk & SAFETI NL.

All these tabs and options are directly related to the map display.


24/43


Risk Group

There are two tabs present in Study Manager, the FN Curve & Contours tabs. These are a subset of

the tabs present in Phast Risk and SAFETI NL.

The Contours tab in Study Manager is identical to that in Phast Risk & SAFETI NL.

The FN Curve tab in Study Manager (shown below) does not include the fields of Aversion index,

Number of top-risk items for Reporting Tool Dashboard (version 6.6 & later) and the Preferences for

calculation of FAR value (version 6.6 & later) are also omitted.

Note that if you want to see all possible graphs and reports from the various imported PSU/PSC files

you should set the Minimum Risk Cut-off level to the lowest value used in any of the imported files

otherwise data may not be displayed. This is not done automatically.


25/43


Deal with combination factors

Study Manager handles combination factors in the same fashion as Phast Risk and SAFETI NL.

However, it is necessary to understand how combination factors are handled upon importing a

PSU/PSC file.Within a SMS, the combination factors can be accessed by double clicking at the desired level. For

example, if you double click at the top level (run rows) then you will see the factors table for all run

rows within the SMS. If you double click on a particular run row you will only see the factors table

for that particular run row.

Imported combinations

When a PSU/PSC file is imported, the existing combination factors table is imported with the existing

factors for as many combinations as there are. If there are eight combinations then all eight columns

of factors will be brought in for those run rows.

In the image below, you can see that the file 02_66AllResults.PSU has two run rows (called Day &

Night) and one combination selected


26/43


When this PSU files is imported into Study Manager, the data above then becomes available as shown

below

The Run Row column will display the full path of the original PSU/PSC being imported as well as the

run rows within the file. The following columns behave the same as they did before in Phast Risk &

SAFETI NL.


27/43


Run rows with more combinations

If another file is imported and has more combinations than already exist in the Study Manager file,

then the program will automatically fill in the values as zero (0) for the columns where run rows had

no factors set, as shown below

In the example above, the first two run rows are the same as the previous screen (and there was only

one combination). We have now added two more run rows and this newly added study had 3

combinations in the original file. To complete the data, zeroes have been automatically added in

columns 2 & 3 for the first run rows.


28/43


Creating new combinations

If a user wishes to see data combinations that are not present from the imported run rows, it is always

possible to add more combinations in the same manner as done in Phast Risk & SAFETI NL.

Carrying on from the example above, in this case we add combinations 4 & 5 by clicking on the box

below the combination number and filling in the desired factors for the desired rows. We have nowcombined the Day rows together and the Night rows together as shown below

Combinations can be deleted simply by deleting the factors in the table.

Selecting combinations

Once all the combination factors are in place, the combinations can be selected by checking the

desired columns and run rows as shown in the previous image.

This is done in the same way as in Phast Risk & SAFETI NL


29/43


View results

Combined risk results in Study Manager can be represented in graphics and reports.

All graphic results can be copied to the clipboard and subsequently pasted into a different document(Excel, Word, email, etc).

To do this, while the image is present on the screen, go to Map > Copy to Clipboard and then paste

into the other application.

Notes:

1. the legend will NOT be copied over due to a design feature of the 3rd

party application used

2. the pasted image will look exactly the same as displayed on the screen (if the edge is cut off

on the right or if it is not centered on the screen, it will look the same in the other application)


30/43


FN curves

FN curves in Study Manager behave the same as they do in Phast Risk & SAFETI NL.

It is possible to view FN curves for ALL run rows together by selecting the Run Rows node (top level

in the study tree) and then selecting View > FN Curves from the menu. This will display all selected

run rows and selected combinations in the Combined FN graph and the individual run rows in the F-NCurve graph as shown below


31/43


Please note in the legend for the image below, that the entire path of the run row is listed, so if the path

is too long, the name will be cut off as in the last two run rows. This can be resolved by either

changing the size of the legend to make it wider or by keeping a relatively short path for the PSU/PSC

files being imported.


32/43


Risk contours

Risk contours in Study Manager behave the same as they do in Phast Risk & SAFETI NL.

It is possible to view risk contours for ALL run rows together by selecting the Run Rows node (top

level in the study tree) and then selecting View > Risk Contours from the menu. This will display all

selected run rows and the first selected combination factors column as seen below

To view the contours for an individual run row or an imported PSU/PSC file, simply select the desired

level (run row or folder) and then select View > Risk Contours from the menu


33/43


There is a limitation to the combined contouring within Study Manager. When adding the risk from

each run row an overall risk grid is sized to accommodate all the included run rows as shown in the

following diagram;

Error! Objects cannot be created from editing field codes.

If the run row risk grids are very wide apart then the overall grid can be excessively large. This cangive a very coarse resolution of the risk and the contours will not be displayed in a useful manner.

Increasing the maximum number of cells in the grid will improve the resolution. This value can be

edited on the Contours tab of the Risk Preferences dialog.

Similarly to Phast Risk & SAFETI NL, when viewing contours it is possible to add (superimpose) a

grid, change the labels display and look at the indoor risk by right clicking on the contour and

selecting the desired option.


34/43


Risk transects

In Study Manager, risk transects behave the same as in Phast Risk and SAFETI NL.

To create a risk transect, right click on the contour and select Risk >Transect from the menu


35/43


The cursor will then convert to a cross hair which will be used to determine the start and end of the

risk transect. Once the risk transect is drawn, the graph will immediately be displayed


36/43


Reports

A summary risk report is available within Study Manager. To view the summary risk report select the

desired level (Run Rows node, imported study folder or run row) and select View > Report from the

menu.

The report has two main sections. The first section contains the risk result for the first selected columnin the factors matrix and the second section contains the summary results for the selected run rows

The report can be navigated using the navigation panel on the left hand side; this panel can navigate

through the various run rows in the report.

The report can be managed in the same manner as reports in Phast Risk and SAFETI NL; it can be

exported in various formats, a search on the report can be carried out, etc.


37/43


Create a new study template

Please note this feature is not available to SAFETI NL users.

When a new file is created in Study Manager, the default new file is blank as shown below

It is possible to customize this default file by using the Study Manager Administrator features. To

do this, the user must be logged in as an administrator.


38/43


To start Study Manager in Administrator mode, use the shortcut icon placed in the Start menu.

If no shortcut is present in the Start menu, then the shortcut properties need to be modified to show

/R:StudyManager /A:%USERNAME% at the end of the Target line in the shortcut properties as

shown below. Please note, username will be the name recorded when changes are made to the StudyManager setup.

Once the shortcut has been created and double clicked, the password screen will show up.

Please contact DNVS technical support for the password ([email protected])


39/43


Once in the program in administrator mode, users can create a new file and modify this file as they

would like it to look every time a new file is created.

In the example below a raster image has been added and this image will be present every time a new

file is created.

Once all modifications have been made, the new study folder is ready to be saved. To save the new

study folder file select Options > Administration > Update New Study Folder.


40/43


A dialog will be displayed where a brief change description should be entered and automatically Study

Manager keeps track of who and when the change was made as shown below

Upon pressing OK a new message is displayed, notifying that the previous file has been saved and its

location


41/43

Study Manager v6.7 Release Notes 41 Making the Most of the Documentation

Making the Most of the Documentation

The Documentation folder on the Study Manager 6.7 DVD contains installation and release notes and

should enable you to find answers to most of the questions you may have about Study Manager

The contents of the Documentation Folder are described below.

Study Manager 6.7 Compiled Help

The Online Help for Study Manager 6.7 is in the form of a *.chm filea compiled HTML Help file.

The file will be installed with the rest of the Phast files when you install the program, and you will

normally access it using the Help menu, but you can also open and read the file directly. There is a

separate version of the Help for each product.

In order to read the files, you must have Microsoft Internet Explorer Version 5 or later installed on

your PC, although it does not have to be your default browser. You must also have some additional

files that are specific to Microsoft HTML Help; these are installed automatically during the Phastsetup process, so you should be able to read the files directly if you have already installed Phast.

You may notice that the ? Help button in the title bar of a dialog is no longer available. For help on a

particular dialog you should use the Help button or press F1. In both cases you will be shown

context-sensitive help relevant to the particular dialog and tab that you are looking at.

Study Manager 6.7 Installation Notes

These Installation Notes are supplied in *.PDF form and should be read prior to installation.

Study Manager 6.7 Release Notes

These Release Notes are supplied in *.PDF form, for future reference.


42/43

Study Manager v6.7 Release Notes 42 Technical Notes for System Administrators

For System Administrators: Technical Notes

These notes give technical details to help you improve the performance of Study Manager 6.7 on your

system. They are aimed mainly at secondary support personnel (e.g. IT professionals), but may be

useful for expert users.

System Requirements

Operating

system

Windows XP SP3, Windows Server 2003,

Microsoft Vista, Windows7

Internet

Browser

IE 5.0x. This does not have to be set as your default browser, but you

must have at least this version installed in order to run the program.

Display 800x600 resolution

Screen color

depth

65536 (16-bit) and higher

CPU 32 bit multi-core CPU from Intel or ADM like Intel Core2 Duo

Media DVD-ROM drive or internet connection

Pointing device MS Mouse or compatible

64 bit operating systems are not currently supported. It can be installed but has not been extensively

tested.

Temporary folders

The program uses hard disk space to write temporary, or scratch, files which are subsequently

deleted once the program has been closed down. By default the program uses the subfolder

C:\DNVUser\Temp to write temporary files that are used during the reporting of results.

For large Study Folders these temporary files can require a lot of hard disk space. Study Manager will

crash if there is insufficient hard disk space for it to create the temporary files, so you should avoid

running Study Manager if the free space on your hard disk is low.

Study Manager uses a third party product called Seagate Crystal Reports to produce text reports.

Crystal Reports always uses the temporary folder set up by your operating system for its own scratch

file space, and by default this is generally the C:\Temp folder.

Sentinel Driver

The Sentinel Driver installation is no longer part of the pre-requisites for the 6.7 installation. The

driver is only necessary if you use a parallel port dongle. The main reason for its removal is that itcauses pre-requisites failure if a newer version already exists (and very few of you have this type of

dongle anyway). Should you want to use parallel dongle for Study Manager, please run as

administrator the driver in "C:\Program Files\DNV\FLEXLm\Drivers\Sentinel Protection Installer

7.5.0.exe".


43/43

Study Manager v6.7 Release Notes 43 Setting Up and Managing Large Studies

Setting Up and Managing Studies

Managing Study Folders

Some general points:

You should always save your Study Folder before generating results. This will ensure that you

do not lose any changes that you have made to the study data in the unlikely event that a

condition emerges in the generation of results that means that the program must be terminated.

You should use only letters, numbers and underscores (_) in the names of Study Folder files,

and should not use special characters such as commas or quotation marks.

Memory Management

Study Manager can use a lot of memory (RAM) when viewing lots of results. You should follow this

simple rule to avoid problems with memory:

Close all out-of-date Reports and Graphs if you are no longer using them. You can alwaysreopen the Report or Graph if you need to view it again;

Runtime memory is memory which will be used by Study Manager for storing results as it performs its

calculations; it is a combination of fixed RAM plus virtual (hard disk substitute) memory. You can

adjust the total available memory size using the System option in the Control Panel. Consult your IT

professional before altering any of these settings.

It has not been explicitly mentioned that the application is a single-thread software and increasing

cores or CPUs will not improve calculation. However, multi-cores would benefit the overall user

experience as the OS, Outlook, SQL Server or other applications can use the other system capacities.

In this case, the bottleneck may be the RAM or disk read/write speed (local or remote).

study manager release notes

Documents