Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
x-tabdeveloping authored Nov 15, 2023
1 parent 1ba4d39 commit dda66f7
Showing 1 changed file with 7 additions and 10 deletions.
17 changes: 7 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@
# embedding-explorer
Tools for interactive visual exploration of semantic embeddings.

[Documentation](https://centre-for-humanities-computing.github.io/embedding-explorer/index.html)

## Installation

Install embedding-explorer from PyPI:
Expand All @@ -11,12 +13,12 @@ Install embedding-explorer from PyPI:
pip install embedding-explorer
```

## Semantic Explorer
## [Semantic Explorer](https://centre-for-humanities-computing.github.io/embedding-explorer/semantic_networks.html)

embedding-explorer comes with a web application built for exploring semantic relations in a corpus with the help of embeddings.
In this section I will show a couple of examples of running the app with different embedding models and corpora.

### Static Word Embeddings
### [Static Word Embeddings](https://centre-for-humanities-computing.github.io/embedding-explorer/semantic_networks.html#exploring-associations-in-static-word-embedding-models)
Let's say that you would like to explore semantic relations by investigating word embeddings generated with Word2Vec.
You can do this by passing the vocabulary of the model and the embedding matrix to embedding-explorer.

Expand All @@ -42,7 +44,7 @@ like to see on the screen.

![Screenshot of the Explorer](assets/glove_screenshot.png)

## Dynamic Embedding Models
## [Dynamic Embedding Models](https://centre-for-humanities-computing.github.io/embedding-explorer/semantic_networks.html#exploring-corpora-with-dynamic-embedding-models)

If you want to explore relations in a corpus using let's say a sentence transformer, which creates contextually aware embeddings,
you can do so by specifying a scikit-learn compatible vectorizer model instead of passing along an embedding matrix.
Expand Down Expand Up @@ -81,7 +83,7 @@ show_network_explorer(corpus=four_grams, vectorizer=model)

![Screenshot of the Explorer](assets/trf_screenshot.png)

## Projection and Clustering
## [Projection and Clustering](https://centre-for-humanities-computing.github.io/embedding-explorer/projection_clustering.html#projection-and-clustering)
:star2: New in version 0.5.0

In embedding-explorer you can now inspect corpora or embeddings by projecting them into 2D space,
Expand Down Expand Up @@ -112,7 +114,7 @@ After this you can investigate the semantic structure of your corpus interactive

![Screenshot of the Clustering](assets/clustering_app.png)

## Dashboard
## [Dashboard](https://centre-for-humanities-computing.github.io/embedding-explorer/dashboards.html)

If you have multiple models to examine the same corpus or multiple corpora, that you want to examine with the same model, then
you can create a dashboard containing all of these options, that users will be able to click on and that takes them to the appropriate explorer page.
Expand All @@ -134,8 +136,3 @@ show_dashboard(cards)
```

![Screenshot of the Dashboard](assets/dashboard_screenshot.png)


## Documentation
Thorough documentation and API reference of embedding-explorer is currently under development,
until then we do not recommend its usage in production for third parties.

0 comments on commit dda66f7

Please sign in to comment.