.gitignore

+__pycache__/
\ No newline at end of file

.gitlab-ci.yml

-# This file is a template, and might need editing before it works on your project.
-# To contribute improvements to CI/CD templates, please follow the Development guide at:
-# https://docs.gitlab.com/ee/development/cicd/templates.html
-# This specific template is located at:
-# https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Python.gitlab-ci.yml
-
-# Official language image. Look for the different tagged releases at:
-# https://hub.docker.com/r/library/python/tags/
-image: python:latest
-
-# Change pip's cache directory to be inside the project directory since we can
-# only cache local items.
-variables:
-  PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
-
-# Pip's cache doesn't store the python packages
-# https://pip.pypa.io/en/stable/topics/caching/
-#
-# If you want to also cache the installed packages, you have to install
-# them in a virtualenv and cache it as well.
-cache:
-  paths:
-    - .cache/pip
-    - venv/
-
-before_script:
-  - python --version  # For debugging
-  - pip install virtualenv
-  - virtualenv venv
-  - source venv/bin/activate
-  - which python
-
-
-test:
-  tags: 
-  - env:docker
-  script:
-    #-  python setup.py test
-    - pip install flake8  # you can also use tox
-    - pwd
-    - ls -lh
-    - flake8 ./trial_json.py
-
-run:
-  tags: 
-  - env:docker
-  script:
-    - pip install -r requirements.txt
-    - python trial_json.py
-    # an alternative approach is to install and run:
-    # - pip install dist/*
-    # run the command here
-#  artifacts:
-#    paths:
-#      - dist/*.whl
-
-#pages:
-#  tags: 
-#  - env:docker
-#  script:
-#    - pip install sphinx sphinx-rtd-theme
-#    - cd doc
-#    - make html
-#    - mv build/html/ ../public/
-#  artifacts:
-#    paths:
-#      - public
-#  rules:
-#    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

LeoCAD/Scooter.ldr

+0 
+0 Name: New Model.ldr
+0 Author: 
+1 71 180 -48 0 1 0 0 0 1 0 0 0 1 56904.dat
+1 0 180 -48 0 1 0 0 0 1 0 0 0 1 30699.dat
+1 4 260 -57.8657 -50 1 0 0 0 1 0 0 0 1 2730.dat
+1 71 180 -48 -30 0 0 1 0 1 0 -1 0 0 32073.dat
+1 47 180 -48 -30 1 0 0 0 1 0 0 0 1 3713.dat
+1 47 180 -48 -70 1 0 0 0 1 0 0 0 1 3713.dat
+1 71 340 -48 0 1 0 0 0 1 0 0 0 1 56904.dat
+1 0 340 -48 0 1 0 0 0 1 0 0 0 1 30699.dat
+1 71 340 -48 -30 0 0 1 0 1 0 -1 0 0 32073.dat
+1 47 340 -48 -30 1 0 0 0 1 0 0 0 1 3713.dat
+1 47 340 -48 -70 1 0 0 0 1 0 0 0 1 3713.dat
+1 47 220 -128 -70 1 0 0 0 0 1 0 -1 0 40490.dat
+1 47 220 -208 -70 0 0 1 0 1 0 -1 0 0 32073.dat
+1 47 220 -208 -25 -1 0 0 0 1 0 0 0 -1 32123.dat
+1 47 220 -208 -35 -1 0 0 0 1 0 0 0 -1 32123.dat
+1 47 220 -208 -45 -1 0 0 0 1 0 0 0 -1 32123.dat
+1 47 220 -208 -55 -1 0 0 0 1 0 0 0 -1 32123.dat
+1 47 220 -208 -85 -1 0 0 0 1 0 0 0 -1 32123.dat
+1 47 220 -208 -95 -1 0 0 0 1 0 0 0 -1 32123.dat
+1 47 220 -208 -105 -1 0 0 0 1 0 0 0 -1 32123.dat
+1 47 220 -208 -115 -1 0 0 0 1 0 0 0 -1 32123.dat
+1 47 220 -48 -60 0 0 1 0 -1 0 1 0 0 3673.dat

README.md

 # Lerneinheit FAIRe Qualitäts-KPIs
 
 ## Einführung
+Siehe Skript und Aufgabenstellung in [moodle](https://moodle.tu-darmstadt.de/course/view.php?id=36368&section=3#tabs-tree-start).
 
 ## Materialien
-
-## Anwendung
+In diesem GitLab Repo finden Sie:
+- Package functions (`functions/`): Beinhaltet die Module `classes` und `calculation_rules`
+- Modul classes (`functions/classes.py`): Werkzeuge zum Aufbau und zur Bearbeitung der LEGO-Konstruktionen
+- Modul calculation_rules (`functions/calculation_rules.py`): Funktionen zum Berechnen der FAIRen
+Qualitäts-KPIs
+- Python-Hilfsdatei (`functions/__init__.py`): Notwendige Datei für die Erzeugung eines Python-Pakets
+- Datenblätter (`datasheets/`): Datenblätter ausgewählter LEGO-Komponenten im JSON-Format
+- Teilebibliothek (`LeoCAD/library.bin`): Teilebibliothek für das Programm LeoCAD
+- Abbildungsordner (`figures`): Ordner zum Ablegen der LeoCAD-Screenshots
+- Beispiel-Notebook (`minimalbeispiel.ipynb`): Einführendes Beispiel zur Verwendung der Werkzeuge
+- Ausarbeitungs-Notebook (`ausarbeitung.ipynb`): Vorlage zur Bearbeitung der Aufgaben und Abgabe
 
 ## Ausarbeitung
 Die Ausarbeitung erfolgt im Notebook `ausarbeitung.ipynb`. In diesem ist bereits eine Gliederung vorgegeben.
 
 ## Abgabe
-Die Abgabe erfolgt über moodle.
+Die Abgabe erfolgt über [moodle](https://moodle.tu-darmstadt.de/mod/assign/view.php?id=1249192). Committen und pushen Sie zunächst Ihre Änderungen auf GitLab und laden Sie von dort Ihr gesamtes Repo als .zip-Datei herunter (ein direkter Download vom JupyterHub ist leider nicht möglich). Benennen Sie die .zip-Datei nach dem folgenden Schema:
+<p style="text-align: center;"> &lt;Nachname&gt;_&lt;Vorname&gt;_&lt;MATR-NR&gt;_&lt;GRUPPEN-NR&gt;_le_1.zip</p>
+
+Abgaben, die diese Namenskonvention nicht erfüllen, können in der Bewertung nicht berücksichtigt werden.
+Laden Sie diese .zip-Datei in moodle hoch. Insbesondere sollten vorhanden sein:
+- Jupyter Notebook mit Erklärungen und Darstellungen von LeoCAD
+- Python-Funktionen für die Berechnung der KPIs
+- Die exportierte(n) JSON-Datei(en) des Fahrzeuges (inkl. der hinzugefügten KPIs)
\ No newline at end of file

datasheets/axles.json

+{
+    "32073":{
+        "item number":32073,
+        "item description":"Axle 5 studs",
+        "category":"axle",
+        "price [Euro]":0.001,
+        "mass [g]":0.66,
+        "environmental impact [kg CO2e /kg]":11.03,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=32073",
+        "dimension [studs]":5
+    },
+    "44294":{
+        "item number":44294,
+        "item description":"Axle 7 studs",
+        "category":"axle",
+        "price [Euro]":0.01,
+        "mass [g]":1.05,
+        "environmental impact [kg CO2e /kg]":11.03,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=44294",
+        "dimension [studs]":7
+    },
+    "3707":{
+        "item number":3707,
+        "item description":"Axle 8 studs",
+        "category":"axle",
+        "price [Euro]":0.01,
+        "mass [g]":1.18,
+        "environmental impact [kg CO2e /kg]":11.03,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3707",
+        "dimension [studs]":8
+    },
+    "60485":{
+        "item number":60485,
+        "item description":"Axle 9 studs",
+        "category":"axle",
+        "price [Euro]":0.01,
+        "mass [g]":1.3,
+        "environmental impact [kg CO2e /kg]":11.03,
+        "delivery time [days]":7,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=60485",
+        "dimension [studs]":9
+    },
+    "3737":{
+        "item number":3737,
+        "item description":"Axle 10 studs",
+        "category":"axle",
+        "price [Euro]":0.01,
+        "mass [g]":1.49,
+        "environmental impact [kg CO2e /kg]":11.03,
+        "delivery time [days]":7,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3737",
+        "dimension [studs]":10
+    },
+    "23948":{
+        "item number":23948,
+        "item description":"Axle 11 studs",
+        "category":"axle",
+        "price [Euro]":0.15,
+        "mass [g]":1.65,
+        "environmental impact [kg CO2e /kg]":11.03,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=23948",
+        "dimension [studs]":11
+    },
+    "3708":{
+        "item number":3708,
+        "item description":"Axle 12 studs",
+        "category":"axle",
+        "price [Euro]":0.02,
+        "mass [g]":1.82,
+        "environmental impact [kg CO2e /kg]":11.03,
+        "delivery time [days]":7,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3708",
+        "dimension [studs]":12
+    },
+    "50451":{
+        "item number":50451,
+        "item description":"Axle 16 studs",
+        "category":"axle",
+        "price [Euro]":0.75,
+        "mass [g]":2.37,
+        "environmental impact [kg CO2e /kg]":11.03,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=50451",
+        "dimension [studs]":16
+    }
+}
\ No newline at end of file

datasheets/batteries.json

+{
+    "8881-1":{
+        "item number":"8881-1",
+        "item description":"Power Functions Battery Box",
+        "category":"battery",
+        "related items":"8882-1, 8883-1, 88003-1",
+        "price [Euro]":12,
+        "mass [g]":179.4,
+        "environmental impact [kg CO2e /kg]":6.95,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?S=8881-1",
+        "output voltage [V]":9,
+        "dimensions [cm]":"8,8 x 6,3 x 3,2"
+    }
+}
\ No newline at end of file

datasheets/create_json_from_excel.py

-"""Create json metadata files from an excel file."""
-import os
-import sys
-from collections import namedtuple
-from typing import Dict, List, NamedTuple
-
-import pandas as pd
-# pandas is using another dependency called openpyxl
-# both need to be installed
-
-
-COLUMN_FOR_INDEX_IN_EXCEL = 0
-KEYWORD_TO_IGNORE_COLUMN = "ignore"
-KEYWORD_TO_IGNORE_SHEET = "ignore"
-HELP_TXT = """
-    1. The source excel file. (e.g. test.xlsx)
-    2. The destination folder for the json file. (e.g. test_folder)
-    3. Override the folder if existing. (OPTIONAL, False)
-
-    Providing only '-- help' will show this text and exit.
-"""
-
-
-def read_terminal_arguments() -> NamedTuple:
-    """Read terminal arguments.
-
-    1. File to read from.
-    2. Name of the folder to store the json files.
-    3. Override the destination folder if existing, defaults False.
-    """
-    terminal_args = namedtuple(
-        "terminal_args",
-        ["source", "destination", "override"],
-        defaults=["test.xlsx", "test", True]
-    )
-    if len(sys.argv) == 1:  # No arguments passed.
-        return terminal_args()  # noqa
-    if sys.argv[1] in ["help", "--help", "-h", "?", "h"]:
-        print(HELP_TXT)
-        raise SystemExit
-    try:
-        arg_1 = sys.argv[1]
-    except IndexError:
-        raise SystemExit
-    try:
-        arg_2 = sys.argv[2]
-    except IndexError:
-        raise SystemExit
-    try:
-        arg_3 = sys.argv[3]
-    except IndexError:
-        arg_3 = False
-
-    terminal_args = terminal_args(
-        source=arg_1,
-        destination=arg_2,
-        override=bool(arg_3)
-    )
-    return terminal_args
-
-
-def read_excel_file(path: str) -> Dict[str, pd.DataFrame]:
-    """Read the sheets of the Excel file into multiple dataframes."""
-    if not os.path.exists(path):
-        raise FileNotFoundError(
-            f"No file found at '{path}'"
-        )
-    sheets_as_dataframes = {}
-    with pd.ExcelFile(path) as xls:
-        for sheet_name in xls.sheet_names:
-            if sheet_name.startswith(KEYWORD_TO_IGNORE_SHEET):
-                continue
-            excel_file = pd.read_excel(
-                xls,
-                sheet_name,
-                index_col=COLUMN_FOR_INDEX_IN_EXCEL
-            )
-            sheets_as_dataframes.update({sheet_name: excel_file})
-        return sheets_as_dataframes
-
-
-def make_json(dataframes: Dict[str, pd.DataFrame]) -> Dict[str, str]:
-    """Create the json strings from the excel data."""
-    json_files = {}
-    for sheet_name, dataframe in dataframes.items():
-        dataframe.dropna(inplace=True, axis=1)
-        dropped_columns = [column for column in dataframe.columns
-                           if column.startswith(KEYWORD_TO_IGNORE_COLUMN)]
-        dataframe.drop(dropped_columns, axis=1, inplace=True,
-                       errors="ignore")
-        print(sheet_name)
-        json_string = dataframe.to_json(orient="index", indent=4, force_ascii=False)
-        json_files.update({sheet_name: json_string})
-    return json_files
-
-
-def save_json_files(folder_name: str, jsons_files: Dict[str, str],
-                    override_files: bool) -> None:
-    """Save the json strings to a '.json' file format."""
-    path_to_json_folder = os.path.join(
-        os.path.abspath(__file__),
-        os.pardir,
-        folder_name
-    )
-    path_to_json_folder = os.path.abspath(path_to_json_folder)
-    path_exists = os.path.exists(path_to_json_folder)
-    if path_exists and not override_files:
-        raise FileExistsError(
-            f"Folder: {path_to_json_folder} exists. Pass override argument "
-            f"to override the folder. See --help for more."
-        )
-    if not path_exists:
-        os.mkdir(path_to_json_folder)
-    for json_name, json_sting in jsons_files.items():
-        file_name = f"{json_name}.json"
-        file_path = os.path.join(path_to_json_folder, file_name)
-        with open(file_path, "w") as f:
-            f.write(json_sting)
-
-
-def main():
-    """The main function."""
-    # Get terminal arguments.
-    terminal_arguments = read_terminal_arguments()
-    # Read the Excel file.
-    path_to_file = os.path.abspath(os.path.join(
-        os.path.abspath(__file__),
-        os.pardir,
-        terminal_arguments.source)
-    )
-    excel_sheets_as_dataframes = read_excel_file(path_to_file)
-    excel_sheets_as_json = make_json(excel_sheets_as_dataframes)
-    save_json_files(terminal_arguments.destination, excel_sheets_as_json,
-                    terminal_arguments.override)
-
-
-if __name__ == "__main__":
-    t = main()

datasheets/frame.json

+{
+    "39790":{
+        "item number":39790,
+        "item description":"Technic, Liftarm, Modified Frame Thick 11 x 15 Open Center",
+        "category":"frame",
+        "price [Euro]":2.19,
+        "mass [g]":12.96,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=39790",
+        "dimension [studs]":"11 x 15 x 1"
+    },
+    "32532":{
+        "item number":32532,
+        "item description":"Technic, Brick 6 x 8 Open Center",
+        "category":"frame",
+        "price [Euro]":0.18,
+        "mass [g]":8.0,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=32532",
+        "dimension [studs]":"6 x 8 x 1"
+    },
+    "32531":{
+        "item number":32531,
+        "item description":"Technic, Brick 4 x 6 Open Center",
+        "category":"frame",
+        "price [Euro]":0.1,
+        "mass [g]":5.0,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=32531",
+        "dimension [studs]":"4 x 6 x 1"
+    },
+    "3700":{
+        "item number":3700,
+        "item description":"Technic, Brick 1 x 2 with Hole",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":0.82,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3700",
+        "dimension [studs]":"1 x 2"
+    },
+    "3701":{
+        "item number":3701,
+        "item description":"Technic, Brick 1 x 4 with Holes",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":1.46,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3701",
+        "dimension [studs]":"1 x 4 x 1"
+    },
+    "3702":{
+        "item number":3702,
+        "item description":"Technic, Brick 1 x 8 with Holes",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":2.85,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3702",
+        "dimension [studs]":"1 x 8 x 1"
+    },
+    "2730":{
+        "item number":2730,
+        "item description":"Technic, Brick 1 x 10 with Holes",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":3.67,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=2730",
+        "dimension [studs]":"1 x 10 x 1"
+    },
+    "3895":{
+        "item number":3895,
+        "item description":"Technic, Brick 1 x 12 with Holes",
+        "category":"frame",
+        "price [Euro]":0.03,
+        "mass [g]":4.2,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3895",
+        "dimension [studs]":"1 x 12 x 1"
+    },
+    "32018":{
+        "item number":32018,
+        "item description":"Technic, Brick 1 x 14 with Holes",
+        "category":"frame",
+        "price [Euro]":0.03,
+        "mass [g]":4.92,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=32018",
+        "dimension [studs]":"1 x 14 x 1"
+    },
+    "3703":{
+        "item number":3703,
+        "item description":"Technic, Brick 1 x 16 with Holes",
+        "category":"frame",
+        "price [Euro]":0.07,
+        "mass [g]":5.87,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3703",
+        "dimension [studs]":"1 x 16 x 1"
+    },
+    "32524":{
+        "item number":32524,
+        "item description":"Technic, Liftarm Thick 1 x 7",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":1.79,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=32524",
+        "dimension [studs]":"1 x 7"
+    },
+    "40490":{
+        "item number":40490,
+        "item description":"Technic, Liftarm Thick 1 x 9",
+        "category":"frame",
+        "price [Euro]":0.02,
+        "mass [g]":2.59,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=40490",
+        "dimension [studs]":"1 x 9"
+    },
+    "64290":{
+        "item number":64290,
+        "item description":"Technic, Liftarm Thick 1 x 11",
+        "category":"frame",
+        "price [Euro]":0.02,
+        "mass [g]":2.8,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=32525",
+        "dimension [studs]":"1 x 11"
+    },
+    "41239":{
+        "item number":41239,
+        "item description":"Technic, Liftarm Thick 1 x 13",
+        "category":"frame",
+        "price [Euro]":0.05,
+        "mass [g]":3.3,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=41239",
+        "dimension [studs]":"1 x 13"
+    },
+    "32278":{
+        "item number":32278,
+        "item description":"Technic, Liftarm Thick 1 x 15",
+        "category":"frame",
+        "price [Euro]":0.05,
+        "mass [g]":4.0,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=32278",
+        "dimension [studs]":"1 x 15"
+    },
+    "3713":{
+        "item number":3713,
+        "item description":"Technic Bush",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":0.14,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3713",
+        "dimension [studs]":1
+    },
+    "32123":{
+        "item number":32123,
+        "item description":"Technic Bush 1/2 Smooth",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":0.01,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=4265c",
+        "dimension [studs]":1
+    },
+    "3749":{
+        "item number":3749,
+        "item description":"Technic, Axle 1L with Pin without Friction Ridges",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":0.22,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3749",
+        "dimension [studs]":"0,75 x 2 x 0,55"
+    },
+    "6536":{
+        "item number":6536,
+        "item description":"Technic, Axle and Pin Connector Perpendicular",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":0.39,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":7,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=6536",
+        "dimension [studs]":"1x 2 x 1"
+    },
+    "14720":{
+        "item number":14720,
+        "item description":"Technic, Liftarm, Modified H-Shape Thick 3 x 5 Perpendicular",
+        "category":"frame",
+        "price [Euro]":0.08,
+        "mass [g]":2.29,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=14720",
+        "dimension [studs]":"3 x 5 x 1"
+    },
+    "48989":{
+        "item number":48989,
+        "item description":"Technic, Pin Connector Perpendicular 3L with 4 Pins",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":1.22,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=48989",
+        "dimension [studs]":"3 x 3 x 1"
+    },
+    "55615":{
+        "item number":55615,
+        "item description":"Technic, Pin Connector Perpendicular 3 x 3 Bent with 4 Pins",
+        "category":"frame",
+        "price [Euro]":0.1,
+        "mass [g]":1.9,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=55615",
+        "dimension [studs]":"4 x 4 x 1"
+    },
+    "32556":{
+        "item number":32556,
+        "item description":"Technic, Pin 3L without Friction Ridges",
+        "category":"frame",
+        "price [Euro]":0.1,
+        "mass [g]":0.25,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=32556",
+        "dimension [studs]":1
+    },
+    "3673":{
+        "item number":3673,
+        "item description":"Technic, Pin without Friction Ridges",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":0.16,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3673",
+        "dimension [studs]":1
+    },
+    "32054":{
+        "item number":32054,
+        "item description":"Technic, Pin 4L with Friction Ridges and Stop Bush",
+        "category":"frame",
+        "price [Euro]":0.01,
+        "mass [g]":0.33,
+        "environmental impact [kg CO2e /kg]":11.93,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=32054",
+        "dimension [studs]":1
+    }
+}
\ No newline at end of file

datasheets/gears.json

+{
+    "6589":{
+        "item number":6589,
+        "item description":"Gear 12 Tooth Bevel",
+        "category":"gear",
+        "price [Euro]":0.01,
+        "mass [g]":0.29,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":12,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=6589"
+    },
+    "10928":{
+        "item number":10928,
+        "item description":"Gear 8 Tooth with Dual Face",
+        "category":"gear",
+        "price [Euro]":0.01,
+        "mass [g]":0.22,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":11,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=10928"
+    },
+    "94925":{
+        "item number":94925,
+        "item description":"Gear 16 Tooth",
+        "category":"gear",
+        "price [Euro]":0.2,
+        "mass [g]":0.7,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":12,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=94925"
+    },
+    "18575":{
+        "item number":18575,
+        "item description":"Gear 20 Tooth Double Bevel",
+        "category":"gear",
+        "price [Euro]":0.36,
+        "mass [g]":1.4,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":13,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=32269"
+    },
+    "24505":{
+        "item number":24505,
+        "item description":"Gear 24 Tooth",
+        "category":"gear",
+        "price [Euro]":0.32,
+        "mass [g]":1.17,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":11,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3648"
+    },
+    "34432":{
+        "item number":34432,
+        "item description":"Gear 40 Tooth",
+        "category":"gear",
+        "price [Euro]":0.81,
+        "mass [g]":3.76,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":11,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3649"
+    },
+    "32498":{
+        "item number":32498,
+        "item description":"Gear 36 Tooth",
+        "category":"gear",
+        "price [Euro]":0.88,
+        "mass [g]":3.5,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":12,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=32498"
+    },
+    "6588":{
+        "item number":6588,
+        "item description":"Gear Worm Gearbox",
+        "category":"gear",
+        "price [Euro]":1.63,
+        "mass [g]":4.5,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":11,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=6588#T=C"
+    },
+    "4716":{
+        "item number":4716,
+        "item description":"Gear Worm Screw",
+        "category":"gear",
+        "price [Euro]":0.54,
+        "mass [g]":0.6,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":12,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=4716#T=C"
+    }
+}
\ No newline at end of file

datasheets/motors.json

+{
+    "8882-1":{
+        "item number":"8882-1",
+        "item description":"Power Functions XL-Motor",
+        "category":"motor",
+        "related items":"8881-1",
+        "idle current [mA]":80,
+        "idle speed [rev per min]":220,
+        "locking torque [Ncm]":40,
+        "price [Euro]":30,
+        "mass [g]":72.85,
+        "environmental impact [kg CO2e /kg]":15.84,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?S=8882-1",
+        "input voltage [V]":9,
+        "dimensions [cm]":"13.6 x 12.2 x 3.9"
+    },
+    "8883-1":{
+        "item number":"8883-1",
+        "item description":"Power Functions M-Motor",
+        "category":"motor",
+        "related items":"8881-1",
+        "idle current [mA]":65,
+        "idle speed [rev per min]":405,
+        "locking torque [Ncm]":11,
+        "price [Euro]":20,
+        "mass [g]":35.0,
+        "environmental impact [kg CO2e /kg]":15.84,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?S=8883-1",
+        "input voltage [V]":9,
+        "dimensions [cm]":"13.8 x 11.9 x 2.3"
+    },
+    "88003-1":{
+        "item number":"88003-1",
+        "item description":"Power Functions L-Motor",
+        "category":"motor",
+        "related items":"8881-1",
+        "idle current [mA]":120,
+        "idle speed [rev per min]":390,
+        "locking torque [Ncm]":18,
+        "price [Euro]":15,
+        "mass [g]":48.0,
+        "environmental impact [kg CO2e /kg]":15.84,
+        "delivery time [days]":3,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?S=88003-1",
+        "input voltage [V]":9,
+        "dimensions [cm]":"13 x 11 x 2.5"
+    }
+}
\ No newline at end of file

datasheets/rims.json

+{
+    "3482":{
+        "item number":3482,
+        "item description":"Wheel with Split Axle Hole",
+        "category":"rim",
+        "related items":3483,
+        "diameter [mm]":17.5,
+        "price [Euro]":0.01,
+        "mass [g]":0.88,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3482"
+    },
+    "6014":{
+        "item number":6014,
+        "item description":"Wheel 11mm D. x 12mm, Hole Round for Wheels Holder Pin",
+        "category":"rim",
+        "related items":6015,
+        "diameter [mm]":11.0,
+        "price [Euro]":0.0045,
+        "mass [g]":0.6,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=6014a"
+    },
+    "18976":{
+        "item number":18976,
+        "item description":"Wheel 18mm D. x 12mm with Axle Hole and Stud, Solid Brake Rotor Lines",
+        "category":"rim",
+        "related items":30391,
+        "diameter [mm]":18.0,
+        "price [Euro]":0.01,
+        "mass [g]":1.4,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=18976"
+    },
+    "56904":{
+        "item number":56904,
+        "item description":"Wheel 30mm D. x 14mm",
+        "category":"rim",
+        "related items":30699,
+        "diameter [mm]":30.0,
+        "price [Euro]":0.01,
+        "mass [g]":4.1,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=56904"
+    },
+    "56908":{
+        "item number":56908,
+        "item description":"Wheel 43.2mm D. x 26mm Technic Racing Small, 6 Pin Holes",
+        "category":"rim",
+        "related items":"41897, 61480",
+        "diameter [mm]":43.2,
+        "price [Euro]":0.05,
+        "mass [g]":9.0,
+        "environmental impact [kg CO2e /kg]":32.06,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=56908"
+    }
+}
\ No newline at end of file

datasheets/tires.json

+{
+    "3483":{
+        "item number":3483,
+        "item description":"Tire 24mm D. x 8mm Offset Tread - Interior Ridges",
+        "category":"tire",
+        "related items":3482,
+        "inner diameter [mm]":17,
+        "outer diameter [mm]":24.0,
+        "price [Euro]":0.0025,
+        "mass [g]":1.69,
+        "environmental impact [kg CO2e /kg]":8.97,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=3483"
+    },
+    "6015":{
+        "item number":6015,
+        "item description":"Tire 21mm D. x 12mm - Offset Tread Small Wide",
+        "category":"tire",
+        "related items":6014,
+        "inner diameter [mm]":11,
+        "outer diameter [mm]":21.0,
+        "price [Euro]":0.0004,
+        "mass [g]":2.0,
+        "environmental impact [kg CO2e /kg]":8.97,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=6015"
+    },
+    "30391":{
+        "item number":30391,
+        "item description":"Tire 30.4 x 14 Offset Tread",
+        "category":"tire",
+        "related items":18976,
+        "inner diameter [mm]":17,
+        "outer diameter [mm]":30.4,
+        "price [Euro]":0.0027,
+        "mass [g]":6.5,
+        "environmental impact [kg CO2e /kg]":8.97,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=30391"
+    },
+    "30699":{
+        "item number":30699,
+        "item description":"Tire 43.2 x 14 Solid",
+        "category":"tire",
+        "related items":56904,
+        "inner diameter [mm]":30,
+        "outer diameter [mm]":43.2,
+        "price [Euro]":0.06,
+        "mass [g]":8.25,
+        "environmental impact [kg CO2e /kg]":8.97,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=30699"
+    },
+    "41897":{
+        "item number":41897,
+        "item description":"Tire 56 x 28 ZR Street",
+        "category":"tire",
+        "related items":56908,
+        "inner diameter [mm]":43,
+        "outer diameter [mm]":56.0,
+        "price [Euro]":0.29,
+        "mass [g]":13.98,
+        "environmental impact [kg CO2e /kg]":8.97,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=41897"
+    },
+    "61480":{
+        "item number":61480,
+        "item description":"Tire 68.7 x 34 R",
+        "category":"tire",
+        "related items":56908,
+        "inner diameter [mm]":43,
+        "outer diameter [mm]":68.7,
+        "price [Euro]":0.02,
+        "mass [g]":20.0,
+        "environmental impact [kg CO2e /kg]":8.97,
+        "delivery time [days]":5,
+        "data source":"https://www.bricklink.com/v2/catalog/catalogitem.page?P=61480"
+    }
+}
\ No newline at end of file

example_item_data_dict.json

-{
-    "1":{
-        "item_number":1,
-        "mass":10,
-        "delivery_time":1
-    },
-    "2":{
-        "item_number":2,
-        "mass":20,
-        "delivery_time":2
-    },
-    "3":{
-        "item_number":3,
-        "mass":30,
-        "delivery_time":3
-    }
-}
\ No newline at end of file

example_item_data_list.json

-[
-    {
-        "item_number":1,
-        "mass":10,
-        "delivery_time":1
-    },
-    {
-        "item_number":2,
-        "mass":20,
-        "delivery_time":2
-    },
-    {
-        "item_number":3,
-        "mass":30,
-        "delivery_time":3
-    }
-]
\ No newline at end of file

functions/calculation_rules.py

@@ -2,22 +2,43 @@
 File consists of several functions for the calculation rules of FAIR Quality KPIs
 """
 
+from functions.classes import *
 
 def test_function():
+    """Test function to check module functionality"""
     print("You called the test function.")
 
-# Function to calculate KPIS that use sums
-# Or function to calculate the mass with sum?
-def kpi_sum(*args):
-    return sum(args[0])
-    # if arguments are handed over not as a list: sum(list(args))
+def kpi_mass(system: LegoAssembly)->float:
+    """
+    Calculates the total mass of the system
 
-# KPI for calculating some real complicated metric
+    Args:
+        system (LegoAssembly): LegoAssembly object that represents the system
 
+    Returns:
+        total_mass (float): Sum of masses of all components in the system in g
+
+    Raises:
+        TypeError: If an argument with unsupported type is passed
+            (i.e. anything other than LegoAssembly).
+    """
+    if not isinstance(system, LegoAssembly):
+        raise TypeError(f"Unsupported type {type(system)} passed to kpi_mass()")
+
+    total_mass = 0
+    for c in system.get_component_list(-1):
+        total_mass += c.properties["mass [g]"]
+    return total_mass # alternative: sum(c.properties["mass [g]"] for c in system.get_component_list(-1))
+
+# Add new functions for calculating metrics
 
 
 if __name__ == "__main__":
+    """
+    Function to inform that functions in this module is
+    intended for import not usage as script
+    """
     print(
-        "This script contains functions for calculating the FAIR Quality KPIs. It is not to be executed independently."
+        "This script contains functions for calculating the FAIR Quality KPIs."
+        "It is not to be executed independently."
     )
-    pass