.gitignore

+# Remove git tracking for certain file types or files in certain folders. 
+# Usually you don't need to change this file.
 .vscode/
 venv/
-data/
 *.tmp
 .DS_Store
 __pycache__/
-*.svg
 .ipynb_checkpoints
\ No newline at end of file

README.md

+# Lerneinheit II-II: Kalorimetrie (Präsenz)
+## Einführung
+Siehe Skript und Aufgabenstellung in [moodle](https://moodle.tu-darmstadt.de/course/view.php?id=36368&section=5#tabs-tree-start).
+
+## Materialien
+In diesem GitLab Repo finden Sie:
+- Package functions (`functions/`): Beinhaltet die Module `m_labor`, `utility` und Skript `s_uuid6`
+- Modul `m_labor` (`functions/m_labor.py`): Vorlage der Funktion zum Abspeichern der Einstellung des Labornetzteiles sowie die Zeit der Erwärmung.
+- Modul `utility` (`functions/utility.py`): Vorlage der Funktionen zur Datenauswertung
+- Skript `s_uuid6` (`functions/s_uuid6.py`): Um UUIDs zu generieren
+- Python-Hilfsdatei (`functions/__init__.py`): Notwendige Datei für die Erzeugung eines Python-Pakets
+- Datenblätter (`datasheets/`): Vorlage der Datenblätter der Komponenten des Prüfstandes im JSON-Format
+- Messdaten (`data/`): Wo die Messdaten abgespeichert werden
+- Abbildungsordner (`figures/`): Ordner zum Ablegen die Fotos bzw. Abbildungen aus der Auswertung
+- Notebook Laborversuch (`ausarbeitung_laborversuch.ipynb`): Vorlage zur Messdatenauswertung
+- Main Skript (`main.py`): Zum Aufnahmen der Messdaten
+- Infosblatt (`DS18B20_Datasheet.pdf`): Infosblatt des DS18B20 Sensors
+- Readme (`REAMDE.md`): diese Datei
+- Requirements (`requirements.txt`): Beschreibt die pip-Umgebung, nicht relevant für die Ausarbeitung
+- Matplotlib Style (`FST.mplstyle`): Einstellung für Matplotlib nach der FST-Institut-Vorschrift
+
+### Numpy Quick Start Quide
+`numpy.ndarray` ist eine sehr effiziente Datenstruktur im Python-Package `numpy`, die von Datenwissenschaftlern jeden Tag gebraucht wird. Einige Beispiele werden hier gezeigt.
+
+Initializierung von `numpy.ndarray`:
+```python
+import numpy as np
+
+a = np.array([[1, 2, 3, 4], [5, 6, 7, 8]])
+```
+Anders als `list` müssen die Elemente im `ndarray` von gleichen Typen (zum Beispiel `float64`) sein. Und das Array muss wie eine Matrix in der Mathematik aussehen. Das heißt, die Anzahl der Elemente bei jeder Spalte bzw. Zeile gleich ist.
+
+`numpy.ndarray` erleichert die mathematische Berechnung:
+```python
+# Assuming that each element in "a" is the radius of a circle,
+# the area of each circle can be calculated in this way.
+area = np.pi * a ** 2
+# Print the array.
+print(area)
+# Print a element in the array.
+print(area[0, 3])
+```
+Es ist möglich, Statistik des Arrays durch Build-in Funktionen von `numpy` zu brechen.
+```python
+a_mean = a.mean()
+print(a_mean)
+# Calculate the average of each column.
+a_mean_first_dimension = a.mean(0)
+print(a_mean_first_dimension)
+```
+
+### Links
+Mehr Infomationen über die Datenstruktur sind in der [README.md](https://git.rwth-aachen.de/fst-tuda/public/lehre/calorimetry_home/-/blob/main/README.md) des Küchentischversuches zu finden.
+
+[NumPy: the absolute basics for beginners](https://numpy.org/doc/stable/user/absolute_beginners.html)
+
+[h5py Quick Start Guide](https://docs.h5py.org/en/stable/quick.html)
+
+[NumPy Fundamentals](https://numpy.org/doc/stable/user/basics.html)
+
+[Matplotlib Pyplot Scatter](https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.scatter.html#matplotlib.pyplot.scatter)
+
+[PyPi: W1ThermSensor](https://pypi.org/project/w1thermsensor/)
+
+## Ausarbeitung
+Die Ausarbeitung erfolgt in den Modul `m_labor` und Notebook `ausarbeitung_laborversuch.ipynb`. In diesen ist bereits eine Gliederung vorgegeben.
+
+## Abgabe
+Die Abgabe erfolgt über [moodle](https://moodle.tu-darmstadt.de/mod/assign/view.php?id=1249200). 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_2-2.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 Datenauswertungen
+- Python-Modul
\ No newline at end of file

data/.gitkeep

+## This file is for git to be able to version control empty folders, you can ignore this file, it only helps us to keep the structure of the template. ##
\ No newline at end of file

data/Heat_Capacity/actor_immersionHeater_1ee21744-0355-6023-94b4-d5c041dd32cd.json

+{
+	"JSON": {
+		"ID": "1ee21744-0355-6023-94b4-d5c041dd32cd",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+	"actor": {
+		"type": "immersion heater",
+		"manufacturer": "Zhuodingsen",
+		"power_supply": {
+			"voltage": 12,
+			"type": "DC voltage",
+			"source": {
+				"type": "adjustable laboratory power supply",
+				"model": "DPPS-32-20",
+				"manufacturer": "VOLTCRAFT",
+				"power": "640 Watt",
+				"technology": "clocked power supply",
+				"voltage": "1...32 V",
+				"current": "0...20 A",
+				"residual ripple": "<5 mV"
+			}
+		}
+	}
+}

data/Heat_Capacity/calorimeter_1ee5ec0c-0b57-68cd-9d39-c9b7e9b18753.json

+{
+	"JSON": {
+		"ID": "1ee5ec0c-0b57-68cd-9d39-c9b7e9b18753",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+	"calorimeter": {
+		"type": "heat flow calorimeter",
+		"manufacturer": "Fluidsystemtechnik",
+		"container": {
+			"type": "beaker",
+			"volume": {
+				"value": 600,
+				"unit": "milliliter"
+			}
+		},
+		"medium": {
+			"type": "water",
+			"mass": {
+				"value": 400,
+				"unit": "gramm",
+				"accuracy": {
+					"value": 0,
+					"type": "absolute",
+					"unit": "gramm"
+				}
+			}
+		}
+	}
+}

data/Heat_Capacity/group_1ee5ec0a-1830-63f5-ac3e-6f8ce4468546.json

+{
+	"JSON": {
+		"ID": "1ee5ec0a-1830-63f5-ac3e-6f8ce4468546",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+	"group": {
+		"number": "Laborversuch_Group37",
+		"author": [
+			"Diogo Fernandes Costa",
+			"Zidane Bürmann",
+			"Santiago Ramirez Saldana"
+		],
+		"experiment": "calorimetry",
+		"testrig_number": "1"
+	}
+}

data/Heat_Capacity/instrument_raspPi_1ee5ec0d-e77c-68b7-90f7-2e33485ff91c.json

+{
+	"JSON": {
+		"ID": "1ee5ec0d-e77c-68b7-90f7-2e33485ff91c",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+	"instrument": {
+		"name": "raspberry_pi",
+		"type": "single_board_computer",
+		"manufacturer": "Raspberry Pi Foundation",
+		"model": "Raspberry Pi 4 Model B Rev. 1.5",
+		"serial": "10000000dbd18662",
+		"operating_system": "Raspberry Pi OS",
+		"comment": "to get model and serial number put this code in the terminal: cat /proc/cpuinfo"
+	}
+}

data/Heat_Capacity/sensor_tempCalorimeter1_1ee5ec00-4a00-68a1-bb1e-873c2dd4dbde.json

+{
+	"JSON": {
+		"ID": "1ee5ec00-4a00-68a1-bb1e-873c2dd4dbde",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+	"sensor": {
+		"name": "Temperature_Sensor",
+		"type": "DS18B20",
+		"manufacturer": "keyestudio",
+		"serial": "3c01f0956007",
+		"comment": "",
+		"range": {
+			"min": -55,
+			"max": 125,
+			"units": "degree_celsius"
+		},
+		"accuracy": {
+			"value": 0.5,
+			"type": "absolute",
+			"unit": "degree_celsius"
+		}
+	}
+}

data/Heat_Capacity/sensor_tempCalorimeter2_1ee5ec03-7e64-6071-8ca3-98dbab0a7719.json

+{
+	"JSON": {
+		"ID": "1ee5ec03-7e64-6071-8ca3-98dbab0a7719",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+	"sensor": {
+		"name": "Temperature_Sensor",
+		"type": "DS18B20",
+		"manufacturer": "keyestudio",
+		"serial": "3cf9e3818fb8",
+		"comment": "",
+		"range": {
+			"min": -55,
+			"max": 125,
+			"units": "degree_celsius"
+		},
+		"accuracy": {
+			"value": 0.5,
+			"type": "absolute",
+			"unit": "degree_celsius"
+		}
+	}
+}

data/Heat_Capacity/sensor_tempCalorimeter3_1ee5ec04-30cd-678f-a64b-0ce7544ef5e8.json

+{
+	"JSON": {
+		"ID": "1ee5ec04-30cd-678f-a64b-0ce7544ef5e8",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+	"sensor": {
+		"name": "Temperature_Sensor",
+		"type": "DS18B20",
+		"manufacturer": "keyestudio",
+		"serial": "3c01f095b066",
+		"comment": "",
+		"range": {
+			"min": -55,
+			"max": 125,
+			"units": "degree_celsius"
+		},
+		"accuracy": {
+			"value": 0.5,
+			"type": "absolute",
+			"unit": "degree_celsius"
+		}
+	}
+}

data/Heat_Capacity/sensor_tempEnvironment_1ee5ec04-c845-69e2-853a-25c11543466f.json

+{
+	"JSON": {
+		"ID": "1ee5ec04-c845-69e2-853a-25c11543466f",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+	"sensor": {
+		"name": "Temperature_Sensor",
+		"type": "DS18B20",
+		"manufacturer": "keyestudio",
+		"serial": "3c01f095d465",
+		"comment": "",
+		"range": {
+			"min": -55,
+			"max": 125,
+			"units": "degree_celsius"
+		},
+		"accuracy": {
+			"value": 0.5,
+			"type": "absolute",
+			"unit": "degree_celsius"
+		}
+	}
+}

data/Heat_Capacity/setup_constant.json

+{
+	"JSON": {
+		"ID": "1ee5ec1a-e3f7-66be-b5a8-ad82b1e18627",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+    "comment": "this setup is used to measure the calorimeter constant by bringing in a known amount of energy, while measuring the temperature",
+	"setup": {
+		"1ee5ec0a-1830-63f5-ac3e-6f8ce4468546": {
+            "type": "group_info",
+			"name": "group_info",
+            "comment": ""
+        },
+		"1ee5ec0d-e77c-68b7-90f7-2e33485ff91c": {
+            "type": "instrument",
+			"name": "raspberry_pi",
+            "comment": ""
+        },
+        "1ee5ec0c-0b57-68cd-9d39-c9b7e9b18753": {
+            "type": "calorimeter",
+			"name": "calorimeter",
+            "comment": ""
+        },
+		"1ee21744-0355-6023-94b4-d5c041dd32cd": {
+            "type": "actor",
+			"name": "immersion_heater",
+            "comment": "this heater is used to warm up the water in the calorimeter for measuring the calorimeter constant"
+        },
+		"1ee5ec00-4a00-68a1-bb1e-873c2dd4dbde": {
+            "type": "sensor",
+			"name": "temperature_calorimeter_1",
+            "comment": ""
+        },
+		"1ee5ec03-7e64-6071-8ca3-98dbab0a7719": {
+            "type": "sensor",
+			"name": "temperature_calorimeter_2",
+            "comment": ""
+        },
+		"1ee5ec04-30cd-678f-a64b-0ce7544ef5e8": {
+            "type": "sensor",
+			"name": "temperature_calorimeter_3",
+            "comment": ""
+        },
+		"1ee5ec04-c845-69e2-853a-25c11543466f": {
+            "type": "sensor",
+			"name": "temperature_environment",
+            "comment": ""
+        }
+	}
+}
\ No newline at end of file

data/PDC003/actor_sousvide_1ee21750-5282-63bc-86e9-b4de622ee43e.json

+{
+	"JSON": {
+		"ID": "1ee21750-5282-63bc-86e9-b4de622ee43e",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+	"actor": {
+		"type": "Sous Vide cooker",
+		"model": "DE310B",
+		"manufacturer": "KitchenBoss",
+		"power_supply": {
+			"voltage": "230 V",
+			"type": "AC voltage",
+			"power": "1100 W"
+		},
+		"temperature_range": {
+			"min": 40,
+			"max": 90,
+			"unit": "degree Celsius"
+		},
+		"circulation": "available"
+	}
+}
\ No newline at end of file

data/PDC003/calorimeter_1ee5ec0c-0b57-68cd-9d39-c9b7e9b18753.json

+{
+	"JSON": {
+		"ID": "1ee5ec0c-0b57-68cd-9d39-c9b7e9b18753",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+	"calorimeter": {
+		"type": "heat flow calorimeter",
+		"manufacturer": "Fluidsystemtechnik",
+		"container": {
+			"type": "beaker",
+			"volume": {
+				"value": 600,
+				"unit": "milliliter"
+			}
+		},
+		"medium": {
+			"type": "water",
+			"mass": {
+				"value": 400,
+				"unit": "gramm",
+				"accuracy": {
+					"value": 0,
+					"type": "absolute",
+					"unit": "gramm"
+				}
+			}
+		}
+	}
+}

data/PDC003/group_1ee5ec0a-1830-63f5-ac3e-6f8ce4468546.json

+{
+	"JSON": {
+		"ID": "1ee5ec0a-1830-63f5-ac3e-6f8ce4468546",
+		"label": "",
+		"comment": "UUID6 is used"
+	},
+	"group": {
+		"number": "Laborversuch_Group37",
+		"author": [
+			"Diogo Fernandes Costa",
+			"Zidane Bürmann",
+			"Santiago Ramirez Saldana"
+		],
+		"experiment": "calorimetry",
+		"testrig_number": "1"
+	}
+}