README.md

@@ -19,9 +19,41 @@ In diesem GitLab Repo finden Sie:
 - 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)

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"
+	}
+}

data/PDC003/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/PDC003/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/PDC003/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"
+		}
+	}
+}