Articles in this section

See more

Tower of Hanoi Active Task Export Format

  • Updated
Follow

The Tower of Hanoi Active Task is based on the ResearchKit Tower of Hanoi task.

When your project uses the CSV export format for Survey Results, data for Active Tasks is exported in the file SurveyTowerOfHanoiResults.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.
  • Detailed information on each action taken during the survey.

Table of Contents

Data Fields

Field Description
SurveyTowerOfHanoiResultKey

A unique, auto-generated observation ID for a each Tower of Hanoi survey.
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.
PuzzleWasSolved

A Boolean value indicating whether the puzzle was solved; "TRUE" or "FALSE."
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.
Moves

An array that contains the results of the moves, including:


Timestamp A relative timestamp indicating the time of the tap event.


DonorTowerIndexThe index of the donor (starting) tower in the move.


RecipientTowerIndexThe index of the recipient (ending) tower in the move.

Sample CSV Export

SurveyTowerOfHanoiResultKey,SurveyStepResultKey,SurveyResultKey,ParticipantIdentifier,PuzzleWasSolved,StartDate,EndDate,Moves
f2e32976-0881-eb11-88a8-001c426fd18d,e6e32976-0881-eb11-88a8-001c426fd18d,dde32976-0881-eb11-88a8-001c426fd18d,123ac,False,2021-03-09T13:50:12-05:00,2021-03-09T13:51:30-05:00,"[{""Timestamp"":0.0,""DonorTowerIndex"":0,""RecipientTowerIndex"":1},{""Timestamp"":1.5831879377365112,""DonorTowerIndex"":0,""RecipientTowerIndex"":2},{""Timestamp"":16.500602960586548,""DonorTowerIndex"":2,""RecipientTowerIndex"":0},{""Timestamp"":19.917852997779846,""DonorTowerIndex"":0,""RecipientTowerIndex"":2},{""Timestamp"":29.785323023796082,""DonorTowerIndex"":2,""RecipientTowerIndex"":0},{""Timestamp"":31.818869948387146,""DonorTowerIndex"":0,""RecipientTowerIndex"":2},{""Timestamp"":38.202430963516235,""DonorTowerIndex"":1,""RecipientTowerIndex"":0},{""Timestamp"":40.535854935646057,""DonorTowerIndex"":2,""RecipientTowerIndex"":1},{""Timestamp"":41.91926896572113,""DonorTowerIndex"":0,""RecipientTowerIndex"":2},{""Timestamp"":51.403347015380859,""DonorTowerIndex"":2,""RecipientTowerIndex"":1},{""Timestamp"":53.103510022163391,""DonorTowerIndex"":0,""RecipientTowerIndex"":2},{""Timestamp"":60.652601003646851,""DonorTowerIndex"":1,""RecipientTowerIndex"":0},{""Timestamp"":62.353826999664307,""DonorTowerIndex"":1,""RecipientTowerIndex"":2},{""Timestamp"":64.6876369714737,""DonorTowerIndex"":0,""RecipientTowerIndex"":2},{""Timestamp"":66.121009945869446,""DonorTowerIndex"":0,""RecipientTowerIndex"":1},{""Timestamp"":73.2048100233078,""DonorTowerIndex"":2,""RecipientTowerIndex"":1},{""Timestamp"":75.454828023910522,""DonorTowerIndex"":2,""RecipientTowerIndex"":0}]"

Sample JSON Export

Note that since the JSON export is included in the SurveyResults.json file, some of the reference keys either do not apply, or are part of the overall survey step data.

{"SurveyResultKey":"dde32976-0881-eb11-88a8-001c426fd18d","SurveyKey":"3aa996e2-0181-eb11-88a8-001c426fd18d","SurveyName":"towerofhanoi","ParticipantIdentifier":"123ac","SurveyTaskKey":"39713765-0781-eb11-88a8-001c426fd18d","Type":"Survey","SurveyVersion":0,"StartDate":"2021-03-09T13:49:50-05:00","EndDate":"2021-03-09T13:51:33-05:00","DevicePlatform":"iOS","DeviceName":"iPhone8,4","DeviceOSVersion":"14.3","InsertedDate":"2021-03-09T18:51:34Z","StepResults":[{"SurveyStepResultKey":"e4e32976-0881-eb11-88a8-001c426fd18d","StepIdentifier":"instruction","StartDate":"2021-03-09T13:49:50-05:00","EndDate":"2021-03-09T13:49:53-05:00","Results":[]},{"SurveyStepResultKey":"e5e32976-0881-eb11-88a8-001c426fd18d","StepIdentifier":"instruction1","StartDate":"2021-03-09T13:49:53-05:00","EndDate":"2021-03-09T13:49:58-05:00","Results":[]},{"SurveyStepResultKey":"e6e32976-0881-eb11-88a8-001c426fd18d","StepIdentifier":"towerOfHanoi","StartDate":"2021-03-09T13:49:58-05:00","EndDate":"2021-03-09T13:51:30-05:00","Results":[{"Type":"TowerOfHanoiResult","SurveyTowerOfHanoiResultKey":"f2e32976-0881-eb11-88a8-001c426fd18d",
"PuzzleWasSolved":"False",
"TowerOfHanoiMoves":[
     {
     "Timestamp":0.0,
     "DonorTowerIndex":0,
     "RecipientTowerIndex":1
     },
     {
     "Timestamp":1.5831879377365112,
     "DonorTowerIndex":0,
     "RecipientTowerIndex":2
     },
     {
     "Timestamp":16.500602960586548,
     "DonorTowerIndex":2,
     "RecipientTowerIndex":0
     },
     {
     "Timestamp":19.917852997779846,
     "DonorTowerIndex":0,
     "RecipientTowerIndex":2
     },
     {
     "Timestamp":29.785323023796082,
     "DonorTowerIndex":2,
     "RecipientTowerIndex":0
     },
     {
     "Timestamp":31.818869948387146,
     "DonorTowerIndex":0,
     "RecipientTowerIndex":2
     },
     {
     "Timestamp":38.202430963516235,
     "DonorTowerIndex":1,
     "RecipientTowerIndex":0
     },
     {
     "Timestamp":40.535854935646057,
     "DonorTowerIndex":2,
     "RecipientTowerIndex":1
     },
     {
     "Timestamp":41.91926896572113,
     "DonorTowerIndex":0,
     "RecipientTowerIndex":2
     },
     {
     "Timestamp":51.403347015380859,
     "DonorTowerIndex":2,
     "RecipientTowerIndex":1
     },
     {
     "Timestamp":53.103510022163391,
     "DonorTowerIndex":0,
     "RecipientTowerIndex":2
     },
     {
     "Timestamp":60.652601003646851,
     "DonorTowerIndex":1,
     "RecipientTowerIndex":0
     },
     {
     "Timestamp":62.353826999664307,
     "DonorTowerIndex":1,
     "RecipientTowerIndex":2
     },
     {
     "Timestamp":64.6876369714737,
     "DonorTowerIndex":0,
     "RecipientTowerIndex":2
     },
     {
     "Timestamp":66.121009945869446,
     "DonorTowerIndex":0,
     "RecipientTowerIndex":1
     },
     {
     "Timestamp":73.2048100233078,
     "DonorTowerIndex":2,
     "RecipientTowerIndex":1
     },
     {
     "Timestamp":75.454828023910522,
     "DonorTowerIndex":2,
     "RecipientTowerIndex":0
     }],
"StartDate":"2021-03-09T13:50:12-05:00",
"EndDate":"2021-03-09T13:51:30-05:00"
}

Related articles