Skip to content

build-3d-point-cloud-entwine

Optionally reprojects a LAS/LAZ dataset, then converts it to an Entwine Point Tile (EPT) dataset for scalable web visualization and streaming. DATASET_INFO runs in parallel with the conversion on the (reprojected) input. Fires a webhook on completion.

Reprojection is safe to include unconditionally: if source_epsg and target_epsg are equal or empty, REPROJECT_LAS short-circuits and returns the input unchanged with no I/O cost.

Recipe name: build-3d-point-cloud-entwineVersion: 1.0.0Reprojection: Optional (passthrough when source_epsg/target_epsg are equal or empty) Output format: EPT (Entwine Point Tiles)


Steps

StepTypeRuns
reprojectREPROJECT_LASFirst
build_eptBUILD_EPTAfter reproject
dataset_infoDATASET_INFOParallel with build_ept (both after reproject)
call_webhookCALL_WEBHOOKon_exit

Recipe (v1.0.0 snapshot)

json
{
  "name": "build-3d-point-cloud-entwine",
  "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_ept",
        "type": "BUILD_EPT",
        "inputs":  { "input_las": "step:reproject.output_las" },
        "outputs": { "output_ept": "step:build_ept.output_ept" }
      },
      {
        "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": 41,
    "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_ept.output_ept": {
        "path": "development/results/survey/ept"
      },
      "step:dataset_info.metadata": {
        "path": "development/results/survey/metadata.json"
      }
    }
  }'

Required inputs

Artifact keyTypeDescription
job:input_laslasSource LAS/LAZ file

Required params

StepParamDescription
reprojectsource_epsgSource CRS (e.g. "EPSG:2271")
reprojecttarget_epsgTarget CRS (e.g. "EPSG:3857")
call_webhookwebhook_urlURL to POST the job result to

Producible outputs

ArtifactTypeDescription
step:build_ept.output_epteptEntwine Point Tile dataset directory
step:dataset_info.metadatajsonPDAL metadata report