read

Read data from datastore

Since R2024a

Syntax

data = read(DS)

[data,info]
= read(DS)

Description

data = read(DS) returns data from a DLCHOMP datastore. Subsequent calls to the read function continue reading from the endpoint of the previous call.

[data,info] = read(DS) also returns information about the extracted data in info, including metadata.

Input Arguments

collapse all

`DS` — Input datastore
`dlCHOMPDatastore` object

Input datastore, specified as a dlCHOMPDatastore object.

Output Arguments

collapse all

`data` — Output data
three-element cell array

Output data, returned as a three-element cell array with the these elements:

2*M-element numeric array of the first and last waypoints of the Trajectory field of the input JSON file concatenated row-wise. M is the joint size of the robot.
E-element numeric array of the obstacle encoding from Encoding field of the input JSON file. E is the size of the basis point set.
(W-2)*M numeric array of the intermediate waypoints of the Trajectory field of the input JSON file. W is the number of waypoints. M is the joint size of the robot.

Use elements 1 and 2 as inputs, and element 3 as the corresponding output, to train the neural network stored in the dlCHOMP object using trainDLCHOMP function.

`info` — Information about read data
structure array

Information about data, returned as a structure array. The structure array contains the these fields.

Field Name	Description
`Size`	Size of the DATA output
`FileName`	Fully resolved path to the JSON file being read, containing the path string, name of the file, and file extension.
`Offset`	Starting position of the read operation, in bytes.