Material

From FreeCAD Documentation
Revision as of 16:34, 1 February 2013 by Jriegel (talk | contribs) (→‎General)

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 key (name) and the value of the property uses only ASCII characters (7-bit). The keys are written in Camel-Case but interpreted case-insensitive.

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.

At the moment I think of a compiled in mini dataset with a set of "basic" materials and its basic properties and a SQLite based full version.


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).


Basic material properties

Here now the description of agreed material-properties. Feel free to add a subsection for the material-properties of you field of expertise.

General

General material properties
property name Description Unit/Data-Type
Name Unique name of the property, following the rules descripted above ASCII string 7-bit
SpecificWeight The specific weight (also known as the unit weight) is the weight per unit volume of a material. see: Specific_weight kg/mm^3

Mechanical

Finite Element Method

Computational Fluid Dynamics