EXTERNAL MATERIAL DATABASEclicking the button ‘Launch external database’ at the top-right of the Material Databases window. When running fe-safe on Linux the Database server requires

EXTERNAL MATERIAL DATABASEfe-safe 2017

Contents

FE-SAFE® EXTERNAL MATERIAL DATABASE ................................................................... 1

CONTENTS ................................................................................................................. 3

1 INTRODUCTION TO THE FE-SAFE EXTERNAL MATERIAL DATABASE ............................. 5

1.1 ABOUT THE DATABASE .............................................................................................. 5

1.2 ABOUT THIS DOCUMENT ............................................................................................ 5

1.3 PREREQUISITES ....................................................................................................... 5

2 MANAGING THE DATABASE SERVER ........................................................................ 7

2.1 RUNNING THE SERVER .............................................................................................. 7

2.2 CONFIGURING THE SERVER TO RUN REMOTELY .......................................................... 7

3 MANAGING THE SEARCH CLIENT ............................................................................. 9

3.1 CLIENT LICENCE ....................................................................................................... 9

3.2 LAUNCHING THE SEARCH CLIENT .............................................................................. 9

3.3 CONFIGURING THE SEARCH CLIENT TO CONNECT TO A REMOTE DATABASE .................. 9

3.3.1 UI Optimisation Properties (Optional) .................................................................... 9

3.3.2 Look-and-Feel Properties (Optional) .................................................................... 10

3.4 LOGGING ............................................................................................................... 10

4 USING THE SEARCH CLIENT ................................................................................. 11

4.1 INTRODUCTION ....................................................................................................... 11

4.2 MENU .................................................................................................................... 11

4.2.1 File >> Import ....................................................................................................... 11

4.2.2 File >> Export ....................................................................................................... 12

4.2.3 File >> Exit ........................................................................................................... 12

4.2.4 Edit >> Delete selected materials ........................................................................ 12

4.2.5 Edit >> Select from... ........................................................................................... 12

4.3 QUERY PANEL ........................................................................................................ 13

4.4 SUMMARY PANEL ................................................................................................... 14

4.5 DETAILS PANEL ...................................................................................................... 15

4.5.1 Scalar Properties ................................................................................................. 15

4.5.2 Dimensional Properties ........................................................................................ 15

4.5.3 Plots ..................................................................................................................... 16

2 fe-safe® External Material Database Copyright © 2016 Dassault Systemes Simulia Corp.

Issue: 3.0 Date: 01.09.2016

Trademarks

fe-safe, Abaqus, Isight, Tosca, the 3DS logo, and SIMULIA are commercial trademarks or registered

trademarks of Dassault Systèmes or its subsidiaries in the United States and/or other countries. Use of any

Dassault Systèmes or its subsidiaries trademarks is subject to their express written approval. Other

company, product, and service names may be trademarks or service marks of their respective owners.

Legal Notices

fe-safe and this documentation may be used or reproduced only in accordance with the terms of the software

license agreement signed by the customer, or, absent such an agreement, the then current software license

agreement to which the documentation relates.

This documentation and the software described in this documentation are subject to change without prior

notice.

Dassault Systèmes and its subsidiaries shall not be responsible for the consequences of any errors or

omissions that may appear in this documentation.

© Dassault Systèmes Simulia Corp, 2016.

Copyright © 2016 Dassault Systemes Simulia Corp. fe-safe® External Material Database 3

Issue: 3.0 Date: 01.09.2016

Third-Party Copyright Notices

Certain portions of fe-safe contain elements subject to copyright owned by the entities listed below.

© Battelle

© Endurica LLC

© Amec Foster Wheeler Nuclear UK Limited

fe-safe Licensed Programs may include open source software components. Source code for these

components is available if required by the license.

The open source software components are grouped under the applicable licensing terms. Where required,

links to common license terms are included below.

IP Asset Name IP Asset

Version

Copyright Notice

Under BSD 2-Clause

UnZip (from

Info-ZIP)

2.4 Copyright (c) 1990-2009 Info-ZIP. All rights

reserved.

Under BSD 3-Clause

Qt Solutions 2.6 Copyright (c) 2014 Digia Plc and/or its

subsidiary(-ies)

All rights reserved.

http://opensource.org/licenses/BSD-2-Clausehttp://opensource.org/licenses/BSD-3-Clause


Issue: 3.0 Date: 01.09.2016


Issue: 3.0 Date: 01.09.2016

1 Introduction to the fe-safe External Material Database

1.1 About the database

The fe-safe External Material Database consists of the following components:

Database Server – an instance of the Apache Derby database server

Search Client – a user interface (UI) for selecting and viewing materials data

Material data – a database file populated with material data supplied by Dassault Systemes UK

By default the external material database is installed when you run the standard fe-safe Fatigue Analysis

application, and a local copy of the database is installed, which can only be run on the client machine. This

database can also be configured to run on a remote host, but the Search Client always needs to reside on the

same machine as fe-safe.

1.2 About this document

For clarity is used throughout this document to refer to the fe-safe installation directory. This

has no meaning in the actual software.

1.3 Prerequisites

The client and database server both require a Java run-time environment (JRE) at version 1.7.xxx or higher.

This is installed as standard with fe-safe and resides at /jre.


Issue: 3.0 Date: 01.09.2016


Issue: 3.0 Date: 01.09.2016

2 Managing the Database Server

2.1 Running the server

By default, the fe-safe installer installs a local copy of the server, but the server can be run on any network

machine. When a local server has been installed, there is no need to launch it explicitly as it is started by the

same process that launches the search client. This server instance is terminated when the user exits the

search client.

For use as a network server, the database server is invoked using the scripts start-server.bat (on

Windows) or start-server.sh (on Linux), which can be found in the /materials_server/

directory.

2.2 Configuring the server to run remotely

There is currently no installer routine to install just the database server on a remote machine, but it is

straightforward to set it up. The steps are as follows:

a. Create a folder on the remote server (e.g. “remote_dbase”).

b. Copy the /materials_server/ and /jre/ folders into this new

folder.

c. Configure the properties file (/materials_server/derby.properties) to contain

the host name of the remote server. The line to change is derby.drda.host, e.g where “DELL-1000”

is the host name:

derby.drda.host=DELL-1000

derby.drda.portNumber=1527

derby.security.portNumber=1528

d. Start the server using the script start-server.bat (on Windows) or start-server.sh (on Linux) in

/materials_server/.


Issue: 3.0 Date: 01.09.2016


Issue: 3.0 Date: 01.09.2016

3 Managing the Search Client

3.1 Client Licence

The client runs under the standard fe-safe client licence. If you have not yet configured a licence, please see

the main fe-safe User Guide.

3.2 Launching the Search Client

When running fe-safe, the Search Client and an instance of the local Database Server can be launched by

clicking the button ‘Launch external database’ at the top-right of the Material Databases window.

When running fe-safe on Linux the Database server requires root access to launch, so in the event that there is not

already a server component running, when using the ‘Launch external database’ button in the fe-safe gui it will fail to

launch the server and client as a user with typical access privileges.

Alternatively, both client and server can be launched on Windows using the start-menu link ‘External Material

Database’ under the ‘fe-safe ’ folder. There is no need to have fe-safe running to do this.

On Linux, both client and server can be launched outside of fe-safe by running

/exe/material_launcher.

3.3 Configuring the Search Client to connect to a remote database

The client is configured via the materialsdb.config file located in the /materials_client/.

The file is configured by default to connect to a database running on the local host but can easily be

configured to look for a remote server.

e.g where “DELL-1000” is the host name of the remote server:

# database details

com.safetechnology.materialsdb.servername=DELL-1000

com.safetechnology.materialsdb.serverport=1527

com.safetechnology.materialsdb.securityport=1528

3.3.1 UI Optimisation Properties (Optional)

The following properties can be used to change the way the client behaves:

com.safetechnology.materialsdb.ui.hideUnusedPropertyPanels=true

By default the Details Panel will not display a panel for a category that does not have any property values for

the currently selected material. This behaviour can be changed by setting this option to false.

com.safetechnology.materialsdb.ui.hideUnusedScalarProperty=true

By default the Details panel will not display a label for properties that do not have a value for the currently

selected material. This behaviour can be changed by setting this option to false:


Issue: 3.0 Date: 01.09.2016

com.safetechnology.materialsdb.ui.propertyPanelsPerRow = 3

This option can be used to control how many category panels are displayed per row on the Details Panel.

3.3.2 Look-and-Feel Properties (Optional)

com.safetechnology.materialsdb.ui.lookandfeel=Windows

The ‘Look and Feel’ (L&F) of the Search Client can be changed using this option. If the option is not set then

the client will default to the standard Java L&F. The option can be set to a valid name or class for a L&F

available on the client machine.

3.4 Logging

Client logging is implemented used the Apache log4j library. It is configured via the logging.properties file

located in /materials_client/.

By default the logging is performed at ‘Information’ level and appends its output to a file called

materialsdb.log, in the /materials_client/logs directory.

If problems occur with the client, the logging level can be increased to ‘debug’ or ‘trace’ by altering the

following property, replacing INFO with DEBUG or TRACE.

log4j.rootLogger=INFO, stdout, R

The name and location of the output log file can be changed with the following logging property:

log4j.appender.R.File=materialsdb.log


Issue: 3.0 Date: 01.09.2016

4 Using the Search Client

4.1 Introduction

When the client first starts it looks like this:

Figure 4.1-1 - Client at startup

The client contains a menu and the UI is split into the following three areas:

The Query Panel - The left-hand panel is used to enter selection criteria for the materials you wish to

see

The Summary Panel – The top panel displays a list of materials which match the selection criteria

The Details Panel – The bottom panel displays all properties of the material selected in the Summary

Panel

4.2 Menu

4.2.1 File >> Import

Customer material definitions can be imported into the external material database using the File >> Import

menu item.

The user is prompted for a tab-delimited text file which contains material definitions which conform to the

properties currently defined within the external material database. Properties defined in the import file which

are not valid will be ignored.


Issue: 3.0 Date: 01.09.2016

Customer-imported material data can later be deleted from the database (see Section 4.2.4 below).

4.2.2 File >> Export

Material definitions can be exported from the Search Client and saved as Materials Data (e.g. an fe-safe

*.dbase file).

The materials to be exported are selected using the Summary Panel. Once selected, the File >> Export menu

item will prompt the user for a file name and location for the Materials Data.

Up to six materials can be exported. If this limit is exceeded an error message is displayed.

4.2.3 File >> Exit

The File >> Exit menu item can be used to exit the application. You can also click to close the application

window in the usual way.

4.2.4 Edit >> Delete selected materials

Materials are selected for deletion using the Summary Panel.

Customer-imported data can be deleted using this menu. Core data delivered with the installation cannot be

deleted. An error will be displayed if one or more of the selected materials cannot be deleted for this reason.

The Edit >> Select from... feature (see below) can be used to only display / select customer import data

before a delete is attempted.

4.2.5 Edit >> Select from...

The Edit >> Select from... menu item provides three options to limit the range of materials that the user can

select from using the Query Panel. The options are:

Core data only (i.e. materials defined in the supplied database)

User data only (i.e. materials imported by the customer)

All data


Issue: 3.0 Date: 01.09.2016

4.3 Query Panel

A query is built up by entering selection criteria for one or more properties. The properties are grouped into

various categories and can be displayed by clicking on a category button. The button for the currently

selected category is highlighted.

Text-based properties can be searched on by entering some text next to the property name. Numeric

properties can be searched on by entering either a minimum and/or maximum value (see Figure 4.3-1 - Query

Panel with Strain-Life Category selected).

Multiple properties can be searched on at the same time. The selection criteria can be used with logic

operators “AND” (all criteria have to match) or “OR” (one criterion has to match) by using the radio buttons at

the bottom of the Query Panel.

Figure 4.3-1 - Query Panel with Strain-Life Category selected


Issue: 3.0 Date: 01.09.2016

The ‘Clear’ button clears the selection criteria for all properties (including those on hidden category panels).

The ‘Go’ button executes the query using the current selection criteria (from all properties including those on

hidden category panels) and the materials that match the selection (if any) are displayed in the Summary

Panel.

If there are no selection criteria then all materials are displayed.

4.4 Summary Panel

The Summary Panel lists all of the materials selected via the Query Panel. You can select one or more

materials on the Summary Panel by clicking on them.

Figure 4.4-1 - Summary Panel

Selecting one material causes its details to be loaded into the Details Panel.

Selecting multiple materials allows them to be either exported or deleted via the Menu.


Issue: 3.0 Date: 01.09.2016

4.5 Details Panel

The Details Panel displays all of the defined properties for the selected material. The properties are grouped

by category with each category being displayed in a sub-panel.

Different types of properties are displayed as follows.

4.5.1 Scalar Properties

Properties having a single (scalar) value are displayed in a simple text field next to their name.

Figure 4.5-1 - Scalar Properties

4.5.2 Dimensional Properties

Properties having values defined against one or more dimensions are displayed as one or more tables. For

example:

Figure 4.5-2 - Dimensional Properties


Issue: 3.0 Date: 01.09.2016

4.5.3 Plots

Plots are a series of related property values defined for multiple dimension values. They are displayed as a

table with the index property on the vertical axis and the other partner values on the horizontal axis, one

column for each dimension value. For example:

Figure 4.5-3 - Plot Properties

1 Introduction to the fe-safe External Material Database1.1 About the database1.2 About this document1.3 Prerequisites

2 Managing the Database Server2.1 Running the server2.2 Configuring the server to run remotely

3 Managing the Search Client3.1 Client Licence3.2 Launching the Search Client3.3 Configuring the Search Client to connect to a remote database3.3.1 UI Optimisation Properties (Optional)3.3.2 Look-and-Feel Properties (Optional)

3.4 Logging

4 Using the Search Client4.1 Introduction4.2 Menu4.2.1 File >> Import4.2.2 File >> Export4.2.3 File >> Exit4.2.4 Edit >> Delete selected materials4.2.5 Edit >> Select from...

4.3 Query Panel4.4 Summary Panel4.5 Details Panel4.5.1 Scalar Properties4.5.2 Dimensional Properties4.5.3 Plots

Documents

EXTERNAL MATERIAL DATABASEclicking the button ‘Launch external database’ at the top-right of the Material Databases window. When running fe-safe on Linux the Database server requires