Template:Infobox earthquake/doc

Usage


Examples


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. The format is required (unless 'pre-1900' is set); any other text (including timezone or citations) generate an error. In the near future 'timestamp' itself may be required. 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.: https&#58;//earthquake.usgs.gov/earthquakes/eventpage/usp000fjta), or just the final part (e.g.: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
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.

For handling cases of multiple main shocks, five parameters – timestamp, isc-event, anss-url, local-time, and magnitude – have a suffixed form (e.g.: timestamp-A, etc.) for adding multiple values, as seen in the example. Other parameters (like depth, intensity, etc.) are free-format, and multiple values can be added by judicious use of "&lt;br>" and "&amp;nbsp;". See the articles in Category:Doublet earthquakes for examples.

Setting 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 different estimates of magnitude for a single event. To enable explicit labeling of each part add the line y. Doublet/multiplet earthquakes should also be added to Category:Doublet earthquakes, but in general this should be contingent on a source stating that.

Tracking categories


The following identify articles needing attention.

TemplateData
{	"params": { "name": { "aliases": [ "title" ],			"example": "2007 Peru earthquake", "type": "string" },		"image": { "description": "file name only", "example": "40 - Tremblement de terre - Août 2007.JPG", "type": "wiki-file-name" },		"image_size": {}, "alt": { "aliases": [ "image alt" ],			"example": "Picture showing earthquake damage." },		"caption": { "aliases": [ "imagecaption" ],			"example": "Piles of rubble, one week after the shock" },		"map": { "description": "file name only", "example": "Peru Quake Aug 15-2007.jpg", "type": "wiki-file-name" },		"map_size": { "aliases": [ "mapsize" ]		},		"map_alt": { "aliases": [ "map alt" ],			"example": "Map of the Peru coastline, showing location and strength of quake.", "type": "string" },		"map_caption": { "aliases": [ "image name" ],			"example": "Map of the Peru coastline, showing location and strength of quake. Star marks epicenter.", "type": "string" },		"pushpin_map": { "label": "Pushpin Map", "type": "string", "required": false, "description": "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." },		"pushpin_mapsize": { "label": "Pushpin Mapsize", "type": "number", "required": false, "description": " The width to display the pushpin map, in pixels. Just the number, without \"px\". If omitted or left empty, defaults to 220." },		"pushpin_map_alt": { "label": "Pushpin Map Alternative", "type": "string", "required": false, "description": " Alt text for the pushpin map." },		"pushpin_map_caption": { "label": "Pushpin Map Caption", "type": "string", "required": false, "description": "Caption to display below the pushpin map. If left blank or omitted, a caption will not be displayed." },		"pushpin_relief": { "label": "Pushpin Relief", "type": "string", "required": false, "description": " 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." },		"pushpin_image": { "label": "Pushpin Image", "type": "wiki-page-name", "required": false, "description": " Name of an alternative map image, which must have the same edge coordinates as the location map template specified via pushpin_map" },		"pushpin_label": { "label": "Pushpin Label", "type": "string", "required": false, "description": "The text of the label to place next to the pushpin mark. The default is no label." },		"pushpin_label_position": { "label": "Pushpin Label Position", "type": "string", "required": false, "description": " 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." },		"pushpin_mark": { "label": "Pushpin Mark", "type": "string", "required": false, "description": "The name of an image to display as the pushpin mark. The default is File:Bullseye1.png ( Bullseye1.png )." },		"pushpin_marksize": { "label": "Pushpin Marksize", "type": "number", "required": false, "description": " The size of the mark in pixels" },

"pre-1900": { "label": "(no label, not displayed)", "description": "Earthquakes prior to 1900 are considered 'historical'.", "example": "yes", "default": "no" },               "timestamp": { "label": "UTC timestamp", "description": "UTC date and time in 'yyyy-mm-dd hh:mm[:ss]' format. Required for all earthquakes since 1900.", "example": "1989-10-18 00:04:14" },               "isc-event": { "label": "ISC event", "description": "ISC event id; automatically linked to the event page. Usually not available until several months after the event. ", "example": "389808" },               "anss-url": { "label": "USGS-ANSS", "description": "URL to USGS-ANSS event page", "example": "https://earthquake.usgs.gov/earthquakes/eventpage/nc216859" },               "local-date": { "label": "Local date", "description": "", "example": "October 18, 1989", },               "local-time": { "label": "Local time", "description": "Local time, with timezone", "example": "5:04 p.m. PST" },		"date": { "label": "Date", "description": "", "example": "August 15, 2007" },		"time": { "aliases": [ "origintime" ],			"label": "Origin time", "example": "23:40:57 UTC" },		"duration": { "label": "Duration" },		"magnitude": { "label": "Magnitude", "description": "Get the initial reported magnitude from the USGS-ANSS site. Indicate the scale with . Use  for moment magnitude (but only if explicitly stated),  if implicitly Mw, or  if uncertain.", "example": "6.9 ", "type": "string"

},		"depth": { "label": "Depth", "description": "NNN km", "example": "39 km", "type": "string" },		"location": { "label": "Epicenter", "description": "°N, °W", "example": "-13.354°N, -76.509°W", "type": "string" },		"fault": { "label": "Fault", "example": "Nazca-South American plate", "type": "string" },		"type": {}, "affected": { "aliases": [ "countries affected" ],			"label": "Areas affected", "example": "Ica Region (Pisco, Ica and Chincha Alta) and Lima Region (San Vicente de Cañete)", "type": "string" },		"damages": { "aliases": [ "damage" ],			"label": "Total damage", "description": "cost/extent of property damage" },		"intensity": { "label": "Max. intensity" },		"pga": { "aliases": [ "PGA" ],			"label": "Peak acceleration", "description": "NN g" },		"pgv": { "aliases": [ "PGV" ],			"label": "Peak velocity", "description": "NN cm/s" },		"tsunami": { "example": "flooded part of Lima's Costa Verde highway, and much of Pisco's shore", "type": "string" },		"landslide": { "label": "Landslides" },		"foreshocks": {}, "aftershocks": {}, "casualties": { "example": "519 confirmed dead, 1,366 injured", "type": "string" },		"maxmagnitude": { "label": "Greatest magnitude", "description": "Swarms-only" },		"meandepth": { "label": "Mean depth", "description": "Swarms-only" },		"events": { "label": "Total events", "description": "Swarms-only" },	       "engvar": { "label": "English variant language", "description": "en-UK to spell 'Epicentre'" },		"module": { "aliases": [ "embedded", "misc" ]		},		"citations": { "label": "Citations", "type": "string" },		"related": {} },	"description": "Infobox for an earthquake", "format": "block" }