Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.generalrobotics.dev/llms.txt

Use this file to discover all available pages before exploring further.

Estimate depth from a stereo image pair using Fast-FoundationStereo. ~10x faster than the original FoundationStereo while maintaining comparable accuracy (14.6M params, real-time capable).

​
Parameters

​
left_image
str | PIL.Image | np.ndarray
required
Left stereo image.
​
right_image
str | PIL.Image | np.ndarray
required
Right stereo image.
​
aux_args
Dict[str, Any]
required
Camera parameters:
  • K — 3x3 camera intrinsics matrix
  • baseline — Stereo baseline in meters
  • hiera — Use hierarchical coarse-to-fine inference (bool)
  • valid_iters — Number of GRU refinement iterations (default 8)
​
timeout
float | None
Optional HTTP timeout.

​
Returns

np.ndarray — Depth map of shape (H, W) with dtype float32. Values in meters.

​
Example

from grid_cortex_client import CortexClient
import numpy as np
from PIL import Image

client = CortexClient()
K = np.array([[525, 0, 320], [0, 525, 240], [0, 0, 1]], dtype=np.float32)
aux = {"K": K, "baseline": 0.1, "hiera": False, "valid_iters": 8}
left = Image.open("left.jpg")
right = Image.open("right.jpg")

depth = client.run(
    model_id="fast-foundationstereo",
    left_image=left,
    right_image=right,
    aux_args=aux,
)
print(depth.shape)  # (480, 640)