----------------- 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 velocity models from the literature 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 

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

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 S-wave velocity models for degree 20:
average_model_vs_lc20.xyz
votemap_negative-mean_vs_lc20.xyz
votemap_positive-mean_vs_lc20.xyz
votemap_combined-mean_vs_lc20.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 in percent 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 are also provided, for the different degrees: 
globe_aver-vote-combi_velocities_lc${lmax}.pdf
where lmax is 6 or 20.

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

