Skip to content

L2SCA & LCA fork: cross-platform, GUI, without Java dependency

License

Notifications You must be signed in to change notification settings

tanloong/neosca

Repository files navigation

NeoSCA

build lint codecov codacy commit platform downloads license

NeoSCA is a fork of Xiaofei Lu's L2 Syntactic Complexity Analyzer (L2SCA) and Lexical Complexity Analyzer (LCA). Starting from version 0.1.0, NeoSCA has a graphical interface and no longer requires Java installation, it has translated a portion of the Tregex code into Python and favors Stanza over Stanford Parser.

Usage

GUI

Download and run the packaged application

Release Remarks
Latest Release for Windows 10/11 1. Extract all files
2. Double-click NeoSCA/NeoSCA.exe to run
Latest Release for macOS>=10.15.7 1. Extract all files
2. Search and open Terminal in Launchpad, then type xattr -rc (note the trailing whitespace), drag the whole NeoSCA directory to the Terminal, and press Enter
3. Double-click NeoSCA.app to run
Latest Release for Arch Linux 1. Extract all files
2. Double-click NeoSCA/NeoSCA to run
Past Releases Not recommended
Baidu Netdisk For users with unstable connections to GitHub

Note

On macOS if NeoSCA pops up an error saying OSError: [Errno 30] Read-only file system, please open the Preferences - Settings - Miscellaneous setting page and uncheck the Cache uncached files for faster future runs box. The caching fails without the write permission for the hardcoded cache path. This issue will be fixed in the next release.

Command Line

Install NeoSCA from the source code

pip install git+https://github.com/tanloong/neosca

Run SCA or LCA by

python -m neosca sca filepath.txt
python -m neosca sca --text 'This is a test.'
python -m neosca lca filepath.txt
python -m neosca lca --text 'This is a test.'

To see other command line options please use

python -m neosca --help
python -m neosca sca --help
python -m neosca lca --help

Citing

If you use NeoSCA in your research, please cite as follows.

BibTeX
@misc{long2024neosca,
title        = {NeoSCA: A Fork of L2 Syntactic Complexity Analyzer, version 0.1.4},
author       = {Long Tan},
howpublished = {\url{https://github.com/tanloong/neosca}},
year         = {2024}
}
APA (7th edition)
Tan, L. (2024). NeoSCA (version 0.1.4) [Computer software]. GitHub. https://github.com/tanloong/neosca
MLA (9th edition)
Tan, Long. NeoSCA. version 0.1.4, GitHub, 2024, https://github.com/tanloong/neosca.

If you use the Syntactic Complexity Analyzer module of NeoSCA, please cite Xiaofei's article describing L2SCA as well.

BibTeX
@article{xiaofei2010automatic,
title     = {Automatic analysis of syntactic complexity in second language writing},
author    = {Xiaofei Lu},
journal   = {International journal of corpus linguistics},
volume    = {15},
number    = {4},
pages     = {474--496},
year      = {2010},
publisher = {John Benjamins Publishing Company},
doi       = {10.1075/ijcl.15.4.02lu},
}
APA (7th edition)
Lu, X. (2010). Automatic analysis of syntactic complexity in second language writing. International Journal of Corpus Linguistics, 15(4), 474-496. https://doi.org/10.1075/ijcl.15.4.02lu
MLA (9th edition)
Lu, Xiaofei. "Automatic Analysis of Syntactic Complexity in Second Language Writing." International Journal of Corpus Linguistics, vol. 15, no. 4, John Benjamins Publishing Company, 2010, pp. 474-96, https://doi.org/10.1075/ijcl.15.4.02lu

If you use the Lexical Complexity Analyzer module of NeoSCA, please also cite Xiaofei's article about LCA.

BibTeX
@article{xiaofei2012relationship,
author  = {Xiaofei Lu},
title   = {The Relationship of Lexical Richness to the Quality of ESL Learners' Oral Narratives},
journal = {The Modern Language Journal},
volume  = {96},
number  = {2},
pages   = {190-208},
doi     = {https://doi.org/10.1111/j.1540-4781.2011.01232\_1.x},
year    = {2012}
}
APA (7th edition)
Lu, X. (2012). The relationship of lexical richness to the quality of ESL learners' oral narratives. The Modern Language Journal, 96(2), 190-208.
MLA (9th edition)
Lu, Xiaofei. "The Relationship of Lexical Richness to the Quality of ESL Learners' Oral Narratives." The Modern Language Journal, vol. 96, no. 2, Wiley-Blackwell, 2012, pp. 190-208.

Contact

You can send bug reports, feature requests, or any questions via: