Metadata-Version: 2.4
Name: linguistica
Version: 5.3.0
Summary: Linguistica 5: Unsupervised Learning of Linguistic Structure
Author-email: Jackson Lee <jacksonlunlee@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://linguistica.readthedocs.io/
Project-URL: Source, https://github.com/linguistica-uchicago/lxa5
Keywords: computational linguistics,natural language processing,NLP,linguistics,phonology,morphology,corpora,speech,language,machine learning,unsupervised learning,data visualization
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Human Machine Interfaces
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Text Processing
Classifier: Topic :: Text Processing :: Filters
Classifier: Topic :: Text Processing :: General
Classifier: Topic :: Text Processing :: Indexing
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: numpy>=1.12.1
Requires-Dist: scipy>=0.19.0
Requires-Dist: networkx>=1.11
Provides-Extra: dev
Requires-Dist: black>=24.0.0; extra == "dev"
Requires-Dist: flake8>=3.3.0; extra == "dev"
Requires-Dist: mypy>=1.8; extra == "dev"
Requires-Dist: pytest>=3.0.7; extra == "dev"
Requires-Dist: pytest-cov>=2.4.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: Sphinx>=7.0; extra == "docs"
Requires-Dist: sphinx_rtd_theme>=2.0; extra == "docs"
Provides-Extra: gui
Requires-Dist: PyQt5>=5.15.10; extra == "gui"
Requires-Dist: PyQtWebEngine>=5.15.7; extra == "gui"
Dynamic: license-file

# Linguistica 5

[![PyPI version](https://badge.fury.io/py/linguistica.svg)](https://pypi.org/project/linguistica/)
[![Supported Python versions](https://img.shields.io/pypi/pyversions/linguistica.svg)](https://pypi.org/project/linguistica/)
[![Paper](https://img.shields.io/badge/paper-NAACL_2016-blue.svg)](https://aclanthology.org/N16-3005/)


Linguistica 5 is a Python library for unsupervised learning
of linguistic structure.

Full documentation: https://linguistica.readthedocs.io/

Apart from being a Python library, Linguistica 5 provides two additional
interfaces: (i) graphical user interface; (ii) command line interface.

## Download and install

Note: If you are a developer of the Linguistica project group, you should ignore
this section and set up your environment by following
[CONTRIBUTING.md](CONTRIBUTING.md).

Linguistica 5 is available through `pip`:

```bash
pip install linguistica
```

Linguistica 5 works with Python 3.12+.

The graphical user interface requires `PyQt5` and `PyQtWebEngine` (the latter
powers the word-neighbor manifold visualization). Install them together with the
`gui` extra:

```bash
pip install "linguistica[gui]"
```

These install as binary wheels on x86_64 Linux, Windows, and macOS (including Apple
Silicon).
On aarch64 Linux or Alpine/musl, where wheels are not published, `pip` may build
from source instead.

## Using Linguistica 5

To use Linguistica 5 as a Python library, simply import `linguistica`
in your Python programs:

```python
import linguistica as lxa
```

Quick library demo [here](https://linguistica.readthedocs.io/latest/demo.html).

To launch the Linguistica 5 graphical user interface
(with the `gui` extra installed):

```bash
linguistica gui
```

To launch the Linguistica 5 command line interface:

```bash
linguistica cli
```

## Citation

If you use Linguistica 5, please cite this paper:

Jackson L. Lee and John A. Goldsmith. 2016.
[Linguistica 5: Unsupervised Learning of Linguistic Structure](https://aclanthology.org/N16-3005/).
In *Proceedings of the 2016 Conference of the North American Chapter of the Association for Computational Linguistics: Demonstrations*, pages 22–26, San Diego, California. Association for Computational Linguistics.

```bibtex
@InProceedings{lee-goldsmith:2016:lxa5,
  title = "Linguistica 5: Unsupervised Learning of Linguistic Structure",
  author = "Lee, Jackson L.  and
      Goldsmith, John A.",
  editor = "DeNero, John  and
      Finlayson, Mark  and
      Reddy, Sravana",
  booktitle = "Proceedings of the 2016 Conference of the North {A}merican Chapter of the Association for Computational Linguistics: Demonstrations",
  month = jun,
  year = "2016",
  address = "San Diego, California",
  publisher = "Association for Computational Linguistics",
  url = "https://aclanthology.org/N16-3005/",
  doi = "10.18653/v1/N16-3005",
  pages = "22--26"
}
```

## Technical support

Please [open issues](https://github.com/linguistica-uchicago/lxa5/issues/new)
for questions and bug reports.
Alternatively, please feel free to contact
[Jackson Lee](http://jacksonllee.com/) and
[John Goldsmith](http://people.cs.uchicago.edu/~jagoldsm/).

## License

MIT License

See `LICENSE.txt` on the [GitHub repository](https://github.com/linguistica-uchicago/lxa5).
