Skip to content

Latest commit

 

History

History
83 lines (64 loc) · 3.85 KB

README.md

File metadata and controls

83 lines (64 loc) · 3.85 KB

Lextale

DOI

The main goal of Lextale package is to mark and calculate the %correctAV scoring for the English, German and Dutch LexTALE-test if administered using implementations that do not end with participants' score on the screen, e.g. online surveys. For more info about the test, see Lemhöfer & Broersma, 2012.

Functions and Arguments

lex(dataframe)

This function marks and calculates the lextale score for the English and German versions of the test. The argument takes a dataframe which must include two variables(columns):

  • ID: each ID must have 60 entries, e.g. ID 1987 repeated 60 times, with 40 IDs per time (=2400 rows).
  • answer: a variable of 0/1, with 2400 rows.

Running this function exports/saves a file named 'lex.scores.csv' to your directory. Please note both columns names are case-sensitive. Using this function returns the scores of 40 participants in one lex-click! Future work will be on accepting open number of scores, and Yes/No in the argument.

lex.dutch(dataframe) 

This function marks and calculates the lextale score for the Dutch version of the test. The function lex.dutch() takes a dataframe in its argument that must include two vectors:

  • ID: each ID must have 60 entries, e.g. ID 1987 repeated 60 times, with 40 IDs per time (=2400 rows).
  • answer: a variable of 0/1, with 2400 rows.

Running this function exports/saves a file named 'lex_dutch.scores.csv' to your directory. Please note both columns names are case-sensitive. Using this function returns the scores of 40 participants! Future work will be on accepting open number of scores, and Yes/No in the argument.

CEF() 

This function categorises the English lexTALE-scores into three CEF levels. The categorisation is based on Lemhöfer & Broersma, 2012 study. cef() argument takes a vector score (variable/column) of values from 0 to 100. The function creates two new columns, CEF.level & CEF.descr. based on the provided scores.

Running this function exports/saves a file named 'score2cef.csv' to your directory.

Installation

You can install the Lextale package from GitHub with:

# install.packages("devtools")
devtools::install_github("Ghozayel/Lextale", dependencies = TRUE)

Examples

The first 3 lines below generate fake data for the purpose of testing the functions:

answer <- sample(c(0/1), replace = TRUE, 2400) #generate 2400 random binary responses
ID <- gl(40, 60) #generate  40 ids
data <- cbind(ID, answer, score) #combine the three vectors above into one dataframe
  • lex()
#The following line calculates the score for the English and German versions of lextale-test:
Lextale::lex(data)
  • lex_dutch()
#The following line calculates the score for the lextale Dutch test:
Lextale::lex_dutch(data)
  • cef(data)
#run lex() first before running this function.
#change the column 'p.correctAV' in the resulted csv.file into 'score'
#The following line categorises English lextale-scores into 3 CEF levels, provided with *score* vector in the data:
Lextale::cef(data)

Cite as

Elotteebi, G. (2022). Lextale R-package: A package to calculates %correctAV of the LexTALE test (Version 2.0.0) [Computer software]. https://doi.org/10.5281/zenodo.7017230