srb asset — Manage Assets

List, inspect, download, bake, validate and clean registered assets; inspect cache usage.

Usage

srb asset <action> [options]

Hydra-style key=value overrides are unsupported; stray tokens are named and rejected with exit code 2.

Actions

Kind Choices

Many asset commands accept a KIND positional argument. The supported asset kinds are:

• terrain: Planetary site Digital Elevation Models (DEMs) and orthophotos.
• rocks: Procedural or photogrammetric rock sets.
• hdri: High Dynamic Range Image skydomes.
• lights: Curated environmental lighting presets.

srb asset list

List catalog assets of the specified kind.

srb asset list KIND [--body {moon,mars,earth}]

• KIND: Must be one of: terrain, rocks, hdri, lights.
• --body {moon,mars,earth}: (Optional) Restrict the listed assets to a specific celestial body.

srb asset info

Show one asset’s catalog metadata.

srb asset info KIND TARGET

• KIND: One of: terrain, rocks, hdri, lights.
• TARGET: The name of the specific site, rock set, skydome, or lighting preset to inspect.

srb asset doctor

Preflight a terrain site’s cache, local elevation meshes, coordinates and rendering.

srb asset doctor terrain [TARGET] [options]

• TARGET: (Optional) The target terrain site name to verify.
• --body {moon,mars,earth}: Specify the celestial body.
• --patch PATCH: Patch name to verify (default: default).
• --lod {low,medium,high}: Level of Detail to verify (default: medium).
• --patch-size SIZE: Patch size in meters (float).
• --center X,Y: Center coordinates in meters (e.g. 100.0,200.0).
• --no-ortho: Disable checking/generating the orthophoto.
• --seed SEED: Random seed for procedurals (default: 0).
• --deshade: Assess the illumination-corrected variant; its cache status is tracked separately.

srb asset download

Fetch a planetary asset from registry mirrors and bake it to USD/USDZ in the local cache.

srb asset download KIND [TARGET] [options]

For terrain, use either a curated TARGET or an arbitrary region with --lat, --lon, and --size-m; these forms are mutually exclusive. The region form also accepts --body, --deshade, --num-locations and --location-spread-m.

For kinds other than terrain, --force and every terrain-only option given on the command line are rejected (a --lod medium or --num-locations 1 equal to the default cannot be told apart from omitting it).

srb asset bake

Bake terrain from a local Digital Elevation Model (DEM) raster.

srb asset bake terrain --dem DEM_PATH --body {moon,mars,earth} --site-name NAME --attribution ATTR [options]

• --dem DEM_PATH: (Required) Absolute or relative path to the user-supplied DEM file (e.g., GeoTIFF).
• --body {moon,mars,earth}: (Required) Target celestial body.
• --site-name NAME: (Required) Name to register this custom terrain site under.
• --attribution ATTR: (Required) Data source/attribution string to embed in the metadata.
• --patch-size SIZE: Patch size in meters (float).
• --lod {low,medium,high}: Level of Detail for the baked mesh (default: medium).
• --seed SEED: Random seed for procedural rocks/displacement (default: 0).
• --debug: Enable verbose debug logging during mesh generation.

srb asset clean

Remove raw archives, baked USD files or all cache entries for an asset kind.

srb asset clean KIND [TARGET] [options]

• KIND: One of: terrain, rocks, hdri, lights. Only terrain is currently supported by the clean handler — the other kinds parse but exit with clean: unsupported kind.
• TARGET: (Optional) Clean baked cache only for the specified target name.
• --raw: Remove shared raw downloaded archives; omit TARGET.
• --baked: Remove only the processed, baked USD/USDZ asset cache.
• --all: Remove all cache entries (both raw and baked) for the specified kind; omit TARGET.

Raw archives are shared across terrain sites by content identity. Combining a terrain target with --raw or --all exits with a usage error. Use srb asset clean terrain TARGET --baked for a site-specific cleanup.

srb asset validate-manifest

Validate the curated planetary-sites manifest schema and integrity.

srb asset validate-manifest [--manifest MANIFEST_PATH] [--check-urls] [--check-shas]

• --manifest MANIFEST_PATH: (Optional) Path to a custom manifest YAML. If omitted, uses the default packaged manifest.
• --check-urls: Send HTTP requests to verify that all remote download mirrors and links are live and reachable.
• --check-shas: Verify the SHA256 checksums of any downloaded raw datasets against the manifest declarations.

srb asset cache-stats

Show local asset-cache paths, file counts and disk usage by kind.

srb asset cache-stats

srb asset stack

Preview the catalog layers, resolution, and estimated download size for a region. This command is offline and does not download data.

srb asset stack --body {moon,mars,earth} --lat LAT --lon LON --size SIZE [options]

• --body {moon,mars,earth}: (Required) Target celestial body.
• --lat LAT: (Required) Latitude in degrees.
• --lon LON: (Required) Longitude in degrees.
• --size SIZE: (Required) Region size in meters (capped at 8000 m; larger requests are refused).
• --lod {low,medium,high}: Level of Detail (default: medium).
• --target-gsd GSD: Override the target ground-sample distance in meters.
• --catalog PATH: Override the shipped catalog with a YAML file at PATH (mainly for testing against a fixture catalog).
• --allow-large: Preview the plan as if large downloads were approved (this command never downloads).
• --deshade: Preview the illumination-corrected variant.
• --json: Emit the plan as JSON instead of a formatted table.

The consent line is descriptive, not authorization. Fetching checks consent again; the preview never starts a download.

srb asset prefetch-fixtures

Prefetch curated manifest terrain sites at low detail (lod=low) for headless or offline use.

srb asset prefetch-fixtures