Articles in this section

See more

Hole Peg Test Active Task Export Format

  • Updated
Follow

The Hole Peg Test Active Task is based on the ResearchKit 9-Hole Peg Test.

When your project uses the CSV export format for Survey Results, data for Active Tasks is exported in the file SurveyHolePegTestResults.csv. When your project uses the JSON export format, Active Task data is included in the file SurveyResults.json.

For a typical survey using this task, you'll expect to see:

  • One survey result each time the participant completes the survey.
  • One Hole Peg result for each series of 9 prompts, totaling 4 rows per administration.

Table of Contents

Data Fields

Field Description
SurveyHolePegTestResultKey

A unique, auto-generated observation ID for a single hole peg series tasks.
SurveyStepResultKey A unique, auto-generated key for this step result. Can be used to cross reference with other survey results.
SurveyResultKey The key for the survey result which this step result is contained in. Can be used to cross reference with other survey results.
ParticipantIdentifier The identifier of the participant this task was for. Can be used to cross reference with Participants.
MovingDirection

The hole peg test moving direction; "RIGHT" or "LEFT".
DominantHandTested

Whether the step is for the dominant hand; "TRUE" or "FALSE".
NumberOfPegs

The number of pegs to test.
Threshold

The detection area sensitivity.
Rotated "TRUE" if the device was rotated (landscape) for the test; "FALSE" if the device was not rotated (portrait).
TotalSuccesses

The number of succeeded moves (out of NumberOfPegs possible).
TotalFailures

The number of failed moves.
TotalTime The total time needed to perform the test step (i.e. the sum of all Samples time)
StartDate The timestamp for when the participant started the test, in ISO 8601 format. Includes timezone offset information.
EndDate The timestamp for when the participant completed the test, in ISO 8601 format. Includes timezone offset information.
Samples

An array of collected samples, in which each item represents a peg move.

Index The peg number.

Distance The peg move distance.

TimeThe time interval for the peg move.

Sample CSV Export

SurveyHolePegTestResultKey,SurveyStepResultKey,SurveyResultKey,ParticipantIdentifier,MovingDirection,DominantHandTested,NumberOfPegs,Threshold,Rotated,TotalSuccesses,TotalFailures,TotalTime,StartDate,EndDate,Samples
61301dc9-0881-eb11-88a8-001c426fd18d,52301dc9-0881-eb11-88a8-001c426fd18d,49301dc9-0881-eb11-88a8-001c426fd18d,123ac,Right,True,9,0.20000000000000001,False,9,1,21.91040291600001,2021-03-09T13:52:52-05:00,2021-03-09T13:52:52-05:00,"[{""Index"":0,""Distance"":207.79270935058594,""Time"":3.2001612916666318},{""Index"":1,""Distance"":206.86015319824219,""Time"":5.1027462083333148},{""Index"":2,""Distance"":199.371826171875,""Time"":2.245717708333359},{""Index"":3,""Distance"":200.94277954101563,""Time"":2.2028325833333611},{""Index"":4,""Distance"":203.15049743652344,""Time"":1.9676743333333206},{""Index"":5,""Distance"":192.76620483398438,""Time"":1.6997437500000387},{""Index"":6,""Distance"":204.30445861816406,""Time"":1.8505660000000717},{""Index"":7,""Distance"":193.44007873535156,""Time"":1.7992952500000001},{""Index"":8,""Distance"":211.94117736816406,""Time"":1.8348102500000323}]"
64301dc9-0881-eb11-88a8-001c426fd18d,53301dc9-0881-eb11-88a8-001c426fd18d,49301dc9-0881-eb11-88a8-001c426fd18d,123ac,Left,True,9,0.20000000000000001,False,9,5,26.069380332999998,2021-03-09T13:53:18-05:00,2021-03-09T13:53:18-05:00,"[{""Index"":0,""Distance"":211.92938232421875,""Time"":4.9787653333332855},{""Index"":1,""Distance"":208.102294921875,""Time"":5.1008312916667364},{""Index"":2,""Distance"":203.02217102050781,""Time"":4.8335273333333362},{""Index"":3,""Distance"":196.80574035644531,""Time"":1.9830127083333764},{""Index"":4,""Distance"":186.37629699707031,""Time"":1.8309190833332423},{""Index"":5,""Distance"":188.35935974121094,""Time"":1.6026196666666692},{""Index"":6,""Distance"":194.84432983398438,""Time"":2.0472882916667459},{""Index"":7,""Distance"":196.32514953613281,""Time"":2.1195245000000114},{""Index"":8,""Distance"":191.3765869140625,""Time"":1.5668724583333642}]"
67301dc9-0881-eb11-88a8-001c426fd18d,54301dc9-0881-eb11-88a8-001c426fd18d,49301dc9-0881-eb11-88a8-001c426fd18d,123ac,Left,False,9,0.20000000000000001,False,9,0,13.403684833,2021-03-09T13:53:35-05:00,2021-03-09T13:53:35-05:00,"[{""Index"":0,""Distance"":178.50508117675781,""Time"":1.282260625000049},{""Index"":1,""Distance"":198.79653930664063,""Time"":1.9181157499999699},{""Index"":2,""Distance"":170.5029296875,""Time"":1.3672444166667219},{""Index"":3,""Distance"":190.26248168945313,""Time"":1.5314182083333208},{""Index"":4,""Distance"":172.00454711914063,""Time"":1.5351837083333066},{""Index"":5,""Distance"":167.81034851074219,""Time"":1.2831316249998963},{""Index"":6,""Distance"":169.25665283203125,""Time"":1.4009480833333328},{""Index"":7,""Distance"":197.68218994140625,""Time"":1.5981442499999048},{""Index"":8,""Distance"":192.34474182128906,""Time"":1.4836425000000872}]"
6a301dc9-0881-eb11-88a8-001c426fd18d,55301dc9-0881-eb11-88a8-001c426fd18d,49301dc9-0881-eb11-88a8-001c426fd18d,123ac,Right,False,9,0.20000000000000001,False,9,0,14.395537041000011,2021-03-09T13:53:49-05:00,2021-03-09T13:53:49-05:00,"[{""Index"":0,""Distance"":215.67292785644531,""Time"":2.7885594166666579},{""Index"":1,""Distance"":210.83538818359375,""Time"":1.5835227083333621},{""Index"":2,""Distance"":247.57852172851563,""Time"":1.4666050416667531},{""Index"":3,""Distance"":214.71026611328125,""Time"":1.3845212083333536},{""Index"":4,""Distance"":239.90101623535156,""Time"":1.4490072500000224},{""Index"":5,""Distance"":225.31880187988281,""Time"":1.4667661249999355},{""Index"":6,""Distance"":238.62313842773438,""Time"":1.3515235416666656},{""Index"":7,""Distance"":233.44432067871094,""Time"":1.4662260416665731},{""Index"":8,""Distance"":234.073974609375,""Time"":1.4335382083332888}]"

Sample JSON Export

{"SurveyResultKey":"49301dc9-0881-eb11-88a8-001c426fd18d","SurveyKey":"f2636e7c-0781-eb11-88a8-001c426fd18d","SurveyName":"holepeg","ParticipantIdentifier":"123ac","SurveyTaskKey":"4eb5b4a2-0781-eb11-88a8-001c426fd18d","Type":"Survey","SurveyVersion":0,"StartDate":"2021-03-09T13:52:15-05:00","EndDate":"2021-03-09T13:53:52-05:00","DevicePlatform":"iOS","DeviceName":"iPhone8,4","DeviceOSVersion":"14.3","InsertedDate":"2021-03-09T18:53:53Z","StepResults":[{"SurveyStepResultKey":"50301dc9-0881-eb11-88a8-001c426fd18d","StepIdentifier":"instruction","StartDate":"2021-03-09T13:52:15-05:00","EndDate":"2021-03-09T13:52:19-05:00","Results":[]},{"SurveyStepResultKey":"51301dc9-0881-eb11-88a8-001c426fd18d","StepIdentifier":"instruction1","StartDate":"2021-03-09T13:52:19-05:00","EndDate":"2021-03-09T13:52:27-05:00","Results":[]},{"SurveyStepResultKey":"52301dc9-0881-eb11-88a8-001c426fd18d","StepIdentifier":"hole.peg.test.dominant.place","StartDate":"2021-03-09T13:52:27-05:00","EndDate":"2021-03-09T13:52:52-05:00","Results":[{"Type":"HolePegTestResult","SurveyHolePegTestResultKey":"61301dc9-0881-eb11-88a8-001c426fd18d",
"MovingDirection":"Right",
"DominantHandTested":true,
"NumberOfPegs":9,
"Threshold":0.20000000000000001,
"Rotated":false,
"TotalSuccesses":9,
"TotalFailures":1,
"TotalTime"c21.91040291600001,
"Samples":[{"Index":0,"Distance":207.79270935058594,"Time":3.2001612916666318},{"Index":1,"Distance":206.86015319824219,"Time":5.1027462083333148},{"Index":2,"Distance":199.371826171875,"Time":2.245717708333359},{"Index":3,"Distance":200.94277954101563,"Time":2.2028325833333611},{"Index":4,"Distance":203.15049743652344,"Time":1.9676743333333206},{"Index":5,"Distance":192.76620483398438,"Time":1.6997437500000387},{"Index":6,"Distance":204.30445861816406,"Time":1.8505660000000717},{"Index":7,"Distance":193.44007873535156,"Time":1.7992952500000001},{"Index":8,"Distance":211.94117736816406,"Time":1.8348102500000323}],
"StartDate":"2021-03-09T13:52:52-05:00",
"EndDate":"2021-03-09T13:52:52-05:00"
},
{
"MovingDirection":"Left",
"DominantHandTested":true,
"NumberOfPegs":9,
"Threshold":0.20000000000000001,
"Rotated":false,
"TotalSuccesses":9,
"TotalFailures":5,
"TotalTime":26.069380332999998,
"Samples":[{"Index":0,"Distance":211.92938232421875,"Time":4.9787653333332855},{"Index":1,"Distance":208.102294921875,"Time":5.1008312916667364},{"Index":2,"Distance":203.02217102050781,"Time":4.8335273333333362},{"Index":3,"Distance":196.80574035644531,"Time":1.9830127083333764},{"Index":4,"Distance":186.37629699707031,"Time":1.8309190833332423},{"Index":5,"Distance":188.35935974121094,"Time":1.6026196666666692},{"Index":6,"Distance":194.84432983398438,"Time":2.0472882916667459},{"Index":7,"Distance":196.32514953613281,"Time":2.1195245000000114},{"Index":8,"Distance":191.3765869140625,"Time":1.5668724583333642}],
"StartDate":"2021-03-09T13:53:18-05:00",
"EndDate":"2021-03-09T13:53:18-05:00"
},
{
"MovingDirection":"Left",
"DominantHandTested":false,
"NumberOfPegs":9,
"Threshold":0.20000000000000001,
"Rotated":false,
"TotalSuccesses":9,
"TotalFailures":0,
"TotalTime":13.403684833,
"Samples":[{"Index":0,"Distance":178.50508117675781,"Time":1.282260625000049},{"Index":1,"Distance":198.79653930664063,"Time":1.9181157499999699},{"Index":2,"Distance":170.5029296875,"Time":1.3672444166667219},{"Index":3,"Distance":190.26248168945313,"Time":1.5314182083333208},{"Index":4,"Distance":172.00454711914063,"Time":1.5351837083333066},{"Index":5,"Distance":167.81034851074219,"Time":1.2831316249998963},{"Index":6,"Distance":169.25665283203125,"Time":1.4009480833333328},{"Index":7,"Distance":197.68218994140625,"Time":1.5981442499999048},{"Index":8,"Distance":192.34474182128906,"Time":1.4836425000000872}],
"StartDate":"2021-03-09T13:53:35-05:00",
"EndDate":"2021-03-09T13:53:35-05:00"
},
{
"MovingDirection":"Right",
"DominantHandTested":false,
"NumberOfPegs":9,
"Threshold":0.20000000000000001,
"Rotated":false,
"TotalSuccesses":9,
"TotalFailures":0,
"TotalTime":14.395537041000011,
"Samples":[{"Index":0,"Distance":215.67292785644531,"Time":2.7885594166666579},{"Index":1,"Distance":210.83538818359375,"Time":1.5835227083333621},{"Index":2,"Distance":247.57852172851563,"Time":1.4666050416667531},{"Index":3,"Distance":214.71026611328125,"Time":1.3845212083333536},{"Index":4,"Distance":239.90101623535156,"Time":1.4490072500000224},{"Index":5,"Distance":225.31880187988281,"Time":1.4667661249999355},{"Index":6,"Distance":238.62313842773438,"Time":1.3515235416666656},{"Index":7,"Distance":233.44432067871094,"Time":1.4662260416665731},{"Index":8,"Distance":234.073974609375,"Time":1.4335382083332888}],
"StartDate":"2021-03-09T13:53:49-05:00",
"EndDate":"2021-03-09T13:53:49-05:00"
}

Related articles