build-3d-point-cloud-copc

Optionally reprojects a LAS/LAZ dataset, then converts it to COPC (Cloud Optimized Point Cloud) format. DATASET_INFO runs in parallel with the conversion on the (reprojected) input. Fires a webhook on completion.

When REPROJECT_LAS transforms or corrects the data, its output is already COPC, so BUILD_COPC detects it and skips the rebuild. An input that is uploaded as COPC and needs no reprojection also skips the rebuild.

Reprojection is safe to include unconditionally: if either EPSG param is empty, REPROJECT_LAS returns the input unchanged without downloading it; if they are equal and the file's embedded CRS is valid, it inspects the file and then returns it unchanged; if the embedded CRS turns out to be invalid, it corrects it by assigning target_epsg even when no transform was requested. Whenever it transforms or corrects the data, it writes COPC. See REPROJECT_LAS for details.

Recipe name: build-3d-point-cloud-copcVersion: 1.0.0Reprojection: Optional (skipped when source_epsg/target_epsg are equal or empty and the embedded CRS is valid — see REPROJECT_LAS) Output format: COPC (Cloud Optimized Point Cloud, .copc.laz)

Steps

Step	Type	Runs
`reproject`	`REPROJECT_LAS`	First
`build_copc`	`BUILD_COPC`	After `reproject`
`dataset_info`	`DATASET_INFO`	Parallel with `build_copc` (both after `reproject`)
`call_webhook`	`CALL_WEBHOOK`	`on_exit`

Recipe (v1.0.0 snapshot)

json

{
  "name": "build-3d-point-cloud-copc",
  "version": "1.0.0",
  "definition": {
    "recipe": [
      {
        "id": "reproject",
        "type": "REPROJECT_LAS",
        "inputs":  { "input_las": "job:input_las" },
        "outputs": { "output_las": "step:reproject.output_las" },
        "param_keys": ["source_epsg", "target_epsg"]
      },
      {
        "id": "build_copc",
        "type": "BUILD_COPC",
        "inputs":  { "input_las": "step:reproject.output_las" },
        "outputs": { "output_copc": "step:build_copc.output_copc" }
      },
      {
        "id": "dataset_info",
        "type": "DATASET_INFO",
        "inputs":  { "input_las": "step:reproject.output_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_id": 39,
    "inputs": {
      "job:input_las": {
        "type": "las",
        "uri": "development/survey/dataset.las",
        "hash": "abc123"
      }
    },
    "params": {
      "reproject": {
        "source_epsg": "EPSG:2271",
        "target_epsg": "EPSG:3857"
      },
      "call_webhook": {
        "webhook_url": "https://myapp.example.com/hooks/done"
      }
    },
    "outputs": {
      "step:build_copc.output_copc": {
        "path": "development/results/survey/copc"
      },
      "step:dataset_info.metadata": {
        "path": "development/results/survey/metadata"
      }
    }
  }'

Required inputs

Artifact key	Type	Description
`job:input_las`	`las`	Source LAS/LAZ file

Required params

Step	Param	Description
`reproject`	`source_epsg`	Source CRS (e.g. `"EPSG:2271"`)
`reproject`	`target_epsg`	Target CRS (e.g. `"EPSG:3857"`)
`call_webhook`	`webhook_url`	URL to POST the job result to

Producible outputs

Artifact	Type	Description
`step:build_copc.output_copc`	`las`	COPC-encoded point cloud
`step:dataset_info.metadata`	`json`	PDAL metadata report

build-3d-point-cloud-copc ​

Steps ​

Recipe (v1.0.0 snapshot) ​

Submitting a job ​

Required inputs ​

Required params ​