Template:Infobox earthquake

Template documentationviewedithistorypurge

For presenting the key data of an earthquake in a consistent, standardized format.

Usage

{{{name}}}

{{{native_name}}}
[[File:{{{image}}}|{{{image_size}}}|alt={{{alt}}}|upright=1.15]] {{{caption}}}
[[File:{{{map}}}|{{{map_size}}}|alt={{{map_alt}}}|upright=1.15]] {{{map_caption}}}
[[File:{{{pushpin_mark}}}|8x8px|{{{pushpin_label}}}|link=|class=notpageimage noviewer]] {{{pushpin_label}}} {{{pushpin_caption}}}
UTC time	{{{timestamp}}} Needs 'yyyy-mm-dd hh:mm' A: {{{timestamp_A}}} B: {{{timestamp_B}}} C: {{{timestamp_C}}} D: {{{timestamp_D}}} E: {{{timestamp_E}}}
ISC event	A: B: C: D: E:
USGS-ANSS	ComCat A: ComCat B: ComCat C: ComCat D: ComCat E: ComCat
Local date	{{{local_date}}} A: {{{local_date_A}}} B: {{{local_date_B}}} C: {{{local_date_C}}} D: {{{local_date_D}}} E: {{{local_date_E}}}
Local time	{{{local_time}}} A: {{{local_time_A}}} B: {{{local_time_B}}} C: {{{local_time_C}}} D: {{{local_time_D}}} E: {{{local_time_E}}}
Duration	{{{duration}}}
Magnitude	{{{magnitude}}} A: {{{magnitude_A}}} B: {{{magnitude_B}}} C: {{{magnitude_C}}} D: {{{magnitude_D}}} E: {{{magnitude_E}}}
Depth	{{{depth}}} A: {{{depth_A}}} B: {{{depth_B}}} C: {{{depth_C}}} D: {{{depth_D}}} E: {{{depth_E}}}
Epicenter	0°N 0°E / 0; 0
Fault	{{{fault}}}
Type	{{{type}}}
Areas affected	{{{areas_affected}}}
Total damage	{{{damage}}}
Max. intensity	{{{max_intensity}}}
Peak acceleration	{{{pga}}}
Peak velocity	{{{pgv}}}
Tsunami	{{{tsunami}}}
Landslides	{{{landslide}}}
Foreshocks	{{{foreshocks}}}
Aftershocks	{{{aftershocks}}}
Casualties	{{{casualties}}}
{{{max_magnitude}}}
Mean depth	{{{mean_depth}}}
Total events	{{{events}}}
{{{module}}}
{{{embedded}}}
Citations	{{{citations}}}
{{{related}}}

{{Infobox earthquake
 | name           = 
 | image          = <!-- file name only -->
 | alt            = 
 | caption        = 
 | map            = <!-- file name only -->
 | map_alt        = 
 | map_caption    = 
 | pushpin_map    = <!-- as per Template:Location map -->
 | pre_1900       = <!-- Set to 'yes' if before 1900-01-01. Relaxes timestamp format -->
 | timestamp      = <!-- UTC date/time ("origin time") in yyyy-mm-dd hh:mm:[ss] format -->
 | isc_event      = <!-- ISC event id, or "n/a". SEE BELOW -->
 | anss_url       = <!-- Url (or fragment) of USGS-ANSS event page, or "n/a". SEE BELOW. -->
 | local_date     = <!-- Local date of area most affected: '{{Start date|YYYY|MM|DD}}' -->
 | local_time     = <!-- From newspapers? Include timezone -->
 | duration       = 
 | magnitude      = <!-- 'N.N {{M|?|link=y}}'. Get proper code from source. See below. -->
 | depth          = <!-- '{{convert|NNN|km|mi|0|abbr=on}}' -->
 | coordinates    = <!-- '{{coord|XXXXX|region:XX_type:event|display=inline,title}}' -->
 | fault          = 
 | type           = 
 | areas_affected = 
 | damage         = <!-- cost/extent of property damage -->
 | max_intensity  = 
 | pga            = <!-- NN ''[[Peak ground acceleration|g]]'' -->
 | pgv            = <!-- NN cm/s -->
 | tsunami        = 
 | landslide      = 
 | foreshocks     = 
 | aftershocks    = 
 | casualties     = 
 | engvar         = <!-- follow article: =en-UK will show 'Epicentre' -->
 | citations      = 
}}

Pushpin map

Below are the parameters used by Module:Location map to produce the pushpin map in this Infobox. These parameters are available for editors to set in articles that use this infobox. For the maps available, please consult available maps.

Parameter	Description	Default
|pushpin_map=	The map(s) to display. For example, specifying England will use the values for England in Module:Location map/data/England.Multiple maps can be shown by providing a list of map names separated by #. For multiple maps, the first is shown by default. A reader can select the others with radio buttons.	N/A
|pushpin_caption=	The text of a caption to be displayed below the map. If not provided a default caption will be generated. Multiple captions can be shown when separated by ## (that's two).	Location within MAPNAME
|pushpin_relief=	0/false/off will cause the template to display the map defined as image (generally not a relief map). 1/true/on will cause the template to display the map defined as image1 (generally a relief map). Any non-zero numeric value such as 2 or 3 will display image2 or image3, if those images are defined. Any other non-empty value will cause display of image1. See the example at Location map+/relief.	1
|pushpin_label=	The text of the label to display next to the identifying mark; a wikilink can be used. You can enclose the label inside of {{nowrap}} if you want to make sure that it stays on a single line.	N/A
|pushpin_label_size=	The font size to use for the label, given as a percentage of the normal font size (<100=smaller, >100=larger); the default size is 90. Do not include %. For example, use |pushpin_label_size=80, not |pushpin_label_size=80%. If set to 0, the label is only displayed when the user hovers over the mark.	90
|pushpin_label_position=	The position of the label relative to the identifying mark; valid values are left, right, top, bottom and none. This defaults to either left or right, depending on the coordinates of the marker and its position relative to the right border of the map image. When |pushpin_label_position=none, any defined label will not be displayed with the mark, but it will be used to create the default caption.	none
|pushpin_mark=	The name of an image file to display as the identifying mark; the default is File:Bullseye1.png . See examples at Commons:Location markers and Commons:Category:Map icons.	File:Bullseye1.png
|pushpin_mark_size=	The size of the identifying mark in pixels. Do not include px	40
|pushpin_alt=	Alt text for map; used by screen readers. See WP:ALT.	N/A
|pushpin_background=	The background color to use for the label; see Web colors. The default is no background color, which shows the map image behind the label.	N/A
|pushpin_map_size=	Determines the width of the map in pixels, overriding any default values; do not include px.	N/A

Examples

2007 Peru earthquake

Piles of rubble, one week after the shock
Map of the Peru coastline, showing location and strength of quake. Star marks epicenter.
UTC time	2007-08-15 23:40:58
ISC event	1280473
USGS-ANSS	ComCat
Local date	August 15, 2007 (2007-08-15)
Local time	18:40
Magnitude	8.0 Mw
Depth	39 km (24 mi)
Epicenter	13.354°S 76.509°W / -13.354; -76.509
Fault	Nazca-South American plate
Areas affected	Ica Region (Pisco, Ica and Chincha Alta) and Lima Region (San Vicente de Cañete)
Tsunami	flooded part of Lima's Costa Verde highway, and much of Pisco's shore
Casualties	519 confirmed dead, 1,366 injured

{{Infobox earthquake
 | name           = 2007 Peru earthquake
 | image          = 40 - Tremblement de terre - Août 2007.JPG
 | alt            = Picture showing earthquake damage.
 | caption        = Piles of rubble, one week after the shock
 | map            = Peru Quake Aug 15-2007.jpg
 | map_alt        = Map of the Peru coastline, showing location and strength of quake.
 | map_caption    = Map of the Peru coastline, showing location and strength of quake. Star marks [[epicenter]].
 | timestamp      = 2007-08-15 23:40:37
 | isc_event      = 1280473
 | anss_url       = usp000fjta
 | local_date     = {{Start date|2007|8|15}}
 | local_time     = 18:40
 | magnitude      = 8.0 {{M|w|link=y}}
 | depth          = {{convert|39|km|mi|abbr=on}}
 | coordinates    = {{coord|13.354|S|76.509|W|region:PE_type:event|display=inline,title}}
 | fault          = [[Nazca Plate|Nazca]]–[[South American Plate|South American plate]]
 | areas_affected = [[Ica Region]] ([[Pisco, Peru|Pisco]], [[Ica (city)|Ica]] and [[Chincha Alta]]) and [[Lima Region]] ([[San Vicente de Cañete]])
 | tsunami        = flooded part of Lima's Costa Verde highway, and much of Pisco's shore
 | casualties     = 519 confirmed dead, 1,366 injured
}}

New parameters

As of March, 2018, new parameters have been added to resolve some long-running problems regarding the specification of the date and time of earthquakes. On one hand, the local population (for whom the event has the most significance) and local sources identify an earthquake by the local day and time-of-day, which is also a significant factor in societal impact. On the other hand, earthquake catalogs identify and index earthquakes by their UTC time. Unfortunately, this Infobox has had only one pair of parameters for this purpose – 'date' and 'time' – and indicated neither to the editor whether local or UTC time should be used, nor to the reader which time was used (unless an editor was thoughtful enough to indicate the time zone). There is also an 'origintime' which, being similar to the "origin time" used in some catalogs, suggested UTC time and format, but, when used, actually supplanted the value given for 'time'. Some editors have used a time conversion utility to derive a UTC time from a specified local time, but this is a dubious practice: the UTC time actually used to index a quake should be obtained directly, not calculated from a non-authoritative local time.

These issues can now be avoided by using three new parameters: timestamp, local_date, and local_time. The latter are two are exactly what they say they are: the local day and time, and labeled as such in the display. There are no restrictions on how these are formatted; lacking any other guidelines they can be formatted at the editor's discretion. On the other hand, 'timestamp' is the quake's UTC time in all numeric 'yyyy-mm-dd hh:mm:ss' (ISO) format (the seconds being optional), as found in an authoritative catalog. A properly formatted UTC timestamp is now required (unless 'pre_1900' is set); any other text (including timezone or citations) generates an error. Adding "UTC" is not necessary, as that is included in the displayed label: "UTC time". With these new parameters the use of the ambiguous 'date' and 'time' parameters is deprecated, and should be removed. However, please do not simply copy the old values. These should be checked with an authoritative source such as the ANSS or ISC (see below), which have chronological indices (here and here).

There is also a pre_1900 parameter. Setting this to "yes" identifies a quake as being "historical" (meaning it occurred before the dawn of the instrumental period), relaxes the formatting otherwise required for 'timestamp', and makes certain other parameters optional.

Please note that newspapers and other news sites are NOT reliable sources for the technical details of earthquakes, such as time, location, depth, and – most importantly – magnitude. For details of "breaking news" earthquakes recourse should be had to the same source the news agencies go to: the Advanced National Seismic System (ANSS), a partnership of the USGS (NEIC) and various regional networks which monitors global seismicity and provides information on notable events, usually within 15 minutes. (See Latest Earthquakes, or the Significant Earthquake archive, which link to specific event pages in the Comprehensive Catalog.) The new anss_url parameter provides a link to a specific event page, given either the whole url to the event page (e.g.: |anss_url=https://earthquake.usgs.gov/earthquakes/eventpage/usp000fjta), or just the final part (e.g.: |anss_url=usp000fjta). For uncataloged events (mainly before 1964) use "n/a" ("not available").

The new isc_event parameter provides a link to the event's bibliography page at the International Seismological Centre (ISC) (see chronological Event Index), with a summary of the preferred magnitude and epicenter, and a link to the event's data page. Data collected by the ISC is generally not available until about two months after the event. After two years all available data is reviewed and the magnitudes and location recalculated to provide the most authoritative values available. For uncataloged events (mainly before 1964) use "n/a" ("not available").

Replacement of the deprecated parameters with the new parameters should include verification of the data, and citation to the authoritative source. For this purpose please see the {{cite anss}} and {{cite isc}} templates.

Doublet earthquakes

Doublet example

UTC time	Doublet earthquake:     A: 2011-02-21 23:51:42 B: 2011-02-22 00:04:17
ISC event	A: 16168897 B: 16461282
Local date	February 21, 2011
Local time	A: 13:54 a.m B: 14:05 p.m.
Magnitude	A: 6.1 Mw B: 5.5 Mw

There are special provisions for handling doublet earthquakes, the small number of large earthquakes where the main rupture is interrupted or delayed, resulting in two (or more: multiplet) shocks of similar magnitude, usually within minutes to days of each other. These are not aftershocks (a series of consequent events that usually begin a whole magnitude less than the main shock and steadily diminish in magnitude and frequency according to known laws), these are multiple main shocks. In such cases it incorrect to identify one shock that is slightly bigger than the rest as the main shock, and the rest as foreshocks or aftershocks. Aftershocks can be distinguished in part by starting immediately following a main shock, but usually about 1.2 magnitude smaller, and rapidly decaying in magnitude and frequency (see Bath's Law, whereas doublet/multiplet events are usually only a few events of roughly the same magnitude, separated by hours, days, or even weeks.

Setting |timestamp=doublet (or "triplet" or "multiplet") produces a wikilink to Doublet earthquake so the reader will understand that the following lines refer to the different parts of a multiple event, not to aftershocks or to different estimates of magnitude for a single event. This feature will automatically add the article to Category:Doublet earthquakes. Where doublets have separate articles and this feature is not used, the category should be explicitly added to each article. In general, stating that the quake is a doublet should be contingent on a source.

For handling multi-part main shocks, seven parameters – timestamp, isc_event, anss_url, local_date, local_time, magnitude, and depth – have a suffixed form (e.g.: timestamp_A, etc.) for adding multiple values, as seen in the example. Other parameters (like max_intensity, etc.) are free-format, and multiple values can be added by judicious use of "<br>" and "&nbsp;". To enable explicit labeling of each part add the line |tags=y. See the articles in Category:Doublet earthquakes for examples; see 2010 Mindanao earthquakes for a complex example.

Microformat

The HTML mark-up produced by this template includes an hCalendar microformat that makes event details readily parsable by computer programs. This aids tasks such as the cataloguing of articles and maintenance of databases. For more information about the use of microformats on Wikipedia, please visit the Microformat WikiProject.

Classes used

The HTML classes of this microformat include:

• attendee
• contact
• description
• dtend
• dtstart
• location
• organiser
• summary
• url
• vevent

Please do not rename or remove these classes
nor collapse nested elements which use them.

See also

• {{Earthquake magnitude}}
• {{EQ-isc-link}}
• {{Cite anss}}
• {{Cite isc}}
• {{Short-anss}}
• {{Short-isc}}

Tracking categories

• Category:Pages using infobox earthquake with unknown parameters (0)

• Category:Doublet earthquakes (60)
• Category:EQ_articles_using_'foreshock' (108)
• Category:EQ_articles_using_'aftershock' (351)
• Category:EQ articles needing UTC timestamp (5)
• Category:EQ articles with UTC timestamp error (2)
• Category:EQ articles waiting for ISC event id (42)
• Category:EQ articles needing ANSS url (18)
• Category:EQ articles with ISC set 'n/a' (20)
• Category:EQ articles with ANSS set 'n/a' (19)
• Category:EQ articles needing 'local_time' (52)
• Category:EQ articles needing 'local_date' (9)

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Infobox earthquake in articles based on its TemplateData.

TemplateData for Infobox earthquake

For presenting the key data of an earthquake in a consistent, standardized format.

Template parameters[Edit template data]

This template prefers block formatting of parameters.

Parameter		Description	Type	Status
name	name	no description	Unknown	suggested
native_name	native_name	no description	Unknown	optional
native_name_lang	native_name_lang	no description	Unknown	optional
image	image	File name only	Unknown	suggested
image_size	image_size	no description	Unknown	optional
alt	alt	no description	Unknown	suggested
caption	caption	no description	Unknown	suggested
map	map	File name only, typically a ShakeMap (USGS) uploaded by [[User:Cewbot]]	Unknown	suggested
map_size	map_size	no description	Unknown	optional
map_alt	map_alt	no description	Unknown	suggested
map_caption	map_caption	no description Example Map of the Peru coastline, showing location and strength of quake. Star marks [[epicenter]].	Unknown	suggested
pushpin_map	pushpin_map	The name of a location map as per Template:Location map (eg. Indonesia or Russia). The coordinates field position a pushpin mark and label on the map automatically.	Unknown	optional
pushpin_label	pushpin_label	no description	Unknown	optional
pushpin_alt	pushpin_alt	no description	Unknown	optional
coordinates	coordinates	{{coord|XXXXX|region:XX_type:event|display=inline,title}} Example {{coord|13.354|S|76.509|W|region:PE_type:event|display=inline,title}}	Unknown	suggested
pushpin_mark	pushpin_mark	The name of an image to display as the pushpin mark. The default is File:Bullseye1.png ( Bullseye1.png ).	Unknown	optional
pushpin_mark_size	pushpin_mark_size	no description	Unknown	optional
pushpin_caption	pushpin_caption	no description	Unknown	optional
pushpin_label_position	pushpin_label_position	The position of the label on the pushpin map relative to the pushpin mark (see example 5). Valid values are left, right, top and bottom. This defaults to either left or right, depending on the coordinates of the marker and its position relative to the right border of the map image.	Unknown	optional
pushpin_map_size	pushpin_map_size	The width to display the pushpin map, in pixels. Just the number, without \"px\". If omitted or left empty, defaults to 220.	Unknown	optional
pushpin_relief	pushpin_relief	Any non-blank value (yes, 1, etc.) will cause the template to display a relief map image, where available (see example 1). For additional information, see Template:Location map#Relief parameter.	Unknown	optional
timestamp	timestamp	UTC date/time ("origin time") in yyyy-mm-dd hh:mm:[ss] format Example 2019-11-28 18:13:53	Unknown	suggested
pre_1900	pre_1900	Set to 'yes' if before 1900-01-01. Relaxes timestamp format. Earthquakes prior to 1900 are considered 'historical'. Example yes	Unknown	optional
timestamp_A	timestamp_A	no description	Unknown	optional
tags	tags	no description	Unknown	optional
timestamp_B	timestamp_B	no description	Unknown	optional
timestamp_C	timestamp_C	no description	Unknown	optional
timestamp_D	timestamp_D	no description	Unknown	optional
timestamp_E	timestamp_E	no description	Unknown	optional
isc_event	isc_event	ISC event id. Automatically linked to the event page. Usually not available until several months after the event. See template documentation for more information	Unknown	suggested
isc_event_A	isc_event_A	no description	Unknown	optional
isc_event_B	isc_event_B	no description	Unknown	optional
isc_event_C	isc_event_C	no description	Unknown	optional
isc_event_D	isc_event_D	no description	Unknown	optional
isc_event_E	isc_event_E	no description	Unknown	optional
USGS-ANSS	anss_url	URL to the USGS-ANSS event page. See template documentation for more information Example https://earthquake.usgs.gov/earthquakes/eventpage/nc216859	Unknown	suggested
anss_url_A	anss_url_A	no description	Unknown	optional
anss_url_B	anss_url_B	no description	Unknown	optional
anss_url_C	anss_url_C	no description	Unknown	optional
anss_url_D	anss_url_D	no description	Unknown	optional
anss_url_E	anss_url_E	no description	Unknown	optional
local_date	local_date	Local date of area most affected: {{Start date|YYYY|MM|DD}}	Unknown	suggested
local_date_A	local_date_A	no description	Unknown	optional
local_date_B	local_date_B	no description	Unknown	optional
local_date_C	local_date_C	no description	Unknown	optional
local_date_D	local_date_D	no description	Unknown	optional
local_date_E	local_date_E	no description	Unknown	optional
local_time	local_time	Local time of area most affected: hh:mm:ss [[timezone]] ([[UTC±x]]) Example 18:13:53 [[Central European Time|CET]] ([[UTC+1]])	Unknown	suggested
local_time_A	local_time_A	no description	Unknown	optional
local_time_B	local_time_B	no description	Unknown	optional
local_time_C	local_time_C	no description	Unknown	optional
local_time_D	local_time_D	no description	Unknown	optional
local_time_E	local_time_E	no description	Unknown	optional
duration	duration	no description	Unknown	suggested
magnitude	magnitude	N.N {{M|?|link=y}}. Get the initial reported magnitude from the USGS-ANSS site. Indicate the scale with {{M}}. Use {{M|w}} for moment magnitude (but only if explicitly stated), {{M|.}} if implicitly Mw, or {{M|?}} if uncertain. See template documentation for more information Example 5.9 {{M|w|linky}}	Unknown	suggested
magnitude_A	magnitude_A	no description	Unknown	optional
magnitude_B	magnitude_B	no description	Unknown	optional
magnitude_C	magnitude_C	no description	Unknown	optional
magnitude_D	magnitude_D	no description	Unknown	optional
magnitude_E	magnitude_E	no description	Unknown	optional
depth	depth	{{convert|NNN|km|mi|0|abbr=on}}	Unknown	suggested
depth_A	depth_A	no description	Unknown	optional
depth_B	depth_B	no description	Unknown	optional
depth_C	depth_C	no description	Unknown	optional
depth_D	depth_D	no description	Unknown	optional
depth_E	depth_E	no description	Unknown	optional
English variant language	engvar	en-UK to spell 'Epicentre' instead of en-US 'Epicenter'	Unknown	optional
fault	fault	For specific fault, unless two plates are clearly the culprit. Ensure a source verifies this. Example [[Alpine Fault|Alpine]] or [[Nazca Plate|Nazca]]-[[South American Plate|South American plate]]	Unknown	suggested
type	type	no description	Unknown	suggested
areas_affected	areas_affected	Affected regions or cities	Unknown	suggested
damage	damage	Cost/extent of property damage. Give in local currency and/or US$ as per [[WP:CURRENCY]]. Use {{US$|X.xx|link=yes}} or {{In USD|X.xx|ISO code|year=YYYY}}	Unknown	suggested
max_intensity	max_intensity	Use [[Mercalli intensity scale]] Example [[Mercalli intensity scale|VIII (''Severe'')]]	Unknown	suggested
pga	pga	NN ''[[Peak ground acceleration|g]]'' Example 0.436 ''[[Peak ground acceleration|g]]''	Unknown	suggested
pgv	pgv	Peak ground velocity. NN cm/s Example 456 cm/s	Unknown	suggested
tsunami	tsunami	no description Example Flooded part of Lima's Costa Verde highway, and much of Pisco's shore	Unknown	suggested
landslide	landslide	no description	Unknown	suggested
foreshocks	foreshocks	{{M|?|link=y}}. Get proper code from source, and date using {{Start date|YYYY|mm|dd|hh|mm}} Example {{M|w|link=yes}} 5.6 ({{Start date|2019|9|21|14|04}})	Unknown	suggested
aftershocks	aftershocks	{{M|?|link=y}}. Get proper code from source, and date using {{Start date|YYYY|mm|dd|hh|mm}} unless the same day as "origin date". Use {{plainlist}} for multiple Example {{M|w|link=yes}} 4.0	Unknown	suggested
casualties	casualties	Fatalities and injuries. Cite reliable source Example 400 fatalities, 6,000 injuries	Unknown	suggested
max_magnitude	max_magnitude	Swarms-only	Unknown	optional
mean_depth	mean_depth	Swarms-only	Unknown	optional
events	events	Swarms-only	Unknown	optional
module	module	no description	Unknown	optional
embedded	embedded	no description	Unknown	optional
citations	citations	no description	Unknown	suggested
related	related	no description	Unknown	optional

The above documentation is transcluded from Template:Infobox earthquake/doc. (edit | history)
Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
Add categories to the /doc subpage. Subpages of this template.