Versions_ListVersionPreviewItems
const url = 'https://junction-api.qualiastudios.dev/v1/accounts/example/datasets/example/versionPreviews/example/items';const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://junction-api.qualiastudios.dev/v1/accounts/example/datasets/example/versionPreviews/example/items \ --header 'X-API-Key: <X-API-Key>'A preview’s windows, take by take, with what each measured: the numbers its charts draw. Paged.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The account id.
The dataset id.
The versionPreview id.
Query Parameters
Section titled “Query Parameters ”At most this many windows; 0 means 500, the maximum is 2000.
From a previous response’s next_page_token.
Responses
Section titled “ Responses ”OK
Response for Versions.ListVersionPreviewItems.
object
One page of windows, in take order and each take’s in time order.
One window of a preview: a stretch of one take the version would hold, and how it measured.
object
Accounts/{account}/datasets/{dataset}/episodes/{episode}: the take it is cut from.
Its place among the take’s windows, from 0.
The take’s windows: 1 for a take as recorded or trimmed, more for a split.
Where it starts, seconds from the start of the take’s recording.
Where it ends, seconds from the start of the take’s recording.
The take as a person finds it in the dataset, e.g. “episode 41 · pick_cup_041”.
Accounts/{account}/datasets/{dataset}/episodes/{episode}: the episode the version pins for it. The take itself when it is published as recorded; for an edited take, its new episode once the preview is PUBLISHED, and empty before (publishing makes the new episodes).
How it moves, measured over the window alone, as Episode.analysis reads; unset when it could not be measured.
object
The definition the numbers follow; a reader treats another one as not measured yet.
Why the take could not be measured: “no_joints” (no state) or “channel_never_read”. Empty when measured.
Rows per second it was measured at.
Rows read.
Variance of the joint speed over every state channel, (units/s)^2.
Mean joint speed over every state channel, units/s.
Mean norm of the state’s third difference, units/s^3.
Share of the speed spectrum’s power above 3 Hz.
Share of frames under 5% of the top speed.
Mean |v_smooth - v| / (|v_smooth| + |v|) over the arm joints.
Commanded gripper moves of at least 30% of their travel.
The most events of one gripper inside 0.5 s.
Regrasps within 3 s, plus events the arm retraces its approach round.
State channel names, in the order of the poses.
First state row, every channel.
Last state row, every channel.
Every commanded channel, in recording order.
One commanded channel’s training-chart inputs.
object
Channel name, as the recording names it.
The value at 50 evenly spaced points of the take, first to last.
Autocorrelation at lags 1..min(100, frames / 2); empty when the channel never moves, and in a list.
Unset when the state has no channel of this name, and in a list.
object
Correlation at lags -30..30 frames; NaN where a lag has no variance. Empty when the take is under 5 frames.
Empty on the last page.
Example generated
{ "versionPreviewItems": [ {} ], "nextPageToken": "example"}default
Section titled “default ”Default error response
A refusal from the API itself.
object
The gRPC code name in upper case, e.g. NOT_FOUND.
Whether the same call may succeed if retried.
Empty, except when a dataset copy or move is refused: then one google.rpc.ErrorInfo with the refusal’s reason code, its domain and, in metadata, the datasets it names.
object
A refusal from the gateway before the call reaches the API, for example 401 bad or missing API key, 403 key lacks the scope or environment closed, 413 body too large.
object
What went wrong.
Example generated
{ "code": "example", "message": "example", "retryable": true, "details": [ {} ]}