Template:Earthquake magnitude/doc


 * For the "small letter m with dot below" please copy-and-paste: ṃ

Given a valid code (see table), outputs an earthquake magnitude scale label, either the generic, or a subtype (such as or ), conformable with the labels most commonly used by the major seismological authorities. The article is automatically added to a tracking category. Optionally adds a value or relation, identifies a source, or links to explanatory text at Seismic magnitude scales.

Usage
The full name serves to better identify this template's purpose. For most practical purposes, the shortcut M is used as described below.



A valid code is required (see table), other parameters are optional.

Examples
Label only:

With a value or range:

Label wikilinked to explanatory text (useful for first mention):

To show that a magnitude is from a particular catalog or source use src:
 * (Note: this is not suitable for purposes of WP:Verification.)
 * (Note: this is not suitable for purposes of WP:Verification.)

There are multiple magnitude scales. To maintain accuracy and avoid error please use the proper code (see below). If you are uncertain use the special maintenance code "?", which flags this instance for further attention:

Typical use in article text, with in-line citation:
 * The 1964 Alaska earthquake, magnitude &lt;ref>.&lt;/ref> ....

The special code "magnitude" produces a suitable wikilink for generic use:
 * A 7 earthquake ....

The special codes "M" and "mag" produce a suitably wikilinked caption for use in tables:

The standard symbol for seismic moment can be produced as straight text, or as a math variable (applies CSS 'texhtml' styling using mvar):

just because a newspaper or other popular media says "Richter". That is usually incorrect. Earthquake magnitudes reported by the U.S. Geological Survey (USGS) and other seismological authorities now generally use the moment magnitude scale for magnitudes greater than 4.0. While most newspapers and other popular media refer to this as the "Richter" magnitude, that is not correct. Richter's original scale, explicitly denoted with the symbol "ML" or "ML" (where "L" indicates "Local"), was developed for measuring the magnitude of earthquakes in the vicinity of southern California. While the "Richter" and moment magnitude scales are similar, they do differ, particularly for earthquakes stronger than about M 6.5, or deeper than about 50 km.

In general: where any source specifies magnitude on a scale other than "Richter", or uses "M" (or "m") with one or more other letters (such as ML, Mw, Ms, or mb), that can be relied on; use the table below to match the label and determine the proper code.

Where a newspaper or other popular media refers to the scale or magnitude of a recent earthquake as "Richter" it is probably the popular mis-identification of the moment magnitude scale. Best practice is to check with an authoritative source, such as the USGS or the International Seismic Centre (see below). USGS policy is that magnitudes in press releases, indicated as "M" without any additional characters, are implicitly moment magnitude. But: do not use the "w" code if the source does not actually say "Mw" or "moment magnitude scale". If you have a strong basis for believing moment magnitude is meant – e.g., because it is a USGS press release – use the "dot" code to indicate an implicit Mw. E.g.: → ; →.

If you are not sure of the scale, use. See below on how to find authoritative magnitudes.

Data sources
It is preferable that earthquake magnitudes always be obtained from authoritative sources, such as the following.


 * The ANSS (Advanced National Seismic System) Composite Catalog, commonly known as "ComCat" is a near-realtime repository of earthquake information from the USGS (United States Geological Survey) and various regional data centers, with additional data from seismic networks around the world. Event pages for significant events generally have an executive summary, a tectonic overview, past earthquake history of that area, ShakeMaps, and other material.  ComCat can be accessed in several ways:


 * Latest Earthquakes. In most cases there is an initial report within 10 to 30 minutes of all magnitude 5.0+ earthquakes globally, and magnitude 4.0+ earthquakes within the contiguous U.S. Note that the magnitudes and locations in the initial reports are only first-order approximations, which get revised in the following hours, days, and months.


 * Significant Earthquakes archive: a chronological listing of events since 1900.


 * Interactive search.


 * All of these access methods link to event pages in the ANSS Comprehensive Catalog (ComCat), which can be cited using short-anss and cite_anss.


 * The ISC (International Seismological Centre) is the final and authoritative archive of global earthquake data. Services include:
 * The On-Line Bulletin (IRIS mirror) incorporates several catalogs (databases). There are catalog-specific search functions for finding events constrained by date period, magnitude range, or region (by latitude and longitude, or Flinn-Engdahl regions). Data may be revised years later as more data is obtained or processes refined. This is the most complete, most authoritative, and preferred source for earthquake magnitudes and epicenters.
 * Event Bibliography (IRIS mirror) of scientific articles for notable events, indexed chronologically. (Useful for finding ISC event id.)
 * The ISC-GEM Global Instrumental Earthquake Catalogue: Definitive magnitudes for selected earthquakes since 1900. (Source id: GEM.)


 * Data from the ISC can cited using short-isc and cite isc.

Earthquake magnitudes are given on different scales because they measure different aspects of the event, or are measured in different ways. It is valid to list multiple magnitudes for an event (not to be confused with multiple events such as foreshocks, aftershocks, and doublet earthquakes). Estimates of magnitude may differ between networks and across time because of differences or changes in how the seismograms are read and the data processed. For details see the NMSOP-2 documentation (below).

Table of codes
These are the most commonly found scales of earthquake magnitude. Any scale not found in this table is mostly likely one of the following:
 * An intensity scale. See Seismic intensity scales for explanation. This template does not cover intensity scales.
 * A regional (or "local") scale used by some particular seismic network (or country). In general it is preferable to use one of the better known scales from the table. Exceptions are for historical reports; you will need to explicitly format as appropriate. If the scale has been properly calibrated (see MNSOP-2, Chapter 3, §3.2.4.3, p. 65) then "L" may be appropriate, along with the src parameter.
 * A technical scale. While these might come up in an article related to seismology, they are not appropriate for general description of earthquakes. If needed, please format appropriately. On first use be sure to add a footnote explaining the scale.

Be careful to distinguish upper- and lower-case "M/m", "B/b", "L/ l ", and " I/i ". Other than that case is generally not significant, nor italicization or subscripting.

The examples in the table are representative, even comprehensive, but not complete.

Examples of use are from the International Association of Earth Physics and Interior (IASPEI), the first edition of the New Manual of Seismological Practice (NMSOP)(the second edition follows the IASPEI), the United States Geological Survey (USGS) National Earthquake Information Center (NEIC), the International Seismological Centre (ISC), and the Bulletin of the Seismological Society of America (BSSA), as summarized in table 3 of the IASPEI/MNSOP-2 Information Sheet 3.3. Additional magnitude scales from Chapter 3 of MNSOP-2, ISC documentation, the USGS, and a review of the literature. Section numbers under "Comments" are for either Chapter 3, or Information Sheet 3.3

Principal references on usage are:



These sources also have extensive discussion and references on the derivation and comparison of the various scales.

The nomenclature style implemented here is adapted from IASPEI/MNSOP-2 Information Sheet 3.3. This style differs from IASPEI style mainly in using subscripts rather than underscores, and from BSSA style mainly in not using parentheses. "Cat.": the Categories for tracking use of these various scales. "#" is the number of articles in that category.