Mark an item as complete.

Mark an item as having an error.

Mark an item as in progress.

Mark a queue item as processing.

Merge adjacent rendered quadrants into larger bounding boxes.

Merge adjacent rendered quadrants into larger bounding boxes. When two adjacent quadrants (forming a half) are both rendered, they are m

Get the 4-connected neighbors of this position.

Parse an export filename to extract quadrant coordinates. Args: filename: Filename like "export_tl_-1_77_br_0_78.png" Returns: Tu

Parse a generation filename in the format <xxx>_<yyy>_<hash>.png. Args: filename: The filename to parse (e.g., "123_456_abc123.png") Retu

Parse a quadrant list string into a list of (x, y) tuples. Args: quadrant_str: String in format "(x,y),(x,y),..." or "(x,y)" Returns:

Parse quadrant string like '(0,0),(1,0)' into list of tuples.

Parse a reference coordinate string like "(0,1)" or "0,1" into a tuple. Args: ref_str: String in format "(x,y)" or "x,y" Returns: Tup

Parse a target position string into (dx, dy) offset within the tile. Args: position: One of "tl", "tr", "bl", "br" Returns: Tuple of

Parse a target position string into (dx, dy) offset within the tile. Args: position: One of "tl", "tr", "bl", "br" Returns: Tuple of

input_path: Path to the source image. output_path: Where to save the result. pixel_scale: How 'chunky' the pixels should be. Higher = blockier.

Apply pixelation and quantization to a single tile using a shared palette. Args: input_path: Path to source tile output_path: Path t

Fill remaining gaps with 1x1 tiles. A 1x1 tile can only be placed if 3 of 4 quadrants in at least one 2x2 block containing it are already gene

Place 2x1 and 1x2 tiles where possible. These tiles bridge gaps between 2x2 tiles and the generation edge.

Place as many 2x2 tiles as possible. Returns the generation steps and the set of scheduled quadrants. Strategy: 1. First pass: Place 2x2 ti

Convert PNG bytes to a PIL Image.

Convert PNG bytes to a PIL Image.

Convert PNG bytes to a PIL Image.

Convert PNG bytes to a PIL Image.

Analyze all tiles and populate water masks for ALL_WATER and ALL_LAND tiles. Args: generation_dir: Path to the generation directory dry_

Apply pixelation and color quantization to an image.

Print a progress bar with stats.

Print a progress bar with stats.

Process all tiles in parallel using the shared palette. Args: tiles_dir: Directory containing source tiles output_dir: Directory to

Process all export files and generate corresponding renders. Args: exports_dir: Directory containing export PNG files generation_dir

Process a single generation item. Returns (success, message) tuple.

Process a single quadrant, replacing the target color. Args: conn: Database connection config: Generation config x: Quadrant x

Process a JSON file of quadrant entries. The script will: - Process entries with status "pending" or "error" (retries errors) - Update statu

Process a comma-separated list of quadrant tuples. Args: generation_dir: Path to the generation directory quadrants_str: String like

Process a single queue item (generate or render).

Process a single queue item from the database.

Process a single tile with optional postprocessing and bounds clipping. Args: raw_data: Raw image bytes from database src_x: Quad

Process multiple web view exports in a single browser session. Args: tasks: List of (output_dir, view_config) tuples port: Port where we

Check if a quadrant already has generation data.

Render the bounding box visualization using the web renderer. Args: view_params: Dictionary with view parameters (lat, lon, width, height,

Render a single quadrant using the web server.

Render a quadrant and save to database. Returns the PNG bytes of the rendered quadrant.

Synchronously render a quadrant and wait for the result. This is a blocking call that waits for the render to complete. Args: qua

Render a tile with quadrant (x, y) in the top-left position. The rendered tile covers quadrants: (x, y), (x+1, y), (x, y+1), (x+1, y+1). After

Render a quadrant using the global web renderer. Returns the PNG bytes of the rendered quadrant.

Render a single tile using Playwright.

Render a tile region spanning from (tl_x, tl_y) to (br_x, br_y). For a standard 2x2 tile where br = tl + (1, 1), this renders a single tile. F

Reset ALL items in 'processing' state back to 'pending'. This should be called on server startup to ensure any items that were interrupted mid

Reset all error items to pending. Returns count of reset items.

Run the bounds editor web server. Args: generation_dir: Path to the generation directory existing_bounds_path: Optional path to existing

Run quadrant extraction tests.

Run the full generation pipeline for selected quadrants. This is a wrapper around run_generation_for_quadrants that ensures the web server is

Run a single generation step for the given quadrants. This uses the flexible TemplateBuilder approach that can handle 1, 2, or 4 quadrant sele

Wrapper to call nano banana generation with references from DB.

Run template creation tests with synthetic images. Args: output_dir: If provided, save test images to this directory Returns: True if

Run validation tests and return True if all pass.

Run water mask generation for a single quadrant. Args: conn: Database connection config: Generation config quadrant: The quadrant to

Sample colors from quadrants in the database to build a representative color set. Args: db_path: Path to the quadrants.db file. tl:

Sample colors from quadrants in the database to build a representative color set.

Sample colors from a subset of tiles to build a representative color set. Args: tile_paths: List of all tile paths sample_size: Numb

Save a GeoJSON bounds file. Args: geojson: GeoJSON dict to save name: Name for the bounds file (without extension) b

Save the palette image to disk.

Save the palette image to disk.

Save dark mode (nighttime) bytes for a quadrant at position (x, y). Creates the quadrant if it doesn't exist. Returns True if successful.

Save generation or render bytes for a quadrant.

Save generation bytes for a quadrant.

Save water mask bytes for a quadrant at position (x, y). Creates the quadrant if it doesn't exist. Sets water_type to WATER_EDGE since this is

Save the strip plan to a JSON file.

Save a tile to the cache.

Seed the quadrant database for a generation. Reads the generation_config.json, calculates all tile and quadrant positions, and populates the S

Set the state of a quadrant.