Vorlage:Maß/Doku
Vorlage:Dokumentation/Seitenhinweis Vorlage:Standardbaustein 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
<syntaxhighlight lang="wikitext" copy>
</syntaxhighlight>
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 <math>\tfrac\text{Parameter 2}\text{Parameter 4}</math>.
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 <math>\tfrac\text{Parameter 7}\text{Parameter 2}</math>.
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
8zu 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.
<templatestyles src="TOC nonum/styles.css"></templatestyles>
⧼templatedata-doc-params⧽
| ⧼templatedata-doc-param-name⧽ | ⧼templatedata-doc-param-desc⧽ | ⧼templatedata-doc-param-type⧽ | ⧼templatedata-doc-param-status⧽ | |
|---|---|---|---|---|
| Maßzahl | 1 | Die Maßzahl, der Zahlenwert des Maßes.
| ⧼templatedata-doc-param-type-number⧽ | ⧼templatedata-doc-param-status-required⧽ |
| Maßeinheit | 2 | Einheit, in der gemessen wird
| ⧼templatedata-doc-param-type-line⧽ | ⧼templatedata-doc-param-status-required⧽ |
| Schwellwert (kl. Einheit) | 3 | Schwellwert für die Umrechnung in eine kleinere Einheit.
| ⧼templatedata-doc-param-type-number⧽ | ⧼templatedata-doc-param-status-optional⧽ |
| Die kleinere Einheit | 4 | Eine kleinere Einheit, kleiner als bei Parameter 2.
| ⧼templatedata-doc-param-type-line⧽ | ⧼templatedata-doc-param-status-optional⧽ |
| Umrechnungsfaktor (kl. Einheit) | 5 | Der Umrechnungsfaktor der kleineren Einheit: Parameter 2 ÷ Parameter 4
| ⧼templatedata-doc-param-type-number⧽ | ⧼templatedata-doc-param-status-optional⧽ |
| Schwellwert (gr. Einheit) | 6 | Schwellwert für die Umrechnung in eine größere Einheit.
| ⧼templatedata-doc-param-type-number⧽ | ⧼templatedata-doc-param-status-optional⧽ |
| Die größere Einheit | 7 | Eine größere Einheit, größer als bei Parameter 2. (Umrechnung in größere Einheit).
| ⧼templatedata-doc-param-type-line⧽ | ⧼templatedata-doc-param-status-optional⧽ |
| Umrechnungsfaktor (gr. Einheit) | 8 | Der Umrechnungsfaktor der größeren Einheit: Parameter 2 ÷ Parameter 4
| ⧼templatedata-doc-param-type-number⧽ | ⧼templatedata-doc-param-status-optional⧽ |
| Nachkommastellen | round | Runden auf diese Anzahl Nachkommastellen.
| ⧼templatedata-doc-param-type-number⧽ | ⧼templatedata-doc-param-status-optional⧽ |
| Messunsicherheit | eps | Fügt dem Resultat einen Wert für Messunsicherheit hinzu: Messwert ± Messunsicherheit.
| ⧼templatedata-doc-param-type-number⧽ | ⧼templatedata-doc-param-status-optional⧽ |
| Klammern | kl | Wenn hier und für die Messunsicherheit (eps) ein Wert angegeben ist, wird das Resultat in Klammern gesetzt.
| ⧼templatedata-doc-param-type-line⧽ | ⧼templatedata-doc-param-status-optional⧽ |
Beispiele
Info: Es bietet sich an, ggf. einzelne Leerzeichen zur Gruppierung der Parameter zu nutzen; ähnlich der Zifferngruppierung.
Beispiel für Schwellwert:
- <syntaxhighlight inline lang="mediawiki">57,8 ha</syntaxhighlight> wird zu 57,8 ha, weil 0,578 km² kleiner als 1 km² sind. Ein Quadratkilometer hat 100 Hektar.
Beispiel mit Rundung:
- <syntaxhighlight inline lang="mediawiki">19,1 km </syntaxhighlight> wird zu 19,1 km
Beispiel mit Messunsicherheit:
- <syntaxhighlight inline lang="mediawiki">1,578 ± 0,02 kg </syntaxhighlight> ergibt 1,578 ± 0,02 kg
Beispiel einer Schätzung; mit Messunsicherheit und Klammern:
- <syntaxhighlight inline lang="mediawiki">(1,578 ± 0,02) kg </syntaxhighlight> ergibt (1,578 ± 0,02) kg
Weitere Beispiele:
| Quelltext-Eingabe | Resultat |
|---|---|
| <syntaxhighlight inline lang="mediawiki">3000 m</syntaxhighlight> | 3000 m |
| <syntaxhighlight inline lang="mediawiki">3000 m</syntaxhighlight> | 3000 m |
| <syntaxhighlight inline lang="mediawiki">9,9 mm</syntaxhighlight> | 9,9 mm |
| <syntaxhighlight inline lang="mediawiki">1,11 cm </syntaxhighlight> | 1,11 cm |
| <syntaxhighlight inline lang="mediawiki">990 m</syntaxhighlight> | 990 m |
| <syntaxhighlight inline lang="mediawiki">997,6 m</syntaxhighlight> | 997,6 m |
| <syntaxhighlight inline lang="mediawiki">2 km </syntaxhighlight> | 2 km |
| <syntaxhighlight inline lang="mediawiki">1,99 km </syntaxhighlight> | 1,99 km |
| <syntaxhighlight inline lang="mediawiki">0,99 xyz</syntaxhighlight> | 0,99 xyz |
| <syntaxhighlight inline lang="mediawiki">99 ha</syntaxhighlight> | 99 ha |
| <syntaxhighlight inline lang="mediawiki">7,99 km²</syntaxhighlight> | 7,99 km² |
| <syntaxhighlight inline lang="mediawiki">1 km </syntaxhighlight> | 1 km |
| <syntaxhighlight inline lang="mediawiki">235 m</syntaxhighlight> | 235 m |
| <syntaxhighlight inline lang="mediawiki">1,235 km</syntaxhighlight> | 1,235 km |
| <syntaxhighlight inline lang="mediawiki">578 ± 20 g</syntaxhighlight> | 578 ± 20 g |
| <syntaxhighlight inline lang="mediawiki">578 ± 2 kg</syntaxhighlight> | 578 ± 2 kg |
| <syntaxhighlight inline lang="mediawiki">150,682.49 km³</syntaxhighlight> | 150,682.49 km³ |