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

##################### This documentation file was generated on 2025/01/31 by Lucrecia Rallo Fabra ######################################################

GENERAL INFORMATION
-------------------

1. Title of Dataset: Replication data for Predicting discrimination difficulty of Californian English vowel contrasts from L2-to-L1 categorization

2. Authorship: 

	Name: Lucrecia Rallo Fabra
	Institution: Universitat de les Illes Balears
	ORCID: 0000-0003-0253-2601

3. Contact:

	Nom: Lucrecia Rallo Fabra
	Institució: Universitat de les Illes Balears
	Correu electrònic: lucrecia.rallo@uib.es
	ORCID: 0000-0003-0253-2601

DESCRIPTION
-----------

1. Dataset language: English

2. Abstract:

Results of two perceptual experiments: a perceptual assimilation (categorisation) of Californian English vowels and an ABX discrimination test of Californian English vowels by Spanish-Catalan advanced learners.

3. Keywords:

L2 perception, categorisation, discrimination, PAM-L2

4. Kind of data:

Experimental data

5. Date of data collection (single date or date range):
2021/02/01 - 2021/02/28

6. Date of dataset publication:
2025-01-31

7. Funding sources: 

	Funding agency: Agencia Estatal de Investigación
	Project number: FFI2017-84479-P

	Funding agency: Agencia Estatal de Investigación
	Project number: PID 2020-117804GB-I00

8. Geographic location/s of data collection:
Palma de Mallorca (Balearic Islands, Spain)

ACCESS INFORMATION
------------------

1. Creative Commons License of the dataset:

 CC0

2. Dataset DOI: 10.5281/zenodo.14781428

3. Related publication:

Lucrecia Rallo Fabra, Michael D. Tyler,
Predicting discrimination difficulty of Californian English vowel contrasts from L2-to-L1 categorization,
Ampersand,
Volume 10,
2023,
100109,
ISSN 2215-0390,
https://doi.org/10.1016/j.amper.2023.100109.

VERSIONING AND PROVENANCE
-------------------------

1. Last modification date:
2025-01-31

2. Was data derived from another source?:
No

METHODOLOGICAL INFORMATION
--------------------------

1. Description of methods used for collection-generation of data: 

The data are the results of a categorisation experiments and an ABX discrimination experiment (for more detail, please check the published paper in the Ampersand journal)

2. Methods for processing the data: 

The perception tests were run with Firefox. When completing each test, a csv file was generated for each participant and appended to a single Excel file. 

The overall results were processed in Excel and SPSS. 

Please check the above cited paper for more detailed information. 

3. Instrument- or software- specific information needed to interpret the data:

Excel or similar

FILE OVERVIEW
--------------

1. Explain the file naming convention, if applicable:

2. File List:

	Filename: categorization_CalEnglishtoCatalan.xlsx    
	Short description: contains the results of the vowel categorization experiment based on the Perceptual Assimilation Model (PAM-L2)

	Filename: Discrimination all contrasts_all Ss
	Short description: contains the results of the ABX vowel discrimination task

3. Relationship between files:

The results of the categorisation task were used to make predictions of discrimination difficulty based on PAM-L2

4. File format:
xlxs 

TABULAR DATA-SPECIFIC INFORMATION
---------------------------------

1. File name:  categorization_CalEnglishtoCatalan.xlsx

2. Number of rows and columns: 
rows: 881
columns: 6

3. Variable list:

Variable name: stimcategory
        Description: vowel category of the stimulus
	Measurement units or value labels: I will use Wells standard lexical sets
	heeba= FLEECE, hibba=KIT, hebba=DRESS, habba=TRAP, hubba=STRUT, hobba=LOT, hooba=FOOT, whoba=GOOSE, h@bba=commA, highba=PRICE,
	howba=MOUTH, hayba=FACE, hairba=NURSE, here-ba=NEAR, herba=lettER, hoiba=CHOICE, Horba=NORTH, hoaba=GOAT, harba=START, hourba=MOUTH+/r/

Variable name: Subject
        Description: Participant number
	Measurement units or value labels: ordinal numbers

Variable name: cat
	Description: Category Type based on PAM-L2
	Measurement units or value labels: 
	C = Categorised, U = Uncategorised

Variable name: cat_type
	Description: Categorisation type based on Faris et al. (2018)
	Measurement units or value labels: 
	FOCL=FOCALISED, CLUS=CLUSTERED, DISP=DISPERSED

Variable name: cat_label
	Description: Response L1 vowel category given by the listener
	Measurement units or value labels: the eight Catalan vowel categories

Variable name: abv_ch
	Description: Above-chance response category/categories and goodness ratings
	Measurement units: % assimilation (0-100%) followed by goodness ratings (1=poor example, 7=good example)

TABULAR DATA-SPECIFIC INFORMATION
---------------------------------

1. File name:  Discrimination all contrasts_all Ss.xlsx

2. Number of rows and columns: 
rows: 406
columns: 10

3. Variable list:

Variable name: PARTICIPANT
        Description: Participant number
	Measurement units or value labels: ordinal number

Variable name: CONTRAST
        Description: Vowel contrast tested
	Measurement units or value labels: I will use Wells standard lexical sets
	heeba= FLEECE, hibba=KIT, hebba=DRESS, habba=TRAP, hubba=STRUT, hobba=LOT, hooba=FOOT, whoba=GOOSE, h@bba=commA

Variable name: HITS
	Description: number of correct discrimination trials out of 48
	Measurement units or value labels: numerical value (0-48)

Variable name: TOTAL
	Description: total number of trials per contrast
	Measurement units or value labels: numerical value (=48)

Variable name: DISC_SCORE
	DESCRIPTION: discrimination score
	Measurement units or value labels: number of hits/total number of trials

Variable name: Contrast means
	Description: Mean discrimination score
	Measurement units or value labels: discrimination score for each vowel contrast averaged across participants

Variable name: Contrast SD
	Description: Standard deviation for each vowel contrast
	Measurement units or value labels: standard deviation for each vowel contrast	

Variable name: Overlap score
	Description: percentage of times a response L1 category has been used to classify the two vowels of the contrast (see Rallo Fabra & Tyler, 2023 for more detail)
	Measurement units or value labels: Percentage ranging from 1 to 100%

Variable name: Individual assimilation:
	Description: perceptual assimilation patterns derived from PAM-L2
	Measurement units or value labels::
	C = Categorised
	U = Uncategorised
	SC = Single Category
	TC = Two-category
	CG = Category goodness
	-C = completely overlapping
	-P = partially overlapping
	-N = non-overlapping
	
Variable name: Subj-Contrast
	Description: composite variable for visualisation purposes
	Measurement units or value labels: N/A