Parse a coordinate string into an (x, y) tuple. Args: coord_str: String in format "(x,y)" Returns: Tuple of (x, y) integers Ra

Apply pixelation and color quantization to an image.

Convert a quadrant selection to infill dimensions. Args: selected_positions: List of selected quadrant positions quadrant_size: Size of

Render a quadrant and save to database. This renders the tile containing the quadrant and saves all 4 quadrants. Args: conn: Database con

Set the state of a quadrant at position (x, y).

Convert to JSON-serializable dict.

Validate that the current selection is legal for generation. A selection is legal if: 1. Selected quadrants form a contiguous region

Find context quadrants that don't have generated pixels. Returns list of (qx, qy) positions that are in the template but not in the infi

Check if a water mask can be generated at point p. A water mask can be generated if 3 of 4 quadrants in at least one 2x2 block containing p al

Check if a 1x1 tile can be placed at point p with valid context. A 1x1 tile requires that 3 of 4 quadrants in at least one 2x2 block containin

Convenience function to create a plan from coordinate tuples. Args: tl: Top-left corner (x, y) br: Bottom-right corner (x, y)

Ensure the dark_mode column exists in the quadrants table (migration).

Ensure the starred column exists in the quadrants table (migration).

Ensure the water_mask and water_type columns exist in the quadrants table (migration).

Ensure the web server for rendering is running.

Extract RGB palette from a quantized palette image. Args: palette_img: A quantized PIL Image with a palette Returns: Li

Create from JSON dict.

Create an infill region for a single quadrant.

Get all 2x2 blocks that contain the point p. A point can be in up to 4 different 2x2 blocks: - As top-left - As top-right - As bottom-left

Get the default bounds directory.

Get the generations subdirectory.

Get the generations subdirectory.

Get the optimal pixel position for the infill region in the template. Uses InfillPositioner to find the best position that: - Maximizes

Get the inputs subdirectory.

Get the inputs subdirectory.

Calculate maximum allowed rectangle area (1/2 of total).

Get a model configuration by its ID.

Get a summary of the plan for display.

Get a quadrant by its (x, y) position. Returns the quadrant's anchor coordinates and metadata.

Get all quadrants that already have water mask data. Returns: Set of Points for quadrants with existing water masks.

Generate a static map URL for satellite view.

Get progress counts for each step.

Get count of steps by status.

Get the CREATE TABLE statement for a table.

Generate filename from quadrant sources.

Check if a quadrant has any generated neighbors (4-connected).

Create a function to check if a quadrant has generation in the database.

Load the application configuration from app_config.json. Args: config_path: Path to the config file. If None, looks in the generation dir.

Print a progress summary.

Save quadrant entries to a JSON file. Args: json_path: Path to the JSON file entries: List of quadrant entry dicts

Start the queue worker thread if not already running.

Stitch images from tile subdirectories into a single large image. Args: tile_dir: Directory containing tile subdirectories (000_000, 000_0

Update the status of a specific step.

Validate that all steps in a plan have valid 2x2 context for generation. Each generation step must have at least one 2x2 block where all 4 quadr

Try to expand the infill region to cover missing context quadrants. The expanded region must still fit within the template and not exceed

Find position along one axis. Args: margin: Available margin (template_size - infill_size) has_near_gen: Generated pixels at nea

Start the web server subprocess.

Try to find a valid placement with given context preferences. Args: include_left: Whether to try to include left context include

Add a new item to the generation queue. Args: conn: Database connection item_type: Type of operation (generate or render) quadrants:

Add a generation/render request to the queue.

Add a generation/render request to the database queue.

Desaturate an image (move towards grayscale). Args: img: Input PIL Image intensity: Desaturation intensity (0.0 = no change, 1.0 = full

Apply gamma crush to destroy the flat look and separate highlights from shadows. The "Gamma Crush" pushes dark greys to black while keeping ligh

Add multiplicative noise (grain) to an image. Uses multiplicative noise to mimic "texture loss" rather than "sensor static." This looks like g

Assign generation types when each image has a variable number of variants. This is similar to assign_generation_types but handles different vari

Build a unified palette image from sampled colors.

Calculate the geographic corners of a block. Returns corners in order: TL, TR, BR, BL for Leaflet polygon.

Calculate the new lat/lon center after shifting the view by shift_x_px and shift_y_px. This is adapted from plan_tiles.py to handle isometric pr

Check if a 1x2 horizontal tile can be generated. Layout: [left][right] IMPORTANT: Generated neighbors can ONLY be on the LONG sides (top/bott

Check if a 2x1 vertical tile can be generated. Layout: [top] [bottom] IMPORTANT: Generated neighbors can ONLY be on the LONG sides (l

Clear generation for a single quadrant.

Collect all PNG tile paths from the tiles directory.

Compute sensible default view settings for the app. Returns x, y centered on the image, and zoom at approximately 4:1 (each screen pixel

Compute a short hash for image content. Uses MD5 and returns the first 8 characters for a compact identifier that's still sufficiently unique

Count how many generated neighbors a quadrant has (4-connected).

Create a black tile (postprocessed if palette provided).

Create a template.png for the given tile directory based on neighbors. Returns: Tuple of (path to template.png, prompt string) or (None, N

Create a solid color PNG mask.

Creates a template.png for the given tile directory based on its neighbors' generation.png files. Args: tile_dir_path: Path to the tile dire

Create a test quadrant image with a solid color.

Draw a red border around a rectangular region. The border is drawn ON TOP of the image (no pixel displacement). Args: image: The image

Ensure the flagged column exists in the quadrants table (migration).

Ensure the is_water column exists in the quadrants table (migration).

Export a 2x2 tile with the starred quadrant in the top-left position. The tile includes: - (x, y) - starred quadrant (top-left) - (x+1,