Skip to content

build-copc

Converts a LAS/LAZ dataset to COPC format. Runs DATASET_INFO in parallel. Fires a webhook on completion.

Recipe name: copc-conversionVersion: 3.0.0Reprojection: No Output format: COPC (Cloud Optimized Point Cloud, .copc.laz)


Steps

StepTypeRuns
build_copcBUILD_COPCMain
dataset_infoDATASET_INFOParallel with build_copc
call_webhookCALL_WEBHOOKon_exit

Recipe (v3.0.0 snapshot)

json
{
  "name": "copc-conversion",
  "version": "3.0.0",
  "definition": {
    "recipe": [
      {
        "id": "build_copc",
        "type": "BUILD_COPC",
        "inputs": { "input_las": "job:input_las" },
        "outputs": { "output_copc": "step:build_copc.output_copc" }
      },
      {
        "id": "dataset_info",
        "type": "DATASET_INFO",
        "inputs": { "input_las": "job:input_las" },
        "outputs": { "metadata": "step:dataset_info.metadata" }
      }
    ],
    "on_exit": {
      "id": "call_webhook",
      "type": "CALL_WEBHOOK",
      "inputs": { "waits_for": "step:dataset_info.metadata" },
      "param_keys": ["webhook_url"]
    }
  }
}

Submitting a job

bash
curl -X POST https://dev.mapprism.com/ordo/jobs \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "recipe": {
      "name": "copc-conversion",
      "version": "3.0.0",
      "definition": { ... }
    },
    "inputs": {
      "job:input_las": {
        "type": "las",
        "uri": "development/survey/dataset.las",
        "hash": "abc123"
      }
    },
    "params": {
      "call_webhook": {
        "webhook_url": "https://myapp.example.com/hooks/done"
      }
    },
    "outputs": {
      "step:build_copc.output_copc": {
        "path": "development/results/survey/dataset.copc.laz"
      }
    }
  }'

Required inputs

Artifact keyTypeDescription
job:input_laslasSource LAS/LAZ file

Required params

StepParamDescription
call_webhookwebhook_urlURL to POST the job result to

Producible outputs

ArtifactTypeDescription
step:build_copc.output_copclasCOPC-encoded point cloud
step:dataset_info.metadatajsonPDAL metadata report