************************* PAGER-CAT_v1_readme.txt ************************* Below we provide a brief description of the PAGER-CAT data and tools available for download. The catalogue is more fully described in: Allen, T.I., Marano, K.D., Earle, P.S., and Wald, D.J. (in review). PAGER-CAT: A composite earthquake catalog for calibrating global fatality models: Seism. Res. Lett. ********************** Index ********************** readpagercat.m PAGER_CAT_v1.csv - Appendix 1: Description of PAGER-CAT fields - Appendix 2: Casualty descriptor/quality key Tips for ArcGIS users ********************** readpagercat.m ********************** readpagercat.m is a Matlab function to query the Matlab structure contained in the download PAGER_CAT_v1.mat. Queries that the user can perform with the Matlab function include searches on: start and stop dates, country, shaking and total death thresholds, magnitude threshold, tsunami or landslide flags, or events within a given radius about a point. To get started, type "load PAGER_CAT_v1" in your working directory. This will load the variable "pagerCat" which is parsed by the function readpagercat. For function usage, type "help readpagercat" in the Matlab command window. ********************** PAGER-CAT_v1.csv ********************** The following list provides a description of the PAGER-CAT fields (Appendix 1) and casualty quality indicator (Appendix 2). If no quality indicator is given, then the value is assumed to be 'exact' (i.e., no approximations were used to eveluate the value). Acronyms used: PDE: Preliminary Determination of Epicenters EHB: Engdahl, van der Hilst and Buland Catalogue GCMT: Global Centroid Moment Tensor Database PAGER: Prompt Assessment of Global Earthquakes for Response ISO: International Organization for Standardization EM-DAT: Emergency Events Database HTD: Historical Tusnami Database (National Geophysical Data Center) *************************APPENDIX 1************************* eqID: Earthquake identification number (based on PDE origin time) PAGER_dateStr: Date string from preferred origin time PAGER_dateNum: PAGER preferred date number (number of days starting from January 1st, 0000) PAGER_lat: PAGER preferred latitude PAGER_lon: PAGER preferred longitude PAGER_depth: PAGER preferred depth PAGER_locSrc: PAGER preferred location source PAGER_prefMag: PAGER preferred magnitude PAGER_prefMagType: PAGER preferred magnitude type PAGER_prefMagSrc: PAGER preferred magnitude source PDE_dateNum: PDE date number (number of days starting from January 1st, 0000) PDE_lat: PDE latitude PDE_lon: PDE longitude PDE_depth: PDE depth PDE_Mb: PDE body wave magnitude PDE_Ms: PDE surface wave magnitude PDE_contrib_mag1: PDE contributed magnitude #1 PDE_contrib_magType1: PDE contributed magnitude type #1 PDE_contrib_magSrc1: PDE contributed magnitude source #1 PDE_contrib_mag2: PDE contributed magnitude #2 PDE_contrib_magType2: PDE contributed magnitude type #2 PDE_contrib_magSrc2: PDE contributed magnitude source #2 PDE_prefMagFlag: PDE preferred magnitude flag (1-4 indicating Mb, Ms, contributed #1 or contributed #2) PDE_prefMag: PDE preferred magnitude PDE_lossFlag: PDE impact flag (0-3 indicating not felt, felt, damage or casualties, respectively) EHB_dateNum: EHB date number (number of days starting from January 1st, 0000) EHB_lat: EHB latitude EHB_lon: EHB longitude EHB_depth: EHB depth EHB_locSrc: EHB location source (equal to EHB after 1973, otherwise taken from the Centennial Catalogue) EHB_prefMag: EHB preferred magnitude (taken from Centennial Catalogue) EHB_prefMagType: EHB preferred magnitude type (taken from Centennial Catalogue) EHB_prefMagSrc: EHB preferred magnitude source (taken from Centennial Catalogue) CMT_moment: GCMT scalar moment, M0 (dyne-cm) CMT_Mw: GCMT moment magnitude determined using the equation Mw = (2/3)*(log M0 - 16.1) CMT_magSrc: GCMT magnitude source (HRV, GCMT or empty) CMT_lat: GCMT centroid latitude CMT_lon: GCMT centroid longitude CMT_depth: GCMT centroid depth CMT_strike1: GCMT strike of fault plane #1 CMT_dip1: GCMT dip of fault plane #1 CMT_rake1: GCMT rake of fault plane #1 CMT_strike2: GCMT strike of fault plane #2 CMT_dip2: GCMT dip of fault plane #2 CMT_rake2: GCMT rake of fault plane #2 CMT_faultType: GCMT fault type (RS, SS, NS or empty) ISO_country: ISO country (ISO) ISO_code: ISO two letter country code ISO_arcDist: Location distance to nearest ISO country (degrees; equals zero if within political borders) deltaUTC: Time difference from Coordinated Universal Time (UTC) localHour: Local hour of earthquake localDOW: Local day of week of earthquake daySavingFlag: Daylight savings flag (equals 1 if daylight savings was observed in 2007) PDE_shakingDeaths: PDE number of shaking deaths PDE_shakingDeathsFlag: PDE shaking death quality indicator (1-6) PDE_shakingDeathsComm: PDE comments on shaking deaths PDE_landslideDeaths: PDE number of landslide deaths PDE_landslideDeathsFlag: PDE landslide death quality indicator (1-6) PDE_tsunamiDeaths: PDE comments on landslide deaths PDE_tsunamiDeathsFlag: PDE number of tsunami deaths PDE_otherDeaths: PDE tsunami death quality indicator (1-6) PDE_otherDeathsFlag: PDE comments on tsunami deaths PDE_missing: PDE number of people missing PDE_missingFlag: PDE missing quality indicator (1-6) PDE_undiffDeaths: PDE number of undifferentiated deaths PDE_undiffDeathsFlag: PDE undifferentiated deaths quality indicator (1-6) PDE_totalDeaths: PDE total deaths PDE_totalDeathsFlag: PDE total deaths quality indicator (1-6) PDE_totalDeathsComm: PDE total deaths comments PDE_injured: PDE number of people injured PDE_injuredFlag: PDE injured quality indicator (1-6) PDE_injuredComm: PDE injured comments PDE_homeless: PDE number of people homeless PDE_homelessFlag: PDE people homeless quality indicator (1-6) PDE_homelessComm: PDE people homeless comments PDE_buildDestroyed: PDE number of buildings destroyed PDE_buildDestroyedFlag: PDE buildings destroyed quality indicator (1-6) PDE_buildDestroyedComm: PDE buildings destroyed comments PDE_buildDamaged: PDE number of buildings damaged only PDE_totDamagedBuild: PDE total number of buildings damaged and destroyed PDE_tsunamiFlag: PDE tsunami flag (equals 1 if tsunami observed, zero if not) PDE_landslideFlag: PDE landslide flag (equals 1 if landslide observed, zero if not) PDE_liquefactionFlag: PDE liquefaction flag (equals 1 if liquefaction observed, zero if not) PDE_comments: Final PDE comments UTSU_deathsStr: Utsu deaths string (may or may not be numerical value) UTSU_injuriesStr: Utsu injuries string (may or may not be numerical value) UTSU_deaths: Utsu deaths (numerical value only) UTSU_injuries: Utsu injuries (numerical value only) UTSU_deathFlag: Utsu death flag (equals 1 if deaths observed) UTSU_tsunamiFlag: Utsu tsunami flag (equals 1 if tsunami observed, zero if not) UTSU_landslideFlag: Utsu landslide flag (equals 1 if landslide observed, zero if not) UTSU_fireFlag: Utsu fire flag (equals 1 if fire observed, zero if not) UTSU_comments: Final Utsu comments EMDAT_deaths: EM-DAT number of deaths EMDAT_injuries: EM-DAT number of injuries EMDAT_homeless: EM-DAT number of people homeless EMDAT_totalDamage: EM-DAT total damage estimate in thousands of US dollars EMDAT_insuredLoss: EM-DAT insured losses estimated in thousands of US dollars EMDAT_aidContribution: EM-DAT foreign aid estimate in thousands of US dollars EMDAT_tsunamiFlag: EM-DAT tsunami flag (equals 1 if tsunami observed, zero if not) EMDAT_landslideFlag: EM-DAT landslide flag (equals 1 if landslide observed, zero if not) EMDAT_fireFlag: EM-DAT fire flag (equals 1 if fire observed, zero if not) HTD_tsunamiFlag: HTD flag indicating occurrence of a tsunami HTD_maxHeight: HTD maximum water height above sea level in meters HTD_numRunups: HTD total number of tsunami runups HTD_deaths: HTD number of deaths HTD_injuries: HTD number of injuries HTD_damage: HTD damage in millions of dollars at time of the event HTD_buildingsDestroyed: HTD number of houses destroyed by tsunami OTHER_shakingDeaths: Number of shaking deaths from other source OTHER_totalDeaths: Total deaths from other source OTHER_injuries: Number of injuries from other source OTHER_source: Reference to other source PAGER_prefShakingDeaths: PAGER preferred shaking deaths PAGER_prefShakingDeathsSrc: Source of PAGER preferred shaking deaths PAGER_prefTotalDeaths: PAGER preferred total deaths PAGER_prefTotalDeathsSrc: Source of PAGER preferred total deaths PAGER_prefInjuries: PAGER preferred injuries PAGER_prefInjuriesSrc: Source of PAGER preferred injuries PAGER_prefHomeless: PAGER preferred number of people homeless PAGER_prefHomelessSrc: Source of PAGER preferred homeless *************************APPENDIX 2************************* Casualty descriptor/quality key: 1) at least, more than, over 2) estimated, approximately, about 3) unconfirmed, possibly 4) x to y 5) nearly, as many as, up to 6) no numerical value ********************** Tips for ArcGIS users ********************** GIS software packages, such as ArcGIS, require very specific ASCII data formats so that they can be read into these programs. Here we outline the key steps to successfully load PAGER-CAT onto the ArcGIS platform. 1) To add data in ArcGIS, select "Tools -> Add XY Data" on the main menu. 2) In the Add XY Data dialog box, browse for your newly modified version of PAGER-CAT 3) Select the X Field as PAGER_lon and the Y Field as PAGER_lat 4) Edit the coordinate system by pressing "Edit -> Select" and select the coordinate system of you choice. 5) Click "OK" on the Add XY Data dialog box The point data should now be indicated in the Map window. It is recommend that the user now creat a Shapefile of these data. To do this, right click on the modified PAGER-CAT in the Display pane, select "Data -> Export Data" and follow the promts. This will now enable the user to sort and select events in the shapefile attribute table.