python-materialsdb is an unofficial python library for materialsdb.org an open format and database for building materials.

Features :

Package

• serialiser.py :
  • from xml : deserialise from materialsdb*.xsd compliant xml file
  • to xml : serealise classes to a materialsdb*.xsd compliant xml file
• classes.py : generated classes corresponding to XML elements
• cache.py : cache latest materials data from producers
• config.py : set and get user config as language and country
• ifc/project_library.py : convert deserialised source into IFC (IfcProjectLibrary)

devutils

• classes_generator.py : generate classes (dataclasses except for simple type) for materialsdb*.xsd elements

config

Materials data are often localized. You can set your language and country this way:

from materialsdb import config

config.set_lang("fr")
config.set_country("CH")

Note: in materialsdb standard languages are ISO 639-1 codes and countries are ISO_3166-1_alpha-2 codes.

Usage examples :

Check out some examples:

• Convert latest materials data to ifc
• Create your own materialsdb.org compliant XML

Querying materials :

The library keeps an sqlite index of the cached materials data for fast filtering and single-material access:

from materialsdb import query

query.refresh()                                   # incremental update from cached xml
rows = query.search("isolant", sort="lambda")     # filtered, sorted summaries
material = query.get_material(rows[0].id)         # full material dataclass

How to install

Using pip

pip install python-materialsdb

Dependencies

• lxml (BSD) : xml parser (tested with version 6.1.1)
• ifcopenshell (LGPL) : ifc read/write (tested with version 0.8.5)

Third parties :

• materialsdb.org (GPL) : materials schema