This GCMT3D-CATALOGreadme.txt file was generated on 2021-12-20 by Lucas Sawade

GENERAL INFORMATION

1. Title of Dataset: GCMT3D - CATALOG

2. Author Information
	A. Principal Investigator Contact Information
		Name: Lucas Sawade
		Institution: Princeton University
		Address: Guyot Hall 318, Princeton, NJ, 08544
		Email: lsawade@princeton.edu

	B. Associate or Co-investigator Contact Information
		Name: Jeroen Tromp
		Institution: Princeton University
		Address: 320 Guyot Hall
		Email: jtromp@princeton.edu

	C. Alternate Contact Information
		Name:
		Institution:
		Address:
		Email:

3. Date of data collection (single date, range, approximate date):
2019-01-01 -- 2021-12-12

4. Geographic location of data collection:
Global

5. Information about funding sources that supported the collection of the data:
		- Oak Ridge Leadership Computing Facility, a DOE Office of Science User Facility, contract DE-AC05-00OR22725;
		- NSF grant 1644826


SHARING/ACCESS INFORMATION

1. Licenses/restrictions placed on the data:
	CC-BY 4.0 International


2. Links to publications that cite or use the data:
Sawade et al. (2022). Global Centroid Moment Tensor Solutions in a
	Heterogeneous Earth: The CMT3D Catalog. Geophys. J.
	Int. https://doi.org/10.1093/gji/ggac280

3. Links to other publicly accessible locations of the data:
https://global.shakemovie.princeton.edu
https://lsawade.github.io
https://globalcmt3d.org

4. Links/relationships to ancillary data sets:
https://ds.iris.edu/ds/nodes/dmc/

5. Was data derived from another source? yes/no
	A. If yes, list source(s):
		https://ds.iris.edu/ds/nodes/dmc/

6. Recommended citation for this dataset:

	Sawade, L., Beller S., Lei, W., and Tromp, J. (2022). GCMT3D - CATALOG.
		https://doi.org/10.34770/gp8e-sx34.


DATA & FILE OVERVIEW

1. File List:
GCMT3D-CATALOGreadme.txt
gcmt3d.txt
gcmt3d.tar.gz

2. Relationship between files, if important:

gcmt3d.txt and gcmt3d.tar.gz provide the same thing but in different formats
for convenience. gcmt3d.txt is a text file containing all source model files.
gcmt3d_dir.tar.gz is a compressed directory containing one file for each
event; the files are named using the respective Global CMT event id.

3. Additional related data collected that was not included in the current data
package:

To produce the event catalogs we downloaded observed displacement
records from the IRIS Data Management Center (DMC) and computed synthetic
seismograms using specfem3d_globe. Due to the size of the raw data and their
reproducibility, we do not include them in this data package.

4. Are there multiple versions of the dataset?
no


METHODOLOGICAL INFORMATION

1. Description of methods used for collection/generation of data:
For the full methodology please refer to:

	Sawade et al. (2022). Global Centroid Moment Tensor Solutions in a
	Three-Dimensionally Heterogeneous Earth: The GCMT3D Catalog. Geophys. J.
	Int.

2. Methods for processing the data:

For details on the processing parameters, please refer to the supplementary
material

	Sawade et al. (2022). Global Centroid Moment Tensor Solutions in a
	Heterogeneous Earth: The CMT3D Catalog. Geophys. J.
	Int. https://doi.org/10.1093/gji/ggac280


3. Instrument- or software-specific information needed to interpret the data:
The synthetic seismograms used in the inversion for the events were computed
on the HPC cluster Summit at Oak Ridge National Lab, using specfem3d_globe
and the three-dimensional heterogeneous Earth model GLAD-M25. For all processing
we used a combination of the software available here

	Sawade et al. (2021). GCMT3D - Software.
	https://github.com/lwsspy/lwsspy.gcmt3d. https://doi.org/10.34770/yctp-3c03.
	Princeton Dataspace. 0.0.3.

7. People involved with sample collection, processing, analysis and/or submission:
Lucas Sawade
Stephen Beller
Wenjie Lei
Jeroen Tromp

DATA-SPECIFIC INFORMATION FOR: gcmt3d_dir.tar.gz
Untar as follows

$ tar -vzxf gcmt3d_dir.tar.gz

1. Number of files:
9382

2. Number of rows per file:
13

3. Line by line:
	1. PDE Solution
	2. event id
	3. timeshift in seconds
	4. half duration in seconds
	5. latitude in degrees [-90, 90]
	6. longitude in degrees [-180, 180]
	7. depth in km
	8.  Mrr - moment tensor component in dyn*cm
	9.  Mtt - moment tensor component in dyn*cm
	10. Mpp - moment tensor component in dyn*cm
	11. Mrt - moment tensor component in dyn*cm
	12. Mrp - moment tensor component in dyn*cm
	13. Mtp - moment tensor component in dyn*cm

DATA-SPECIFIC INFORMATION FOR: gcmt3d.txt
Contains all events in CMTSOLUTION format. The 13 lines of each event are
defined as the 13 lines for each file in the gcmt3d_dir.

The file contains
	13 lines * 9382 events = 121966 lines
	                         ------------