Skip to content
Snippets Groups Projects
Commit 4cc8efe9 authored by Hock, Martin's avatar Hock, Martin
Browse files

Finish "minimal example".

parent 6c03d8b3
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
Showing
with 245 additions and 65 deletions
ausarbeitung.ipynb
+ 245
− 65
View file @ 4cc8efe9
%% Cell type:markdown id:c9328cd1 tags:
# FAIRe Qualitäts-KPIs
Name:
Datum:
%% Cell type:markdown id:2ee8746d tags:
## Einführung
FAIRe Qualitäts-KPIs schaffen eine transparente und nachvollziehbare Entscheidungsgrundlage. In dieser Lerneinheit sollen sie die Methodik erlernen, indem sie LEGO-Autos zusammenbauen, deren Qualitäts-KPIs bestimmen und miteinander vergleichen.
### Werkzeug für den Zusammenbau
Der Zusammenbau der Autos erfolgt virtuell. Als Werkzeug steht Ihnen das Modul `classes` zur Verfügung. In diesem sind unterschiedliche Klassen und Methoden implementiert (Objektorientierung). Sie erzeugen jeweils Objekte der Klassen. Ein Objekt ist dabei die virtuelle Abbildung eines realen Bauteiles. Die Eigenschaften des Bauteiles werden über die Eigenschaften des Objektes abgebildet.
### Berechnung der Qualitäts-KPIs
KPIs (Key Performance Indikatoren) sind Kenngrößen des Systems. Sie werden über Berechnungsvorschriften (`calculation_rules`) bestimmt. Diese Berechnungsvorschriften sind von Ihnen als python-Funktionen im Modul `calculation_results` zu implementieren.
### Datenblätter
Für den Zusammenbau stehen Ihnen verschiedene Bauteile in unterschiedlichen Ausführungen zur Verfügung. Sie nutzen die Datenblätter, die als `json-Dateien` zur Verfügung gestellt werden, um Ihre Autos zusammenzubauen.
%% Cell type:markdown id:1c702114 tags:
## Eigene Module und Minimalbeispiel
Für die Ausarbeitung nutzen wir zwei eigene Module (Python-Dateien), die im Ordner `functions` gespeichert sind.
Das Modul `calculation_rules` erweitern Sie während der Ausarbeitung. Um die Änderungen zu nutzen, müssen Sie das Notebook neu starten.
Im Modul `classes` befinden sich die Klassen `LegoComponent, LegoAssembly, AggergationLayer, KPIEncoder` und die Funktion `print_assembly_tree`.
`LegoComponent` bildet einzelne Komponenten ab, während `LegoAssembly` zusammengesetzte Aggregationsebenen abdeckt, also Bauteil, Baugruppe und System. Zur Unterscheidung dient die Klasse Aggregationslayer, diese ist für `LegoComponent` immer `Component`, muss für `LegoAssembly` aber entsprechend auf `SYSTEM, ASSEMBLY` oder `SUBASSEMBLY` gesetzt werden.
Im Modul `classes` befinden sich die komplette Klassen und Funktionen zur Verwendung.
Mit einem Minimalbeispiel wird Ihnen gezeigt, wie sie die Module nutzen.
Mit einem Minimalbeispiel wird Ihnen gezeigt, wie sie die Module nutzen. Dabei wird nur aus Achse, Rahmen und Reifen ein Tretroller gebaut.
%% Cell type:markdown id:6d3310be tags:
### Modul classes
`LegoComponent, LegoAssembly, AggergationLayer, KPIEncoder` und die Funktion `print_assembly_tree`.
`LegoComponent` bildet einzelne Komponenten ab, während `LegoAssembly` zusammengesetzte Aggregationsebenen abdeckt, also Bauteil, Baugruppe und System. Zur Unterscheidung dient die Klasse Aggregationslayer, diese ist für `LegoComponent` immer `Component`, muss für `LegoAssembly` entsprechend auf `SYSTEM, ASSEMBLY` oder `SUBASSEMBLY` gesetzt werden.
Wir bauen aus Achse, Rahmen und Reifen einen Tretroller zusammen.
%% Cell type:code id:b2778dee tags:
``` python
# import modules
import json
import pprint
from functions import calculation_rules
from functions import classes
# Importing all modules one by one to provide an overview
# The next commented line would provide the same result in one line
# from functions.classes import *
from functions.classes import LegoComponent
from functions.classes import LegoAssembly
from functions.classes import AggregationLayer
from functions.classes import KPIEncoder
from functions.classes import print_assembly_tree
```
%% Cell type:code id:0b1f9aff tags:
``` python
## ## Create the wheels and axles as single components first
# Look up the specific item you want from the provided json files, we can load the full file into a dict
with open('datasheets/axles.json') as json_file:
axles = json.load(json_file)
# Pick a specific axle via its 'item number'
print(axles['32073'])
# Create the component with the dict:
front_axle = classes.LegoComponent('front axle',axles['32073'])
front_axle = LegoComponent('front axle',axles['32073'])
# Both label and the data dict are optional parameters. You can view, add or edit the properties just any dict:
print(front_axle.properties['label'])
front_axle.properties['color']= 'grey'
# Viewing dicts in one line is not easy to read, a better output comes with pretty print (pprint):
pprint.pprint(front_axle.properties)
# Create the second axle
back_axle = classes.LegoComponent()
back_axle = LegoComponent()
back_axle.properties['label'] = 'back axle'
back_axle.properties.update(axles['32073'])
# Do not use = here, otherwise you'd overwrite existing properties.
# Instead use update to have all entries added to properties
back_axle.properties['color'] = 'grey'
# Viewing dicts in one line is not easy to read, a better output comes with pretty print (pprint):
pprint.pprint(back_axle.properties)
```
%% Output
{'item number.1': 32073, 'item description': 'Axle 5 studs', 'category': 'axle', 'price [Euro]': 0.001, 'mass [g]': 0.66, 'delivery time [days]': 3, 'Abmessung [studs]': 5}
---------------------------------------------------------------------------
KeyError Traceback (most recent call last)
Cell In[1], line 18
16 front_axle = classes.LegoComponent('front axle',axles['32073'])
17 # Both name and the data dict are optional parameters. You can view, add or edit the properties just any dict:
---> 18 print(front_axle.properties['name'])
19 front_axle.properties['color']= 'grey'
20 # Viewing dicts in one line is not easy to read, a better output comes with pretty print (pprint):
KeyError: 'name'
{'item number': 32073, 'item description': 'Axle 5 studs', 'category': 'axle', 'price [Euro]': 0.001, 'mass [g]': 0.66, 'delivery time [days]': 3, 'Abmessung [studs]': 5}
front axle
{'Abmessung [studs]': 5,
'category': 'axle',
'color': 'grey',
'delivery time [days]': 3,
'item description': 'Axle 5 studs',
'item number': 32073,
'label': 'back axle',
'mass [g]': 0.66,
'price [Euro]': 0.001}
%% Cell type:code id:b4a8e8c8 tags:
``` python
# Now wheels
with open('datasheets/wheels.json') as json_file:
wheels = json.load(json_file)
# Adding the color here already as dict, and the surface as key-value argument.
# Multiple of both are supported, but only in this
#front_wheel = classes.LegoComponent('front wheel', wheels['2903'],{'color':'yellow'},winter='true')
# Multiple of both parameters are supported, but only in this order.
#front_wheel = LegoComponent('front wheel', wheels['2903'],{'color':'yellow'},winter='true')
front_wheel = classes.LegoComponent('front wheel', wheels['2903'],surface='rough', paint = 'glossy')
# front_
front_wheel = LegoComponent('front wheel', wheels['2903'],surface='rough', paint = 'glossy')
pprint.pprint(front_wheel.properties)
# We included a clone function, so you can easily create multiple items:
back_wheel = front_wheel.clone()
# We included a clone function to both Lego classes, so you can easily create duplicate objects:
back_wheel = front_wheel.clone('back wheel') # Passing the new label is optional
```
%% Output
{'category': 'wheel',
'data source': 'https://www.bricklink.com/v2/catalog/catalogitem.page?P=2903c02#T=C',
'delivery time [days]': 5,
'diameter [mm]': 81.6,
'item description': 'wheel 81,6',
'item number.1': 2903,
'item number': 2903,
'label': 'front wheel',
'mass [g]': 30.0,
'name': 'front wheel',
'paint': 'glossy',
'price [Euro]': 1.31,
'related items': 2902,
'surface': 'rough'}
%% Cell type:code id:bd3c7a6b tags:
%% Cell type:code id:25bd06c5 tags:
``` python
## Create subassemblies and add the wheels and axles
# The AggregationLayer must be used, passing the label, or additional properties is optional
front_wheel_assembly = LegoAssembly(AggregationLayer.SUBASSEMBLY, 'front wheel assembly',
assembly_method='stick together like lego blocks')
# Add LegoComponents to the LegoAssembly, single or as list
front_wheel_assembly.add([front_wheel,front_axle])
# You can access the components of an assembly like this:
print(front_wheel_assembly.components[1].properties['label'])
# Assemblies can be cloned as well (including their children), but don't forget to adjust
# labels or you might be stuck with a 'front wheel' in your 'back wheel assembly'
# Stick together back wheel parts
back_wheel_assembly = LegoAssembly(AggregationLayer.SUBASSEMBLY, 'back wheel assembly')
```
%% Output
front axle
%% Cell type:code id:2b6648e1 tags:
``` python
## Create frame component and assemble the system
with open('datasheets/frame.json') as json_file:
frame = json.load(json_file)
scooter_frame = LegoComponent('scooter frame', frame['3702'], {'color' : 'red'})
# The scooter is our system level assembly, you can choose the AggregationLayer
# But the hiercarchy (SYSTEM > ASSEMBLY > SUBASSEMBLY) must be in order.
# Components can be added to all LegoAssembly objects
# Also need a frame
with open('datasheets/Gestell.json') as json_file:
Gestelle = json.load(json_file)
Gestellbeschreibung = "Technic, Brick 1 x 8 with Holes"
Gestell = Gestelle[Gestellbeschreibung]
scooter = LegoAssembly(AggregationLayer.SYSTEM,'scooter', manufacturer='FST', comment='Faster! Harder! Scooter!')
# add frame and subassemblies
scooter.add([scooter_frame, front_wheel_assembly, back_wheel_assembly])
```
%% Cell type:markdown id:3b69752c tags:
%% Cell type:code id:71324895 tags:
``` python
## Look at the assembly
### Modul calculation_results
Sie können die unterschiedlichen Funktionen (Berechnungsvorschriften) aufrufen. Beachten Sie dabei die Übergabe- und Rückgabewerte.
# We can get all LegoComponents from this assembly.
# Without parameter 'max_depth' only direct children will be listed.
scooter.get_component_list(5)
```
%% Output
%% Cell type:code id:294c680b tags:
LegoAssembly faster, harder, scooter [faaf8065-7a4b-4d5b-8ede-72f051cca87f]
├── LegoAssembly front wheel assembly [97a43799-b91b-49b5-8d78-38bb72257931]
│ ├── LegoComponent front wheel [9cfcfc76-7ce1-4066-a8ab-ebf30f59683d]
│ └── LegoComponent front axle [010ba850-ca1b-41e2-90b9-13a3528c49e8]
├── LegoAssembly back wheel assembly [82f000db-da62-44bd-993d-b8042baf03d3]
└── LegoComponent scooter frame [87489434-ba11-42d2-91b2-bbf9735b7091]
%% Cell type:markdown id:001f1c77 tags:
### Modul calculation_rules
Um für unser System "Tretroller" ein KPI für das Gesamtgewicht zu erzeugen, wurde in `functions.calculation_rules` die Funktion `kpi_sum` definiert. Zusammen mit den Hilfsfunktionen der Klasse können wir nun das KPI Gewicht für das System hinzufügen. Die Massen der einzelnen Komponenten sind in den Datenblättern unter `mass [g]` enthalten.
%% Cell type:code id:7b60d0fb tags:
``` python
# test the import
calculation_rules.test_function()
```
%% Cell type:markdown id:a2c87a3c tags:
%% Output
### Modul classes
Wir bauen ein Auto zusammen.
You called the test function.
%% Cell type:code id:8db386db tags:
%% Cell type:code id:fe4edad6 tags:
``` python
## Add mass to assemblies
# List all components' mass
combined_weight = 0
for c in scooter.get_component_list(100):
combined_weight += c.properties['mass [g]']
print("Gesamtgewicht: ",combined_weight,"g")
# Add KPI to system
scooter.properties['mass [g]'] = combined_weight
# We can also add the mass to the subassemblies
# children() returns a dict with a list added parts
for a in scooter.children()['assemblies']:
a_mass = 0
for c in a.get_component_list(99):
a_mass += c.properties['mass [g]']
a.properties['mass [g]'] = a_mass
```
%% Cell type:code id:8f2ae9f4 tags:
%% Output
Gesamtgewicht: 33.51 g
%% Cell type:code id:4d56419f tags:
``` python
## Look at the full assembly with KPI
# Print the full assembly with all levels
print_assembly_tree(scooter)
```
%% Output
LegoAssembly faster, harder, scooter [faaf8065-7a4b-4d5b-8ede-72f051cca87f]
├── LegoAssembly front wheel assembly [97a43799-b91b-49b5-8d78-38bb72257931]
│ ├── LegoComponent front wheel [9cfcfc76-7ce1-4066-a8ab-ebf30f59683d]
│ └── LegoComponent front axle [010ba850-ca1b-41e2-90b9-13a3528c49e8]
├── LegoAssembly back wheel assembly [82f000db-da62-44bd-993d-b8042baf03d3]
└── LegoComponent scooter frame [87489434-ba11-42d2-91b2-bbf9735b7091]
LegoAssembly front wheel assembly [97a43799-b91b-49b5-8d78-38bb72257931]
LegoAssembly faster, harder, scooter [faaf8065-7a4b-4d5b-8ede-72f051cca87f]
%% Cell type:code id: tags:
``` python
# Dump to json file with to_dict() and KPIEncoder
with open("scooter.json", "w") as fp:
json.dump(scooter.to_dict(), fp, cls=KPIEncoder)
# full view is too big for Juypter (try it)
# pprint.pprint(scooter.to_dict())
```
%% Cell type:markdown id:53793ae8 tags:
In dieser exportierten json-Datei ('scooter.json') lassen sind die Werte maschinen- und menschenlesbar hinterlegt.
Zusammen mit der Berechnungsvorschrift in `calculation_rules` ist auch die Entstehung des KPI nachvollziehbar und wiederverwendbar dokumentiert und damit 'FAIR'.
%% Cell type:code id:b91fed73 tags:
``` python
## Additional details
# Each child knows its parent
first_child = scooter.children()['assemblies'][0]
print("Child:", first_child)
print("Parent:", first_child.parent)
# Also we can access the "top" parent
latest_child = first_child.children()['components'][0]
print("Top parent: ",latest_child.get_root_assembly())
# Each part created has a unique identifier (the long number in [])
# Don't try add the identical part again.
```
%% Output
Child: LegoAssembly front wheel assembly [97a43799-b91b-49b5-8d78-38bb72257931]
Parent: LegoAssembly faster, harder, scooter [faaf8065-7a4b-4d5b-8ede-72f051cca87f]
Top parent: LegoAssembly faster, harder, scooter [faaf8065-7a4b-4d5b-8ede-72f051cca87f]
%% Cell type:markdown id:de070039 tags:
## Aufgabe: Aufbau eines ersten Fahrzeugs
Bauen Sie ein erstes Fahrzeug aus den gegebenen LEGO-Teilen auf.
Das Fahrzeug muss aus Baugruppen, Bauteilen und Komponenten bestehen. Es muss mindestens vier Räder haben und sich durch den elektrischen Antrieb fortbewegen können.
%% Cell type:markdown id:05a8eb21 tags:
### Beschreibung des Fahrzeuges
Beschreiben Sie kurz und präzise Ihr Fahrzeug.
%% Cell type:code id:ccaf3043 tags:
``` python
# initialize componentens
```
%% Cell type:code id:1ea61422 tags:
``` python
# read out properties from datasheets
```
%% Cell type:code id:36f981df tags:
``` python
# set properties
```
%% Cell type:code id:24400d94 tags:
``` python
# export car and its properties
```
%% Cell type:markdown id:c1fef7f0 tags:
## Aufgabe: Bestimmung der Qualität mittels KPIs
Bestimmen Sie die Qualität Ihres Fahrzeugs mittels KPIs.
Die Qualität des Fahrzeugs ist mit mindestens einem KPI je Qualitätsdimension (Aufwand, Verfügbarkeit, Akzeptanz) zu bestimmen. Enwickeln Sie zunächst sinnvolle KPIs, welche mit den gegebenen Daten umsetzbar sind. Halten Sie die Berechnungsvorschriften im Jupyter Notebook fest. Implementieren Sie deren Berechnung für das Gesamtsystem "Fahrzeug" mittels einzelner Funktionen im Skript `calculation_rules`. Sie können zusätzlich Ihre Methoden auch auf die niedrigeren Aggregationsebenen anwenden.
%% Cell type:markdown id:d5f02096 tags:
### Beschreibung KPI
Beschreiben Sie den jeweiligen KPI und geben Sie seine Berechnungsvorschrift an.
$$
a = \frac{b}{c} + d
$$
%% Cell type:code id:59eabafc tags:
``` python
# calculate the KPIs for your car
```
%% Cell type:code id:c774b381 tags:
``` python
# print your KPIs
```
%% Cell type:markdown id:89c75440 tags:
## Aufgabe: Aufbau eines zweiten Fahrzeugs
Setzen Sie sich ein Ziel, welche Qualitätsdimensionen in einem zweiten Fahrzeug verbessert werden sollen und bauen Sie dementsprechend ein zweites Fahrzeug aus den gegebenen LEGO-Teilen auf.
Das Fahrzeug muss aus Baugruppen, Bauteilen und Komponenten bestehen. Es muss mindestens vier Räder haben und sich durch den elektrischen Antrieb fortbewegen können. Die Verwendung eines Getriebes zwischen Motor und Antriebsachse(n) ist verpflichtend. Es sind nur die gegebenen LEGO-Teile zu verwenden.
%% Cell type:markdown id:3cef0828 tags:
### Beschreibung
Beschreiben Sie, welche Verbesserung Sie vornehmen.
...
%% Cell type:markdown id:73c454f2 tags:
### Aufbau des zweiten Fahrzeuges
Beschreiben Sie kurz und präzise den Aufbau des zweiten Fahrzeugs
%% Cell type:code id:ea18e735 tags:
``` python
# build a second car
```
%% Cell type:code id:b3438fc4 tags:
``` python
# read out properties from datasheets
```
%% Cell type:code id:0b7336fb tags:
``` python
# set properties
```
%% Cell type:code id:446abbca tags:
``` python
# export car and its properties
```
%% Cell type:markdown id:89e54480 tags:
### KPIs des zweiten Fahrzeuges
Bestimmen Sie die KPIs des zweiten Fahrzeuges
%% Cell type:code id:762a1e93 tags:
``` python
# calculate the KPIs for your car
```
%% Cell type:code id:1ed67328 tags:
``` python
# print your KPIs
```
%% Cell type:markdown id:e413cd84 tags:
## Aufgabe: Darstellung und Vergleich der Ergebnisse
Stellen Sie die Ergebnisse für beide Fahrzeuge übersichtlich dar.
Die entwickelten KPIs müssen dargestellt und die Datengrundlage ersichtlich sein.
Eine geeignete grafische Darstellung für die Gegenüberstellung der Ergebnisse für beide Fahrzeuge ist zu wählen.
%% Cell type:code id:b0f93e22 tags:
``` python
# plot the data, save diagramm as svg-file
```
%% Cell type:markdown id:62ff04b2 tags:
### Interpretation der Ergebnisse
Interpretieren Sie ihre Ergebnisse. Vergleichen Sie die KPIs ihrer Autos. Konnten Sie ihre gewünschte Verbesserung erzielen?
%% Cell type:markdown id:a0840fbf tags:
## Aufgabe: Exportieren Sie ihre Daten
Exportieren/ Speichern Sie alle relevaten Daten ab.
%% Cell type:code id:a4bdfc7a tags:
``` python
# export all relevant data
```
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment