Read EpicRaw File

Description

Reads local camera data files or folders.

Overview

Reads EpicRaw data from a file or folder.

Scenarios

  • When Epic Eye camera data (.epicraw) has been captured and needs to be loaded into ATOM for vision algorithm processing

  • When both image and point cloud from the same capture frame are needed, ensuring strict temporal alignment

  • When camera intrinsics and distortion coefficients are needed from the file (e.g., for 3D-to-2D projection or coordinate transformation)

  • When replaying historical capture data frame-by-frame to validate algorithm performance

Inputs and Outputs

Inputs

Empty Input: Enable at least one input mapping on this node if you want it and downstream nodes to run with the graph.

Outputs

Image: BGR 3-channel color image parsed from the EpicRaw file.

Point Cloud: 3D point cloud data (XYZ coordinates), strictly synchronized with the image within the same capture frame.

Camera parameters: Camera intrinsics, distortion, color-camera, and passive-stereo parameters.

Parameters

Enable Directory Mode

Description

Selects the read source. false reads the single file parameter; true filters supported files from the directory and reads them one by one in directory enumeration order across executions, looping to the beginning after the last file.

Tuning Instructions

Turn it off and set a file path for single-file reading; turn it on and set a folder path to iterate through directory files.

Parameter Range

Default: False

EpicRaw File

Description

Specifies one .epicraw file. Used only when directory reading is false; parsing is also controlled by the passive-stereo option.

Tuning Instructions

Configure according to the stated semantics; the parameter is inactive when its associated mode, path, or input condition is not selected.

Parameter Range

Options: .epicraw

Parameter Range

Values/Range:

  • .epicraw

EpicRaw Folder

Description

Specifies a directory containing supported files. With directory reading enabled, the single-file path is ignored; matching files are read across executions and loop after the last one.

Tuning Instructions

When folder reading is enabled, select a directory containing files supported by the mapped output type.

Read Passive Stereo Data

Description

Controls EpicRaw3 parsing. true returns images and camera parameters required for passive-stereo reconstruction and removes the point-cloud output port; false returns image, point cloud, and camera parameters in normal mode. Non-EpicRaw3 data is parsed as normal content.

Tuning Instructions

Turn it on for passive-stereo EpicRaw3 data; turn it off when normal image, point-cloud, and camera-parameter outputs are required.

Parameter Range

Default: False