satorbis_kit.vector_operation.wherobots_geometry module

Wherobots Geometry Operations

Functions for dissolve, simplify, and buffer operations on Wherobots Cloud.

satorbis_kit.vector_operation.wherobots_geometry.buffer_points_wherobots(input_path: str, output_path: str, buffer_distance: float, distance_unit: str = 'meter', api_key: str | None = None, region: str | None = None, script_base_uri: str | None = None, runtime: str | None = None, timeout_seconds: int | None = None, job_name_prefix: str = 'buffer-points') → dict[source]

Submit a buffer generation job to Wherobots Cloud.

Parameters:

  • input_path – Input GeoParquet file path (must contain point geometries)

  • output_path – Output GeoParquet file path

  • buffer_distance – Buffer distance in the specified unit

  • distance_unit – Unit for buffer distance (meter, kilometer, foot, mile)

  • api_key – Wherobots API key (optional, uses hardcoded default if None)

  • region – Wherobots region (optional, uses hardcoded default if None)

  • script_base_uri – Base URI for scripts (optional, uses hardcoded default if None)

  • runtime – Runtime size (optional, defaults to “tiny”)

  • timeout_seconds – Job timeout (optional, defaults to 3600)

  • job_name_prefix – Job name prefix (optional)

Returns:

Dictionary with job submission result

Example

>>> result = buffer_points_wherobots(
...     input_path="s3://bucket/points.parquet",
...     output_path="s3://bucket/buffered.parquet",
...     buffer_distance=1000,
...     distance_unit="meter",
... )
satorbis_kit.vector_operation.wherobots_geometry.dissolve_simplify_wherobots(input_path: str, output_path: str, dissolve_by: str | None = None, simplify_tolerance: float | None = None, api_key: str | None = None, region: str | None = None, script_base_uri: str | None = None, runtime: str | None = None, timeout_seconds: int | None = None, job_name_prefix: str = 'dissolve-simplify') → dict[source]

Submit a dissolve and/or simplify job to Wherobots Cloud.

Parameters:

  • input_path – Input GeoParquet file path

  • output_path – Output GeoParquet file path

  • dissolve_by – Column name to dissolve by (optional)

  • simplify_tolerance – Simplify tolerance (optional, Douglas-Peucker algorithm)

  • api_key – Wherobots API key (optional, uses hardcoded default if None)

  • region – Wherobots region (optional, uses hardcoded default if None)

  • script_base_uri – Base URI for scripts (optional, uses hardcoded default if None)

  • runtime – Runtime size (optional, defaults to “tiny”)

  • timeout_seconds – Job timeout (optional, defaults to 3600)

  • job_name_prefix – Job name prefix (optional)

Returns:

Dictionary with job submission result

Example

>>> result = dissolve_simplify_wherobots(
...     input_path="s3://bucket/input.parquet",
...     output_path="s3://bucket/output.parquet",
...     dissolve_by="region_name",
...     simplify_tolerance=0.001,
... )