Vorlage:Maß/Doku

Diese Vorlage ist vielfach eingebunden. Wenn du die Auswirkungen genau kennst, kannst du sie bearbeiten. Meist ist es jedoch sinnvoll, Änderungswünsche erst auf Vorlage Diskussion:Maß abzustimmen.

Diese Vorlage:Maß (bzw. Vorlage:Mass) dient zum Umrechnen und Formatieren von berechneten Zahlen mitsamt Einheitenzeichen.

Da ihre Ausgabe keinen semantischen Mehrwert generiert, ist es sinnfrei, die Vorlage nur zur Zahlenformatierung zu nutzen. Sie sollte daher bevorzugt innerhalb von Vorlagen, Infoboxen und dergleichen angewendet werden.

Sonderfälle: Bei den Einheiten km und km² wird automatisch m bzw. ha verwendet, falls die Eingabe kleiner als 1,0 ist und keine Parameter zur Umrechnung übergeben werden.

Bei Fehlangaben: Nichtnumerische Parameter werden unverändert ausgegeben und erzeugen einen Wartungseintrag „Maßzahl nicht numerisch“.

Kopiervorlagen

{{Maß|1=|2=|3=|4=|5=|6=|7=|8=|round=|eps=|kl=1}}
{{Maß|1=|2=|3=|4=|5=|6=|7=|8=|round=|eps=}}
{{Maß|1=|2=|3=|4=|5=|6=|7=|8=|round=}}
{{Maß| | | | | |round=|eps=}}
{{Maß| | |6=|7=|8=|round=}}

Parameter

Zwei Pflichteingaben:

1: Die Maßzahl, der Zahlenwert des Maßes.
2: Die Maßeinheit. Ausgefallene Einheiten können verlinkt werden.

Für eine Umrechnung in eine kleinere Einheit:

3: Ein Schwellwert zur kleineren Einheit
4: Eine Einheit kleiner als bei Parameter 2
5: Der Umrechnungsfaktor zur kleineren Einheit, also ${\tfrac {\text{Parameter 2}}{\text{Parameter 4}}}$ .

Für eine Umrechnung in eine größere Einheit:

6: Ein Schwellwert zur größeren Einheit
7: eine größere Einheit als Parameter 2
8: Der (inverse) Umrechnungsfaktor zur größeren Einheit, also ${\tfrac {\text{Parameter 7}}{\text{Parameter 2}}}$ .

Bei ausschließlicher Umrechnung in größere Einheiten, wird dringend empfohlen, die jeweiligen Standardparameter explizit zuzuweisen; zum Beispiel: |6=…|7=…|8=…

Weitere Parameter:

round: Anzahl der Nachkommastellen. Bei einer etwaigen Umrechnung in eine größere Einheit ist diese Angabe dringend erforderlich, wenn die Division durch Parameter 8 zu viele Dezimalstellen erzeugt (z. B. periodische Dezimalzahl)!
eps: Mithilfe dieses optionalen Parameters kann ein Wert im Format Schätzwert ± Messunsicherheit ausgegeben werden. Die Einheiten von Messunsicherheit und Schätzwert sind identisch. Bei Angabe eines Schwellwerts wird entsprechend umgerechnet. Der Schätzwert wird mit Parameter 1 übergeben.
kl: Ein logischer Parameter; ist er nicht leer und auch ein Wert für die Messunsicherheit (eps) angegeben, so wird das Ergebnis mit einer Klammer versehen: (Schätzwert ± Messunsicherheit)

Umrechnen und Formatieren von berechneten Zahlen mitsamt Einheitenzeichen.

Vorlagenparameter

Parameter		Beschreibung	Typ	Status
Maßzahl	`1`	Die Maßzahl, der Zahlenwert des Maßes. Beispiel 1234.56789	Zahlenwert	erforderlich
Maßeinheit	`2`	Einheit, in der gemessen wird Beispiel m	Einzeiliger Text	erforderlich
Schwellwert (kl. Einheit)	`3`	Schwellwert für die Umrechnung in eine kleinere Einheit. Beispiel 1	Zahlenwert	optional
Die kleinere Einheit	`4`	Eine kleinere Einheit, kleiner als bei Parameter 2. Beispiel cm	Einzeiliger Text	optional
Umrechnungsfaktor (kl. Einheit)	`5`	Der Umrechnungsfaktor der kleineren Einheit: Parameter 2 ÷ Parameter 4 Beispiel 100	Zahlenwert	optional
Schwellwert (gr. Einheit)	`6`	Schwellwert für die Umrechnung in eine größere Einheit. Beispiel 1000	Zahlenwert	optional
Die größere Einheit	`7`	Eine größere Einheit, größer als bei Parameter 2. (Umrechnung in größere Einheit). Beispiel km	Einzeiliger Text	optional
Umrechnungsfaktor (gr. Einheit)	`8`	Der Umrechnungsfaktor der größeren Einheit: Parameter 2 ÷ Parameter 4 Beispiel 1000	Zahlenwert	optional
Nachkommastellen	`round`	Runden auf diese Anzahl Nachkommastellen. Beispiel 3	Zahlenwert	optional
Messunsicherheit	`eps`	Fügt dem Resultat einen Wert für Messunsicherheit hinzu: Messwert ± Messunsicherheit. Beispiel 5	Zahlenwert	optional
Klammern	`kl`	Wenn hier und für die Messunsicherheit (eps) ein Wert angegeben ist, wird das Resultat in Klammern gesetzt. Beispiel 1	Einzeiliger Text	optional

Beispiele

Info: Es bietet sich an, ggf. einzelne Leerzeichen zur Gruppierung der Parameter zu nutzen; ähnlich der Zifferngruppierung.

Beispiel für Schwellwert:

{{Maß|0.578|km²|1|ha|100}} wird zu 57,8 ha, weil 0,578 km² kleiner als 1 km² sind. Ein Quadratkilometer hat 100 Hektar.

Beispiel mit Rundung:

{{Maß|19.12|km |1|m|1000 |round=1}} wird zu 19,1 km

Beispiel mit Messunsicherheit:

{{Maß|1.578|kg |1|g|1000 |eps=0.02}} ergibt 1,578 ± 0,02 kg

Beispiel einer Schätzung; mit Messunsicherheit und Klammern:

{{Maß |1.578|kg |1|g|1000 |eps=0.02|kl=ja}} ergibt (1,578 ± 0,02) kg

Weitere Beispiele:

Quelltext-Eingabe	Resultat
`{{Maß\|3000 m\|m}}`	3000 mdep1
`{{Maß\|3000\|m}}`	3000 m
`{{Maß\|0.99\|cm \|1\|mm\|10 \|10\|dm\|1 \|round=3}}`	9,9 mm
`{{Maß\|1.11\|cm \|1\|mm\|10 \|10\|dm\|1 \|round=3}}`	1,11 cm
`{{Maß\|0.99\|km \|1\|m\|1000 \|round=1}}`	990 m
`{{Maß\|0.99756\|km \|1\|m\|1000 \|round=1}}`	997,6 m
`{{Maß\|1.993\|km \|1\|m\|1000 \|round=1}}`	2 km
`{{Maß\|1.993\|km \|1\|m\|1000 \|round=2}}`	1,99 km
`{{Maß\|0.99\|xyz}}`	0,99 xyz
`{{Maß\|0.99\|km²}}`	99 ha
`{{Maß\|7.99\|km²}}`	7,99 km²
`{{Maß\|1.234567\|km \|1\|m\|1000 \|round=0}}`	1 km
`{{Maß\|0.234567\|km \|1\|m\|1000 \|round=0}}`	235 m
`{{Maß\|1234.5678901234\|m \|1\|cm\|100 \|1000\|km\|1000 \|round=3}}`	1,235 km
`{{Maß\|0.578\|kg \|1\|g\|1000 \|eps=0.02}}`	578 ± 20 g
`{{Maß\|578\|kg\|eps=2}}`	578 ± 2 kg
`{{Maß\|150682490000\|m³ \|1 \|6=100000000 \|7=km³ \|8=1000000000}}`	150,682.49 km³

Lua

Verwendetes Modul: Measure #Masz