fe-safe 2017 EXTERNAL MATERIAL DATABASE

Transcription

1 fe-safe 2017 EXTERNAL MATERIAL DATABASE

2

3 Contents FE-SAFE EXTERNAL MATERIAL DATABASE... 1 CONTENTS INTRODUCTION TO THE FE-SAFE EXTERNAL MATERIAL DATABASE ABOUT THE DATABASE ABOUT THIS DOCUMENT PREREQUISITES MANAGING THE DATABASE SERVER RUNNING THE SERVER CONFIGURING THE SERVER TO RUN REMOTELY MANAGING THE SEARCH CLIENT CLIENT LICENCE LAUNCHING THE SEARCH CLIENT CONFIGURING THE SEARCH CLIENT TO CONNECT TO A REMOTE DATABASE UI Optimisation Properties (Optional) Look-and-Feel Properties (Optional) LOGGING USING THE SEARCH CLIENT INTRODUCTION MENU File >> Import File >> Export File >> Exit Edit >> Delete selected materials Edit >> Select from QUERY PANEL SUMMARY PANEL DETAILS PANEL Scalar Properties Dimensional Properties Plots... 16

4 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, fe-safe External Material Database Copyright 2016 Dassault Systemes Simulia Corp.

5 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 Info-ZIP) (from 2.4 Copyright (c) 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. Copyright 2016 Dassault Systemes Simulia Corp. fe-safe External Material Database 3

6 4 fe-safe External Material Database Copyright 2016 Dassault Systemes Simulia Corp.

7 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 <install_dir> 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 <install_dir>/jre. Copyright 2016 Dassault Systemes Simulia Corp. fe-safe External Material Database 5

8 6 fe-safe External Material Database Copyright 2016 Dassault Systemes Simulia Corp.

9 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 <install_dir>/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 <install_dir>/materials_server/ and <install_dir>/jre/ folders into this new folder. c. Configure the properties file (<remote_dbase>/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 <remote_dbase>/materials_server/. Copyright 2016 Dassault Systemes Simulia Corp. fe-safe External Material Database 7

10 8 fe-safe External Material Database Copyright 2016 Dassault Systemes Simulia Corp.

11 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 <version> 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 <install_dir>/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 <install_dir>/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= 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: Copyright 2016 Dassault Systemes Simulia Corp. fe-safe External Material Database 9

12 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 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 <install_dir>/materials_client/. By default the logging is performed at Information level and appends its output to a file called materialsdb.log, in the <install_dir>/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 10 fe-safe External Material Database Copyright 2016 Dassault Systemes Simulia Corp.

13 4 Using the Search Client 4.1 Introduction When the client first starts it looks like this: Figure 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 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. Copyright 2016 Dassault Systemes Simulia Corp. fe-safe External Material Database 11

14 Customer-imported material data can later be deleted from the database (see Section below) 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 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 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 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 12 fe-safe External Material Database Copyright 2016 Dassault Systemes Simulia Corp.

15 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 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 Query Panel with Strain-Life Category selected Copyright 2016 Dassault Systemes Simulia Corp. fe-safe External Material Database 13

16 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 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. 14 fe-safe External Material Database Copyright 2016 Dassault Systemes Simulia Corp.

17 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 Scalar Properties Properties having a single (scalar) value are displayed in a simple text field next to their name. Figure Scalar Properties Dimensional Properties Properties having values defined against one or more dimensions are displayed as one or more tables. For example: Copyright 2016 Dassault Systemes Simulia Corp. fe-safe External Material Database 15 Figure Dimensional Properties

18 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 Plot Properties 16 fe-safe External Material Database Copyright 2016 Dassault Systemes Simulia Corp.