Template:SI light units: Difference between revisions
moving general note about symbols in column to the top |
Rv. The "J" has been too big a source of confusion for readers. See talk page. |
||
| Line 12: | Line 12: | ||
! <small>Name</small> |
! <small>Name</small> |
||
! <small>Symbol</small> |
! <small>Symbol</small> |
||
! <small>Symbol</small> |
|||
| ⚫ | |||
|- |
|- |
||
| [[Luminous energy]] |
| [[Luminous energy]] |
||
| Line 18: | Line 18: | ||
| [[lumen second]] |
| [[lumen second]] |
||
| [[lumen (unit)|lm]]⋅s |
| [[lumen (unit)|lm]]⋅s |
||
| ⚫ | | '''T'''⋅'''J''' {{#tag:ref|"'''J'''" here is the symbol for the [[Dimension of a physical quantity|dimension]] of luminous intensity, not the symbol for the [[Units of measurement|unit]] joule.|group={{#if:{{{3|}}}|{{{3}}}|nb}}|name=note-dimension-J}}<!-- [[http://www.bipm.org/utils/common/pdf/si_brochure_8.pdf]] [[http://www.ptb.de/cms/fileadmin/internet/publikationen/DasInternationaleEinheitensystem.pdf]] --> |
||
| '''T'''⋅'''J''' |
|||
| The lumen second is sometimes called the ''talbot''. |
| The lumen second is sometimes called the ''talbot''. |
||
|- |
|- |
||
| Line 25: | Line 25: | ||
| [[lumen (unit)|lumen]] (= cd⋅[[steradian|sr]]) |
| [[lumen (unit)|lumen]] (= cd⋅[[steradian|sr]]) |
||
| lm |
| lm |
||
| '''J''' {{#tag:ref||group={{#if:{{{3|}}}|{{{3}}}|nb}}|name=note-dimension-J}} |
|||
| '''J''' |
|||
| Luminous energy per unit time |
| Luminous energy per unit time |
||
|- |
|- |
||
| Line 32: | Line 32: | ||
| [[candela]] (= lm/sr) |
| [[candela]] (= lm/sr) |
||
| [[candela|cd]] |
| [[candela|cd]] |
||
| '''J''' {{#tag:ref||group={{#if:{{{3|}}}|{{{3}}}|nb}}|name=note-dimension-J}} |
|||
| '''J''' |
|||
| Luminous flux per unit [[solid angle]] |
| Luminous flux per unit [[solid angle]] |
||
|- |
|- |
||
Revision as of 07:10, 15 December 2017
| Quantity | Unit | Dimension | Notes | |||||
|---|---|---|---|---|---|---|---|---|
| Name | Symbol[nb 1] | Name | Symbol | Symbol | ||||
| Luminous energy | Qv [nb 2] | lumen second | lm⋅s | T⋅J [nb 3] | The lumen second is sometimes called the talbot. | |||
| Luminous flux / luminous power | Φv [nb 2] | lumen (= cd⋅sr) | lm | J [nb 3] | Luminous energy per unit time | |||
| Luminous intensity | Iv | candela (= lm/sr) | cd | J [nb 3] | Luminous flux per unit solid angle | |||
| Luminance | Lv | candela per square metre | cd/m2 | L−2⋅J | Luminous flux per unit solid angle per unit projected source area. The candela per square metre is sometimes called the nit. | |||
| Illuminance | Ev | lux (= lm/m2) | lx | L−2⋅J | Luminous flux incident on a surface | |||
| Luminous exitance / luminous emittance | Mv | lux | lx | L−2⋅J | Luminous flux emitted from a surface | |||
| Luminous exposure | Hv | lux second | lx⋅s | L−2⋅T⋅J | Time-integrated illuminance | |||
| Luminous energy density | ωv | lumen second per cubic metre | lm⋅s⋅m−3 | L−3⋅T⋅J | ||||
| Luminous efficacy | η [nb 2] | lumen per watt | lm/W | M−1⋅L−2⋅T3⋅J | Ratio of luminous flux to radiant flux or power consumption, depending on context | |||
| Luminous efficiency / luminous coefficient | V | 1 | Luminous efficacy normalized by the maximum possible efficacy | |||||
| See also: SI · Photometry · Radiometry | ||||||||
- ^ Standards organizations recommend that photometric quantities be denoted with a suffix "v" (for "visual") to avoid confusion with radiometric or photon quantities. For example: USA Standard Letter Symbols for Illuminating Engineering USAS Z7.1-1967, Y10.18-1967
- ^ a b c Alternative symbols sometimes seen: W for luminous energy, P or F for luminous flux, and ρ or K for luminous efficacy.
- ^ a b c "J" here is the symbol for the dimension of luminous intensity, not the symbol for the unit joule.
Usage
This template displays a table of SI photometry units for usage in articles about photometry. It may also serve as a navigation box at the end of corresponding articles.
The template supports three optional parameters to finetune its behaviour.
Parameters
Documentation of parameters:
Parameter 1
1 = undefined or empty
The template will not display the string "Table X. " in front of the table's title "SI photometry units".
1 = <number>
The template will display the table number as part of the table header in the following form: "Table <number>. SI photometry units.", where <number> is a placeholder for the number (or other table designation) given as parameter.
Parameter 2
2 = undefined or empty
The template will not show a "(Compare)" link in the table footer.
2 = "self"
The template will display a "(Compare) link in the table footer to jump to the corresponding radiometry table within the same article for quick comparisons. In order for this to work, the radiometry table must be included using the template {{SI radiometry units}} as well. It is not necessary to reload the article for comparison.
2 = any non-empty string other than "self"
The template will display a "(Compare)" link (as above). However, the link will point to the corresponding radiometry table in the separate article on "Radiometry", not to within the article, where the {{SI light units}} template has been included. This is useful, if the other table should not be included in the article.
Parameter 3
3 = undefined
The table's footnotes will be grouped in a reference group named "nb" and displayed immediately after the table. In order to avoid conflicts with other references in the article, it is advisable to use other group names for external references (default is ""). Otherwise, these external references would be listed after the table as well.
3 = empty, that is: ""
The table's footnotes will be grouped in the article's default group "", as used for all other references without specific group names. It is important to manually include a <references/> tag or the {{Reflist}} template somewhere in the article. This is the place where the footnotes will show up.
3 = <groupname>
The table's footnotes will be grouped in a reference group named as specified in the groupname. It is important to manually include a <references group="<groupname>"/> tag or the {{Reflist|group=<groupname>}} template somewhere in the article. This is the place where the footnotes will show up. Try to use a short groupname, as the table will look nicer this way.
Examples
Some easy examples:
{{SI light units}}
{{SI light units|1}}
{{SI light units|1|compare}}
{{SI light units||compare}}
{{SI light units|1|compare|""}}
{{SI light units|1||""}}
{{SI light units||compare|""}}
{{SI light units|1|compare|Note}}
{{SI light units|||notes}}
{{SI light units||compare|Note}}
Combining both tables in a single article (individually grouped footnotes in group "nb"):
{{SI light units|1|self}}
{{SI radiometry units|2|self}}
Combining both tables in a single article (individual footnotes in separately named groups, for example "T1" and "T2"):
{{SI light units|1|self|T1}}
{{Reflist|group=T1}}
{{SI radiometry units|2|self|T2}}
{{Reflist|group=T2}}
Combining both tables in a single article (combined footnotes, for example in group "nb"):
{{SI light units|1|self|nb}}
{{SI radiometry units|2|self|nb}}
...
{{Reflist|group=nb}}
Combining both tables in a single article (combined footnotes with default references):
{{SI light units|1|self|""}}
{{SI radiometry units|2|self|""}}
...
{{Reflist}}
Notes
Ideally, the "(Compare)" link would show up to the left or right of the table header, similar to the "v d e" links. Thereby, the cursor would remain in the same position and one could flip back and forth between the two tables without any necessary window realignment. However, this would require a small change in the {{Tnavbar-header}} template.
See also