Skip to content

matlab/matlab-agentic-toolkit / skills-catalog/automotive/matlab-use-scenario-builder

matlab-use-scenario-builder

Verified

Generate driving scenes, scenarios, road surfaces, and 3D content from scenariobuilder.* sensor data (GPS, camera, lidar, actor tracks) using Scenario Builder for Automated Driving Toolbox. BUILD, EXPORT, or AUGMENT a virtual scenario/scene/map: ego or actor trajectories, trajectory smoothing, OpenCRG road-surface extraction, 3D asset generation, static-object placement, point-cloud georeferencing + elevation, lane-based ego localization, sensor-fusion tracking, scenario-event extraction (cut-ins, hard brakes, near-misses, ADAS disengagements), or export to RoadRunner, drivingScenario, OpenDRIVE, OpenCRG, OpenSCENARIO, or Unreal Engine. Also: log-to-scenario, scenario harvesting, accident/near-miss reconstruction, SOTIF (ISO 21448) and ISO 26262 scenario coverage, USGS-aerial-lidar augmentation, traffic-sign placement, vision-based vehicle classification for actor assets. NOT for raw-data import or multi-sensor sync/crop/offset/timestamp normalization — route those to matlab-import-driving-data.

FileKindSize
SKILL.mdskill md56.6 KB
manifest.yamlconfig704 B
references/actortrackdata-api.mdmarkdown3.3 KB
references/example-roadrunner-scenario.mdmarkdown4.3 KB
references/example-scenario-from-gps-and-tracks.mdmarkdown9.6 KB
references/execution-rules-detail.mdmarkdown16.7 KB
references/gpsdata-api.mdmarkdown2.4 KB
references/osm-flat-scene-gotchas.mdmarkdown8.8 KB
references/per-frame-detections-to-actortrackdata.mdmarkdown7.8 KB
references/python-spkg-install-troubleshooting.mdmarkdown5.8 KB
references/trajectory-api.mdmarkdown13.7 KB
references/visualization-patterns.mdmarkdown12.4 KB
references/workflow-04-roadrunner-export-detail.mdmarkdown32.6 KB
references/workflow-07-height-correction.mdmarkdown3.3 KB
references/workflow-08-lane-localization.mdmarkdown39.1 KB
references/workflow-09-static-objects.mdmarkdown9.3 KB
references/workflow-10-road-surface-opencrg.mdmarkdown4.7 KB
references/workflow-11-point-cloud-georef.mdmarkdown4.5 KB
references/workflow-12-3d-asset-generation.mdmarkdown2.0 KB
references/workflow-13-event-extraction.mdmarkdown5.3 KB
references/workflow-14-sensor-fusion-tracking.mdmarkdown6.9 KB
references/workflow-15-driving-scenario-designer.mdmarkdown7.6 KB
references/workflow-16-aerial-lidar-augmentation.mdmarkdown14.4 KB
references/workflow-17-traffic-signs-from-sensor-data.mdmarkdown12.5 KB
references/workflow-18-vehicle-classification.mdmarkdown12.8 KB
references/workflow-19-ego-lane-inference.mdmarkdown10.0 KB
scripts/buildBestCropGrid.mother5.2 KB
scripts/openFile.mother716 B
scripts/plotActorCircles.mother3.5 KB
scripts/plotBEVAndCamera.mother4.2 KB

references/python-spkg-install-troubleshooting.md

View on GitHub
---
name: python-spkg-install-troubleshooting
description: Diagnose and fix install-time / first-run failures for Python-backed Scenario Builder support packages (RVLD lane detector via laneBoundaryDetector(Model="RVLD"), TripoSR via imageAssetGenerator). Covers the three customer-reported failure modes — proxy block, SSL connection error, PyTorch read timeout — and the documented fixes. REACTIVE: load this only when MATLAB reports a recognizable install symptom.
---

# Python Support Package Install Troubleshooting

> **Parent skill:** [`SKILL.md`](../SKILL.md). **Reactive reference** — load this when the user reports a Python-SPKG install failure or first-run download failure on:
> - `laneBoundaryDetector(Model="RVLD")` — Workflow 8 (lane localization)
> - `imageAssetGenerator` (TripoSR) — Workflow 12 (3D asset generation)
> - Any other Python-backed Scenario Builder support package that downloads PyTorch / 3P Python wheels at install or first run.
>
> **Do NOT** preemptively dump this content. Only surface the relevant row when the symptom appears in MATLAB's error/log output.

## Why these failures happen

RVLD and `imageAssetGenerator` (TripoSR) are **Python-backed** models. Installing or first-running them downloads third-party Python packages (notably PyTorch) from PyPI / `download.pytorch.org`. That download is what fails on customer networks.

## Symptom → Fix matrix

Match the **literal substring** in the customer's MATLAB error output or SPKG install log to one of these rows. If multiple rows match, fix in the order listed.

| Symptom (substring in error / log) | Root cause | Fix |
|---|---|---|
| `proxyError`, `ProxyError`, `Cannot connect to proxy`, or any 407 / proxy-related connection failure during pip / SPKG install | Customer's corporate network blocks direct outbound HTTPS; pip cannot reach PyPI / `download.pytorch.org`. | Set `http_proxy` and `https_proxy` environment variables to the customer's proxy URL **before** retrying the SPKG install. See "Setting proxy env vars" below. |
| `SSL: CERTIFICATE_VERIFY_FAILED`, `SSLError`, `SSLConnectionError`, or any TLS / certificate handshake failure | Same root cause as the proxy case — the customer's network intercepts TLS and pip rejects the substituted cert. The proxy variables route pip through the corporate gateway that owns the cert chain. | Same fix as the proxy row: set `http_proxy` and `https_proxy`. Reinstall the SPKG. |
| `ReadTimeoutError: HTTPSConnectionPool(host='download.pytorch.org', port=443): Read timed out` (or any PyTorch / PyPI read timeout) | PyPI or `download.pytorch.org` is slow or transiently unavailable. Default pip timeout is too short for the PyTorch wheel on a slow link. | **Reinstall the SPKG.** The retry usually succeeds because the slow / unavailable mirror has caught up. Customers have resolved this by simply re-running the SPKG install. |

## Setting proxy environment variables

Set these **before** launching MATLAB (or before re-running the SPKG installer), in the same shell that will execute pip:

**Windows (cmd.exe / PowerShell):**
```cmd
set http_proxy=http://<proxy-host>:<port>
set https_proxy=http://<proxy-host>:<port>
```
PowerShell:
```powershell
$env:http_proxy  = "http://<proxy-host>:<port>"
$env:https_proxy = "http://<proxy-host>:<port>"
```

**macOS / Linux (bash / zsh):**
```bash
export http_proxy=http://<proxy-host>:<port>
export https_proxy=http://<proxy-host>:<port>
```

If the proxy needs authentication, use `http://<user>:<password>@<proxy-host>:<port>`. Get the proxy URL from the customer's IT / network team — do not guess.

After setting, **re-run the SPKG install** from the Add-Ons explorer or the install command shown in the original error.

## What to ASK the user

If you do not yet have enough info to pick a row, ASK one direct question:

> "The Python support package install failed. Can you paste the **full error message** from MATLAB (or the path to the SPKG install log)? I am looking for one of three patterns: a proxy/SSL connection error (corporate-network gateway), or a `ReadTimeoutError` from `download.pytorch.org` (slow PyPI mirror)."

Do NOT recommend a fix until you have matched the literal symptom. Guessing wastes a 10–30 minute reinstall cycle.

## Verification after the fix

After applying the fix and reinstalling the SPKG, verify the model works before continuing the user's actual scenario task:

```matlab
% Verify RVLD installed (Workflow 8)
try
    detector = laneBoundaryDetector(Model="RVLD");
    fprintf("RVLD installed.\n");
catch ME
    fprintf("RVLD still failing: %s\n", ME.message);
end
```

```matlab
% Verify imageAssetGenerator installed (Workflow 12)
try
    assetGen = imageAssetGenerator;
    fprintf("imageAssetGenerator (TripoSR) installed.\n");
catch ME
    fprintf("imageAssetGenerator still failing: %s\n", ME.message);
end
```

If the verification still fails after the fix, escalate — there is a customer-network specific issue that needs IT involvement, not a generic retry.

## When this is the wrong reference

| Situation | Where to go instead |
|---|---|
| User has not even attempted to install — they are asking generally about RVLD | Workflow 8 (RVLD section). |
| User has not even attempted to install — they are asking generally about `imageAssetGenerator` / TripoSR | Workflow 12. |
| The error is a MATLAB-side runtime error (e.g., `imageToVehicle` out-of-bounds) AFTER the model loaded successfully | The relevant workflow file's "Pitfalls" section, not this reference. |
| Customer cannot get the proxy URL from IT, or the proxy requires NTLM / SSO authentication that pip cannot handle | This is beyond the documented fixes — escalate to MathWorks support with the customer's network details. Do NOT recommend disabling SSL verification or pinning fake certs. |

----

Copyright 2026 The MathWorks, Inc.

----
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 321kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 321kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 321kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall