ysights.viz

YSights Visualization

This module provides visualization functions for YSocial simulation data. It includes plotting functions for paradox analysis, profile similarity, topic evolution, global trends, and recommendation system metrics.

Submodules:

• paradox_viz: Visibility paradox visualizations

• profiles_viz: Agent profile and similarity visualizations

• topics_viz: Topic density and evolution visualizations

• global_trends: Aggregate statistics and trends

• recommendations: Recommendation system visualizations

Example

Creating visualizations:

from ysights import YDataHandler
from ysights.algorithms import visibility_paradox, profile_topics_similarity
from ysights.viz import (
    paradox_histogram,
    profile_similarity_distribution,
    topic_density_temporal_evolution,
    daily_contents_trends
)

# Initialize data handler
ydh = YDataHandler('path/to/database.db')
network = ydh.social_network()

# Visualize paradox
paradox_results = visibility_paradox(ydh, network, N=100)
fig = paradox_histogram(paradox_results)
fig.show()

# Visualize profile similarity
similarities = profile_topics_similarity(ydh, network)
fig = profile_similarity_distribution(similarities)
fig.show()

# Visualize topic evolution
fig = topic_density_temporal_evolution(ydh, min_days=15)
fig.show()

# Show daily content trends
fig = daily_contents_trends(ydh)
fig.show()

Note

Most visualization functions return Plotly figure objects that can be displayed with .show(), saved with .write_html(), or further customized.

See also

• ysights.algorithms: Analysis algorithms that generate data for plots

• ysights.models: Data models and database interface

Modules

global_trends	Global Trends Visualization Functions
paradox_viz	Paradox Visualization Functions
profiles_viz	Profile Visualization Functions
recommendations	Recommendation System Visualization Functions
topics_viz	Topic Visualization Functions