signaloid-cli samples from-value-id

Get samples of a Reference core run using Task and Value ID.

Synopsis

signaloid-cli samples from-value-id --task-id <id> --value-id <id> [options]

Description

Retrieves samples for a specific traced value, encoded using a Value ID, from a completed Reference core task.

Options

Option	Description
--task-id <id>	Task ID (required)
--value-id <id>	Value ID (required)
--count <n>	Number of samples to retrieve (default varies)

Output

Returns a JSON object containing the samples array:

{
  "Samples": [
    985.7978697751669,
    1015.4539913890895,
    997.7518234451446,
    1015.1507376278006,
    1044.4753687949049,
    967.98984989865,
    1004.7514649084582,
    965.373776280156,
    957.3288817410029,
    1046.4543716494652,
    969.0096352414854,
    1029.6017479149193,
    1012.3419634763102,
    1040.0981602326456,
    983.1615353371229,
    990.1626295099129,
    1044.6501505906724,
    977.8470040716751,
    954.8433181242157,
    1005.3272787087232,
    973.6966566259385,
    982.9029399524292,
    1010.883457243626,
    963.2839769391891,
    986.3355083414234,
    1020.7962206678202,
    1017.6006440426896,
    1030.8649177743798,
    995.5812420449212,
    962.1091668416199,
    989.6883108806343,
    985.1079060056707
  ],
  "Count": 32
}

Examples

Get Samples for a Value

signaloid-cli samples from-value-id \
  --task-id tsk_abc123 \
  --value-id value_xyz789 \
  --count 1000

Find Value IDs

First, get task output of a Reference core run to identify value IDs:

# Get task output with value IDs
signaloid-cli tasks output --task-id tsk_abc123

Expected output of a Reference core run

Export for Analysis

# Export to CSV for Excel/R/Python
signaloid-cli samples from-value-id \
  --task-id $TASK_ID \
  --value-id $VALUE_ID \
  --count 5000 | \
  jq -r '.Samples[]' > samples.csv

Exit Codes

Code	Description
0	Success
1	Failed to fetch samples (task not found, value not found, API error)

Notes

• Both --task-id and --value-id are required
• The task must be completed before samples can be retrieved
• Value IDs can be found in task outputs

See Also

• signaloid-cli samples from-ux-string - Get samples from Ux strings
• signaloid-cli tasks output - Get task output
• signaloid-cli plot - Visualizing uncertainty