Migrated from GitHub

.gitattributes

@@ -33,3 +33,20 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+fonts/Roboto-Bold.ttf filter=lfs diff=lfs merge=lfs -text
+fonts/Roboto-Light.ttf filter=lfs diff=lfs merge=lfs -text
+fonts/Roboto-Regular.ttf filter=lfs diff=lfs merge=lfs -text
+posters/barcelona_warm_beige_20260108_172924.png filter=lfs diff=lfs merge=lfs -text
+posters/chicago_noir_20260108_173313.png filter=lfs diff=lfs merge=lfs -text
+posters/dubai_midnight_blue_20260108_174920.png filter=lfs diff=lfs merge=lfs -text
+posters/marrakech_terracotta_20260108_180821.png filter=lfs diff=lfs merge=lfs -text
+posters/melbourne_forest_20260108_181459.png filter=lfs diff=lfs merge=lfs -text
+posters/mumbai_contrast_zones_20260108_170325.png filter=lfs diff=lfs merge=lfs -text
+posters/mumbai_contrast_zones_20260108_172010.png filter=lfs diff=lfs merge=lfs -text
+posters/new_york_noir_20260108_164217.png filter=lfs diff=lfs merge=lfs -text
+posters/new_york_noir_20260108_172453.png filter=lfs diff=lfs merge=lfs -text
+posters/san_francisco_sunset_20260108_184122.png filter=lfs diff=lfs merge=lfs -text
+posters/singapore_neon_cyberpunk_20260108_184503.png filter=lfs diff=lfs merge=lfs -text
+posters/tokyo_japanese_ink_20260108_165830.png filter=lfs diff=lfs merge=lfs -text
+posters/venice_blueprint_20260108_165527.png filter=lfs diff=lfs merge=lfs -text
+posters/washington_blueprint_20260108_184314.png filter=lfs diff=lfs merge=lfs -text

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ankur Gupta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ORIGINAL_README.md

@@ -0,0 +1,254 @@
+# City Map Poster Generator
+
+Generate beautiful, minimalist map posters for any city in the world.
+
+<img src="posters/singapore_neon_cyberpunk_20260108_184503.png" width="250">
+<img src="posters/dubai_midnight_blue_20260108_174920.png" width="250">
+
+## Examples
+
+
+| Country      | City           | Theme           | Poster |
+|:------------:|:--------------:|:---------------:|:------:|
+| USA          | San Francisco  | sunset          | <img src="posters/san_francisco_sunset_20260108_184122.png" width="250"> |
+| Spain        | Barcelona      | warm_beige      | <img src="posters/barcelona_warm_beige_20260108_172924.png" width="250"> |
+| Italy        | Venice         | blueprint       | <img src="posters/venice_blueprint_20260108_165527.png" width="250"> |
+| Japan        | Tokyo          | japanese_ink    | <img src="posters/tokyo_japanese_ink_20260108_165830.png" width="250"> |
+| India        | Mumbai         | contrast_zones  | <img src="posters/mumbai_contrast_zones_20260108_170325.png" width="250"> |
+| Morocco      | Marrakech      | terracotta      | <img src="posters/marrakech_terracotta_20260108_180821.png" width="250"> |
+| Singapore    | Singapore      | neon_cyberpunk  | <img src="posters/singapore_neon_cyberpunk_20260108_184503.png" width="250"> |
+| Australia    | Melbourne      | forest          | <img src="posters/melbourne_forest_20260108_181459.png" width="250"> |
+| UAE          | Dubai          | midnight_blue   | <img src="posters/dubai_midnight_blue_20260108_174920.png" width="250"> |
+
+## Installation
+
+```bash
+pip install -r requirements.txt
+```
+
+## Usage
+
+```bash
+python create_map_poster.py --city <city> --country <country> [options]
+```
+
+### Options
+
+| Option | Short | Description | Default |
+|--------|-------|-------------|---------|
+| `--city` | `-c` | City name | required |
+| `--country` | `-C` | Country name | required |
+| `--theme` | `-t` | Theme name | feature_based |
+| `--distance` | `-d` | Map radius in meters | 29000 |
+| `--list-themes` | | List all available themes | |
+
+### Examples
+
+```bash
+# Iconic grid patterns
+python create_map_poster.py -c "New York" -C "USA" -t noir -d 12000           # Manhattan grid
+python create_map_poster.py -c "Barcelona" -C "Spain" -t warm_beige -d 8000   # Eixample district
+
+# Waterfront & canals
+python create_map_poster.py -c "Venice" -C "Italy" -t blueprint -d 4000       # Canal network
+python create_map_poster.py -c "Amsterdam" -C "Netherlands" -t ocean -d 6000  # Concentric canals
+python create_map_poster.py -c "Dubai" -C "UAE" -t midnight_blue -d 15000     # Palm & coastline
+
+# Radial patterns
+python create_map_poster.py -c "Paris" -C "France" -t pastel_dream -d 10000   # Haussmann boulevards
+python create_map_poster.py -c "Moscow" -C "Russia" -t noir -d 12000          # Ring roads
+
+# Organic old cities
+python create_map_poster.py -c "Tokyo" -C "Japan" -t japanese_ink -d 15000    # Dense organic streets
+python create_map_poster.py -c "Marrakech" -C "Morocco" -t terracotta -d 5000 # Medina maze
+python create_map_poster.py -c "Rome" -C "Italy" -t warm_beige -d 8000        # Ancient layout
+
+# Coastal cities
+python create_map_poster.py -c "San Francisco" -C "USA" -t sunset -d 10000    # Peninsula grid
+python create_map_poster.py -c "Sydney" -C "Australia" -t ocean -d 12000      # Harbor city
+python create_map_poster.py -c "Mumbai" -C "India" -t contrast_zones -d 18000 # Coastal peninsula
+
+# River cities
+python create_map_poster.py -c "London" -C "UK" -t noir -d 15000              # Thames curves
+python create_map_poster.py -c "Budapest" -C "Hungary" -t copper_patina -d 8000  # Danube split
+
+# List available themes
+python create_map_poster.py --list-themes
+```
+
+### Distance Guide
+
+| Distance | Best for |
+|----------|----------|
+| 4000-6000m | Small/dense cities (Venice, Amsterdam center) |
+| 8000-12000m | Medium cities, focused downtown (Paris, Barcelona) |
+| 15000-20000m | Large metros, full city view (Tokyo, Mumbai) |
+
+## Themes
+
+17 themes available in `themes/` directory:
+
+| Theme | Style |
+|-------|-------|
+| `feature_based` | Classic black & white with road hierarchy |
+| `gradient_roads` | Smooth gradient shading |
+| `contrast_zones` | High contrast urban density |
+| `noir` | Pure black background, white roads |
+| `midnight_blue` | Navy background with gold roads |
+| `blueprint` | Architectural blueprint aesthetic |
+| `neon_cyberpunk` | Dark with electric pink/cyan |
+| `warm_beige` | Vintage sepia tones |
+| `pastel_dream` | Soft muted pastels |
+| `japanese_ink` | Minimalist ink wash style |
+| `forest` | Deep greens and sage |
+| `ocean` | Blues and teals for coastal cities |
+| `terracotta` | Mediterranean warmth |
+| `sunset` | Warm oranges and pinks |
+| `autumn` | Seasonal burnt oranges and reds |
+| `copper_patina` | Oxidized copper aesthetic |
+| `monochrome_blue` | Single blue color family |
+
+## Output
+
+Posters are saved to `posters/` directory with format:
+```
+{city}_{theme}_{YYYYMMDD_HHMMSS}.png
+```
+
+## Adding Custom Themes
+
+Create a JSON file in `themes/` directory:
+
+```json
+{
+  "name": "My Theme",
+  "description": "Description of the theme",
+  "bg": "#FFFFFF",
+  "text": "#000000",
+  "gradient_color": "#FFFFFF",
+  "water": "#C0C0C0",
+  "parks": "#F0F0F0",
+  "road_motorway": "#0A0A0A",
+  "road_primary": "#1A1A1A",
+  "road_secondary": "#2A2A2A",
+  "road_tertiary": "#3A3A3A",
+  "road_residential": "#4A4A4A",
+  "road_default": "#3A3A3A"
+}
+```
+
+## Project Structure
+
+```
+map_poster/
+├── create_map_poster.py          # Main script
+├── themes/               # Theme JSON files
+├── fonts/                # Roboto font files
+├── posters/              # Generated posters
+└── README.md
+```
+
+## Hacker's Guide
+
+Quick reference for contributors who want to extend or modify the script.
+
+### Architecture Overview
+
+```
+┌─────────────────┐     ┌──────────────┐     ┌─────────────────┐
+│   CLI Parser    │────▶│  Geocoding   │────▶│  Data Fetching  │
+│   (argparse)    │     │  (Nominatim) │     │    (OSMnx)      │
+└─────────────────┘     └──────────────┘     └─────────────────┘
+                                                     │
+                        ┌──────────────┐             ▼
+                        │    Output    │◀────┌─────────────────┐
+                        │  (matplotlib)│     │   Rendering     │
+                        └──────────────┘     │  (matplotlib)   │
+                                             └─────────────────┘
+```
+
+### Key Functions
+
+| Function | Purpose | Modify when... |
+|----------|---------|----------------|
+| `get_coordinates()` | City → lat/lon via Nominatim | Switching geocoding provider |
+| `create_poster()` | Main rendering pipeline | Adding new map layers |
+| `get_edge_colors_by_type()` | Road color by OSM highway tag | Changing road styling |
+| `get_edge_widths_by_type()` | Road width by importance | Adjusting line weights |
+| `create_gradient_fade()` | Top/bottom fade effect | Modifying gradient overlay |
+| `load_theme()` | JSON theme → dict | Adding new theme properties |
+
+### Rendering Layers (z-order)
+
+```
+z=11  Text labels (city, country, coords)
+z=10  Gradient fades (top & bottom)
+z=3   Roads (via ox.plot_graph)
+z=2   Parks (green polygons)
+z=1   Water (blue polygons)
+z=0   Background color
+```
+
+### OSM Highway Types → Road Hierarchy
+
+```python
+# In get_edge_colors_by_type() and get_edge_widths_by_type()
+motorway, motorway_link     → Thickest (1.2), darkest
+trunk, primary              → Thick (1.0)
+secondary                   → Medium (0.8)
+tertiary                    → Thin (0.6)
+residential, living_street  → Thinnest (0.4), lightest
+```
+
+### Adding New Features
+
+**New map layer (e.g., railways):**
+```python
+# In create_poster(), after parks fetch:
+try:
+    railways = ox.features_from_point(point, tags={'railway': 'rail'}, dist=dist)
+except:
+    railways = None
+
+# Then plot before roads:
+if railways is not None and not railways.empty:
+    railways.plot(ax=ax, color=THEME['railway'], linewidth=0.5, zorder=2.5)
+```
+
+**New theme property:**
+1. Add to theme JSON: `"railway": "#FF0000"`
+2. Use in code: `THEME['railway']`
+3. Add fallback in `load_theme()` default dict
+
+### Typography Positioning
+
+All text uses `transform=ax.transAxes` (0-1 normalized coordinates):
+```
+y=0.14  City name (spaced letters)
+y=0.125 Decorative line
+y=0.10  Country name
+y=0.07  Coordinates
+y=0.02  Attribution (bottom-right)
+```
+
+### Useful OSMnx Patterns
+
+```python
+# Get all buildings
+buildings = ox.features_from_point(point, tags={'building': True}, dist=dist)
+
+# Get specific amenities
+cafes = ox.features_from_point(point, tags={'amenity': 'cafe'}, dist=dist)
+
+# Different network types
+G = ox.graph_from_point(point, dist=dist, network_type='drive')  # roads only
+G = ox.graph_from_point(point, dist=dist, network_type='bike')   # bike paths
+G = ox.graph_from_point(point, dist=dist, network_type='walk')   # pedestrian
+```
+
+### Performance Tips
+
+- Large `dist` values (>20km) = slow downloads + memory heavy
+- Cache coordinates locally to avoid Nominatim rate limits
+- Use `network_type='drive'` instead of `'all'` for faster renders
+- Reduce `dpi` from 300 to 150 for quick previews

create_map_poster.py

@@ -0,0 +1,471 @@
+import osmnx as ox
+import matplotlib.pyplot as plt
+from matplotlib.font_manager import FontProperties
+import matplotlib.colors as mcolors
+import numpy as np
+from geopy.geocoders import Nominatim
+from tqdm import tqdm
+import time
+import json
+import os
+from datetime import datetime
+import argparse
+
+THEMES_DIR = "themes"
+FONTS_DIR = "fonts"
+POSTERS_DIR = "posters"
+
+def load_fonts():
+    """
+    Load Roboto fonts from the fonts directory.
+    Returns dict with font paths for different weights.
+    """
+    fonts = {
+        'bold': os.path.join(FONTS_DIR, 'Roboto-Bold.ttf'),
+        'regular': os.path.join(FONTS_DIR, 'Roboto-Regular.ttf'),
+        'light': os.path.join(FONTS_DIR, 'Roboto-Light.ttf')
+    }
+    
+    # Verify fonts exist
+    for weight, path in fonts.items():
+        if not os.path.exists(path):
+            print(f"⚠ Font not found: {path}")
+            return None
+    
+    return fonts
+
+FONTS = load_fonts()
+
+def generate_output_filename(city, theme_name):
+    """
+    Generate unique output filename with city, theme, and datetime.
+    """
+    if not os.path.exists(POSTERS_DIR):
+        os.makedirs(POSTERS_DIR)
+    
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    city_slug = city.lower().replace(' ', '_')
+    filename = f"{city_slug}_{theme_name}_{timestamp}.png"
+    return os.path.join(POSTERS_DIR, filename)
+
+def get_available_themes():
+    """
+    Scans the themes directory and returns a list of available theme names.
+    """
+    if not os.path.exists(THEMES_DIR):
+        os.makedirs(THEMES_DIR)
+        return []
+    
+    themes = []
+    for file in sorted(os.listdir(THEMES_DIR)):
+        if file.endswith('.json'):
+            theme_name = file[:-5]  # Remove .json extension
+            themes.append(theme_name)
+    return themes
+
+def load_theme(theme_name="feature_based"):
+    """
+    Load theme from JSON file in themes directory.
+    """
+    theme_file = os.path.join(THEMES_DIR, f"{theme_name}.json")
+    
+    if not os.path.exists(theme_file):
+        print(f"⚠ Theme file '{theme_file}' not found. Using default feature_based theme.")
+        # Fallback to embedded default theme
+        return {
+            "name": "Feature-Based Shading",
+            "bg": "#FFFFFF",
+            "text": "#000000",
+            "gradient_color": "#FFFFFF",
+            "water": "#C0C0C0",
+            "parks": "#F0F0F0",
+            "road_motorway": "#0A0A0A",
+            "road_primary": "#1A1A1A",
+            "road_secondary": "#2A2A2A",
+            "road_tertiary": "#3A3A3A",
+            "road_residential": "#4A4A4A",
+            "road_default": "#3A3A3A"
+        }
+    
+    with open(theme_file, 'r') as f:
+        theme = json.load(f)
+        print(f"✓ Loaded theme: {theme.get('name', theme_name)}")
+        if 'description' in theme:
+            print(f"  {theme['description']}")
+        return theme
+
+# Load theme (can be changed via command line or input)
+THEME = None  # Will be loaded later
+
+def create_gradient_fade(ax, color, location='bottom', zorder=10):
+    """
+    Creates a fade effect at the top or bottom of the map.
+    """
+    vals = np.linspace(0, 1, 256).reshape(-1, 1)
+    gradient = np.hstack((vals, vals))
+    
+    rgb = mcolors.to_rgb(color)
+    my_colors = np.zeros((256, 4))
+    my_colors[:, 0] = rgb[0]
+    my_colors[:, 1] = rgb[1]
+    my_colors[:, 2] = rgb[2]
+    
+    if location == 'bottom':
+        my_colors[:, 3] = np.linspace(1, 0, 256)
+        extent_y_start = 0
+        extent_y_end = 0.25
+    else:
+        my_colors[:, 3] = np.linspace(0, 1, 256)
+        extent_y_start = 0.75
+        extent_y_end = 1.0
+
+    custom_cmap = mcolors.ListedColormap(my_colors)
+    
+    xlim = ax.get_xlim()
+    ylim = ax.get_ylim()
+    y_range = ylim[1] - ylim[0]
+    
+    y_bottom = ylim[0] + y_range * extent_y_start
+    y_top = ylim[0] + y_range * extent_y_end
+    
+    ax.imshow(gradient, extent=[xlim[0], xlim[1], y_bottom, y_top], 
+              aspect='auto', cmap=custom_cmap, zorder=zorder, origin='lower')
+
+def get_edge_colors_by_type(G):
+    """
+    Assigns colors to edges based on road type hierarchy.
+    Returns a list of colors corresponding to each edge in the graph.
+    """
+    edge_colors = []
+    
+    for u, v, data in G.edges(data=True):
+        # Get the highway type (can be a list or string)
+        highway = data.get('highway', 'unclassified')
+        
+        # Handle list of highway types (take the first one)
+        if isinstance(highway, list):
+            highway = highway[0] if highway else 'unclassified'
+        
+        # Assign color based on road type
+        if highway in ['motorway', 'motorway_link']:
+            color = THEME['road_motorway']
+        elif highway in ['trunk', 'trunk_link', 'primary', 'primary_link']:
+            color = THEME['road_primary']
+        elif highway in ['secondary', 'secondary_link']:
+            color = THEME['road_secondary']
+        elif highway in ['tertiary', 'tertiary_link']:
+            color = THEME['road_tertiary']
+        elif highway in ['residential', 'living_street', 'unclassified']:
+            color = THEME['road_residential']
+        else:
+            color = THEME['road_default']
+        
+        edge_colors.append(color)
+    
+    return edge_colors
+
+def get_edge_widths_by_type(G):
+    """
+    Assigns line widths to edges based on road type.
+    Major roads get thicker lines.
+    """
+    edge_widths = []
+    
+    for u, v, data in G.edges(data=True):
+        highway = data.get('highway', 'unclassified')
+        
+        if isinstance(highway, list):
+            highway = highway[0] if highway else 'unclassified'
+        
+        # Assign width based on road importance
+        if highway in ['motorway', 'motorway_link']:
+            width = 1.2
+        elif highway in ['trunk', 'trunk_link', 'primary', 'primary_link']:
+            width = 1.0
+        elif highway in ['secondary', 'secondary_link']:
+            width = 0.8
+        elif highway in ['tertiary', 'tertiary_link']:
+            width = 0.6
+        else:
+            width = 0.4
+        
+        edge_widths.append(width)
+    
+    return edge_widths
+
+def get_coordinates(city, country):
+    """
+    Fetches coordinates for a given city and country using geopy.
+    Includes rate limiting to be respectful to the geocoding service.
+    """
+    print("Looking up coordinates...")
+    geolocator = Nominatim(user_agent="city_map_poster")
+    
+    # Add a small delay to respect Nominatim's usage policy
+    time.sleep(1)
+    
+    location = geolocator.geocode(f"{city}, {country}")
+    
+    if location:
+        print(f"✓ Found: {location.address}")
+        print(f"✓ Coordinates: {location.latitude}, {location.longitude}")
+        return (location.latitude, location.longitude)
+    else:
+        raise ValueError(f"Could not find coordinates for {city}, {country}")
+
+def create_poster(city, country, point, dist, output_file):
+    print(f"\nGenerating map for {city}, {country}...")
+    
+    # Progress bar for data fetching
+    with tqdm(total=3, desc="Fetching map data", unit="step", bar_format='{l_bar}{bar}| {n_fmt}/{total_fmt}') as pbar:
+        # 1. Fetch Street Network
+        pbar.set_description("Downloading street network")
+        G = ox.graph_from_point(point, dist=dist, dist_type='bbox', network_type='all')
+        pbar.update(1)
+        time.sleep(0.5)  # Rate limit between requests
+        
+        # 2. Fetch Water Features
+        pbar.set_description("Downloading water features")
+        try:
+            water = ox.features_from_point(point, tags={'natural': 'water', 'waterway': 'riverbank'}, dist=dist)
+        except:
+            water = None
+        pbar.update(1)
+        time.sleep(0.3)
+        
+        # 3. Fetch Parks
+        pbar.set_description("Downloading parks/green spaces")
+        try:
+            parks = ox.features_from_point(point, tags={'leisure': 'park', 'landuse': 'grass'}, dist=dist)
+        except:
+            parks = None
+        pbar.update(1)
+    
+    print("✓ All data downloaded successfully!")
+    
+    # 2. Setup Plot
+    print("Rendering map...")
+    fig, ax = plt.subplots(figsize=(12, 16), facecolor=THEME['bg'])
+    ax.set_facecolor(THEME['bg'])
+    ax.set_position([0, 0, 1, 1])
+    
+    # 3. Plot Layers
+    # Layer 1: Polygons
+    if water is not None and not water.empty:
+        water.plot(ax=ax, facecolor=THEME['water'], edgecolor='none', zorder=1)
+    if parks is not None and not parks.empty:
+        parks.plot(ax=ax, facecolor=THEME['parks'], edgecolor='none', zorder=2)
+    
+    # Layer 2: Roads with hierarchy coloring
+    print("Applying road hierarchy colors...")
+    edge_colors = get_edge_colors_by_type(G)
+    edge_widths = get_edge_widths_by_type(G)
+    
+    ox.plot_graph(
+        G, ax=ax, bgcolor=THEME['bg'],
+        node_size=0,
+        edge_color=edge_colors,
+        edge_linewidth=edge_widths,
+        show=False, close=False
+    )
+    
+    # Layer 3: Gradients (Top and Bottom)
+    create_gradient_fade(ax, THEME['gradient_color'], location='bottom', zorder=10)
+    create_gradient_fade(ax, THEME['gradient_color'], location='top', zorder=10)
+    
+    # 4. Typography using Roboto font
+    if FONTS:
+        font_main = FontProperties(fname=FONTS['bold'], size=60)
+        font_top = FontProperties(fname=FONTS['bold'], size=40)
+        font_sub = FontProperties(fname=FONTS['light'], size=22)
+        font_coords = FontProperties(fname=FONTS['regular'], size=14)
+    else:
+        # Fallback to system fonts
+        font_main = FontProperties(family='monospace', weight='bold', size=60)
+        font_top = FontProperties(family='monospace', weight='bold', size=40)
+        font_sub = FontProperties(family='monospace', weight='normal', size=22)
+        font_coords = FontProperties(family='monospace', size=14)
+    
+    spaced_city = "  ".join(list(city.upper()))
+
+    # --- BOTTOM TEXT ---
+    ax.text(0.5, 0.14, spaced_city, transform=ax.transAxes,
+            color=THEME['text'], ha='center', fontproperties=font_main, zorder=11)
+    
+    ax.text(0.5, 0.10, country.upper(), transform=ax.transAxes,
+            color=THEME['text'], ha='center', fontproperties=font_sub, zorder=11)
+    
+    lat, lon = point
+    coords = f"{lat:.4f}° N / {lon:.4f}° E" if lat >= 0 else f"{abs(lat):.4f}° S / {lon:.4f}° E"
+    if lon < 0:
+        coords = coords.replace("E", "W")
+    
+    ax.text(0.5, 0.07, coords, transform=ax.transAxes,
+            color=THEME['text'], alpha=0.7, ha='center', fontproperties=font_coords, zorder=11)
+    
+    ax.plot([0.4, 0.6], [0.125, 0.125], transform=ax.transAxes, 
+            color=THEME['text'], linewidth=1, zorder=11)
+
+    # --- ATTRIBUTION (bottom right) ---
+    if FONTS:
+        font_attr = FontProperties(fname=FONTS['light'], size=8)
+    else:
+        font_attr = FontProperties(family='monospace', size=8)
+    
+    ax.text(0.98, 0.02, "© OpenStreetMap contributors", transform=ax.transAxes,
+            color=THEME['text'], alpha=0.5, ha='right', va='bottom', 
+            fontproperties=font_attr, zorder=11)
+
+    # 5. Save
+    print(f"Saving to {output_file}...")
+    plt.savefig(output_file, dpi=300, facecolor=THEME['bg'])
+    plt.close()
+    print(f"✓ Done! Poster saved as {output_file}")
+
+def print_examples():
+    """Print usage examples."""
+    print("""
+City Map Poster Generator
+=========================
+
+Usage:
+  python create_map_poster.py --city <city> --country <country> [options]
+
+Examples:
+  # Iconic grid patterns
+  python create_map_poster.py -c "New York" -C "USA" -t noir -d 12000           # Manhattan grid
+  python create_map_poster.py -c "Barcelona" -C "Spain" -t warm_beige -d 8000   # Eixample district grid
+  
+  # Waterfront & canals
+  python create_map_poster.py -c "Venice" -C "Italy" -t blueprint -d 4000       # Canal network
+  python create_map_poster.py -c "Amsterdam" -C "Netherlands" -t ocean -d 6000  # Concentric canals
+  python create_map_poster.py -c "Dubai" -C "UAE" -t midnight_blue -d 15000     # Palm & coastline
+  
+  # Radial patterns
+  python create_map_poster.py -c "Paris" -C "France" -t pastel_dream -d 10000   # Haussmann boulevards
+  python create_map_poster.py -c "Moscow" -C "Russia" -t noir -d 12000          # Ring roads
+  
+  # Organic old cities
+  python create_map_poster.py -c "Tokyo" -C "Japan" -t japanese_ink -d 15000    # Dense organic streets
+  python create_map_poster.py -c "Marrakech" -C "Morocco" -t terracotta -d 5000 # Medina maze
+  python create_map_poster.py -c "Rome" -C "Italy" -t warm_beige -d 8000        # Ancient street layout
+  
+  # Coastal cities
+  python create_map_poster.py -c "San Francisco" -C "USA" -t sunset -d 10000    # Peninsula grid
+  python create_map_poster.py -c "Sydney" -C "Australia" -t ocean -d 12000      # Harbor city
+  python create_map_poster.py -c "Mumbai" -C "India" -t contrast_zones -d 18000 # Coastal peninsula
+  
+  # River cities
+  python create_map_poster.py -c "London" -C "UK" -t noir -d 15000              # Thames curves
+  python create_map_poster.py -c "Budapest" -C "Hungary" -t copper_patina -d 8000  # Danube split
+  
+  # List themes
+  python create_map_poster.py --list-themes
+
+Options:
+  --city, -c        City name (required)
+  --country, -C     Country name (required)
+  --theme, -t       Theme name (default: feature_based)
+  --distance, -d    Map radius in meters (default: 29000)
+  --list-themes     List all available themes
+
+Distance guide:
+  4000-6000m   Small/dense cities (Venice, Amsterdam old center)
+  8000-12000m  Medium cities, focused downtown (Paris, Barcelona)
+  15000-20000m Large metros, full city view (Tokyo, Mumbai)
+
+Available themes can be found in the 'themes/' directory.
+Generated posters are saved to 'posters/' directory.
+""")
+
+def list_themes():
+    """List all available themes with descriptions."""
+    available_themes = get_available_themes()
+    if not available_themes:
+        print("No themes found in 'themes/' directory.")
+        return
+    
+    print("\nAvailable Themes:")
+    print("-" * 60)
+    for theme_name in available_themes:
+        theme_path = os.path.join(THEMES_DIR, f"{theme_name}.json")
+        try:
+            with open(theme_path, 'r') as f:
+                theme_data = json.load(f)
+                display_name = theme_data.get('name', theme_name)
+                description = theme_data.get('description', '')
+        except:
+            display_name = theme_name
+            description = ''
+        print(f"  {theme_name}")
+        print(f"    {display_name}")
+        if description:
+            print(f"    {description}")
+        print()
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(
+        description="Generate beautiful map posters for any city",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  python create_map_poster.py --city "New York" --country "USA"
+  python create_map_poster.py --city Tokyo --country Japan --theme midnight_blue
+  python create_map_poster.py --city Paris --country France --theme noir --distance 15000
+  python create_map_poster.py --list-themes
+        """
+    )
+    
+    parser.add_argument('--city', '-c', type=str, help='City name')
+    parser.add_argument('--country', '-C', type=str, help='Country name')
+    parser.add_argument('--theme', '-t', type=str, default='feature_based', help='Theme name (default: feature_based)')
+    parser.add_argument('--distance', '-d', type=int, default=29000, help='Map radius in meters (default: 29000)')
+    parser.add_argument('--list-themes', action='store_true', help='List all available themes')
+    
+    args = parser.parse_args()
+    
+    # If no arguments provided, show examples
+    if len(os.sys.argv) == 1:
+        print_examples()
+        os.sys.exit(0)
+    
+    # List themes if requested
+    if args.list_themes:
+        list_themes()
+        os.sys.exit(0)
+    
+    # Validate required arguments
+    if not args.city or not args.country:
+        print("Error: --city and --country are required.\n")
+        print_examples()
+        os.sys.exit(1)
+    
+    # Validate theme exists
+    available_themes = get_available_themes()
+    if args.theme not in available_themes:
+        print(f"Error: Theme '{args.theme}' not found.")
+        print(f"Available themes: {', '.join(available_themes)}")
+        os.sys.exit(1)
+    
+    print("=" * 50)
+    print("City Map Poster Generator")
+    print("=" * 50)
+    
+    # Load theme
+    THEME = load_theme(args.theme)
+    
+    # Get coordinates and generate poster
+    try:
+        coords = get_coordinates(args.city, args.country)
+        output_file = generate_output_filename(args.city, args.theme)
+        create_poster(args.city, args.country, coords, args.distance, output_file)
+        
+        print("\n" + "=" * 50)
+        print("✓ Poster generation complete!")
+        print("=" * 50)
+        
+    except Exception as e:
+        print(f"\n✗ Error: {e}")
+        import traceback
+        traceback.print_exc()
+        os.sys.exit(1)

fonts/Roboto-Bold.ttf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:61f89f8db49261c2f6106e8dccc35df7b2f7ed909020db40a3fc905e95f99334
+size 514260

fonts/Roboto-Light.ttf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:028f843b1990ba46e2a1c4ef1b82729c4da9a946b0d9d8dbf59e623d1095e454
+size 518580

fonts/Roboto-Regular.ttf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:56a45233d29f11b4dfb86d248e921939d115778f87325e7ae8cc108383d6664d
+size 515100

requirements.txt

@@ -0,0 +1,29 @@
+certifi==2026.1.4
+charset-normalizer==3.4.4
+contourpy==1.3.3
+cycler==0.12.1
+fonttools==4.61.1
+geographiclib==2.1
+geopandas==1.1.2
+geopy==2.4.1
+idna==3.11
+kiwisolver==1.4.9
+matplotlib==3.10.8
+networkx==3.6.1
+numpy==2.4.0
+osmnx==2.0.7
+packaging==25.0
+pandas==2.3.3
+pillow==12.1.0
+pyogrio==0.12.1
+pyparsing==3.3.1
+pyproj==3.7.2
+python-dateutil==2.9.0.post0
+pytz==2025.2
+requests==2.32.5
+scipy==1.16.3
+shapely==2.1.2
+six==1.17.0
+tqdm==4.67.1
+tzdata==2025.3
+urllib3==2.6.3

themes/autumn.json

@@ -0,0 +1,15 @@
+{
+  "name": "Autumn",
+  "description": "Burnt oranges, deep reds, golden yellows - seasonal warmth",
+  "bg": "#FBF7F0",
+  "text": "#8B4513",
+  "gradient_color": "#FBF7F0",
+  "water": "#D8CFC0",
+  "parks": "#E8E0D0",
+  "road_motorway": "#8B2500",
+  "road_primary": "#B8450A",
+  "road_secondary": "#CC7A30",
+  "road_tertiary": "#D9A050",
+  "road_residential": "#E8C888",
+  "road_default": "#CC7A30"
+}

themes/blueprint.json

@@ -0,0 +1,15 @@
+{
+  "name": "Blueprint",
+  "description": "Classic architectural blueprint - technical drawing aesthetic",
+  "bg": "#1A3A5C",
+  "text": "#E8F4FF",
+  "gradient_color": "#1A3A5C",
+  "water": "#0F2840",
+  "parks": "#1E4570",
+  "road_motorway": "#E8F4FF",
+  "road_primary": "#C5DCF0",
+  "road_secondary": "#9FC5E8",
+  "road_tertiary": "#7BAED4",
+  "road_residential": "#5A96C0",
+  "road_default": "#7BAED4"
+}

themes/contrast_zones.json

@@ -0,0 +1,15 @@
+{
+  "name": "Contrast Zones",
+  "description": "Strong contrast showing urban density - darker in center, lighter at edges",
+  "bg": "#FFFFFF",
+  "text": "#000000",
+  "gradient_color": "#FFFFFF",
+  "water": "#B0B0B0",
+  "parks": "#ECECEC",
+  "road_motorway": "#000000",
+  "road_primary": "#0F0F0F",
+  "road_secondary": "#252525",
+  "road_tertiary": "#404040",
+  "road_residential": "#5A5A5A",
+  "road_default": "#404040"
+}

themes/copper_patina.json

@@ -0,0 +1,15 @@
+{
+  "name": "Copper Patina",
+  "description": "Oxidized copper aesthetic - teal-green patina with copper accents",
+  "bg": "#E8F0F0",
+  "text": "#2A5A5A",
+  "gradient_color": "#E8F0F0",
+  "water": "#C0D8D8",
+  "parks": "#D8E8E0",
+  "road_motorway": "#B87333",
+  "road_primary": "#5A8A8A",
+  "road_secondary": "#6B9E9E",
+  "road_tertiary": "#88B4B4",
+  "road_residential": "#A8CCCC",
+  "road_default": "#88B4B4"
+}

themes/feature_based.json

@@ -0,0 +1,15 @@
+{
+  "name": "Feature-Based Shading",
+  "description": "Different shades for different road types and features with clear hierarchy",
+  "bg": "#FFFFFF",
+  "text": "#000000",
+  "gradient_color": "#FFFFFF",
+  "water": "#C0C0C0",
+  "parks": "#F0F0F0",
+  "road_motorway": "#0A0A0A",
+  "road_primary": "#1A1A1A",
+  "road_secondary": "#2A2A2A",
+  "road_tertiary": "#3A3A3A",
+  "road_residential": "#4A4A4A",
+  "road_default": "#3A3A3A"
+}

themes/forest.json

@@ -0,0 +1,15 @@
+{
+  "name": "Forest",
+  "description": "Deep greens and sage tones - organic botanical aesthetic",
+  "bg": "#F0F4F0",
+  "text": "#2D4A3E",
+  "gradient_color": "#F0F4F0",
+  "water": "#B8D4D4",
+  "parks": "#D4E8D4",
+  "road_motorway": "#2D4A3E",
+  "road_primary": "#3D6B55",
+  "road_secondary": "#5A8A70",
+  "road_tertiary": "#7AAA90",
+  "road_residential": "#A0C8B0",
+  "road_default": "#7AAA90"
+}

themes/gradient_roads.json

@@ -0,0 +1,15 @@
+{
+  "name": "Gradient Roads",
+  "description": "Smooth gradient from dark center to light edges with subtle features",
+  "bg": "#FFFFFF",
+  "text": "#000000",
+  "gradient_color": "#FFFFFF",
+  "water": "#D5D5D5",
+  "parks": "#EFEFEF",
+  "road_motorway": "#050505",
+  "road_primary": "#151515",
+  "road_secondary": "#2A2A2A",
+  "road_tertiary": "#404040",
+  "road_residential": "#555555",
+  "road_default": "#404040"
+}

themes/japanese_ink.json

@@ -0,0 +1,15 @@
+{
+  "name": "Japanese Ink",
+  "description": "Traditional ink wash inspired - minimalist with subtle red accent",
+  "bg": "#FAF8F5",
+  "text": "#2C2C2C",
+  "gradient_color": "#FAF8F5",
+  "water": "#E8E4E0",
+  "parks": "#F0EDE8",
+  "road_motorway": "#8B2500",
+  "road_primary": "#4A4A4A",
+  "road_secondary": "#6A6A6A",
+  "road_tertiary": "#909090",
+  "road_residential": "#B8B8B8",
+  "road_default": "#909090"
+}

themes/midnight_blue.json

@@ -0,0 +1,15 @@
+{
+  "name": "Midnight Blue",
+  "description": "Deep navy background with gold/copper roads - luxury atlas aesthetic",
+  "bg": "#0A1628",
+  "text": "#D4AF37",
+  "gradient_color": "#0A1628",
+  "water": "#061020",
+  "parks": "#0F2235",
+  "road_motorway": "#D4AF37",
+  "road_primary": "#C9A227",
+  "road_secondary": "#A8893A",
+  "road_tertiary": "#8B7355",
+  "road_residential": "#6B5B4F",
+  "road_default": "#8B7355"
+}

themes/monochrome_blue.json

@@ -0,0 +1,15 @@
+{
+  "name": "Monochrome Blue",
+  "description": "Single blue color family with varying saturation - clean and cohesive",
+  "bg": "#F5F8FA",
+  "text": "#1A3A5C",
+  "gradient_color": "#F5F8FA",
+  "water": "#D0E0F0",
+  "parks": "#E0EAF2",
+  "road_motorway": "#1A3A5C",
+  "road_primary": "#2A5580",
+  "road_secondary": "#4A7AA8",
+  "road_tertiary": "#7AA0C8",
+  "road_residential": "#A8C4E0",
+  "road_default": "#4A7AA8"
+}

themes/neon_cyberpunk.json

@@ -0,0 +1,15 @@
+{
+  "name": "Neon Cyberpunk",
+  "description": "Dark background with electric pink/cyan - bold night city vibes",
+  "bg": "#0D0D1A",
+  "text": "#00FFFF",
+  "gradient_color": "#0D0D1A",
+  "water": "#0A0A15",
+  "parks": "#151525",
+  "road_motorway": "#FF00FF",
+  "road_primary": "#00FFFF",
+  "road_secondary": "#00C8C8",
+  "road_tertiary": "#0098A0",
+  "road_residential": "#006870",
+  "road_default": "#0098A0"
+}

themes/noir.json

@@ -0,0 +1,15 @@
+{
+  "name": "Noir",
+  "description": "Pure black background with white/gray roads - modern gallery aesthetic",
+  "bg": "#000000",
+  "text": "#FFFFFF",
+  "gradient_color": "#000000",
+  "water": "#0A0A0A",
+  "parks": "#111111",
+  "road_motorway": "#FFFFFF",
+  "road_primary": "#E0E0E0",
+  "road_secondary": "#B0B0B0",
+  "road_tertiary": "#808080",
+  "road_residential": "#505050",
+  "road_default": "#808080"
+}

themes/ocean.json

@@ -0,0 +1,15 @@
+{
+  "name": "Ocean",
+  "description": "Various blues and teals - perfect for coastal cities",
+  "bg": "#F0F8FA",
+  "text": "#1A5F7A",
+  "gradient_color": "#F0F8FA",
+  "water": "#B8D8E8",
+  "parks": "#D8EAE8",
+  "road_motorway": "#1A5F7A",
+  "road_primary": "#2A7A9A",
+  "road_secondary": "#4A9AB8",
+  "road_tertiary": "#70B8D0",
+  "road_residential": "#A0D0E0",
+  "road_default": "#4A9AB8"
+}

themes/pastel_dream.json

@@ -0,0 +1,15 @@
+{
+  "name": "Pastel Dream",
+  "description": "Soft muted pastels with dusty blues and mauves - dreamy artistic aesthetic",
+  "bg": "#FAF7F2",
+  "text": "#5D5A6D",
+  "gradient_color": "#FAF7F2",
+  "water": "#D4E4ED",
+  "parks": "#E8EDE4",
+  "road_motorway": "#7B8794",
+  "road_primary": "#9BA4B0",
+  "road_secondary": "#B5AEBB",
+  "road_tertiary": "#C9C0C9",
+  "road_residential": "#D8D2D8",
+  "road_default": "#C9C0C9"
+}

themes/sunset.json

@@ -0,0 +1,15 @@
+{
+  "name": "Sunset",
+  "description": "Warm oranges and pinks on soft peach - dreamy golden hour aesthetic",
+  "bg": "#FDF5F0",
+  "text": "#C45C3E",
+  "gradient_color": "#FDF5F0",
+  "water": "#F0D8D0",
+  "parks": "#F8E8E0",
+  "road_motorway": "#C45C3E",
+  "road_primary": "#D87A5A",
+  "road_secondary": "#E8A088",
+  "road_tertiary": "#F0B8A8",
+  "road_residential": "#F5D0C8",
+  "road_default": "#E8A088"
+}

themes/terracotta.json

@@ -0,0 +1,15 @@
+{
+  "name": "Terracotta",
+  "description": "Mediterranean warmth - burnt orange and clay tones on cream",
+  "bg": "#F5EDE4",
+  "text": "#8B4513",
+  "gradient_color": "#F5EDE4",
+  "water": "#A8C4C4",
+  "parks": "#E8E0D0",
+  "road_motorway": "#A0522D",
+  "road_primary": "#B8653A",
+  "road_secondary": "#C9846A",
+  "road_tertiary": "#D9A08A",
+  "road_residential": "#E5C4B0",
+  "road_default": "#D9A08A"
+}

themes/warm_beige.json

@@ -0,0 +1,15 @@
+{
+  "name": "Warm Beige",
+  "description": "Earthy warm neutrals with sepia tones - vintage map aesthetic",
+  "bg": "#F5F0E8",
+  "text": "#6B5B4F",
+  "gradient_color": "#F5F0E8",
+  "water": "#DDD5C8",
+  "parks": "#E8E4D8",
+  "road_motorway": "#8B7355",
+  "road_primary": "#A08B70",
+  "road_secondary": "#B5A48E",
+  "road_tertiary": "#C9BBAA",
+  "road_residential": "#D9CFC2",
+  "road_default": "#C9BBAA"
+}