{"spec_id":"timeline-basic","library":"plotnine","language":"python","code":"\"\"\" anyplot.ai\ntimeline-basic: Event Timeline\nLibrary: plotnine 0.15.4 | Python 3.13.13\nQuality: 95/100 | Updated: 2026-05-11\n\"\"\"\n\nimport os\nimport sys\nfrom pathlib import Path\n\n\n# Remove current directory from path to avoid importing local plotnine.py\ncurrent_dir = str(Path(__file__).parent)\nsys.path = [p for p in sys.path if p != current_dir and p != \"\"]\n\nimport pandas as pd\nfrom plotnine import (\n    aes,\n    element_blank,\n    element_line,\n    element_rect,\n    element_text,\n    geom_point,\n    geom_segment,\n    geom_text,\n    ggplot,\n    labs,\n    scale_color_manual,\n    scale_y_continuous,\n    theme,\n    theme_minimal,\n)\n\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# Okabe-Ito palette (first series is always #009E73)\nIMPRINT = [\"#009E73\", \"#C475FD\", \"#4467A3\", \"#BD8233\"]\n\n# Data - Software development project milestones with varied timing\ndata = {\n    \"date\": pd.to_datetime(\n        [\n            \"2024-01-08\",\n            \"2024-02-15\",\n            \"2024-03-08\",\n            \"2024-04-12\",\n            \"2024-05-20\",\n            \"2024-06-10\",\n            \"2024-07-18\",\n            \"2024-08-05\",\n            \"2024-09-22\",\n            \"2024-10-15\",\n            \"2024-11-08\",\n            \"2024-12-20\",\n        ]\n    ),\n    \"event\": [\n        \"Project Kickoff\",\n        \"Requirements Complete\",\n        \"Architecture Review\",\n        \"Backend Alpha\",\n        \"Frontend Alpha\",\n        \"Integration Testing\",\n        \"Beta Release\",\n        \"User Acceptance\",\n        \"Performance Tuning\",\n        \"Security Audit\",\n        \"Release Candidate\",\n        \"Production Launch\",\n    ],\n    \"category\": [\n        \"Planning\",\n        \"Planning\",\n        \"Planning\",\n        \"Development\",\n        \"Development\",\n        \"Testing\",\n        \"Development\",\n        \"Testing\",\n        \"Development\",\n        \"Testing\",\n        \"Release\",\n        \"Release\",\n    ],\n}\n\ndf = pd.DataFrame(data)\n\n# Alternate label positions above and below the axis\ndf[\"y_offset\"] = [1 if i % 2 == 0 else -1 for i in range(len(df))]\ndf[\"y_point\"] = df[\"y_offset\"] * 0.35\ndf[\"y_label\"] = df[\"y_offset\"] * 0.65\n\n# Split dataframe for alternating text positions\ndf_above = df[df[\"y_offset\"] == 1].copy()\ndf_below = df[df[\"y_offset\"] == -1].copy()\n\n# Category colors - using Okabe-Ito palette\ncategory_colors = {\n    \"Planning\": IMPRINT[0],\n    \"Development\": IMPRINT[1],\n    \"Testing\": IMPRINT[2],\n    \"Release\": IMPRINT[3],\n}\n\n# Create timeline plot\nplot = (\n    ggplot(df, aes(x=\"date\", y=0))\n    # Vertical connector lines from axis to points\n    + geom_segment(aes(x=\"date\", xend=\"date\", y=0, yend=\"y_point\"), color=INK_SOFT, size=0.8, alpha=0.5)\n    # Timeline axis line\n    + geom_segment(\n        aes(x=df[\"date\"].min() - pd.Timedelta(days=20), xend=df[\"date\"].max() + pd.Timedelta(days=20), y=0, yend=0),\n        color=INK_SOFT,\n        size=1.5,\n    )\n    # Event points on the timeline\n    + geom_point(aes(x=\"date\", y=\"y_point\", color=\"category\"), size=5)\n    # Event labels above the axis\n    + geom_text(data=df_above, mapping=aes(x=\"date\", y=\"y_label\", label=\"event\"), size=11, color=INK, va=\"bottom\")\n    # Event labels below the axis\n    + geom_text(data=df_below, mapping=aes(x=\"date\", y=\"y_label\", label=\"event\"), size=11, color=INK, va=\"top\")\n    # Styling\n    + scale_color_manual(values=category_colors)\n    + scale_y_continuous(limits=(-1.2, 1.2))\n    + labs(title=\"timeline-basic · plotnine · anyplot.ai\", x=\"Project Timeline 2024\", y=\"\", color=\"Phase\")\n    + theme_minimal()\n    + theme(\n        figure_size=(16, 9),\n        plot_background=element_rect(fill=PAGE_BG, color=PAGE_BG),\n        panel_background=element_rect(fill=PAGE_BG, color=PAGE_BG),\n        plot_title=element_text(size=24, ha=\"center\", color=INK),\n        axis_title_x=element_text(size=20, color=INK),\n        axis_text_x=element_text(size=16, color=INK_SOFT),\n        axis_text_y=element_blank(),\n        axis_ticks_major_y=element_blank(),\n        axis_line_y=element_blank(),\n        panel_grid_major_y=element_blank(),\n        panel_grid_minor_y=element_blank(),\n        panel_grid_major_x=element_line(color=INK_SOFT, alpha=0.1, size=0.3),\n        panel_grid_minor_x=element_blank(),\n        legend_background=element_rect(fill=ELEVATED_BG, color=INK_SOFT),\n        legend_title=element_text(size=18, color=INK),\n        legend_text=element_text(size=16, color=INK_SOFT),\n        legend_position=\"bottom\",\n    )\n)\n\n# Save\nplot.save(f\"plot-{THEME}.png\", dpi=300, verbose=False)\n"}