Il template {{M}} serve per agevolare e uniformare la scrittura di misure di grandezze fisiche nelle voci. Esso consente di inserire gruppi di cifre separati da spazi, e fa in modo che tali spazi non vengano spezzati automaticamente in caso di andata a capo (per ottenere questo effetto quando non è necessario impiegare unità di misura, risulta più agevole l'utilizzo dell'apposito template {{tutto attaccato}} o della funzione formatnum).

Introduzione

modifica

Questo template è dedicato al gestire valori numerici, specialmente quelli scritti in notazione scientifica, con incertezza di misura o valori di unità fisiche.

Valore semplice

modifica

Per esprimere un valore, più un'eventuale incertezza simmetrica o asimmetrica si usano i primi tre parametri del template

  • {{M|numero}}numero, formattato con le cifre divise in gruppi di tre separati da uno spazio: {{M|123456.78901}}123 456,78901 
  • {{M|numero|incertezza}}numero ± incertezza, per esempio {{M|123478|56}}123 478 
  • {{M|numero|(incertezza)}}numero(incertezza), per esempio {{M|12345|(56)}}12 345 
  • {{M|numero|incertezza1|incertezza2}}numero Template:Su per esempio {{M|1234|+56|-78}}1 234 

    Attenzione! Prefisso non valido.



    Attenzione! Unità di misura non valida.

Valore e unità di misura

modifica

Per esprimere un'unità di misura si usano i parametri Template:Param oppure Template:Param, per esempio:

  • {{M|4|u=m2}}
  • {{M|4|ul=m2}}

Il valore del parametro Template:Param/Template:Param è un "codice unità" (in questo caso m2) che il template usa per formattare il simbolo corrispondente (m2 in questo caso). Inoltre se viene usato Template:Param il simbolo viene anche collegato alla voce della corrispondente unità di misura. Un codice unità è semplicemente un'abbreviazione del nome dell'unità, ma questo può diventare discretamente convoluta per unità composte, con "moltiplicatori" o "divisori".

È possibile usare altri due parametri Template:Param e Template:Param per indicare un'unità di misura al denominatore:

  • {{M|9.8|u=gal|upl=min}}9,8 
  • {{M|9.8|ul=parsec|up=anno}}9,8 

Per permettere di inserire unità di misura complesse o non previste se il Template:Param non viene riconosciuto viene riportato così com'è:

  • {{M|5.4|u=[[kg]]&sdot;[[metro|m]]/s<sup>2</sup>}}5,4 
  • {{M|7.6|u=[[Metro al secondo quadrato|m/s<sup>2</sup>]]}}7,6 

Il template riconosce i simboli gestiti dal {{Converti}}, più quelli definiti in Modulo:Val/units (questo ha la precedenza in in caso di simboli duplicati).

Prefissi e suffissi al valore

modifica

A volte un numero e un codice unità non sono sufficienti. Sono disponibili due parametri per aggiungere un prefisso o un suffisso, Template:Param e Template:Param.

  • {{M|7600|u=C&sdot;Ga|p=>|s=<}}7 600 
  • {{M|7600|u=C|p=<span style="color:green"><sup>|s=</sup></span>}}7 600 

Sintassi

modifica

Il primo parametro del template deve essere sempre un numero. Il secondo può essere un numero (nel qual caso rappresenta un'incertezza simmetrica), oppure uno dei simboli di intervallo riconosciuti che unisce il primo e il terzo valore.

primo parametro Il primo valore scritto in cifre, senza separatori delle migliaia e con il punto o la virgola come separatore decimale (es. 123456.78 o 123456,78);

Sono accettati anche numeri già formattati a mano, suddivisi da uno spazio ordinario: 299 792 458...;

  • {{M|1234567.1234567}}1 234 567,1234567 
  • {{M|.1234}},1234                     (aggiunge lo zero)
  • {{M|+1234}}1 234                      (visualizza il più)
  • {{M|-1234}}−1 234                      (rimpiazza il trattino-meno con un segno meno)
  • {{M|12e34}}120 000 000 000 000 000 000 000 000 000 000 000                 (notazione normalizzata)
Template:Param Di default i numeri sono formattati con uno spazio che separa ogni gruppi di tre cifre, sia nella parte intera, che frazionale.

Comunque numeri di quattro cifre non sono formattate con spazi, per forzare il comportamento usate il parametro Template:Param.
Usate Template:Param per delimitare la parte intera del numero con punti.
Usate Template:Param per non effettuare alcuna formattazione (niente spazi o punti).
{{M|1234567.1234567}}1 234 567,1234567 
{{M|1234567.1234567|fmt=commas}}1 234 567,1234567 
{{M|1234}}1 234 
{{M|1234|fmt=gaps}}1 234 
{{M|1234.5}}1 234,5 
{{M|1234.5|fmt=none}}1 234,5 

Template:Param Aggiunge qualcosa al termine del primo numero (prima di ogni altra cosa che potrebbe seguire).

{{M|11|end=<END>}}11 
{{M|11|22|end=<END>}}11 
{{M|1111|(22)|end=<END>}}1 111 
{{M|11|22|33|end=<END>}}11 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|11|ul=m/s|end=<END>}}11 

secondo parametro non nominato L'incertezza di misura in uno di due formati.

{{M|11|22|u=m/s}}11 
{{M|11|(22)|u=ms}}11 
Un simbolo di congiunzione per unire due numeri, utile per intervalli, formattare grammaticalmente il risultato, ecc..
{{M|11|-|33|u=m/s}}11 

Attenzione! Unità di misura non valida.


{{M|11|–|33|u=m/s}}11 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|11|,|33|u=m/s}}11 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|11|by|33|e=9|u=m/s}}11 × 109 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|11|and|33|u=m/s|end=$}}11 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|11|or|33|u=m/s}}11 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|11|to|33|u=m/s}}11 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|11|x|33|u=m/s}}11 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|11|×|33|u=m/s}}11 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|11|/|33|u=m/s}}11 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


terzo parametro non nominato Incertezza asimmetrica

{{M|11|22|33}}11 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.

Template:Param o Template:Param e Template:Param Aggiunge qualcosa dopo l'incertezza di misura.

{{M|11|22|errend=<Errend>}}11 
{{M|11|22|33|+errend=<+Errend>|-errend=<−Errend>}}11 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.

Template:Param o Template:Param Il codice unità della misura. Il template inserisce uno spazio dopo il valore e l'unità di misura.

Template:Param L'unità di misura è collegata alla sua voce.
Template:Param L'unità di misura non è collegata alla sua voce (in questo caso può contenere markup wiki).
{{M|11|ul=m}}11 

Template:Param o Template:Param Un codice unità, ma invece di uno spazio Val aggiunte una barra prima dell'unità di misura. Serve per inserire un'unità di misura a denominatore, per formare un rapporto.

Template:Param L'unità di misura è collegata alla sua voce.
Template:Param L'unità di misura non è collegata alla sua voce (in questo caso può contenere markup wiki).
The ratio can be of two unit codes, or a prefix and a unit code. Val will add parentheses to disambiguate, if a unit code has a dot or a slash.
{{M|11|ul=J/C|upl=F/m}}11 
{{M|11|upl=acre|p=$}}11 
{{M|11|ul=km/s|upl=Mpc}}11 
{{M|11|ul=kg.m|upl=s-2}}11 

Template:Param Aggiunge un prefisso all'espressione generata dal templatae. Accetta markup wiki. Se si vuole aggiungere uno spazio prima del prefiss iniziare con &amp;.

{{M|11|22|ul=m/s|p=<Prefix>}}11 
{{M|11|22|ul=m/s|p=<Prefix>&nbsp;}}11 

Template:Param Aggiunge un sufisso all'espressione generata dal templatae. Accetta markup wiki. Se si vuole aggiungere uno spazio prima del prefiss iniziare con &amp;

{{M|11|22|ul=m/s|s=<Suffix>}}11 
{{M|11|22|ul=m/s|s=&nbsp;<Suffix>}}11 

Template:Param Esponente. In alternativa l'esponente può essere inserito direttamente in coda al numero precedtuto da "e" (vedi "primo parametro non nominato" sopra).

{{M|11|22|33|e=11}}11 × 1011 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|11e11|22|33}}1 100 000 000 000 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.

Template:Param Di solito un'unità è espressa nella scala corta e un billione significa Template:Val. Ma alcune unità hanno una versione lunga, vedi scala lunga e scala corta. Il parametro Template:Param assegna all'unità la scala lunga. Il codice dell'unità cambierà e sarà ordinato diversamente nelle tabelle.
Template:Param Impedisce che pagine con errori siano aggiunte alla categoria Errori di compilazione del template M. da usare per pagine di documentazione e test che non devono essere corretti.

La validità degli argomenti viene controllata e gli errori sono segnalati in evidenza. Le pagine che contegono errori sono inseriti nella categoria Errori di compilazione del template M, salvo che non venga usato il Template:Param.

Ordinamento

modifica

Il template genera una chiave di ordinamento che tiene conto dell'unità di misura, per cui, per esempio, Template:Val è considerato minore di Template:Val e maggiore di Template:Val. Ovviamente il confronto tra unità di misura non compatibili (pesi con lunghezze avrà risultati non prevedibili). La chiave di ordinamento per ogni unità ordinabile è visibile a Template:Val/list.

Questo è un esempio di una tabella ordinabile, con unità di misura differenti:

{| class="sortable"
! Val sort test
|-
| {{val|3|ul=  Mm    }}
|-
| {{val|4e6|u=  m    }}
|-
| {{val|1|u=   km    }}
|-
| {{val|5e3|u=  m    }}
|-
| {{val|2|u=    m    }}
|}
Clicca per ordinare ↓
Test di ordinamento
Template:Val
Template:Val
Template:Val
Template:Val
Template:Val

La chiave di ordinamento viene generata con la seguente logica.

  1. Il valore numerico è il punto di partenza.
  2. Viene applicato l'ordine di magnitudine del prefisso SI, se l'unità ne ha uno
  3. Il valore dell'unità dal suo proprio sistema di unità viene applicato
  4. Se l'unità è composta ogni subunità viene moltiplicata o divisa per la sua dimensione.
  5. Al risultato viene applicata una formula di normalizzazione
  6. Il risultato viene aggiunto all'attributo di ordinamento delle tabelle.

Altri esempi di espressione

modifica

{{M|1234567.1234567}}1 234 567,1234567 
.{{val|  1234567.1234567   }}. → .Template:Val.
{{M|.1234567|fmt=commas}},1234567 
{{M|+1234567|fmt=commas}}1 234 567 
{{M|-1234567}}−1 234 567 

Incertezza

modifica

{{M|1.234|0.005}}1,234 
{{M|1.234|0.005|e=3}}1,234 × 103 
{{M|1.234|+0.005|-0.006}}1,234 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|1.234|(5)}}1,234 

{{M|1.234|u=m}}1,234 
{{M|1.234|u=m2}}1,234 
{{M|1.234|ul=m}}1,234 
{{M|123.4|ul=USgal}}123,4 
{{M|12.34|ul=mpgimp}}12,34 

{{M|12.34|u=deg}}12,34 
{{M|1.234|0.005|u='}}1,234 
{{M|1.234|+0.005|-0.006|u="}}1,234 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|1.234|u=%}}1,234 
{{M|1.234|end=&nbsp;[[m/s]]}}1,234 

{{M|12.34|u=degC}}12,34 
{{M|12.34|u=K}}12,34 

Esponenti

modifica

{{M|1.234e5|ul=m}}123 400 
{{M|1.234|e=5|ul=m}}1,234 × 105 

{{M|1.234e7|0.056}}12 340 000 
{{M|1.234|0.056|e=7}}1,234 × 107 

{{M|1.23456e-9|+0.00007|-0.00008|ul=m/s}}

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.


{{M|1.23456|+0.00007|-0.00008|e=-9|ul=m/s}}1,23456 × 10-9 

Attenzione! Prefisso non valido.



Attenzione! Unità di misura non valida.

{{M|1.234e7|0.056|ul=psi}}12 340 000 
{{M|1.234|0.056|e=7|ul=psi}}1,234 × 107 

{{M|1.234e-2|(5)}}0,012 
{{M|1.234|(5)|e=-2}}1,234 × 10-2 

Prefissi/suffissi

modifica

{{M|12.34|p=Δ&nbsp;}}12,34 
{{M|12.34|u=%|p=≅}}12,34 
{{M|12.34|0.25|s=%}}12,34 

Numeratore/denominatore

modifica

{{M|1.234|e=7|ul=W|up=m2}}1,234 × 107 

Cifre ripetute

modifica

{{val|1.2|end={{overline|34}}|e=7|ul=W|up=m2}}Template:Val


Template correlati

modifica