matlab/matlab-agentic-toolkit / skills-catalog/image-processing-and-computer-vision/matlab-read-write-point-cloud-file
matlab-read-write-point-cloud-file
VerifiedRead and write 3-D point cloud data using Lidar Toolbox file I/O. Covers PLY, PCD, LAS/LAZ, PCAP (Velodyne/Ouster/Hesai), E57, and IDC (Ibeo) formats. Use when loading point clouds from disk, saving to disk, choosing the correct reader or writer for a file format, extracting or preserving lidar point attributes, reading Ibeo IDC sensor recordings, or converting between formats.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.8 KB |
| manifest.yaml | config | 507 B |
| references/INDEX.md | markdown | 1.5 KB |
| references/quick-ref/las-io.md | markdown | 2.9 KB |
| references/quick-ref/pcap-readers.md | markdown | 3.6 KB |
references/quick-ref/pcap-readers.md
View on GitHub# PCAP File Readers Quick Reference
## Velodyne — velodyneFileReader
```matlab
reader = velodyneFileReader(fileName, deviceModel);
reader = velodyneFileReader(fileName, deviceModel, CalibrationFile=xmlPath, OrganizePoints=true);
```
| Device Model | Channels | Notes |
|---|---|---|
| `"VLP16"` | 16 | Most common low-cost sensor |
| `"PuckLITE"` | 16 | Lighter variant of VLP16 |
| `"PuckHiRes"` | 16 | Higher vertical resolution |
| `"VLP32C"` | 32 | Mid-range |
| `"HDL32E"` | 32 | Classic mid-range |
| `"HDL64E"` | 64 | High-density |
| `"VLS128"` | 128 | Top-of-line |
| `"VelarrayH800"` | — | Solid-state |
**Key Properties:** FileName, DeviceModel, CalibrationFile, NumberOfFrames, Duration, StartTime, EndTime, CurrentTime, Timestamps, OrganizePoints, HasPositionData
**Methods:** hasFrame, readFrame, reset
### Reading Frames
```matlab
reader = velodyneFileReader("lidarData_ConstructionRoad.pcap", "HDL32E");
while hasFrame(reader)
ptCloud = readFrame(reader);
end
% Read specific frame by timestamp
frameTime = reader.Timestamps(10);
ptCloud = readFrame(reader, frameTime);
```
## Ouster — ousterFileReader
```matlab
reader = ousterFileReader(fileName, calibrationFile);
reader = ousterFileReader(fileName, calibrationFile, SkipPartialFrames=true, CoordinateFrame="center");
```
| Device Models | Notes |
|---|---|
| OS0-32/64/128 | Short-range, wide FOV |
| OS1-16/32/64/128 | Mid-range |
| OS2-32/64/128 | Long-range |
| OS Dome-32/64/128 | Hemispherical (R2025a+) |
**Key Properties:** FileName, CalibrationFile, DeviceModel (read-only, auto-detected), LidarMode, ReturnMode, FirmwareVersion, LidarUDPProfile, HasIMUData, NumberOfFrames, Duration, Timestamps, SkipPartialFrames, CoordinateFrame
**Methods:** hasFrame, readFrame, readIMU, reset
### Dual-Return Mode
When `ReturnMode` contains two entries (e.g., `{"strongest","weakest"}`), `readFrame` returns an N-by-2 pointCloud array. Index into column 1 for strongest return.
```matlab
reader = ousterFileReader("data.pcap", "calibration.json");
while hasFrame(reader)
ptCloud = readFrame(reader);
if size(ptCloud, 2) > 1
ptCloud = ptCloud(:,1); % strongest return
end
end
```
### IMU Data
```matlab
if reader.HasIMUData
imuData = readIMU(reader);
end
```
## Hesai — hesaiFileReader
```matlab
reader = hesaiFileReader(fileName, deviceModel);
reader = hesaiFileReader(fileName, deviceModel, CalibrationFile=csvPath, SkipPartialFrames=true);
```
| Device Model | Channels | Notes |
|---|---|---|
| `"Pandar128E3X"` | 128 | High-density |
| `"Pandar64"` | 64 | Mid-range |
| `"PandarQT"` | — | Short-range |
| `"PandarXT32"` | 32 | Compact |
**Key Properties:** FileName, DeviceModel, CalibrationFile, SkipPartialFrames, ReturnMode, NumberOfFrames, Duration, StartTime, EndTime, CurrentTime, Timestamps
**Methods:** hasFrame, readFrame, reset
## Common Patterns
### Extract first N frames from any PCAP
```matlab
N = 10;
frames = cell(1, N);
count = 0;
while hasFrame(reader) && count < N
count = count + 1;
frames{count} = readFrame(reader);
end
```
### Reset reader to re-read from beginning
```matlab
reset(reader);
```
## Gotchas
- Wrong calibration file for Ouster = reader returns zero frames silently
- `readFrame` returns `pointCloud`, not raw XYZ arrays
- `NumberOfFrames` is available immediately (from PCAP header scan)
- `Timestamps` gives the start time of each frame — use it for random access via `readFrame(reader, time)`
- Velodyne `OrganizePoints` defaults to `true` (organized output); Ouster/Hesai always produce organized output
----
Copyright 2026 The MathWorks, Inc.
----
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |