README for Material Property Database (MPDB)
Program details
Notes on the material properties
Notes for SolidWorks & COSMOS users
Notes for ANSYS Workbench users
Notes for ANSYS standard users
Notes for ABAQUS users
FAQ's
Program Details
- Both versions (Windows and Linux) have the same data and the same functionality.
- The demo version is fully functional. However, the property values for non-elements are multiplied by a random number and should not be used. Also, the references are not shown for the non-elements. The data for the elements are provided for free.
- Single-clicking on an element or double-clicking on a material will bring up a form showing the properties that are available for that material.
- Right clicking on an element will bring up a window listing all of the materials in the database that have that element as a major component. A material can then be selected from this list by left clicking on it. A right mouse click will dismiss this window.
- The menu item "Materials->List materials by UNS number..." will bring up a window listing the materials in the database by their UNS number (if they have one). A material can then be selected from this list by left clicking on it. A right mouse click will dismiss this window.
- Select the property, phase, orientation (if available) and output format.
- The data can also be written directly to a text file.
- The directory where the text file will be written can be changed with the "Options->Output..." menu item.
- The output units of the properties can be changed with the "Options->Units..." menu item.
- The vapor pressure can be written out as log(pressure) or as the pressure itself. This can be selected in the "Options->Output..." menu.
- The subroutines/functions return either a default value or the last valid value when the requested temperature is out of the range of the data. The default value is preset to 1.0E100. The return value can be changed in the "Options->Output..." menu.
- Once a material is selected calculations can be performed on the data to calculate new quantities. This functionality is only available in the Windows version and is accessed through the "Options->Calculations" menu item. The user selects which properties to include in the calculation and enters the equation. An example equation may be A + (2*B + A) / C, where A, B and C represent properties in the database like elastic modulus, heat capacity, etc. You may not use stress-strain data in a calculation with any other property, since stress-strain is a function of strain and all of the other properties are functions of temperature.
- Two types of search options are available under the "Materials->Search/Report Values" menu item. The user goes to the material class they are interested in (Ni based alloys for example) and then selects the "Search/Report" menu item. "Report" will return the desired property at a user specified temperature for all of the materials in the current class. "Search" allows the user to specify the desired temperature and a minimum and maximum value for a property and returns all materials that match. If you leave either the minimum or maximum value blank this limit will be ignored, this is the same as entering a very small or a very large value for the limit. If the "search all materials" option is selected the entire database will be searched. You can place you cursor on the line of a material and click the "Goto" button to go this material in the main program. More than one property can be selected at a time. If the "optional" box is checked for a property then the material is included in the results even if this property is missing from the database.
- The experimental data were fit to an equation to give the best numerical values. The mathematic forms used do not imply any physical model. It is not recommended that derivatives be taken of these equations without examination of the resultant values.
- Some of the equations are too long to fit into Excel, and only part of the equation will be pasted into Excel which results in an Excel error. No fix for this problem is known.
- All compositions given are nominal values only.
- A listing of all of the materials and the properties for each of the materials can be written to a file with the menu item "Options->Write materials file". The file is called materials_and_data.txt and is an ASCII text file. This file is written to the directory where the text file with the data/subroutines are written.
- Users can add their own properties to the database.
You can select to use either a local user_mats.txt file or a remote one. The local user_mats.txt file will reside in the directory where the program is. The remote user_mats.txt file will be in another directory or on another machine over the network.
You can only add or change materials if you have selected "User materials->Use local user_mats.txt file". This allows multiple users to have one central user_mats.txt which is administered by one person.
The "User materials" tab must be selected, the menu items for adding/editing/deleting user materials are then active. Select the "Add new material..." option and enter your data.
The data can be entered as one of five types of equation. For all but the "single point data" or "x-y pairs" format the temperatures must be in Kelvin and the data itself must be in the proper units - these are indicated in the window. For the "single point data" or "x-y pairs" format (the exact name depends on the version you are using) you can select the units that you enter the data in. Once the data is entered you can select any units as usual. If you enter your data in the "single point data" or "x-y pairs" format the program will fit a straight line between the data points.
To remove the data for a property for a given material, without deleting the entire material, change the "Number of temperature zones" for that property to 0 or click the "clear current dataset" button and then the "Save dataset" button.
You can add more than one set of data for a given property by specifying a "Phase/Condition" and "Orientation/Condition". You can change the default name of a "Phase/Condition" or "Orientation/Condition" by right clicking on the label. You must specify a "Phase/Condition" but you do not have to select an "Orientation/Condition" unless you want to add more than one dataset. The actual "Phase/Condition" or "Orientation/Condition" is only used to organize your data and does not have any other significance.
After adding or editing data you must click the "Save data" set button. After all of your changes are made, click the "OK" button to save your changes to disk. All of your user material data is written to a file called "user_mats.txt" in the directory where your application is, usually c:\program files\MPDB\. You may want to periodically make copies of this file as a back-up. All versions of the program use the same format for the user_mats.txt file so it can be shared among them.
Notes on the material properties:
- Linear expansion (ΔL/L): This property is fairly insensitive to composition and heat treatment. Notable exceptions are the "zero-expansion" Invar type alloys (Fe-36Ni).
- Coefficient of thermal expansion (CTE): This property is also fairly insensitive to composition and heat treatment. Notable exceptions are the "zero-expansion" Invar type alloys (Fe-36Ni). The value given in the database is the instantaneous thermal expansion; the derivative of (ΔL/L) with respect to the temperature.
- Mean coefficient of thermal expansion: This property is also fairly insensitive to composition and heat treatment. Notable exceptions are the "zero-expansion" Invar type alloys (Fe-36Ni). This value is defined as (ΔL/L)T / (T-Tref). In most cases this property is calculated from the ΔL/L values. The error is expected to be in the range of 10-15%, it may be higher near room temperature due to the small value of T-Tref.
- Elastic & shear modulus: These properties are fairly insensitive to composition and heat treatment. Order-disorder transformations may cause anomalous behavior. Strongly anisotropic materials may have a texture effect. Some Fe-Ni alloys are sensitive to the amount of cold work. The accuracy of this data is estimated to be approximately 5-10%. For solder alloys the literature reports a wide spread of values. Data from several sources, when available, are evaluated and representative values are given, the error is estimated to be 10-25%. For some polymers the flexural modulus is used as the elastic modulus. The flexural modulus is typically within 10% of the elastic modulus. Typically, values measured with a strain gauge are approximately 10% lower than those measured with a dynamic technique. Values measured by a dynamic technique are preferred over those measured by strain gauge techniques.
Note: for cubic materials where the elastic and shear modulus were calculated from the elastic constants (C11, C12, C44) the average of the Reuss and Voigt equations were used (see R.F.S. Hearmon, Advanced Physics, v5, p232 (1956)). For isotropic solids (glasses) L.D. Landau and E.M. Sifshitz, in Theory of Elasticity, Pub. Addison-Wesley, New York (1966) was used.
- Poisson's ratio & bulk modulus: These properties are calculated from the elastic & shear modulus using standard relationships and in this sense are self-consistent and accurate. The accuracy of this data is estimated to be approximately 10-20%, however since this is a derived quantity the error can be significantly higher. The curves for these properties often show improbable shapes which are most likely due to their derived nature and are not believed to be real. If the elastic & shear modulus were determined in a self-consistent manner the curves would likely be much better behaved. However, all of the data are presented "as is" from the original references and are self-consistent within this database.
- Thermal conductivity: This property is very sensitive to impurities, heat treatment and mechanical worked state, especially at very low temperatures. This sensitivity is somewhat decreased above room temperature and decreases as the amount of alloying increases. Compare 4340-QT (quenched and tempered) and 4340-NT (annealed).
- Viscosity: This property is fairly insensitive to composition except for glasses where the sensitivity can be large.
- Specific heat (Cp - constant pressure): This property is fairly insensitive to composition and heat treatment.
- Heat capacity: This property is fairly insensitive to composition and heat treatment.
- Vapor pressure: This property can be strongly effected by the presence of trace gases, such as oxygen.
- Thermal diffusivity: This property is also very sensitive to impurities, heat treatment and mechanical worked state, especially at very low temperatures. This sensitivity is somewhat decreased above room temperature and decreases as the amount of alloying increases. An example of this can be seen by comparing the data for elemental (high purity) Fe and Armco iron (commercial purity).
- Electrical resistivity: This property is also very sensitive to impurities, heat treatment and mechanical worked state, especially at very low temperatures. This sensitivity is decreased above room temperature.
- Hemispherical total emissivity (εT): the measured emissivity over all wavelengths and 2π radians. This is the emissivity used in the Stefan-Boltzmann law.
- Normal total emissivity (εT,n): the measured emissivity over all wavelengths at a direction normal to the surface. This is the most commonly reported value. For polished metal the following assumption is valid: εT/εT,n = 1.15 - 1.20.
- Both emissivities are sensitive to the surface condition (roughness and oxide thickness).
- Density (ρ): The density for solids is calculated from the room temperature density and the linear expansion coefficient and is given by: ρ/(1 + ΔL/L)3. The data for oxides, carbides and nitrides depend on the porosity of the material. For gases the ideal gas law is used.
- Tensile strength, yield strength and elongation: Most of the data for these properties are taken from product brochures provided by the material suppliers. These data should be used with the understanding that they are only representative of the actual material properties. The variation with temperature is usually not smooth. The tensile and yield strengths depend on (grain size)-1/2 of the materials, however, the grain size is usually not given in the reference. Many of these materials are precipitation hardening alloys and the temperature affects the aging processes different ways at different temperatures. Unless otherwise stated, the data are for "short" times at the indicated temperatures and not for the equilibrium structure. These properties are very sensitive to the details of the processing and heat treatments. Comparison of data from different suppliers indicate that the spread in the published values is approximately 20% for materials with similar processing. The spread in the elongation data can be as high as 50-100%.
- True stress-true strain curves: Most of this data was measured at room temperature. The curves in the database are for the true plastic strain. Data for engineering stress-strain curves are not included since finite element programs require the true stress-strain and not the engineering values. The differences between the true values and engineering values can be quite significant. Data for both the true and engineering values are given for the Fe-based alloy 1112 in the database for comparison. The plastic strain for all of the curves was calculated using the 0.2% offset method if it was not calculated in the reference. Since there is a limited amount of this data, difference sources for the same data cannot be found. The error (spread) is therefore assumed to be similar to that suggested above for the yield strength. The error will be larger near 0 strain due to difficulties in defining the 0.2% offset stress. For some datasets (as noted in the database) engineering stress-strain data have been converted into true stress-strain curves using the equation below:
σtrue = σeng(1 + εeng)
and
εtrue = ln(1 + εeng) - σtrue/E
where σtrue is the true stress, σeng is the engineering stress,
εtrue is the plastic true strain, εeng is the total engineering strain and E is the elastic modulus. This equation is valid up to the onset of necking.
- Creep strength and Stress-rupture curves: This data is very sensitive to the microstructure, heat treatment and test atmosphere.
- Magnetic properties (B vs H, H vs B and permeability vs H): This data is also very sensitive to the microstructure and heat treatment. All of this data is derived from the B vs H data. B is defined as the magnetic flux density and H is defined as the magnetic field intensity.
The absolute permeability, μ, is defined as B/H. The relative permeability, μr, is unitless and is defined by:
μr = &mu / μ0
where μ0 is the permeability of a vacuum and equals 4π x 10-7.
The error range for this type of data are not given in any of the references but it is estimated to be in the range of 10-20%.
- The properties of polymers and polymer-based composites are sensitive to moisture, processing conditions and may show time-dependence at the higher temperatures. The errors/uncertainties can be large compared to those of other materials. You should use the properties of these materials with this in mind.
- The magnitude of the errors reported by authors for a given property is usually smaller by a factor of 2-3 than the error between difference sources for the same data. This is especially true for materials such as ceramics.
Special notes for SolidWorks & COSMOS users
- The data in the database can be written out in XML format to a *.sldmat file. This database file can then be read directly into SolidWorks products.
- The following steps outline how to create a *.sldmat data file:
- Start the database.
- Make sure the "SolidWorks/ANSYS XML->SolidWorks XML format" menu item is checked, then click the "SolidWorks/ANSYS XML->Create a new database..." menu item.
- Enter a name and location for the database.
- If the menu item "SolidWorks/ANSYS XML->Temperature dependent data" is checked (the default setting) the property data will be written to the database as temperature dependent data. If the menu item "SolidWorks/ANSYS XML->Room temperature data" is checked only the room temperature values will be written to the database. This option can be changed for each property added to the database.
- If the menu item "SolidWorks/ANSYS XML->Use database material name" is checked (the default setting) you will not be
prompted to enter a material name. The material name will be the same name displayed in the MPDB database.
You may also enter your own name by unchecking the "SolidWorks/ANSYS XML->Use database material name" menu item. This option can be changed for each material added to the database.
- Click the "SolidWorks/ANSYS XML->Create a new material..." menu item.
- Pick a color for the material. This color will be used in SolidWorks.
- Pick a material in the MPDB database to add to your SolidWorks database.
- Select a property you want to add for this material and click the "Add to database" button to add the data to your database. You can add as many properties as you like.
Note that you can use properties from more than one material in the MPDB to put into your material. You may need to do this if a material in the MPDB does not have all of the properties you require. Duplicate properties are always overwritten with the last entered data written to the database.
- Once you have added you properties, click on the "SolidWorks/ANSYS XML->Close material" menu item.
- You can add more materials to this database by repeating steps 6-10.
- Once your database is finished click the "SolidWorks/ANSYS XML->Close database" menu item.
- You can view your SolidWorks database in a text editor. You can open it within MPDB it using the "File->Open File..." menu item.
- You can access the data by using the "From library files" option in the "Apply/Edit material" window within COSMOSWorks.
- SolidWorks accepts up to 5000 data points for a property. You can specify the temperature increment for writing the data to the database. If there will be more than 5000 points the program will automatically calculate the temperature increment needed to give 5000 points and use that value. You can limit the temperature range which the data is outputted to be the entire temperature range available, temperatures from 20C and higher, or from 20C and lower.
Special notes for ANSYS Workbench users
- The data in the database can be written out in XML format to a *.xml file. This database file can then be read directly into ANSYS Workbench.
- The following steps outline how to create an *.xml data file:
- Start the database.
- Make sure the "SolidWorks/ANSYS XML->ANSYS XML format" menu item is checked, then click the "SolidWorks/ANSYS XML->Create a new database..." menu item.
- Enter a name and location for the database.
- If the menu item "SolidWorks/ANSYS XML->Temperature dependent data" is checked (the default setting) the property data will be written to the database as temperature dependent data. If the menu item "SolidWorks/ANSYS XML->Room temperature data" is checked only the room temperature values will be written to the database. This option can be changed for each property added to the database.
- If the menu item "SolidWorks/ANSYS XML->Use database material name" is checked (the default setting) you will not be
prompted to enter a material name. The material name will be the same name displayed in the MPDB database for the first property added.
You may also enter your own name by unchecking the "SolidWorks/ANSYS XML->Use database material name" menu item. This option can be changed for each material added to the database.
- Click the "SolidWorks/ANSYS XML->Create a new material..." menu item.
- Pick a material in the MPDB database to add to your database.
- Select a property you want to add for this material and click the "Add to database" button to add the data to your database. You can add as many properties as you like.
Note that you can use properties from more than one material in the MPDB to put into your database. You may need to do this if a material in the MPDB does not have all of the properties you require. Duplicate properties are always overwritten with the last entered data written to the database.
- Once you have added you properties, click on the "SolidWorks/ANSYS XML->Close material" menu item.
- You can add more materials to this database by repeating steps 6-9.
- Once your database is finished click the "SolidWorks/ANSYS XML->Close database" menu item.
- You can view your database in a text editor. You can open it within MPDB it using the "File->Open File..." menu item.
- ANSYS accepts up to 100 data points for a property. You can specify the temperature increment for writing the data to the database. If there will be more than 100 points the program will automatically calculate the temperature increment needed to give 100 points and use that value. You can limit the temperature range which the data is outputted to be the entire temperature range available, temperatures from 20C and higher, or from 20C and lower.
Special notes for ANSYS standard users
- All of the data for a particular material must be in the same file and there can be no more than 100 data points for a given property. Each material must have a unique material number.
- When the "Temperature iteration control" dialog is shown the first time for a material using the ANSYS output format (with the "Write a text file" option selected), the "Start a new ANSYS file" option will be checked. This means that any existing file for this material will be over written. For subsequent properties for the same material this option will not be pre-selected. This will cause the new property to be written to the existing file. You can also select or de-select this option manually.
- For the first property for a given material, the "Material number" can be changed, however, for subsequent properties of the same material this cannot be changed. This ensures that all properties in the same file will have the same material number.
- All of the above will be reset each time you select a material from the main window.
- If your model tries to access data at a temperature that is not in your file ANSYS sets the value to 0. If you need data outside of the range that is in the database you must edit the data file manually and enter a reasonable value.
Special notes for ABAQUS users
- When the ABAQUS output format is selected only those properties used by ABAQUS are visible.
- For thermal expansion ABAQUS uses the mean thermal expansion, called total thermal expansion by ABAQUS see section 12.1.2-1 of the ABAQUS User Manual v6.2.
- ABAQUS uses electrical conductivity instead of electrical resistivity. If the ABAQUS output format is selected the electrical resistivity data will automatically be converted to electrical conductivity. The property label is changed to reflect this.
- Once the data is written to a file, this file can be directly read by CAE. When you are in the material definition dialog, click the "temperature dependent" option, put you cursor in the first
cell of the table, right click the mouse and then click "read from a file". Navigate to the data file with the desired property and all the data will be imported into the table.
- If you have a material with orientation dependent properties you must create the data file manually. Due to how the directions are defined MPDB cannot write the complete file for you. It is suggested that you do this in a spreadsheet program and then paste the results into a text file to be read by ABAQUS.
- You can also use the scripting language Python to import material properties into ABAQUS CAE. An example script is given on the
web site.
Visit the web site at www.jahm.com for updates, information, to report bugs, additional requests or any other questions. Direct e-mail to
info1@jahm.com.