VueronTechnology
    EN-previous
    • EN
    • KR
    • EN-previous
    • KR-previous
    • Vueron VueFlow Operation Manual
    • How to Install Oslo Client
    • VueFlow PCD Calibration Guide
    • Mbembo
      • User
        • UserLogin
        • RefreshToken
      • Statistics
        • Get Zone Statistics
        • Get Zone Statistics Client
      • Event
        • Stream Area Frame
        • Stream Event
      • AlarmLog
        • Get AlarmLog Count
        • Get AlarmLog List
      • Batch
        • Start Batch
      • Dev
        • 혼잡도-예측

    VueFlow PCD Calibration Guide

    About this guide#

    COPYRIGHT © 2026 Vueron Technology Co., Ltd. All rights reserved.
    This guide is provided to the Vueron Technology Customer as a reference and training aid for the following purchased Vueron products.
    This guide may be distributed to the employees and agents of the Customer as a reference and for internal training purposes. All other reproductions of this document are prohibited without the written permission of Vueron Technology.
    Vueron Technology makes no warranties, expressed or implied, regarding this documentation. The information contained herein is subject to change without notice. Revisions may be issued to advise of such changes.
    The software described in this guide is furnished under a license agreement or nondisclosure agreement. Copying the software on any medium except as specifically allowed in the license or nondisclosure agreement is prohibited.

    VueFlow PCD Calibration Guide#

    Installing Vueron’s Oslo Client on your local PC is required to perform PCD calibration with VueFlow.

    Interface Overview#

    Controls
    Left mouse drag — Adjust the position of the viewer
    Right mouse drag — Adjust the orientation of the viewer
    Press V — Switch views (Perspective / XY / XZ / YZ)
    Display Options
    OptionDescription
    LidarDisplays the location of the LiDAR sensor with a red pole
    GridVisualizes the detection range and distance of the LiDAR sensor
    Calibration Parameters
    OptionDescription
    X, Y, ZPosition of the sensors in the coordinate system (1m per grid cell)
    RollRotation angle of the sensor with respect to the X-axis
    PitchRotation angle of the sensor with respect to the Y-axis
    YawRotation angle of the sensor with respect to the Z-axis

    Steps#

    1. Run Oslo#

    Run Oslo Client in your local PC.
    image.png

    2. Access VueFlow#

    Visit https://viewer.vueron.com.
    image.png

    3. Open File Browser#

    Click the folder icon.
    image.png

    4. Load PCD Files#

    Load .pcd files or folders.

    4-1. Recent Files#

    Files will only be displayed if they have been previously opened in VueFlow.
    image.png

    4-2. Explorer#

    Files can be loaded from the file explorer.
    The file must exist inside a folder named vueron-data > recording to be accessible.
    The vueron-data folder is automatically created in the following location depending on your operating system:
    OSPath
    Windowsc:/{users}/vueron-data
    macOS / Linux (Ubuntu)~/vueron-data
    image.png
    image.png

    5. Open Calibration Panel#

    Click the Calibration button.
    image.png

    6. Select LiDAR#

    Click on a LiDAR list item.
    Press the left and right mouse buttons and drag to navigate the viewer's position and direction.
    The number of items displayed corresponds to the number of LiDAR cameras available.
    image.png

    7. Set Adjustment Unit#

    Go to step size, set the adjustment unit to be used for calibration. All units are in meters. "0.1" is recommended for initial adjustment unit.
    image.png

    8. Change PCD Color#

    Change the point cloud color for each sensor.
    image.png
    When calibrating multiple sensors, adjust them one by one.
    Deactivate all other sensors except the first one, which will serve as the reference.

    9. Adjust Calibration Values#

    Adjust each parameter by the configured unit of change.
    image.png

    10. Align to Ground Plane#

    Press V to cycle through views and adjust the X/Y/Yaw, Z, Roll, and Pitch parameters one by one until the point cloud data is horizontally aligned with the gridline.
    To adjust the X, Y, Yaw parameter, press the V button to switch the view to 2D(Top view).
    Set the first LiDAR sensor’s X and Y parameter so that it is located at (0, 0) on the XY grid, then adjust the yaw parameter so that the LiDAR sensor faces along the grid’s X-axis
    image.png
    image.png
    Press V to switch views(Y-Z), then adjust the Z parameter to align the center point of the point cloud with the ground plane.
    image.png
    Align the bottom of the PCD data to the 0m gridline.
    image.png
    At same view(Y-Z), adjust the Roll parameters until the point cloud data is aligned with the ground.
    Press V to switch views(X-Z), adjust the Pitch parameters until the point cloud data is aligned with the ground.
    image.png
    image.png

    Click the eye icon of the Second LiDAR to make its PCD data visible. Select the second LiDAR, then perform calibration using the same steps as for the first LiDAR.
    X/Y/Yaw → Z → Roll → Pitch
    Press V to switch to the view(Top view) for adjusting X, Y, and Yaw.
    Referring to the already calibrated LiDAR, adjust the X, Y, and Yaw parameters to complete the calibration. (Refer to the image below.)
    We recommend finding a cuboid-shaped object with clear right angles, such as a wall or building, and using it to align the X/Y position and yaw with the First sensor that was calibrated.
    Next, use the V key to switch views, then adjust the Z, Roll, and Pitch values as you did for the first LiDAR. Perform calibration based on the ground grid and the first calibrated sensor.
    image.png
    image.png

    When calibrating more than three LiDAR sensors, follow the same steps as the Second sensor: press V to switch views and adjust Roll, then press V again to adjust Pitch.
    image.png

    11. Focus & Hide#

    Click the circle icon to focus on the selected LiDAR camera.
    Click the eye icon to hide it from view.
    image.png

    12. Save and Reset Calibration#

    Click the Reset button to discard changes and return to the initial state.
    Click the Apply button to save the completed calibration.
    image.png

    13. Export / Import Calibration#

    Use Export to save the current calibration.
    Use Import to immediately apply a previously exported calibration.
    Select the PCD folder, then perform Import from the Calibration menu. After applying, click Save to store the changes.
    image.png

    14. Playback Controls#

    Play through frames using the playback controls. Use the range settings to loop specific frames.
    image.png

    15. Export Calibrated Files#

    Click the Export button to export the calibrated files.
    image.png

    16. Configure Export Settings#

    Configure the following options before exporting:
    Export Range — Set the frame range to export
    Folder Name — Set a custom folder name (preview available)
    PCD Data Options — Choose which data fields to include:
    Reflectivity
    Velocity
    Sensor ID
    Sensor Color
    Compressed File
    image.png

    17. Confirm Export#

    The data will be exported.
    image.png

    18. Verify Output#

    Confirm that the exported files have been created in the vueron-data > recording folder.
    image.png

    Notes#

    1. Multi-LiDAR PCD Data Structure#

    Calibration is supported for PCD files recorded from a single scene using multiple LiDARs.
    The folder structure must follow the rules below:
    FolderA
    ├── playable        (0-byte file)
    ├── Sensor1Folder   (alphanumeric filename)
    │   ├── 000001.pcd
    │   └── 000002.pcd
    └── Sensor2Folder   (alphanumeric filename)
        ├── 000001.pcd
        └── 000002.pcd
    A file named playable must be created inside FolderA, and only subfolders containing PCD files (Sensor1Folder, Sensor2Folder) should exist within it.
    If any other files are present, playback and recognition will fail.
    A cache.json file may be generated during calibration — this can be ignored.
    The names of Sensor1Folder and Sensor2Folder can be set freely.
    However, filenames inside each subfolder must match across all sensors. (Files are recognized as frame sequences in alphanumeric order.)
    In the example above, FolderA becomes selectable, and upon selection, Sensor1Folder and Sensor2Folder are recognized as two separate LiDARs.
    Once recognized, files with the same filename are displayed as the same frame, and each LiDAR can be individually calibrated to align them.
    Since these are PCD files, calibration may appear temporarily misaligned during the process — this is a timing issue. The final calibration settings will be applied to all PCD files at once.
    After completing calibration and exporting, the PCD data from both LiDARs will be merged into a single PCD file upon export.
    Modified at 2026-06-24 07:18:10
    Previous
    How to Install Oslo Client
    Next
    UserLogin
    Built with