Fatigue User’s Guide > Fatigue Utilities > Utilities
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
Utilities
The following advanced utilities are available as separate modules of MSC.Fatigue. These modules are viewed as additional capabilities to the basic functions of MSC.Fatigue. It is therefore assumed that a good working knowledge of MSC.Fatigue is understood. Please familiarize yourself with text and graphical modes of operation as explained in Module Operations (Ch. 17). The modules can be group into several categories:
 
Type
Description
Advance Loading Utilities
MART is a module which arithmetically manipulates standard loading data files. Files may be operated on in ways similar to that offered by a hand held calculator. Complex mathematical procedures can be built up by “chaining” together sets of MART commands. If necessary, the arithmetic manipulation can be applied to a section or window in the data file, leaving the remainder of the data unaffected.
MCOE is an interactive alphanumeric editor that allows both the creation of new and the editing of existing time series data files. MCOE operates within a highly featured spreadsheet environment that allows data to be manipulated within the spreadsheet (points inserted, moved, etc.).
MCYC is used to process a time series signal by extracting fatigue cycles according to the rainflow cycle counting algorithm. MCYC is useful because it allows the user to count cycles using the same parameters for comparing and assessing various time signals.
MFRM is an arithmetic and logical module which can be used to process formulae of varying complexity.
MLEN is used to extract a portion of data from one file or several files, and load the extracted portions into a new output file. It can be used to concatenate (merge), individual data sets into a single output file. It can also be used to delete a selected portion of data from files.
MMFM is an arithmetic and logical module which can be used to process formulae of varying complexity. The formulae themselves are defined by means of a command language which MMFM interprets and executes. The command language is, in effect, a simple programming language that gives users access to all parts of loading files, i.e. header, data area, and extra details keywords.
MPVXMUL extracts turning points from single parameter files such as .dac and RPC multiple data - channel files. The MPVXMUL extraction process maintains synchronous phase by writing corresponding data values to all the output files whenever a turning point is found in any channel.
MSIMMAX performs simultaneous values analysis on either multi-channels in a single RPC file or multiple DAC files from the same test.
MADA calculates the probability density distribution and other function of a time signal.
MASD performs a frequency analysis of a time signal to determine frequency content.
MFFF creates a finite impulse response (FIR), filter by using the window method. After creation, MFFF automatically removes unwanted frequency components from time series data. High-pass, low-pass, band-pass or band-reject can be created.
This program takes a signal file and passes it through a Butterworth filter to produce an output signal file. The filter characteristic can be a low pass, high pass, band pass or band-stop. The filter order can be from 1 to 8 poles which will give a cutoff of between 6db and 48db per octave.
The frequency response analysis, MFRA, analyses the response of a single input, single output linear system. Six files of statistics are generated as a result of this analysis including the cross-correlation.
MRSTATS analyses a time signal and produces a number of statistics about that signal. RSTATS works by breaking the input time signal into segments, and statistically analyzing each segment. Each statistic is fed into an output signal file.
File manipulation (MFILMNP) allows both header and extra details manipulation. In addition it can check that a header conforms to MSC.Fatigue conventions. MFILMNP can list and edit data file headers, and control the extra details data that can be written to files. The files types that can be edited include single parameter files e.g. .dac files and 2 parameter files e.g. .mdf. Three parameter histogram files can also be processed.
Advanced Fatigue Utilities
The MSLF program models fatigue life in software to predict durability based on SN-curves derived from constant amplitude test results for specimens or components. It is the equivalent of MSC.Fatigue’s stress based analyzer, FEFAT, but accepts measured stresses as input from a single location.
MCLF is the equivalent of MSC.Fatigue’s crack initiation module, FEFAT, but in the testing world where the input is a measured strain history from a single location.
MCDA calculates and displays cycles and damage distributions so that different test conditions may be compared and the reasons for variations in fatigue damage may be determined. Displays may be as histograms, continuous curves, or exceedance plots.
MCYL is used to numerically list the contents of a histogram or cycle file. MCYL can also display a summary of the information resident in the file header region. MCYL also accesses the cycle results files generated by the MSC.Fatigue fatigue analyzers FEFAT, MCLF and MSLFMSLF and create a rainflow matrix of cycles according to user specified engineering units and limits.
MTCD is a fatigue analyzer that can be used to pin-point fatigue damage within a loading history. It uses the local stress-strain approach to track local stresses and strains by means of a single-pass algorithm. An estimate of the total damage accrued by one pass through the load history is made and displayed graphically.
MFLF is a single location, stress-based fatigue analysis module that accepts stress response PSDFs as input.
MSSA processes rosetta data and finite element data from MSC.Fatigue, including software strain gauges. MSSA creates outputs suitable for use by either the stress or strain-life fatigue analyzers.
MMLF is a single location multiaxial fatigue analyzer based on Crack Initiation. MMLF requires three strain input signals which typically come from strain gauge rosettes.
MFCG calculates the Paris Law coefficient and exponent from actual raw test data obtained under constant amplitude loading conditions.
MKTAN stores and retrieves values for stress concentration factor (Kt) solutions for geometric details, and calculates Kt and Kf. It allows users without finite element analysis (FEA) software rapid and convenient access to Kt values for a range of common component geometries. The Kt values can be used in MTCD to predict the fatigue life of an engineering component.
Graphical Display Utilities
MGED is the multi-channel interactive graphical editor for time series data allowing online manipulation of a signal.
MMFD displays single parameter data files.
MQLD displays single channel data files.
MTPD displays pared (X-Y) data files. For .mdf files.
MPOD displays pared (X-Y) data files. For .pod files.
 
MP3D is the histogram and waterfall display module.
MQPLOT is used to view or print plot (.plt) files. Up to 2000 plot files can be loaded onto MQPLOT and viewed on screen and/or printed or plotted as hard copy. A large number of output devices are supported. MQPLOT can also be used to convert plot files into different formats, for example .plt to .eps (encapsulated postscript).
MWNPLOT is equivalent to MQPLOT but for the Windows NT environment.
The MSC.Fatigue system can produce graphical hardcopy on a wide range of output devices. These include pen plotters such as the wide range of HP devices, laser printer-plotters and dot matrix printers. Before any hardcopy can be produced, the plotters that are available on the system must first be defined. The plotter definition system controls all aspects of defining the available plotters, and their setup (plot size, position etc.). MPLTSYS allows definitions to be created, modified deleted and listed.
MNCPENS is a simple utility to allow users to change graphic colors on any plot.
File Conversion Utilities
The signal to ASCII module, MDTA, converts a single parameter, X-Y, or histogram binary file into ASCII format. It can also write or omit header details, and write an ASCII file as single or multiple column. MDTA is complimentary to module PTIME which converts ASCII files to binary files. The MADT module also converts ASCII files to binary, operates in batch mode, and converts multi-channel data to multi-files automatically.
MREGEN can regenerate a single parameter signal file (.dac extension) from a three parameter range-mean cycles histogram file (.cyg type), regenerate a single parameter signal file (.dac extension) from a three parameter maximum-minimum cycles histogram file (.cyh type), regenerate a single parameter signal file (.dac extension) from a three parameter Markov Matrix (.mkh type), and generate a Gaussian series from a user supplied irregularity factor and save it as a .dac file.
This program extracts channels of data from MTS RPCtm remote parameter (RPC) files, and creates a single .dac file for each channel of the RPC file. It is possible to selectively extract one or more channel numbers. A time window within the RPC file may be selected which will apply to all channels extracted. Both RPC II and RPC III files may be processed. Full details of the extraction and creation process can be saved to a report file. The reverse of this is MDACREM.
MCONFIL is a binary to binary file conversion program for transfer of files across multiple platforms.
WFLCRE creates a three parameter waterfall file from multiple single parameter files.