Testwiki:MOSPHYS

From testwiki
Jump to navigation Jump to search

Template:Dormant

Rename this page to WP:Manual of Style/Physics when complete and universally agreed on by wikiproject physics.

This part of Wikipedia's Manual of Style contains guidelines for consistency of style in writing and editing articles on physics as well as physics-related parts of other articles. For consistency with the rest of Wikipedia, other manuals of style (in particular WP:MOSMATH for mathematics and WP:MOSCHEM for chemistry) apply when possible. Exceptions and additional conventions specific to physics topics are described here.

Typesetting of formulae

Template:See also

LaTeX versus HTML

There are a number of different techniques to produce mathematical formulae on Wikipedia, all with their advantages and disadvantages. Inevitably, this has led to a wide spectrum of preferences among editors and of styles used in articles. Even worse, there is a perpetual change of formatting by editors who don't like the current style of an article.

The main technical options are:

The main principles to be considered when deciding about a particular formatting are consistency and consensus. Don't set one formula in a style very different from the rest of the article, and don't do mass changes from one style to another without prior discussion on the talk page. That said, the style recommended for physics articles is as a rule of thumb:

  • use wiki markup or the Template:Tl template for inline formulae,
  • use <math>...</math> for displayed formulae.

This choice is aiming at a smooth integration of simple inline formulae in the surrounding text, while offering the extended possibilities of LaTeX formatting for more involved displayed formulae.

Roman versus italic

One of the most basic, though often ignored typesetting conventions for mathematical formulae concerns the use of upright (roman) versus italic typeface: as a general rule,

  • variables (including indices and physical quantities) should be set italic, while
  • names (including abbreviations, names of particles, chemical elements and units of measurement) should be set in roman type.

This rule explicitly applies also to subscripts and superscripts. Paying attention to this seemingly minor detail helps to immediately make clear the meaning of a particular notation, and should not be seen as nitpicking. The rule has a few notable exceptions, which will be explained below.

Greek letters

The Greek alphabet is extensively used throughout physics and mathematics. Due to technical limitations, the <math>...</math> environment always typesets lower case Greek letters in italic, and upper case ones in roman type. For consistency within an article, Greek letters produced using HTML or Template:Tl should thus follow the same convention. This practice applies to both normal and bold font weight.

Lower case Greek letters that denote names of particles, and that don't appear in the same article within a <math> environment, should be set in roman type, following the general style for names.

Some Greek letters have a second, variant form, for example User:Hhhippo/sxt vs. User:Hhhippo/sxt, User:Hhhippo/sxt vs. User:Hhhippo/sxt, or User:Hhhippo/sxt vs. User:Hhhippo/sxt. If they are used, the same symbol should be used for the same quantity consistently throughout the article. (There is also a variant for the lowercase l in the Latin alphabet, User:Hhhippo/sxt, which can be useful for the distinction from an upper case I.)

Units and quantities

Quantities whose values are not given numerically, including both variables and physical constants, are denoted in a way similar to variables in mathematics. Examples are

One must carefully distinguish quantities, units, and dimensions, because different typographies apply to them. For example:

  • Voltage is a quantity and may be denoted as Template:Mvar, an italic capital letter "V".
  • The volt is a unit and must be denoted as V, a roman capital letter. Brackets [] mean the units of, so [V] = V, and braces {} mean the numerical value of so V = {V}[V].
  • The dimension of voltage should be written in terms of the base dimensions in roman sans-serif type:[1] ML2T−3I−1.

When a physical constant serves as a unit in some systems, such as in with atomic units, it should be denoted as a constant (in italics). In particular, the elementary charge, even when treated as a unit, is denoted Template:Math, notwithstanding that it was originally a unit (named the electron, with symbol Template:Math) (see Template:Section link). These symbols are also never prefixed with SI prefixes. Related units that are denoted in roman type include

Generally, all symbols (abbreviations) of units are universally roman (upright). For dimensions, an exception occurs when denoting the dimension of an arbitrary quantity is necessary, as in "[quantity]"; see continuity equation for an example of this case. Representation of units and numerical quantities (where a numerical value and a unit are specified explicitly) should comply with Template:Section link unless the present Manual specifies otherwise. See also: Template:Tl.

The roman versus italic guideline applies to units. For example, write

Template:Xt,

but not

Template:!xt.

Common mathematical formulae

Examples:

Representation of Common mathematical formulae (arithmetic, algebra (including vectors and tensors), summation, integration, differentiation, differential geometry, complex analysis ...) should comply with Template:Section link unless the present Manual specifies otherwise. Notations that are popular in a certain context should be used; unusual or otherwise less common notation (for physics) should be avoided.

Functions

Exponential functions are very common in physics, representing growth and decay from solutions of differential equations, complex number representations, and group generators. As such they can have quite large/complicated variables.

  • For simple arguments on one line, the e notation is legitimate
    ei2πx/λ,eiωt
in which case fractions should use the forward slash /, not \frac{}{}.
Template:Xt
however using the forward slash for division as above is acceptable, although extra brackets are usually needed,
Template:!xt
whereas fractions using the horizontal stroke are not:
Template:!xt

Vectors and vector spaces

Subscripts and superscripts

Subscripts and superscripts follow the general rule about roman versus italic typeface. For example:

User:Hhhippo/sxt,   User:Hhhippo/sxt,  User:Hhhippo/sxt,

rather than

User:Hhhippo/!sxt,   User:Hhhippo/!sxt,   User:Hhhippo/!sxt.

Note that in the last example, "ext" is a text label (an abbreviation for "external") and is thus set roman, while x0 is a variable and is this set in italic. This type of notation is sometimes used instead of Template:Nowrap to indicate that only the functional dependence of B on t is of interest, while x0 is a parameter held fixed (though conceptually still a variable).

An exception can be made when the <math> tag has to be used, and an intended glyph is not available in its renderers, such as non-italicized Greek letters. For example, when typesetting the mass of a neutrino ν (nu) in html or Template:Tl, the ν can remain non-italic:

Template:Math,

while in <math>;

mν (with \mathrm applied to \nu)

looks no different than

mν (without the \mathrm)

and the latter may be used.

Index notation for tensors and spinors

Two ways to denote vectors, tensors, and spinors (also vector fields, tensor fields, and spinor fields) are:

  1. as the full entity with no reference to specific components (which uses the boldface notations above), or
  2. in components via index notation (cf. Ricci calculus and Van der Waerden notation), with or without reference to a basis.

Generally, the first is used in simpler contexts, while index notation is used to make advanced manipulations simpler. The linear operator notation is depreciated (with possible exception of theoretical mechanics and other domains where index notation is traditionally avoided).Template:Clarification needed

Ideally - not all Greek letters are used for indices. For example, ϕ and ψ are excluded due to its heavy usage as wave functions and fields, and η is used to denote the standard (Minkowskian) metric.
(although the letters Template:Mvar may cause confusion where complex numbers are used; this should be clarified in the context),
Template:Math or Ak.
Note that Template:Tl is equivalent to . Distinction of indices is especially helpful when one tensor quantity is built on several linear spaces of different natures.

Calculus

  • If "d" is used in differentials or derivatives, it should be italic or upright throughout; mixed styles look irregular.
  • In vector expressions for the gradient ∇, with respect to a given basis, the basis vectors should be in front of the derivative operators. In 3d Cartesian coordinates:
    Template:Xt
and not
Template:!xt
and similarly for any other coordinates. It is clear this way that the derivatives are operators not acting on the basis vectors (which can have spatial dependence in a local coordinate frame).
  • When using <math>, use either (\nabla) or (\bigtriangledown ) throughout - it looks irregular to mix the styles.
  • The capital delta symbol is universally reserved for changes in quantities, for example Δx for change in position coordinate x.
  • The same symbol Δ is also used in mathematics to denote the Laplacian operator. Where possible, please use the "nabla squared" symbol ∇2, which appears to be more common in physics, and is more intuitive; ∇2 = ∇ ⋅ ∇ is a nicer notation, and less ambiguous for capital delta.
  • The symbol Template:Math is used for the four gradient operator (indexed components), as usual. There are other notations, including
  • The symbol is used for the D'Alembertian operator. There are other notations, including
    • 2, to parallel the Laplacian ∇2. The notation without the square is already known to denote the D'Alembertian. Either can be used (?)
    • Template:Math or Template:Math (very rare), which should be reserved for some covariant derivative (?)
Setting Not recommended Recommended
Laplacian operator Template:Math Template:Math
Four gradient Template:Math, etc. Template:Math
D'Alembertian operator Template:Math 2 etc. ,αα
  • For integrals, either of the notations are employed in the literature:
    Template:Math or f(x)dx,dxf(x)
and either is acceptable in WP physics articles.
  • For Template:Tl, integral symbols can be produced using the same syntax as for LaTeX using the Template:Tl template.
  • For integrations over the boundary of a (hyper)volume V, the partial symbol Template:Math denoting the boundary of a closed volume is encouraged (including a brief explanation such as "where Template:Math is the boundary of the volume V"); it is a powerful and compact notation:
    Template:Math or Vψ(𝐱)dV
and removes the need to use another symbol for the boundary of the volume.
which really means:
Template:Xt
The brackets are often dropped by sources since it is known the integral symbol always includes the differentials (in the above example "Template:Math" and "Template:Math"). Nevertheless: for the sake of clarity an extra pair of brackets will not clutter, and should be included.

Ratios of differential (infinitesimal) quantities and derivatives

Template:See also In physics, ratios of differential (infinitesimal) quantities frequently occur, and share the same notation with first order derivatives, which also frequently occur. For example, the local charge density of an electrically charged continuum is given by the ratio of the infinitesimal charge Template:Math in infinitesimal volume Template:Math:

ρ=dqdV

However, this looks like a derivative of Template:Math with respect to Template:Math. In cases like this, notations can be misleading, as

So these are not exactly the same, differentials are more general. Following are the recommended applications of the notation.

Operations Notation Usage in the literature
Division of infinitesimal quantities Template:Math and Template:Math Template:Math Ratios or derivatives
Derivative of Template:Math as a function of Template:Math Template:Math Used only for derivatives, not ratios as above. Advantages include:
  • makes clear that differentiation is an operator,
  • clarifies notation for higher derivatives by repeated action of a derivative,
    Template:Math

For partial derivatives this is not a problem, since differentials are never written as "Template:Math"; only the full symbol of a partial derivative, in any of the equivalent notations;

Template:Math

has meaning.

Particles, substances and reactions

  • Symbols for subatomic particles and nuclei can be generated with Template:Tl and Nuclide templates, otherwise they should be typographically similar.
  • Where chemical notation is used, it should comply with WP:MOSCHEM.
  • Formulae of (nuclear or particle) reactions should not be formatted with <math> or Template:Tl. Use templates, wiki code formatting, and HTML tags to match the main text, both for inline and displayed formulae.
  • For all reactions, the arrow symbol User:Hhhippo/sxt should be used, the equals sign User:Hhhippo/!sxt is usually wrong.

Examples:

and as particle reaction:
n0p+ + Template:Subatomic particle + Template:Subatomic particle

The roman versus italic guideline applies to substances:

Template:Xt

rather than

Template:!xt

Sets and spaces

Number sets

Where needed, standard number sets should be set in blackboard bold, not just bold face:

Lie groups

Symbols for Lie groups shall be Roman, not italic:

Other

Prerequisite knowledge

An article can usually not give a detailed explanation of all concepts and nomenclatures used to explain its topic. Some basic knowledge of physics and mathematics will generally be required of the reader, to an extent depending on the article's subject. However, where appropriate, links to more introductory articles and summary style descriptions of the essential concepts should be provided.

Physics

A large number of physical theories exist, and compatibility between them varies. Concepts as distance, time and mass appear to be universal, although their exact definitions can depend on the subject. Unless an article deals explicitly with these fundamental concepts, it should not explain the meaning of distance, time or mass.

Expected units

The following everyday units are presumed to be known and needn't be explained, although ideally linked at least once.

Physical quantity SI unit Decimal SI prefixes Common non-SI unit
length metre (m) centimetre (cm)
time second (s) minute (min), hour (h),
mass kilogram (kg) gram (g)

Other well-known derived quantities include (and these should ideally be linked):

Physical quantity SI unit Decimal SI prefixes Common non-SI unit
energy J eV
velocity ms−1
momentum Ns or kgms−1
force N or kgm2s−2
pressure Pa or Nm−2
etc.

Old non-SI units (such as "erg", "dyne", "knots" etc.), and imperial units, ideally should only to be used for:

  • historical relevance,
  • within context relevant to those main articles,
  • if references (databooks, handbooks, appendices of books etc.) present measurements in terms of those units.

In general, SI units are usually assumed by most people. When using other unit systems which are extensively employed in practice although may be unfamiliar to laymen, including:

it should be explicitly stated they are going to be used before using them. There are several sets of natural units, each with their own applications, so which one must be clear. Ideally, natural units shouldn't be used, due to lack of familiarity and potential confusion by many readers. For example: giving masses of elementary particles in MeV when the reader thinks of kg (or decimal prefixes thereof) is confusing, a related point is that writing "Template:Math", without referring to natural units, is confusing when the reader expects the Template:Math factor...

Template:Quotation

Clarifying the relevant physics

Physics is such an enormous subject that an article should specify the relevant branch(es) of it, unless the concept is physically universal. Known academic paradigms, with usual abbreviations, are:

The lead of an article should specify the one of these, for example (see the wavefunction article) anything like:

and not simply:

Template:!xt

Mathematics

No abstract notations

Any abstract notation which requires additional irrelevant explanation (i.e. set builder notation, symbolic logic notations, especially quantifier notation, others?), are not to replace worded descriptions for the sake of compact mathematical statements - they simply create more work in explaining and linking the notations, while contributing no understanding to the physics at hand.

To exemplify:

  • Even if the context becomes abstract, statements like
    Template:!xt
are too long, cluttered, and confusing for non-expert mathematicians: simply write
Template:Xt
since this way explains the context without introducing unfamiliar notations.
which makes it very clear to anyone that Template:Math takes those values and the sequence of numbers is infinite. Even though the full set builder notation:
Template:!xt etc.
is technically more correct, this is actually less clearer to a typical reader, since the symbols have to be explained by editors and/or read up by readers.
may be compact, but is pointless since the notation has to be explained (constituting no thermodynamics). The law can be stated in words:
Template:Xt

Levels of difficulty

The tables below (mainly of numbers, operations, and functions required to build formulae) are roughly grouped into three levels of difficulty; school/(advanced) college level, then undergraduate level, finally graduate level (and beyond). Articles which fall into one (or between?) these sections should consider the reader to assume some familiarity within the scope of the section.

In all cases, the numbers, operations etc.:

  • should be linked to the main articles
  • not require any in-depth explanation (a few words or sentence at most).

Of course, other operations not tabulated can be used, provided their use is declared and linked. Most of the operations not tabulated below will be outside the scope of most of physics, such as some non-elementary functions like tetration, super-roots, and super-logarithms, and hence no prior knowledge of the reader is required.

Elementary level

The following are always presumed to be known:

When complex numbers are expected, particular examples including;

etc., then [[imaginary unit|Template:Math]] (or Template:Math) is presumed to be known too, although the context should state it is the imaginary unit and not something else, like a summation dummy variable or tensor indices.

Operation Notation Notes
Arithmetic and elementary algebra
Addition
Subtraction
Additive inverse
Template:Math
Template:Math
Template:Math
for scalars, vectors, operators, matrices
Multiplication
(Scalar, of a vector)
Template:Math
Template:Math
Template:Math are real numbers,
"vector" Template:Math means element of any linear space
Division Template:Math   or   ab Template:Mvar may be a scalar only
Multiplicative inverse Template:Math for scalars, matrices, operators
Absolute value Template:Math including complex numbers
Plus-minus sign Template:Math
Complex conjugate Template:Math complex scalars or 2-component spinors[3]
Square roots (and nth roots?) Template:Math either Template:Math (then Template:Sqrt ≥ 0),
or defined up to sign
Factorial Template:Math Only for integers.
Summation kak any linear space
only finite sums?
Product kak only finite products?
Elementary functions
Exponentiation Template:Math

(Due to conflict with tensor superscripts, make context clear this is exponentiation)

for scalar, matrix, operator Template:Mvar
for scalar Template:Mvar only(?)
either Template:Math or Template:Mvar must be integer
Natural logarithm Template:Math multivalued unless Template:Math
Trigonometric functions
All the primary ratios should be known;

Template:Math

The secondary are not essential (just reciprocals):

Template:Math

Hyperbolic functions All the primary functions should be known;

Template:Math

The secondary are not essential (just reciprocals):

Template:Math

Elementary calculus
Ordinary derivative (see notation above) Template:Math
Integrals (indefinite, definite, and improper) Template:Math
Basic linear algebra
Dot product Template:Math 3d Euclidean only, unless explained
Cross product Template:Math 3d Euclidean only, unless explained
Matrix multiplication Template:Math Including operations with column- and row vectors
Undergraduate level
Operation Notation Notes
Multivariable calculus
Partial derivatives, nabla Template:Math
Multiple integrals (including line, surface, and volume integrals) Template:Math
Advanced linear algebra
Exterior product Template:Math Euclidean only, unless explained
Tensor product Template:Math Euclidean only, unless explained
Tensor contraction Template:Math possibly by multiple indices; see above
Bra-ket notation Template:Math,   Template:Math,   Template:Math,   Template:Math see above
Linear operator composition Template:Math not always distinguished from matrix multiplication
Conjugate transpose
Hermitian adjoint
Template:Math over complex numbers only,

Usually denoted as Template:Math in pure mathematics.

Additionally:

Graduate level

Very advanced, abstract, and demanding topics, like;

Operation Notation Notes
Differential forms
Variational derivative, fractional derivative, covariant derivative
Functional integration, integration measures?
...

... exterior calculus on manifolds, analytic functions from operators, operator theory on Hilbert spaces, etc., will not be easily understood to the typical reader, and obviously never expected. Such topics need

  • to have enough explanation to make clear the relevance of the mathematics to physics (for instance, why a simpler formulation is not possible?),
  • to be thoroughly linked to the main subject articles containing the details.

Application of graphics and illustrations

Template:Main

Templates can be used for linking groups of articles, in the form of:

  • sidebars: boxes of links with collapsible sections, usually placed in the top right corner of an article, and
  • navboxes: boxes of links which are fully collapsible, usually placed at the very end of the article, even after the "see also", "references", and "external links" sections.

A decision at each article should be made for what kind of template of links to use. Sidebars are a matter of debate for their size and layout of links; some favour their use, others oppose or are neutral. Navboxes are usually less problematic due to their compactness.

  • Often, an article is well-served with a picture, diagram, or even an animation (see wavefunction for a good example), at the very top to provide an immediate visual depiction of what the article says.
    • An image directly corresponding to the specific topic of an article should have priority for putting in the top right corner over a sidebar template.
    • Placing an image in the center, while placing a template in the corner, creates large amounts of whitespace, and the table of contents only adds more whitespace. Both can be avoided by having the image floating in the top-right corner and the sidebar below, or replacing the sidebar with a navbox.
  • Some pages on abstract topics, where it's hard to find an image that's clearly associated with the article, (e.g. articles related to string theory), may benefit from an "icon" inside a sidebar. This can immediately inform the reader about the substance of the article, while including the links to related articles at the same, hence sidebars may be useful in cases like this.
  • Templates with a lot of links (say, 50 or more) are better as footers than as sidebars, since opening the sections of a sidebar makes it extend a long way down the page, and makes the box and article less readable this way.
  • It is legitimate to place navboxes in the "see also" or "references" sections if that's where the article ends. Placing navboxes in "see also" sections is beneficial as they display a large collection of related links in one place with minimum wikicode (only template syntax is needed).
  • If the contents of a template only has partial relevance to the article; they are likely to contribute to template creep, and hence should not be used.
  • If neither are suitable for any reason, the best resort is to just use the categories of the article.

Conventions in WP articles and sources

Aside from units, there are cases where specific choices of mathematical entities have to be made, notably the metric tensors in SR and GR, and the representations of the gamma matrices.

Sometimes, reliable and well-established sources use conventions which may lack a clear physical depiction, and WP editors should consider what the best conventions a physics article should have. Maxwell's equations in differential forms are an example (the 4-current is preferred as a 3-form, but sources (including Gravitation) use the 4-current as a 1-form, see the article Mathematical descriptions of the electromagnetic field for this).

Editors should:

See also

Footnotes

Template:Reflist

Further reading

Template:Refbegin

Template:Refend

  1. JCGM, International vocabulary of metrology – Basic and general concepts and associated terms (VIM)
  2. See, for example, Template:Citation
  3. In pure mathematics, for a complex vector Template:Math its conjugate Template:Math is an element of the complex conjugate vector space. Although the complex conjugate of a vector is used in physics (for example, in Template:Math), the notation with overline is discouraged except for aforementioned two cases.