tmplot

tmplot is a comprehensive Python package for topic modeling analysis and visualization. Built for data scientists and researchers, it provides powerful interactive reports and advanced analytics that extend beyond traditional LDAvis/pyLDAvis capabilities.

Analyze • Visualize • Compare multiple topic models with ease

Key Features

Interactive Visualization

• Topic scatter plots with customizable coordinates and sizing
• Term probability charts with relevance weighting
• Document analysis showing top documents per topic
• Interactive reports with real-time parameter adjustment

Advanced Analytics

• Topic stability analysis across multiple model runs
• Model comparison with sophisticated distance metrics
• Saliency calculations for term importance
• Entropy metrics for model optimization

Model Support

• tomotopy: LDAModel, LLDAModel, CTModel, DMRModel, HDPModel, PTModel, SLDAModel, GDMRModel
• gensim: LdaModel, LdaMulticore
• bitermplus: BTM

Distance Metrics

• Kullback-Leibler (symmetric & non-symmetric)
• Jensen-Shannon divergence
• Jeffrey's divergence
• Hellinger & Bhattacharyya distances
• Total variation distance
• Jaccard index

Dimensionality Reduction

t-SNE, SpectralEmbedding, MDS, LocallyLinearEmbedding, Isomap

Donate

If you find this package useful, please consider donating any amount of money. This will help me spend more time on supporting open-source software.

Quick Start

Installation

# From PyPI (recommended)
pip install tmplot
# Development version
pip install git+https://github.com/maximtrp/tmplot.git

Basic Usage

importtmplotastmp# Load your topic model and documentsmodel=your_fitted_model# tomotopy, gensim, or bitermplusdocs=your_documents# Create interactive reporttmp.report(model, docs=docs)
# Or create individual visualizationscoords=tmp.prepare_coords(model)
tmp.plot_scatter_topics(coords, size_col='size')

Advanced Examples

Get Stable Topics

importtmplotastmp# Find stable topics across multiple modelsmodels= [model1, model2, model3, model4]
closest_topics, distances=tmp.get_closest_topics(models)
stable_topics, stable_distances=tmp.get_stable_topics(closest_topics, distances)

Analyze Model

# Calculate entropy for model selectionentropy_score=tmp.entropy(phi_matrix)
# Analyze topic stabilitysaliency=tmp.get_salient_terms(phi, theta)

Visualize

# Create topic distance matrix with different metricstopic_dists=tmp.get_topics_dist(phi, method='jensen-shannon')
# Generate coordinates with custom algorithmcoords=tmp.get_topics_scatter(topic_dists, theta, method='tsne')
tmp.plot_scatter_topics(coords, topic=3) # Highlight topic 3

Documentation & Examples

• Complete Tutorial - Step-by-step guide
• API Reference - Full documentation
• Example Notebooks - Jupyter examples

Requirements

Core dependencies:numpy, scipy, scikit-learn, pandas, altair, ipywidgets

Optional models:tomotopy, gensim, bitermplus