Reality Capture Commands

Create photoscenes, upload photos, and process them into 3D models using the APS Reality Capture API.

Note: Reality Capture commands require 2-legged OAuth. Run raps auth test to verify credentials.

Commands Overview

CommandDescription
raps reality listList photoscenes
raps reality createCreate a new photoscene
raps reality uploadUpload photos to a photoscene
raps reality processStart processing a photoscene
raps reality statusCheck photoscene progress
raps reality resultGet result (download link)
raps reality formatsList available output formats
raps reality deleteDelete a photoscene

raps reality create

Create a new photoscene for processing.

raps reality create [OPTIONS]

Options:

  • -n, --name <NAME> β€” Photoscene name
  • -s, --scene-type <TYPE> β€” Scene type: aerial or object
  • -f, --format <FORMAT> β€” Output format: rcm, rcs, obj, fbx, ortho

Example:

$ raps reality create -n "Foundation Survey" -f obj
$ raps reality create -n "Site Aerial" -s aerial -f rcm

raps reality upload

Upload photos to an existing photoscene.

raps reality upload <PHOTOSCENE_ID> <FILE>...

Example:

$ raps reality upload abc123 ./photos/photo1.jpg ./photos/photo2.jpg

raps reality process

Start processing a photoscene after uploading all photos.

raps reality process <PHOTOSCENE_ID>

raps reality status

Check the processing progress of a photoscene.

raps reality status <PHOTOSCENE_ID>

raps reality result

Get the download link for processed results.

raps reality result <PHOTOSCENE_ID>

raps reality formats

List all available output formats.

raps reality formats

raps reality delete

Delete a photoscene and its data.

raps reality delete <PHOTOSCENE_ID> [--yes]

Typical Workflow

# 1. List available output formats
raps reality formats

# 2. Create a photoscene
raps reality create -n "Foundation Survey" -f obj

# 3. Upload photos
raps reality upload <photoscene-id> ./photos/*.jpg

# 4. Start processing
raps reality process <photoscene-id>

# 5. Check status (poll until complete)
raps reality status <photoscene-id>

# 6. Download result
raps reality result <photoscene-id>

# 7. Clean up
raps reality delete <photoscene-id> --yes

Next Steps