Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kennethenevoldsen/asent
Asent is a python library for performing efficient and transparent sentiment analysis using spaCy.
https://github.com/kennethenevoldsen/asent
interpretability natural-language-processing nlp python3 sentiment-analysis spacy spacy-extensions
Last synced: 6 days ago
JSON representation
Asent is a python library for performing efficient and transparent sentiment analysis using spaCy.
- Host: GitHub
- URL: https://github.com/kennethenevoldsen/asent
- Owner: KennethEnevoldsen
- License: mit
- Created: 2021-10-13T08:31:08.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-15T20:40:35.000Z (9 months ago)
- Last Synced: 2025-01-06T08:17:20.833Z (6 days ago)
- Topics: interpretability, natural-language-processing, nlp, python3, sentiment-analysis, spacy, spacy-extensions
- Language: Python
- Homepage: https://kennethenevoldsen.github.io/asent/
- Size: 54.2 MB
- Stars: 117
- Watchers: 4
- Forks: 16
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: citation.cff
Awesome Lists containing this project
README
# Asent: Fast, flexible and transparent sentiment analysis
[](https://pypi.org/project/asent/)
[](https://github.com/kennethenevoldsen/asent)
[](https://black.readthedocs.io/en/stable/the_black_code_style/current_style.html)
[](https://github.com/kennethenevoldsen/asent/actions)
[](https://kennethenevoldsen.github.io/asent/)
[](https://pypi.org/project/asent/)
Asent is a rule-based sentiment analysis library for Python made using [SpaCy](https://spacy.io).
It is inspired by [Vader](https://github.com/cjhutto/vaderSentiment), but uses a more modular ruleset, that allows the user to change e.g. the method for finding negations. Furthermore, it includes visualizers to visualize model predictions, making the model easily interpretable.
## Installation
Installing Asent is simple using pip:
```
pip install asent
```
There is no reason to update from GitHub as the version on pypi should always be the same of on GitHub.
## Simple Example
The following shows a simple example of how you can quickly apply sentiment analysis using asent. For more on using asent see the [usage guides].
```python
import spacy
import asent
# create spacy pipeline
nlp = spacy.blank('en')
nlp.add_pipe('sentencizer')
# add the rule-based sentiment model
nlp.add_pipe("asent_en_v1")
# try an example
text = "I am not very happy, but I am also not especially sad"
doc = nlp(text)
# print polarity of document, scaled to be between -1, and 1
print(doc._.polarity)
# neg=0.0 neu=0.631 pos=0.369 compound=0.7526
```
Naturally, a simple score can be quite unsatisfying, thus Asent implements a series of visualizer to interpret the results:
```python
# visualize model prediction
asent.visualize(doc, style="prediction")
```
If we want to know why the model comes the result it does we can use the `analysis` style:
```python
# visualize the analysis performed by the model:
asent.visualize(doc[:5], style="analysis")
```
Where the value in the parenthesis (2.7) indicates the human-rating of the word, while
the value outside the parenthesis indicates the value accounting for the negation.
Asent also accounts for contrastive conjugations (e.g. but), casing, emoji's and
punctuations. For more on how the model works check out the [usage guide].
# 📖 Documentation
| Documentation | |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| 🔧 **[Installation]** | Installation instructions for Asent |
| 📚 **[Usage Guides]** | Guides and instructions on how to use asent and its features. It also gives short introduction to how the models works. |
| 📰 **[News and changelog]** | New additions, changes and version history. |
| 🎛 **[Documentation]** | The detailed reference for Asents's API. Including function documentation |
[Documentation]: https://kennethenevoldsen.github.io/asent/index.html
[Installation]: https://kennethenevoldsen.github.io/asent/installation.html
[usage guides]: https://kennethenevoldsen.github.io/asent/introduction.html
[News and changelog]: https://kennethenevoldsen.github.io/asent/news.html
# 💬 Where to ask questions
| Type | |
| ------------------------------ | ---------------------- |
| 🚨 **FAQ** | [FAQ] |
| 🚨 **Bug Reports** | [GitHub Issue Tracker] |
| 🎁 **Feature Requests & Ideas** | [GitHub Issue Tracker] |
| 👩💻 **Usage Questions** | [GitHub Discussions] |
| 🗯 **General Discussion** | [GitHub Discussions] |
[FAQ]: https://kennethenevoldsen.github.io/asent/faq.html
[github issue tracker]: https://github.com/kennethenevoldsen/asent/issues
[github discussions]: https://github.com/kennethenevoldsen/asent/discussions