Timeline

# === IMPORTS ===
import pandas as pd
import numpy as np
import matplotlib.pyplot as plt
import matplotlib.dates as mdates
from datetime import datetime

# === USER-EDITABLE PARAMETERS ===
title = "Product Launch Roadmap 2024"
figsize = (14, 6)

# === EXAMPLE DATASET ===
milestones = [
    ('Kickoff Meeting', '2024-01-05', 'Planning', 'blue'),
    ('Requirements Complete', '2024-01-30', 'Planning', 'blue'),
    ('Architecture Approved', '2024-02-15', 'Planning', 'blue'),
    ('Alpha Release', '2024-04-01', 'Development', 'green'),
    ('Beta Testing Starts', '2024-05-15', 'Development', 'green'),
    ('Security Audit', '2024-06-10', 'Testing', 'orange'),
    ('Performance Optimization', '2024-07-20', 'Testing', 'orange'),
    ('Release Candidate', '2024-08-30', 'Testing', 'orange'),
    ('Documentation Complete', '2024-09-15', 'Launch', 'red'),
    ('Public Launch', '2024-10-01', 'Launch', 'red'),
]

df = pd.DataFrame(milestones, columns=['Event', 'Date', 'Phase', 'Color'])
df['Date'] = pd.to_datetime(df['Date'])

# Print summary
print("=== Product Launch Timeline ===")
print(f"\nTotal Milestones: {len(df)}")
print(f"Duration: {df['Date'].min().strftime('%b %d, %Y')} to {df['Date'].max().strftime('%b %d, %Y')}")
print(f"\nMilestones by Phase:")
for phase in df['Phase'].unique():
    count = len(df[df['Phase'] == phase])
    print(f"  {phase}: {count} milestones")

# === CREATE TIMELINE ===
fig, ax = plt.subplots(figsize=figsize)

# Create the timeline axis
ax.axhline(y=0, color='gray', linewidth=2, alpha=0.5)

# Alternate label positions above/below
positions = [1 if i % 2 == 0 else -1 for i in range(len(df))]

# Plot milestones
for idx, (_, row) in enumerate(df.iterrows()):
    pos = positions[idx]
    
    # Marker on timeline
    ax.scatter(row['Date'], 0, s=100, c=row['Color'], zorder=5, edgecolors='white', linewidth=2)
    
    # Vertical connector
    ax.plot([row['Date'], row['Date']], [0, pos * 0.4], color=row['Color'], linewidth=2)
    
    # Label box
    ax.annotate(
        f"{row['Event']}\n{row['Date'].strftime('%b %d')}",
        xy=(row['Date'], 0),
        xytext=(row['Date'], pos * 0.5),
        ha='center',
        va='bottom' if pos > 0 else 'top',
        fontsize=9,
        fontweight='bold',
        bbox=dict(boxstyle='round,pad=0.3', facecolor='white', edgecolor=row['Color'], alpha=0.9)
    )

# Format x-axis
ax.xaxis.set_major_locator(mdates.MonthLocator())
ax.xaxis.set_major_formatter(mdates.DateFormatter('%b'))
ax.set_xlim(datetime(2024, 1, 1), datetime(2024, 11, 1))

# Remove y-axis
ax.set_ylim(-1, 1)
ax.set_yticks([])
ax.spines['left'].set_visible(False)
ax.spines['right'].set_visible(False)
ax.spines['top'].set_visible(False)

# Add legend
from matplotlib.patches import Patch
legend_elements = [
    Patch(facecolor='blue', label='Planning'),
    Patch(facecolor='green', label='Development'),
    Patch(facecolor='orange', label='Testing'),
    Patch(facecolor='red', label='Launch')
]
ax.legend(handles=legend_elements, loc='upper right', framealpha=0.9)

plt.title(title, fontsize=16, fontweight='bold', pad=20)
plt.tight_layout()
plt.show()
# END-OF-CODE

=== Product Launch Timeline ===

Total Milestones: 10
Duration: Jan 05, 2024 to Oct 01, 2024

Milestones by Phase:
  Planning: 3 milestones
  Development: 2 milestones
  Testing: 3 milestones
  Launch: 2 milestones