Calculate the lat/lng anchor for a quadrant at position (quadrant_x, quadrant_y). The anchor is the bottom-right corner of the quadrant. For t

Calculate the minimum grid size needed to cover the ground area. Args: lat: Latitude in degrees zoom: Google Maps zoom level tile_si

Calculate the pixel bounding box of selected quadrants within a template. Args: selected_positions: List of selected quadrant positions

Calculate the tile anchor (top-left quadrant) given a target quadrant and its position. For example, if target is (0, 0) and target_position is

Calculate the tile anchor (top-left quadrant) given a target quadrant and its position. For example, if target is (0, 0) and target_position is

Calculate tile positions for an n_tiles_x × n_tiles_y grid. The top-left tile (row=0, col=0) is centered at the seed lat/lng. Tiles extend rig

Calculate the view parameters to show the full bounding box. Args: config: Generation config dictionary top_left: (x, y) quadrant co

Call the Modal inference endpoint.

Call the Gemini API to generate a transformed version of the image. Args: input_image: The input image to transform prompt: The gene

Call the Gemini API to generate a dark mode version of the input image. Args: input_image: The input image (daytime pixel art) to transform

Call the Gemini API to generate pixel art using the nano banana model. Args: template_image: The template image with render pixels and red b

Call the Gemini API to generate a snowy version of the input image. Args: input_image: The input image (original pixel art) to transform

Call the Gemini API to generate a water mask for the input image. Args: input_image: The input image (render or generation) to create mask f

Call the local inference API to generate pixel art. The local API expects multipart/form-data with: - file: The input image as PNG or JPEG

Call the local inference API using base64 encoding (faster than multipart). The local API expects JSON with: - image_b64: Base64-encoded inp

Call the Oxen API to generate an infill image. Args: image_url: Public URL of the infill image api_key: Oxen API key Returns:

Call the Oxen API to generate an infill image.

Call the Oxen API to generate pixel art. Args: image_url: Public URL of the input template image model_config: Optional model config

Call the Oxen API to generate pixel art.

Check if a single quadrant can be generated.

Mark all processing items as cancelled (error status). This is used when the user wants to cancel everything, including items that are current

Cancel a specific queue item by its ID. Can cancel items in 'pending' or 'processing' status. Returns True if an item was cancelled, False ot

Check if all 4 quadrants for the tile starting at (x, y) have been rendered. The tile covers quadrants: (x, y), (x+1, y), (x, y+1), (x+1, y+1)

Render a 2x2 grid of tiles and assemble them. Renders tiles at (0,0), (1,0), (0,1), (1,1) and assembles into one image.

Clear all generations in the database.

Delete completed/errored items older than max_age_seconds. Returns the number of items deleted.

Delete all pending items from the queue. Does NOT affect items that are currently processing. Returns the number of items deleted.

Clear generations for all 4 quadrants in a tile.

Composite images for a single tile directory into a 2x2 grid (1:1 aspect ratio). Layout options: Default: [Whitebox] [Render] [Generati

Compute the bounding box (top_left, bottom_right) from any two opposite corners. Args: top_left: (x, y) of top-left corner top_right

Convert a bounds polygon from lat/lng to quadrant coordinates. Args: config: Generation config dictionary bounds_polygon: Shapely Polygo

Convert a bounds polygon from lat/lng to quadrant coordinates.

Copy infill files from tile subdirs to destination with prefixed names. Args: source_dir: Parent directory containing tile subdirs (e.g.,

Copy the manifest.json to the output directory.

Count how many quadrants in a 2x2 block are generated/scheduled.

Count total and generated quadrants in the specified range. Returns: (total_in_range, with_data_count)

Count total and generated quadrants in the specified range.

Count total and generated quadrants in the specified range.

Create all 8 infill variants for a single tile directory. Returns: Number of variants successfully created.

Create a generation plan and save it to automatic_plan.json. Returns the plan, or None if no generation is needed.

Create a mask for a tile based on bounds polygon. The mask is white (255) where pixels are inside the bounds and black (0) outside. Args:

Create a mask for a tile based on bounds polygon.

Create an interactive debug map showing generated quadrants overlaid on NYC. Args: generation_dir: Path to the generation directory outp

Create an interactive debug map showing the generation plan. Args: layer_dir: Path to the layer directory output_path: Optional outp

Create an optimal generation plan to fill all empty quadrants. Strategy: 1. Fill any interior gaps first (within current generated bounds) 2

Create an infill image for a single tile directory. Output: 1024x1024 'infill.png' Left half (0-512): Left half of generation.png Right half

Create an infill variant by compositing generation and render images. Args: img_gen: The generation (pixel art) image. img_r

Create a CSV file mapping infill images to generations with prompts. Args: dest_dir: Directory containing the copied infill files. i

Create an inpainting training image. Takes the generation image and replaces the specified rectangle with pixels from the render image, then d

Create the layer configuration dictionary and save it. Args: output_dir: Path to the layer directory name: Name of the layer g

Create a metadata sidecar JSON file for the DZI. This provides information the frontend needs that isn't in the DZI file itself. If app_

Create an omni training image. Takes the generation image and replaces specified regions with input pixels, applies transformations (noise, de

Create the progress database with the generation plan. Args: db_path: Path to the database file items: List of GenerationItems to in

Create a strip generation plan. Returns the plan and the generation edge. Raises ValueError if no valid generation edge is found.

Create a template image for the selected quadrants. Args: conn: Database connection config: Generation config selected_quadrants: Li

Create a subset database with only quadrants in the specified rectangle. Args: source_db_path: Path to source quadrants.db dest_db_p

Create a tiny generation directory with a subset of quadrants. Args: source_dir: Source generation directory (e.g., generations/nyc)

Create a solid water color image.

Deploy built content to GitHub Pages branch.

Scan all tiles and detect which ones contain water using parallel processing. Args: generation_dir: Path to the generation directory thr

Calculate Euclidean distance to another point.

Download a file with progress bar.

Download a generation from R2.

Download an image from a URL and save it to the specified path. Args: url: URL of the image to download output_path: Path where the

Download an image from a URL and save it.

Download an image from a URL and return as PIL Image. Includes retry logic for transient errors (e.g., 403 Forbidden when the image is not yet

Download an image from a URL and return as PIL Image. Includes retry logic for transient errors (e.g., 403 Forbidden when the image is not yet

Draw outlines around multiple rectangular regions.

Draw an outline around a rectangular region. The outline is drawn inside the box. When the box extends to the image edge, the outline is inset

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

Draw an outline around a rectangular region. The outline is drawn inside the box. When the box extends to the image edge, the outline is