{"spec_id":"dot-matrix-proportional","library":"letsplot","language":"python","code":"\"\"\" anyplot.ai\ndot-matrix-proportional: Dot Matrix Chart for Proportional Counts\nLibrary: letsplot 4.11.0 | Python 3.14.10\nQuality: 82/100 | Updated: 2026-11-18\n\"\"\"\n\nimport os\n\nimport pandas as pd\nfrom lets_plot import *\nfrom lets_plot import element_blank, element_rect, element_text, theme\nfrom lets_plot.export import ggsave as export_ggsave\n\n\nLetsPlot.setup_html()\n\n# Theme tokens\nTHEME = os.getenv(\"ANYPLOT_THEME\", \"light\")\nPAGE_BG = \"#FAF8F1\" if THEME == \"light\" else \"#1A1A17\"\nELEVATED_BG = \"#FFFDF6\" if THEME == \"light\" else \"#242420\"\nINK = \"#1A1A17\" if THEME == \"light\" else \"#F0EFE8\"\nINK_SOFT = \"#4A4A44\" if THEME == \"light\" else \"#B8B7B0\"\n\n# Imprint palette\nIMPRINT = [\"#009E73\", \"#C475FD\", \"#4467A3\", \"#BD8233\", \"#AE3030\", \"#2ABCCD\", \"#954477\", \"#99B314\"]\n\n# Constants\nCOLS = 10  # dots per grid row\n\n# Columns\nCATEGORY = \"category\"  # role: category\nCOUNT = \"count\"  # role: count\nTOTAL = \"total\"  # role: total\n\n# Data — clinical trial side effect profile (n = 100 patients)\ndf = pd.DataFrame(\n    {CATEGORY: [\"No Side Effects\", \"Mild Effects\", \"Moderate Effects\", \"Severe Effects\"], COUNT: [72, 18, 7, 3]}\n)\n\n# Plot: one dot per unit, filled left to right and top to bottom\nvalid = df.dropna(subset=[COUNT])\ndots = valid.loc[valid.index.repeat(valid[COUNT].astype(int))].reset_index(drop=True)\ndots[\"label\"] = dots[CATEGORY].astype(str) + \"  (n=\" + dots[COUNT].astype(int).astype(str) + \")\"\ndots[\"label\"] = pd.Categorical(dots[\"label\"], categories=dots[\"label\"].unique(), ordered=True)\ndots[\"x\"] = dots.index % COLS\ndots[\"y\"] = -(dots.index // COLS)\n\nanyplot_theme = theme(\n    plot_background=element_rect(fill=PAGE_BG, color=PAGE_BG),\n    panel_background=element_rect(fill=PAGE_BG, color=PAGE_BG),\n    panel_border=element_blank(),\n    panel_grid_major=element_blank(),\n    panel_grid_minor=element_blank(),\n    axis_title=element_blank(),\n    axis_text=element_blank(),\n    axis_line=element_blank(),\n    axis_ticks=element_blank(),\n    plot_title=element_text(color=INK, size=14),\n    legend_background=element_rect(fill=ELEVATED_BG, color=INK_SOFT),\n    legend_text=element_text(color=INK_SOFT, size=10),\n    legend_title=element_blank(),\n    legend_position=\"right\",\n)\n\nplot = (\n    ggplot(dots, aes(x=\"x\", y=\"y\", color=\"label\"))\n    + geom_point(size=7, alpha=0.95)\n    + scale_color_manual(values=IMPRINT[: df.shape[0]])\n    + labs(title=\"dot-matrix-proportional · python · letsplot · anyplot.ai\")\n    + theme_void()\n    + ggsize(600, 600)\n    + anyplot_theme\n)\n\n# Save\nexport_ggsave(plot, filename=f\"plot-{THEME}.png\", path=\".\", scale=4)\nexport_ggsave(plot, filename=f\"plot-{THEME}.html\", path=\".\")\n"}