Another syntactic complexity analyzer of written English language samples
Project description
NeoSCA
NeoSCA is another syntactic complexity analyzer of written English language samples.
Table of Contents
Description Top ▲
NeoSCA is a rewrite of Xiaofei Lu's L2 Syntactic Complexity Analyzer, supporting Windows, macOS, and Linux.
The same as L2SCA, NeoSCA takes written English language samples in plain text format as input, counts the frequency of the following 9 structures in the text:
- words (W)
- sentences (S)
- verb phrases (VP)
- clauses (C)
- T-units (T)
- dependent clauses (DC)
- complex T-units (CT)
- coordinate phrases (CP)
- complex nominals (CN)
and computes the following 14 syntactic complexity indices of the text:
- mean length of sentence (MLS)
- mean length of T-unit (MLT)
- mean length of clause (MLC)
- clauses per sentence (C/S)
- verb phrases per T-unit (VP/T)
- clauses per T-unit (C/T)
- dependent clauses per clause (DC/C)
- dependent clauses per T-unit (DC/T)
- T-units per sentence (T/S)
- complex T-unit ratio (CT/T)
- coordinate phrases per T-unit (CP/T)
- coordinate phrases per clause (CP/C)
- complex nominals per T-unit (CN/T)
- complex nominals per clause (CP/C)
NeoSCA vs. L2SCA Top ▲
L2SCA | NeoSCA |
---|---|
runs on macOS and Linux | runs on Windows, macOS, and Linux |
single and multiple input are handled respectively by two commands | one command for both cases, making your life easier |
runs only under its own home directory | runs under any directory |
outputs only frequencies of the "9+14" syntactic structures | add options to reserve intermediate results, i.e., Stanford Parser's parsing results and Tregex's querying results |
Installation Top ▲
- Install neosca
pip install neosca
-
Install Java 8 or later
-
Download and unzip latest versions of Stanford Parser and Stanford Tregex
4. Set `STANFORD_PARSER_HOME` and `STANFORD_TREGEX_HOME`
- Windows:
In the Environment Variables window (press Windows
+s
, type env, and press Enter
):
STANFORD_PARSER_HOME=\path\to\stanford-parser-full-2020-11-17
STANFORD_TREGEX_HOME=\path\to\stanford-tregex-2020-11-17
- Linux/macOS:
export STANFORD_PARSER_HOME=/path/to/stanford-parser-full-2020-11-17
export STANFORD_TREGEX_HOME=/path/to/stanford-tregex-2020-11-17
Usage Top ▲
The NeoSCA runs via the command nsca
.
- Single input:
nsca sample1.txt
# output will be saved in result.csv
nsca sample1.txt -o sample1.csv
# custom output file
- Multiple input:
nsca sample1.txt sample2.txt
nsca sample*.txt
# wildcard characters are supported
nsca sample[1-10].txt
- Use
-p/--reserve-parsed
to reserve parsed files of Stanford Parser. Use-m/--reserve-match
to reserve match results of Stanford Tregex.
nsca sample1.txt -p -m
- Calling
nsca
without any arguments returns the help message.
Citing Top ▲
Please use the following citation if you use NeoSCA in your work:
@misc{tan2022neosca,
author = {Tan, Long},
title = {NeoSCA},
howpublished = {\url{https://github.com/tanloong/neosca}},
year = {2022}
}
Also, you need to cite Lu's article describing L2SCA:
@article{lu2010automatic,
title={Automatic analysis of syntactic complexity in second language writing},
author={Lu, Xiaofei},
journal={International journal of corpus linguistics},
volume={15},
number={4},
pages={474--496},
year={2010},
publisher={John Benjamins}
}
License Top ▲
The same as L2SCA, NeoSCA is licensed under the GNU General Public License, version 2 or later.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.