----------------- March 2020 -----------------------------
------ Paula Koelemeijer - Royal Holloway ----------------

Files contain average models and vote maps describing the seismological landscape of the core-mantle boundary (Koelemeijer, AGU books, 2020). 

- Average models are computed similar to SMEAN (Becker & Boschi, 2002) or PMEAN, except that only depth slices at 2800 km depth are considered. 
- Vote maps are computed for a positive or negative mean following Shephard et al. (2017), again for structure at 2800 km depth. 
- Combined vote maps based on a combination of the positive and negative mean are provided in addition. 

Note that while these average models and vote maps aid in finding model consistencies, they do not necessarily fit seismological data and are not intended as replacement of the original models. 

##########################################################

Average models and vote maps are computed for existing models from the literature for different selections as indicated below:

### Shear-wave velocity (vs), for models expanded up to degree 6 or 20:

GYPSUM-S	Simmons et al., 2010
SAW642ANb 	Panning et al., 2010
S40RTS 		Ritsema et al., 2011
METAL12-S 	Mosca et al., 2012	
S362ANI+M 	Moulik and Ekstrom, 2014
SAVANI 		Auer et al., 2014
SEMUCB-WM1 	French and Romanowicz, 2014
SGLOBErani 	Chang et al., 2015
SPani-S 	Tesoniero et al., 2015
SP12RTS-S 	Koelemeijer et al., 2016
TX2015 		Lu and Grand, 2016
SEISGLOBE2 	Durand et al., 2017

### Compressional-wave velocity (vp), for models expanded up to degree 6 or 20:

GYPSUM-P 	Simmons et al., 2010
LLNL G3Dv3 	Simmons et al., 2012
METAL12-P 	Mosca et al., 2012
GAP-P4 		Obayashi et al., 2013
SPani-P 	Tesoniero et al., 2015
SP12RTS-P 	Koelemeijer et al., 2016
MIT2016 	Burdick et al., 2017
H2016 		Hosseini, 2016

### Density (rho), for models expanded up to degree 2 or 6:

IT1999		Ishii and Tromp, 1999
Tetal2004 	Trampert et al., 2004 (mean model)
Metal2012	Mosca et al., 2012 (mean model)
ME2016 		Moulik and Ekstrom, 2016
Letal2017	Lau et al., 2017 (mean model)

and either of the following:

KDR2017-pos 	Koelemeijer et al., 2017 (best-fitting model for positive model class)
KDR2017-neg 	Koelemeijer et al., 2017 (best-fitting model for negative model class)

This results in two selections for density: rho_neg-class and rho_pos-class. 

### CMB topography (topo), for models expanded up to degree 2 or 6:

- Models based on body waves (body):

MD1987 		Morelli and Dziewonski, 1987
DH1989-M6 	Doornbos and Hilton, 1989
SV2003		Sze and van der Hilst, 2003
T2010 		Tanaka, 2010
SBF2012-T	Soldati et al., 2012
SBF2012-TGppv 	Soldati et al., 2012

- Models based on normal-modes (modes):
LGW1991-SAF	Li et al., 1991
LGW1991-SAT 	Li et al., 1991
IT1999 		Ishii and Tromp, 1999
KDR2017 	Koelemeijer et al., 2017

Three selections are therefore present for CMB topography: topo_body, topo_modes and topo_all. 

##########################################################

For each selection of models (selection) and each spherical harmonic degree expansion (lmax), 
the following files are provided: 

average_model_${selection}_lc${lmax}.xyz  		
votemap_negative-mean_${selection}_lc${lmax}.xyz  
votemap_positive-mean_${selection}_lc${lmax}.xyz  
votemap_combined-mean_${selection}_lc${lmax}.xyz  

e.g. for all CMB topography models for degree 2:
average_model_topo_all_lc2.xyz
votemap_negative-mean_topo_all_lc2.xyz
votemap_positive-mean_topo_all_lc2.xyz
votemap_combined-mean_topo_all_lc2.xyz

In each case, the file contains three columns (points at every 5x5 degrees): 
Latitude (ge-90,90), Longitude (-180,180), Value
where for vote maps the value is the number of votes  
and for average models this is either in percent (for velocity and density)
or in kilometers (for CMB topography), as deviations from PREM. 

For each selection of models (selection) and each spherical harmonic degree expansion (lmax), 
a figure plotting the relevant files is also provided: 
globe_aver-vote-combi_${selection}_lc${lmax}.pdf  

##########################################################

Overview plots for each parameter are also provided, for the different degrees: 
globe_aver-vote-combi_density_lc${lmax}.pdf
globe_aver-vote-combi_topography_lc${lmax}.pdf
globe_aver-vote-combi_velocities_lc${lmax}.pdf
where lmax is 2 or 6 for density and CMB topography
and lmax is 6 or 20 for the velocities.

These plots are consistent with the figures in the publication (Koelemeijer, 2020). 

