## Author: Suzan Green, ORCID ID 0000-1201-2348-8857
## Project: thesis publication
## Organization: Utrecht University
## Faculty: Geosciences
## Department: Department of Earth Sciences
## Date: October 7 2021

GENERAL
~~~~~~~
Data files for the research publication by 
## Author: John Davidson ORCID ID 0000-0002-7809-8217
## Author: Donuld Trump ORCID ID: 0000-0003-5484-9459
## Author: Lionel Messi ORCID ID: 0000-0002-5767-5590
## Author: Bob Train ORCID ID 0000-0001-7128-8857
## Title: Tectonic context and possible triggering of the 2019-2020 Puerto Rico earthquake sequence
## Journal: Seismological Research Letters
## DOI: to be added

Please refer to this paper and its supplement for more detailed information, bibliography/citations, software, and figures.


INPUT DATA SETS
~~~~~~~~~
- bruna_et_al_2015.csv: lon,lat coordinates of 30 normal faults in southwest Puerto Rico digitized from Granja Bruna et al. (2015)
- french_schenk_2004.gmt: Faults from French and Schenk (2004)
- liu_et_al.dat: Slip model from Liu et al. (2020) in o92util format (below)
- styron_et_al_2020.gmt: Fault segments data from Styron et al. (2020)  
- usgs_mt_2019-2020.csv: Seismicity from 2019 to 2020, M2.5 and larger, from USGS ComCat (https://earthquake.usgs.go/data/comcat), with moment tensors where available
- usgs_seis_prsn.csv: Seismicity from 1990 to May 2021, M2.5 and larger, from USGS ComCat (https://earthquake.usgs.go/data/comcat) with Puerto Rico Seismic Network (PRSN) hypocenters


FOLDER/DIRECTORY STRUCTURE
~~~~~~~~~~~~~~~~~~~~~~~~~~
coul_fshk/: Initial strike-slip events resolved onto the mainshock target plane
	coul_fshk/PRSN/: Using PRSN hypocenter data
		coul_fshk/PRSN/Ndip_mshk/: Using the geometry/orientation of the north-dipping fault of the Mw 6.4 main-shock as the target fault
		coul_fshk/PRSN/Sdip_mshk/: Using the geometry/orientation of the south-dipping fault of the Mw 6.4 main-shock as the target fault
	coul_fshk/cromwell_et_al/: Using Cromwell et al (2021, SRL, same issue) relocated hypocenter data
		coul_fshk/PRSN/Ndip_mshk/: Using the geometry/orientation of the north-dipping fault of the Mw 6.4 main-shock as the target fault
		coul_fshk/PRSN/Sdip_mshk/: Using the geometry/orientation of the south-dipping fault of the Mw 6.4 main-shock as the target fault
coul_mshk/: Initial strike-slip events + M6.4 mainshock resolved onto aftershocks
	coul_mshk/trg_nor: Resolved onto normal faulting target faults
	coul_mshk/trg_ss: Resolved onto strike slip faulting target faults

FILE EXTENSIONS AND ASSOCIATED SOFTWARE
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.csv: comma-delimited data format, ASCII text
.gmt: lon-lat data for plotting with the plot command from Generic Mapping Tools (GMT, https://www.generic-mapping-tools.org), ASCII text
.tmp: data for o92util, ASCII text

The o92util app is part of the open source software package Hdef which is available from https://doi.org/10.5281/zenodo.3894137. The software was developed by Matthew Herman, and for this project we used version 0.0.0 (June 15, 2020). The o92util man-page explains how the input data files in this repository can be used to compute Coulomb stresses and co-seismic displacements from given earthquake sources.


FOLDER/DIRECTORY CONTENTS:
~~~~~~~~~~~~~~~~~~~~~~~~~~
Directories contain the following files for use with, and from, o92util (available at https://doi.org/10.5281/zenodo.3894137)
	- o92_mag.tmp: input file for o92util, location, geometry (str/dip/rak), and magnitude of source faults
	- sta.tmp: input file for o92util, target fault locations
	- trg.tmp: input file for o92util, geometry and effective friction of target faults
	- haf.tmp: input file for o92util, elastic moduli of half-space
	- coul.tmp: output file of o92util, Coulomb stress at each target fault location that is specified in sta.in

