Material

This page is about the material data system in FreeCAD.

Abstract

Since its hard, or even impossible, to define a fixed or complete set of material properties, we go a more open way. Every object in FreeCAD which has to deal with material will have a Property named "Material" which is in itself a key/value list which can hold a infinite number of material properties. Since this is a very open and extensible way to deal with such data, its hold also the danger of chaos. There fore this page define some rules and basic properties to deal with such material-property-maps.

Rules

Every property set has only one mendatory entry which is "Name". This is the primary key of the material. The rest of the matrial properties are optional or can be retrived out of a material DB.

Property names (key) are ordered by strings separated by underscores. The first substring is named by the application or standard, the following can be used to further group the properties. The Values can also be grouped by underscores, e.g. to seperate different sorts of steel. Examples:

• Name=Steel_Casted
• SpecificWeight=7.85 (at 20° in kg/mm3)
• EN10027_name = S235JR+AR (steel standard EN 10027-1)
• FEM_YoungsModulus = xx ( in mm−1·kg·s−2
• FEM_YoungsModulus_Z
• FEM_YoungsModulus_X

Each property has a human readably description on this Material page, with links to further information (e.g. Wikipedia).

For each property a unit has to be defined, based on the FreeCAD internal unit mm-kg-s! That allows consistand usage and translation.

The underscores allow later a tree view property editor/viewer which allow folding.

Material Database

Given that above standard is implemented, it would be stupid to store all the properties again and again to objects. Basically we can build up a Material DB with the Name as a primary key. So if you have no special needs for you material, you just define e.g. Name=Steel and FreeCAD can retrieve all properties from that DB. Every additional property you set in the map overrides the one from the DB.

In the future we can host that DB somwhere in the Web and build up a general OpenSource material DB.

Material.py

Since handling material-properties is a tedious work we should implement a Python front-end module calles Material.py. This will be the place to implement all kind of helper methods for material handling.

• Calculation of Mass out of Volume and Desity
• Translation in different unit systems
• Calculation needed in special application (e.g. FEM)
• and anything else we don't know yet :)

The module should be implemented that way it can run in FreeCAD or stand alone on the command line (material-property-map has be given as python map).