Hole Peg Test Active Task Export Format

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.

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. `Time` The 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"
}