MTS TestSuite™ Fatigue Analyzer User Guide 100-209-352 E be certain.
© 2013 MTS Systems Corporation. All rights reserved. Trademark Information MTS, FlexTest, RPC, and TestWare are registered trademarks and MTS Acumen, MTS TestSuite, Station Builder, and Station Manager are trademarks of MTS Systems Corporation within the United States. These trademarks may be protected in other countries. All other trademarks are the property of their respective holders.
Contents 1.0 Technical Support 7 1.1.0 How to Get Technical Support........................................................................................................7 1.2.0 Before You Contact MTS................................................................................................................7 1.3.0 If You Contact MTS by Phone........................................................................................................9 1.4.0 Problem Submittal Form in MTS Manuals.............
.2.4.0 Opening an Existing Analysis Run................................................................................33 5.0 Customizing the Main Window 35 5.1.0 Overview.......................................................................................................................................36 5.1.1.0 Understanding Views and Displays................................................................................36 5.1.2.0 Creating, Editing, and Deleting Views...............................
6.3.1.0 Multiple Test Runs Overview.........................................................................................57 6.3.2.0 Analyze Multiple Test Runs...........................................................................................58 6.3.3.0 Failure Cycle Analysis Example....................................................................................58 6.3.4.0 Loading Unloading Modulus Analysis Example...........................................................63 6.4.
7.6.1.0 Variable Mapping...........................................................................................................90 7.6.2.0 Mapping a Signal to a Variable......................................................................................92 7.6.3.0 Mapping Additional Variable Calculations....................................................................92 7.6.4.0 Tagged Blocks...............................................................................................................
1.0 Technical Support 1.1.0 How to Get Technical Support Start with your manuals The manuals supplied by MTS provide most of the information you need to use and maintain your equipment. If your equipment includes software, look for online help and README files that contain additional product information. Technical support methods MTS provides a full range of support services after your system is installed.
Know your site number and system number The site number contains your company number and identifies your equipment type (such as material testing or simulation). The number is typically written on a label on your equipment before the system leaves MTS. If you do not know your MTS site number, contact your sales engineer. Example site number: 571167 When you have more than one MTS system, the system job number identifies your system. You can find your job number in your order paperwork.
• Keyboard enhancers • Print spoolers • Messaging applications 1.3.0 If You Contact MTS by Phone A Call Center agent registers your call before connecting you with a technical support specialist. The agent asks you for your: • Site number • Name • Company name • Company address • Phone number where you can be reached If your issue has a notification number, please provide that number. A new issue will be assigned a unique notification number.
• Write down any specific instructions. After you call MTS logs and tracks all calls to ensure that you receive assistance for your problem or request. If you have questions about the status of your problem or have additional information to report, please contact Technical Support again and provide your original notification number. 1.4.
2.0 Preface 2.1.0 Before You Begin Safety first! Before you use your MTS product or system, read and understand the safety information provided with your system. Improper installation, operation, or maintenance can result in hazardous conditions that can cause severe personal injury or death, or damage to your equipment and specimen. Again, read and understand the safety information provided with your system before you continue.
CAUTION: Caution notices indicate the presence of a hazard with a low level of risk which, if ignored, could cause moderate or minor personal injury or equipment damage, or could endanger test integrity. Other special text conventions Important: Important notices provide information about your system that is essential to its proper function. While not safety-related, if the important information is ignored, test results may not be reliable, or your system may not operate properly.
Hypertext links The electronic document has many hypertext links displayed in a blue font. All blue words in the body text, along with all contents entries and index page numbers, are hypertext links. When you click a hypertext link, the application jumps to the corresponding topic.
3.0 Introduction Topics: • • • • • Application Overview.............................................................................................................................16 Overview of MTS TestSuite File Structure.............................................................................................16 Viewing the Main Window......................................................................................................................24 Using the Menu Bar..............................
3.0 Introduction 3.1.0 Application Overview This application enables standard and custom in-depth analysis of test data, including post-processing, using basic statistical and graphical displays. The application supports test run data from the Multipurpose Elite application and Model 793.20 Cyclic Fatigue software. Some features of this application function the same way that they do in the Multipurpose Elite application.
3.0 Introduction Name Icon Test Test Template Description A test is the core component of MTS TestSuite. The test contains the test definition along with any test runs, analysis definitions, or analysis runs that have been created. Test templates eliminate the need to re-create existing information and provide an easy way to run standard tests. Test Run A test run contains all data that was gathered during a single run of the test.
3.0 Introduction A Project Contains Project Settings, Tests, and Test Templates 3.2.2.0 Test A Test is stored within a project folder, and contains the following components: • Test Definition—Contains the main components of the test, such as the procedure, variables, test-run display, resources, functions, and report templates. • Test Run(s)—Contains information that was gathered during the test run, such as variable values.
3.0 Introduction A Test Contains the Test Definition, Test Run(s), Analysis Definition(s), and Analysis Run(s) 3.2.3.0 Test Definition The test definition is stored within the test. The test definition contains the following main components that define the test: • Procedure: A collection of test activities that are performed step-by-step when the test is run. • Resources: A collection of test resources mapped to the controller resources that will be used during the test.
3.0 Introduction of the test. After a test run is complete, values that are stored in variables can be changed using the Fatigue Analyzer and the Fracture Analyzer in order to simulate various "what if" scenarios. • Test-Run Display: A customizable user interface that shows data when the test is run. • Report Templates: A collection of Microsoft Excel Template files that define the layout of generated reports. • Functions: A sequence of instructions that receive arguments and produce a result. 3.2.4.
3.
3.0 Introduction 3.2.5.0 Test Run State Colors The color of a test run entry indicates its run state. Test Run State Colors Color Description Black The test run completed successfully. Dark Blue The test run initialized successfully but has not run. Red The test run stopped. Orange The test run is running, on hold, or an error occurred. If a test run name is orange, data may not be available. If an error occurs while the test runs, no data is viewable.
3.0 Introduction An Analysis Definition Contains Views, Displays, Variables, DAQ Mappings, and Functions 3.2.7.0 Analysis Runs Analysis runs apply the views and variables of an analysis definition to the data from one or more test runs stored in the same test. An analysis run does not alter the original test data, but uses the data to produce an independent set of analysis results. An analysis run contains the analysis results and any reports generated within the analysis run.
3.0 Introduction Analysis Runs use the Analysis Definition and Test Run Data to Generate Data 3.3.0 Viewing the Main Window The Fatigue Analyzer application main window has four sections: • The top section contains menu options and a toolbar. • The left section contains the Explorer. • The major portion of the window contains the work area. • The bottom section contains the Error List panel and the Message Log.
3.0 Introduction Number Description 3 4 5 6 Error List Panel Click arrow to close Error List and Message Log Work Area Application Log 3.4.0 Using the Menu Bar 3.4.1.0 File Menu Options Menus provide navigation to several user activity options. The File menu supports file-level and analysis-level activities. File Menu Options Item Description Open Test Shows the Open Test window that contains a list of available tests.
3.0 Introduction Item Export Description • Test Run—Imports a test run. • Legacy Data—Retrieves test runs, templates or files from data archived from previous software products. For more information about importing legacy files, see the Multipurpose Elite User guide that is included with your MTS TestSuite installation CD. • Test Stores an analysis test to disk as a file with a .tsproj file extension. This option provides a convenient way to transfer test data between workstations.
3.0 Introduction View Menu Options Item Description Re-Dock All Views Returns all views to a docked position. Close All Views Closes all views in the work area. Zoom Allows you to click and drag to select an area of a chart to zoom in to. To reset the zoom level, right-click the chart and select Reset Zoom. Point Picking Shows vertical and horizontal guidelines that move with the cursor. Highlight a point on the graph to show its X and Y values. Format Axes Shows the Format Axes window.
3.0 Introduction Item Description Message Log Shows or removes the Message Log panel. A check mark appears next to the menu item when the panel is active. To remove or show the panel, click the menu item. Error List Shows or removes the Error List panel. A check mark appears next to the menu item when the panel is active. To remove or show the panel, click the menu item. 3.4.5.0 Tools Menu Options Use the Tools menu to access other MTS TestSuite applications.
3.0 Introduction 3.5.0 Using the Analysis Toolbar The Analysis Toolbar allows you to click an icon to create a new chart or table, manage editors, functions, views, and displays. Analysis Toolbar Item Description New Array-Variable Chart Create a chart to show data that is collected and calculated during each test cycle and stored in arrays. New History Chart Create a history chart to plot cycle data in relation to time or another index type.
3.0 Introduction Item Description Refresh All Analysis Views Update all references to variables, calculation, and data acquisition definitions using the current configuration and overridden variable values. Unlock the Current Analysis Allows you to select and open a different analysis run in the Explorer panel. You can open the Variable Editor or Data Acquisitions Editor, make changes, refresh the screen, and show updates when locked.
4.0 Getting Started Topics: • • Begin an Analysis..................................................................................................................................32 Data Analysis.........................................................................................................................................
4.0 Getting Started 4.1.0 Begin an Analysis You can begin an analysis using a sample test to help you learn the application. If you have a test created in a testing application that contains at least one test run with valid data, you can begin analyzing your test results instead. 4.1.1.0 Analyze Example Test Data To familiarize yourself with the software, begin an analysis using an example test: 1. 2. 3. 4. On the File menu, click Open Test. Select the Sample LCF Strain Test . Click OK and then Open.
4.0 Getting Started 4.2.0 Data Analysis 4.2.1.0 Activities and Tests Analysis activities include mathematical and statistical evaluation of the results obtained from the material test of one or more specimens. An evaluation of data from multiple test runs is a multi-run analysis. A project is a collection of settings that indicate where different items necessary for a test can be found. When the test is opened, it opens with default settings when looking for external files and reports.
5.0 Customizing the Main Window Topics: • • • Overview................................................................................................................................................36 Configuring Chart and Table Properties.................................................................................................40 Charts and Tables (Views).....................................................................................................................
5.0 Customizing the Main Window 5.1.0 Overview 5.1.1.0 Understanding Views and Displays Within the application's main window, data is shown in Charts and Tables. Charts and tables may also be called Views. Views contain cycle selection settings and analysis variables mapped to test run variables. The content of each view is context-specific and depends on the property settings that are selected for the view.
5.0 Customizing the Main Window Four Views Containing Peak-Valley Data When you are finished resizing the views to your liking, you can save the current on-screen presentation of views as a Display so that you do not have to recreate it in the future. A display is simply a certain organization and presentation of different views. When you save the display, the size, shape, and location of each view within the display is saved.
5.0 Customizing the Main Window 5.1.2.0 Creating, Editing, and Deleting Views When you create a new view, it is stored in the analysis run. If you delete a view, no change is made to any display that contains the view. The only change is that the display no longer contains the view. Although the application saves the view, the application does not save the original content. If you modify the analysis definition to use new variable values, the presented content changes.
5.0 Customizing the Main Window Split-Screen Display Undocked displays When an undocked display is closed, only the window size is retained. When a display is reopened on a dual-screen system, the application opens on the device to which the mouse points. 5.1.4.0 Creating, Saving, and Editing Displays A display includes one or more views and the location and size of the view(s) in the main window.
5.0 Customizing the Main Window 5.2.0 Configuring Chart and Table Properties 5.2.1.0 Populating Charts with Data Some charts, such as the Load vs. Time and Hysteresis charts, allow you to specify which cycle numbers will show in the chart. Other charts, such as Load Peak-Valley and Strain Peak-Valley charts, allow you to specify which cycle variables will be used to populate the charts data.
5.0 Customizing the Main Window Item Description Y Array Assign an array to the selected trace that is added on the Y axis. Click the drop-down button for a list of available resource arrays. When a second trace is added to a Y axis, the signal list is filtered to only show arrays. X Array Clear the check box to use the index of the array for the X axis. Select the box, click the drop-down button, and select an array to plot on the X axis.
5.0 Customizing the Main Window Item Description Expand Only Select the check box to allow a range to automatically expand if the data exceeds the maximum and minimum ranges. The chart does not rescale to a smaller range. 5.2.5.0 Line and Symbol Properties Line and Symbol Display Properties Item Description Opacity Adjust the opacity to better see through traces when they overlap. If you set the opacity to a lower value, it makes the trace more transparent.
5.0 Customizing the Main Window 5.2.6.0 Limit or Curve Fit Line Properties Limit or Curve Fit Lines Item Description Add a Limit or Curve Click to add a limit or curve fit line. Fit Line Remove a Limit or Curve Fit Line Click to remove a limit or curve fit line. Limit or Curve Fit Lines Lists the names of the limit or curve fit lines that are defined for the scope or chart. If more than one line is defined, use the up-arrow and down-arrow buttons to scroll the list.
5.0 Customizing the Main Window 5.3.0 Charts and Tables (Views) 5.3.1.0 Array-Variable Chart The Array-Variable chart shows data that is collected and calculated during each test cycle and stored in arrays. This chart is used in several ways: • As a runtime display activity • As an analysis tool in the Fracture Analyzer application • As an image in reports in the Reporter Add-In for Excel An Array-Variable chart plots the entire variable array. The data is not cyclic or time-based.
5.0 Customizing the Main Window Runtime In the Multipurpose Elite application, hysteresis charts are available as part of the Runtime Display and View Results. To create a new Hysteresis chart in Runtime Display, double-click or drag the icon to the work area. To see a Hysteresis chart in View Results, click the Hysteresis tab. Group variable mapping occurs in the Procedure definition part of the test.
5.0 Customizing the Main Window 5.3.4.0 History Marker Chart The History Marker chart allows you to add markers and lines to history charts. In fatigue tests, you can show failure cycle information or data from user-specified groups. To create a new History Marker chart, click the New History Chart button. To select a variable for the Y-Axis Data box, click the drop-down box to see the list of available items. The X axis represents the index.
5.0 Customizing the Main Window Item Description Add Marker Value Shows a panel to set one variable value. The selected marker value appears in the New Failure Cycle Chart panel. The Value box is unavailable and you cannot change the value. The Units box has a drop-down button that shows a list of unit options. The content of the list is context-sensitive and depends on the marker selection. The marker’s value and units appear, but the marker is not added to the chart.
5.0 Customizing the Main Window Cycle Marker Chart Properties Item Description Display Name Specify a unique name to identify the chart in the test. Group If more than one type of group is available, select a value from the drop-down list. The default value is Cycle. Other variables listed in this box are variables specified in the Save Variables box of the Map Variables window. Y Variable Select an array-type variable from the drop-down list.
5.0 Customizing the Main Window Item Description Numeric Click this button to show the Numeric Selection window. Variable Click this button to show the Variables Selection window. 5.3.8.0 Array-Variable Table The Array-Variable table shows you the element values in one or more selected array variables. Click the Array Variables button to open the Variables Selection window. Use the arrows to move Available Variables to the Selected Variables box and click OK.
5.0 Customizing the Main Window 5.3.9.0 Variable Table The Variable table shows the current value of the selected analysis run variables. The table supports direct value overrides that can be used for error correction or “what if” speculation. Variable Table You can override values for data not measured from a signal directly in the Value column. However, you cannot override and recalculate calculations, unless you type a number in the Value column.
5.0 Customizing the Main Window Fixed-Column Boundary Table 5.3.11.0 Variable-Column Boundary Table The Variable-Column Boundary table shows the current values of the selected variables. The number of possible table columns depends on the number of data-collection variables and types of indexes. Each row contains data from one cycle or data group. 5.3.12.
5.0 Customizing the Main Window 5.3.13.0 Variable Table for Multiple Runs The Variable Table for Multiple Runs shows data from two or more analysis runs selected as a multi-run analysis. The table is typically used for comparing the data of the analysis runs. This table is activated, along with the Variable-Column Table for Multiple Runs, when a multi-run analysis is created. Values and calculations cannot be changed or recalculated in the table.
6.0 Data Analysis Topics: • • • • Analysis..................................................................................................................................................54 Variable Table Analysis..........................................................................................................................55 Analyzing Multiple Test Runs.................................................................................................................
6.0 Data Analysis 6.1.0 Analysis The application supports a variety of analysis activities, including: • Analysis of completed tests • Reanalysis of a data set requiring updated parameters • “What if?” analysis to evaluate hypothetical scenarios • Cross-specimen analysis to compare two different sets of test data 6.1.1.0 Analysis Procedure You can perform data analysis on a system separate from the test system.
6.0 Data Analysis specific table. To use a variable in more than one data acquisition activity table, you must map it for each table. 8. To select the data acquisition activity table that you want to work with, click the down-arrow in the Select a Data Acquisition Activity box and select the name of an activity table. 9. To map a signal to a variable: a) Select the signal name in the Signal to Variable Mapping panel. The Signal to Variable Mapping panel provides information from the test run.
6.0 Data Analysis The table row becomes highlighted. The value becomes bold and underlined. Your cursor blinks in the table cell. A value entry icon appears at the left end of the row. 2. Highlight the value, type the new value, and click the value entry icon. The new value replaces the old value. The Refresh All Analysis Views button becomes active. 3. Click the Refresh All Analysis Views button. 4. Examine the table and other views for changes in the data. 6.2.2.
6.0 Data Analysis 6. Select the Is Calculated check box and click .... The Calculation Editor window opens. 7. In the Variables panel, select Diameter and right-click Insert. The diameter moves to the Calculation panel. 8. In the Functions panel, select the * symbol (multiplication) and right-click Insert. The * symbol moves to the Calculation panel. 9. In the Variables panel, select GageLength and right-click Insert. GageLength moves to the Calculation panel. 10. Click OK. The Variable Editor opens. 11.
6.0 Data Analysis 6.3.2.0 Analyze Multiple Test Runs When the test runs are in your analysis test, open the analysis set and create an analysis run for each test run. The following procedure uses the Sample LCF Strain Test as an example. 1. On the File menu, click Open Test. 2. Click Sample LCF Strain test and click Open. The Explorer panel shows the test hierarchy. 3. Right-click the “Test Run” entry to show a context menu. 4. Click Analyze Multiple Runs.
6.0 Data Analysis 3. Click New Variable, type FatigueLoadPeak, and click OK. 4. Type the following values into the table. FatigueLoadPeak Item Description Category Failure Cycle Identifier FatigueLoadPeak Display Name Fatigue Load Peak Default Value 0.000 Dimension Force Unit kN String No Array Yes Description 5. Type the calculation in the Calculation panel or select variables and functions using the Insert buttons to create the required calculation. 6.
6.0 Data Analysis Item Description String No Array No Description 9. Select the Use Calculation check box and click Edit. The Calculation Editor window opens. 10. Click CycleCount, click Insert, and click OK. CycleCount appears in the Calculation panel. Cycle Count is a System variable with a default value of 0. You cannot edit its definition. 11. Click New Variable, type FatigueCycles, and click OK. 12. Type the following values into the table.
6.0 Data Analysis Failure Reference Value Item Description Category Test Termination Identifier FailureReferenceValue Display Name Failure Reference Value Default Value 0.000 Dimension Force Unit kN String No Array No Description 17. Click the Use Calculation check box and click Edit. The Calculation Editor window opens. 18. Create the LoadPeak calculation and click OK. 19. Click New Variable, type Failure Cycle Number, and click OK. 20. Type the following values into the table.
6.0 Data Analysis 21. Select the Use Calculation check box and click Edit. The Calculation Editor window opens. 22. Create the following calculation and click OK: FatigueCycles[FatigueLife (FatigueLoadPeak,FatigueCycles,FindNearestValueIndex (FatigueCycles, \ StableCycle), FindNearestValueIndex(FatigueCycles,CrackInitiationCycle),DropPercentage)]. FatigueLife is a function that returns the index of the data arrays matching the fatigue life failure.
6.0 Data Analysis Failure Cycle Analysis Chart 6.3.4.0 Loading Unloading Modulus Analysis Example A Loading Unloading chart plots modulus information for each test cycle. Index markers can be defined to show the values from load start to end. A loading unloading modulus analysis requires several variables. To access the Variable Editor, right-click the analysis run in Explorer and select View . To perform an analysis of modulus loading unloading: 1. Click New Cycle Marker Chart. 2.
6.0 Data Analysis Item Description Unit count String No Array No Description 4. Select the Use Calculation check box and click Edit. The application opens the Calculation Editor window. 5. Create the following calculation: -1 and click OK. 6. Click New Variable, type MarkerLoadingEnd and click OK. 7. Type the following values into the table.
6.0 Data Analysis Item Description Identifier MarkerUnloadingStart Display Name Marker Unloading Start Default Value 0 Dimension Count Unit count String No Array No Description 12. Select the Use Calculation check box and click Edit. 13. Create the following calculation: -1 and click OK. 14. Click New Variable, type MarkerUnloadingEnd, and click OK. 15. Type the following values into the table.
6.0 Data Analysis 19. Click Edit. The application opens the Calculation Editor window. 20. In the Calculation panel, click in the calculation at the end of the second parameter, StrainArray. Make sure the cursor is before the closing parenthesis. 21. Type MarkerLoadingStart, MarkerLoadingEnd. Alternatively, in the Variables panel, select MarkerLoadingStart and click Insert. Then select MarkerLoadingEnd and click Insert.
6.0 Data Analysis f) Click the drop-down button for Index: 2 and select Marker Unloading Start. g) Click the drop-down button for Index: 3 and select Marker Unloading End. Add a marker value. h) Click the drop-down button of the Value field and select Unloading Modulus. The chart that results from this example resembles the following: Loading Unloading Chart 6.4.0 Data Acquisition Signal Addition and Removal Signals can be added and removed from Data Acquisition activities for analysis purposes.
6.0 Data Analysis 6.4.1.0 Adding a Data Acquisition Signal To add a data acquisition signal using the Data Acquisition Editor: 1. 2. 3. 4. 5. Select the analysis run in the Explorer panel. Click the Data Acquisition Editor button in the toolbar. Select the correct Data Acquisition activity. In the Signal to Variable Mapping section, select the row of the signal that you want to add. In the Variable column, click the drop-down button and select the array variable or select .
7.0 Variable Analysis Topics: • • • • • • • Variables and Functions........................................................................................................................70 Variables Editor......................................................................................................................................70 Variable Classes....................................................................................................................................
7.0 Variable Analysis 7.1.0 Variables and Functions You can analyze test results by reviewing the variables and functions used in the test. You can change the data presented in the test by changing the variables and functions used in the mathematical and statistical calculations. The original test data is not lost and does not change. The Fatigue Analyzer and Fracture Analyzer applications have test data variables and analysis variables.
7.0 Variable Analysis Variables Editor Window Parts of the Variables Editor Window Number Item 1 Description Search, Toolbar, Provides menus and quick-access toolbar icons that allow you to perform and Menu Access tasks such as searching for the Display Name of a variable, adding or deleting variables, and access to the Variable Actions menu. You can show all variables, and show or hide read-only or disabled variables in the variables table.
7.0 Variable Analysis Number Item 3 Description Filter and Sort Filters by your selected filter criteria and sorts in ascending or descending Icons for Columns order. If a filter for a column is currently active, the filter icon appears blue. Filter 4 Selected variable Shows the properties for the variable currently selected in the variables table. 5 Properties Shows the properties for the currently selected variable. 7.2.1.
7.0 Variable Analysis 7.2.3.0 Variable Details The Variable Details panel sets the main properties of the selected variable or variables. New categories are defined using the Category box. You can set or change the value type with the String and Array check boxes. You can set or change the Dimension, Unit, and Default values. The calculated frame sets the value as calculated. The Edit button opens the Calculation Editor. 7.2.4.
7.0 Variable Analysis Item Dimension Description • Array of Boolean—The variable holds multiple values of the Boolean data type. • Array of Numbers—The variable holds multiple values of the numeric data type. • Array of Text—The variable holds multiple values of the text data type. • Boolean—The variable type holds a Boolean value of either True or False. • Number—(Default) The variable type holds numeric values.
7.0 Variable Analysis Item Description Fatigue or Fracture Analysis applications (for example, when a marker is moved). This check box must be selected if the calculation contains references to functions that access the controller, such as Signal(), SignalFullscale(), and SystemRate(). If the check box is not selected, a validation error occurs that you must clear before you can start a new test run. 7.2.6.
7.0 Variable Analysis Item Description If the value of the variable is not within the range, the application adjusts the value to be within the range. If the value of the variable does fall inside the specified range, the value remains unchanged. Minimum Specifies the smallest number the variable value can be. If Inclusive is used and the value of the variable is less than the minimum value, the application sets the variable value equal to the minimum value.
7.0 Variable Analysis • If you delete a variable that uses a local choice list, you also delete the choice list. • If you delete a variable that uses a global choice list, only the variable is deleted. The global choice list remains and is available for use with other variables. Properties The Choice List panel is available only for string variables. Choice List Panel Properties Item Description Use Choice List Select this option to modify an existing choice list or create a new choice list.
7.0 Variable Analysis 7.3.2.0 Array Variables Array variables store multiple values of the same data type.
7.0 Variable Analysis After you create the new variable in either the Multipurpose Elite, Fatigue Analyzer, or Fracture Analyzer applications, the Properties panel appears. In the Properties panel, select one of the Array options in the Type field to create a new array variable. Calculations The Calculation Editor provides a variety of array functions for use with array variables. Some result in an array. Some result in a single value, depending on the operation contained in the function.
7.0 Variable Analysis 7.4.0 Managing Variables 7.4.1.0 Variables Overview You create and define variables on the Variables tab. The application also provides shortcuts in various places to allow you to conveniently create a new variable at the point of use. By default, any variables you create are selected to go into a category called Variables. You can create new categories to manage the variables you create.
7.0 Variable Analysis 7.4.3.0 Creating a New Variable 1. Click the New Variable button. The New Variable window prompts you to type a unique identifier for the new variable. The identifier can contain only alphabetical and numerical characters, ‘-’ and ‘_’. The name must not begin with a number. The identifier cannot contain spaces, periods, and other special characters. 2. Click OK. The properties of the variable are specified in the Variable Details panel. 7.4.4.
7.0 Variable Analysis To locate where the variable is used, click the entry. • For a calculation, the entry for the calculated variable becomes selected. • For an activity, the procedure appears in the work area with the activity selected. • For a runtime view, the Runtime Display appears with the view selected. • For a data acquisition, the Data Acquisition window appears with the corresponding entry selected. 7.4.6.
7.0 Variable Analysis Note: If adjacent variable names are not separated by a space or function in the Calculation panel, they are interpreted as a single variable name. This is likely to result in a “...variable..., was not found” error message. Errors panel The Errors panel continually evaluates the calculation as you build it. Note: Calculations are validated only on syntax and references to variables and functions, not expected results.
7.0 Variable Analysis Note: Some languages use a semicolon as a list separator instead of a comma. If you are using one of those languages, the last operator of the table would be replaced with a semicolon. Order of Operations Precedence Operator Function Direction 1 [] Array Index Left-to-Right () Function Call .
7.0 Variable Analysis Precedence Operator Function Direction 10 | Bitwise OR Left-to-Right 11 && Logical AND Left-to-Right 12 || Logical OR Left-to-Right 13 = Assignment Right-to-Left 14 , Comma - List Separator Left-to-Right 7.5.3.0 Variable-Specific Information You can reference variables with delimited notation. A dot separates the variable name from the specifier: . For example, the display name of a variable named PeakLoad is: .
7.0 Variable Analysis However, some operators like the Not (!), Ones Complement (~), and Subtraction when used as a Negate (-), operate on only one argument to the right. Functions requiring arguments In general syntax, functions that require arguments are written as a function name followed immediately by the required arguments enclosed in parenthesis. For example: cos(number) – where “cos” is the function identifier and “(number)” is the required argument. 7.5.5.
7.0 Variable Analysis • The function Pi() represents the mathematical constant, pi. • The function SystemRate() represents the system data rate. 7.5.6.0 Modulus Calculation Functions Modulus is calculated from the slope of the Least Squares Fit calculation of the Stress and Strain arrays between the starting and ending indexes. Loading Modulus LoadingModulus(Stress, Strain[, startIndex, endIndex]) The loading modulus is the modulus of the portion of the curve where the load on the specimen increases.
7.0 Variable Analysis Cycle Modulus CycleModulus(Stress, Strain[, startIndexLoading, endIndexLoading, startIndexUnloading, endIndexUnloading]) CycleModulus returns the average of LoadingModulus and UnloadingModulus. First Cycle Modulus FirstCycleModulus(Stress, Strain[, startIndex, endIndex]) The FirstCycleModulus function returns the modulus of the data in the region prior to the first peak or valley because the first cycle is typically a partial cycle.
7.0 Variable Analysis StressA StressA(StressMax, StressMin) The StressA function returns the value: ((StressMax - StressMin)/(StressMax + StressMin)) StressR StressR(StressMax, StressMin) The StressR function returns the value: StressMin/StressMax 7.5.8.0 Fatigue Life Calculation Function Fatigue Life FatigueLife(YAxis, XAxis, startIndex, endIndex, percentageDrop) The FatigueLife function returns the index of the point where the material under test fails.
7.0 Variable Analysis Data Acquisition Editor Window Callout Description 1 Available signals 2 Other available calculations 3 Additional variables saved with each cycle or group 4 Mapped variables 5 Other variables calculated with each cycle 7.6.1.0 Variable Mapping Cycle, point-by-point, and group data acquisition activities require you to map variables to the signals you want to acquire. Perform this mapping in the Map Variables window.
7.0 Variable Analysis Signal to Variable Mapping The Signal to Variable Mapping part of the window allows you to map signals to variables. Four types of data can be calculated for each signal that is selected for data acquisition. The data types are: • Mean • Minimum • Maximum • Array The application only calculates data for a signal if it is mapped to a variable. To see the variables that are available to map, click the drop-down button.
7.0 Variable Analysis • All Variables—Shows all variables, including variables that do not have a calculation. You can change the variable to include a calculation or change an existing calculation by selecting the variable and clicking the Create or Edit Calculation button. Make sure that all calculation references are resolved. Save variables Select one or more variables to store the value in the raw data file for each group. Cyclic data is stored at the end of each cycle.
7.0 Variable Analysis an incomplete pattern indicates a group to investigate. Configure the Hysteresis chart to show you the data for the groups or cycles of interest. You can detect a restart issue by viewing a History chart. When you have identified the group you want to exclude, select it in the Tagged Blocks window and refresh the data. Results A data refresh recalculates the values of the variables and some variables change in value. The recalculated values are modified on charts and tables.
7.0 Variable Analysis 7.7.0 Function Manager Overview The Function Manager window provides information about the specialized calculations that are used for material testing. Application-supplied functions are read-only. However, you can add, delete, and edit user-defined (custom) functions. Filter You can open the Function Manager window within several contexts. For example, in the Multipurpose Elite application, you can click the Function Manager button from the Specimen Geometry Editor.
7.0 Variable Analysis Item Description Category Show the user-defined type of functions. Functions created in the Geometry Specimen Editor fall into the Geometry category. Functions created in the Function Editor fall into the Test Definition category. Description Describe the function. Add Open the Edit Function window to create a new function. Delete Confirm your request to delete the selected function. Edit Change the function’s definition using the Edit Function window.
7.0 Variable Analysis Item Description the new name shows in this box. The name is case-sensitive, and must not contain spaces. Category Shows the function category. If you create the function through the Specimen Geometry Manager, the category is Geometry. If you create the function from the Test Definition, the category is Test Definition. Usage Shows how to use your function and the arguments required.
7.0 Variable Analysis Note: The example above is not entered as TestVariableX=10. You must enter SetValue in the Function Editor. Arrays To read a test variable array in a function, enter the code as in the following example: functionVariableX=TestVariableX.Value.ValueArray The above syntax is the function variable code to get the value of the array variable.
7.0 Variable Analysis geometry-specific calculations. Placeholders for the common functions are added to the test, if any are not already there. The body of the function is updated (replaced) in the test run to include the calculations that are specific to the selected test specimen’s geometry. If you change the domain, it updates the geometry-specific variable and function placeholders in the test and the analysis definitions. Use Update All when you want to: • Add a new geometry.
7.0 Variable Analysis 1. In the Multipurpose Elite application Explorer tab, click Test Definition and click on the Edit button. In the Fatigue Analyzer and Fracture Analyzer applications, select Definition > Function Manager. The Function Manager window displays. 2. Click Update All or Update Variables and Functions. A message prompts you to confirm your intent to update the functions. 3. Click OK to update the functions or click Cancel to prevent the update.
Index A analysis activities 33 begin 32 create definition 22 create run 22 flow 54 modulus loading unloading 63 runs and sets description 23 test run 98 without template 32 analysis run compare data 52 argument syntax 86 array variable 77 Array-Variable Table 49 B blocks tagged 93 C calculation additional cycle 92 FatigueLife function 89 function arguments 86 function types 85 modulus functions 87 operators 83 strain and stress function definitions 88 chart array variable 44 cycle time 48 failure cycle ch
I import test file menu option 25 invalid cycle values not plotted 46 specimen geometry update all 97 T test L limit line 43 line and symbol properties 42 M main window Fatigue Analyzer 24 map variables 90 markers and marker lines 46 message log display 28 modulus loading unloading analysis 63 N numeric selection window 40 O open example test 32 P panel available calculations 91 calculated 74 Preferences menu 28 print data 27 procedure define calculated variable 56 R refresh all analysis views butto
window (continued) excluded group boundaries 93 window (continued) numeric selection 40 MTS TestSuite™ Fatigue Analyzer User Guide 103
MTS TestSuite™ Fatigue Analyzer User Guide
100-209-352 E
