Instructions

The PIEL Survey runs surveys that are created by importing a Control File (a text file with a ".survey" extension). This file can be emailed to participants or copied directly onto a device. The user interface of the PIEL Survey is designed to be clean and simple so participants can rapidly answer surveys.

The instructions for the PIEL Survey are largely identical for iOS and Android devices.

This similarity simplifies the job of the researcher.

The instructions can be found in in the following sections. Where there are differences between iOS and Android devices, a button will be shown to allow viewing of the alternate instructions.

Plan Project

In this section we provide some ideas on how to plan your research project using the PIEL Survey app. This section will put into context all the other instructions.

Control File: Structure

The survey control file is a text file which controls the survey. It is easily read and edited but offers considerable flexibility in creating a survey. This section sets out the required syntax and method of saving the file.

Control File: Project Information

The first major part of the control file is the project information.

Control File: Survey Information

Following the project information are the surveys. Each survey section starts with "%SURVEY".

Control File: Survey Questions

The core part of the control file is the section which creates the questions and the branching logic.

Project Setup

This section outlines how the participant imports the control file and manages the survey created from that control file.

Run Survey

Running a survey is intuitive for most users so only a brief explanation is required. In this section we also explain user actions when a survey ends. There is also a method of stopping a scheduled survey, but this should only be used if a mistake is made in starting the survey in the first place.

Export Results

The participant will need to take action to send back the data at the end of the survey. This can be easily achieved by email or file sharing. This section also outlines the structure of the data file.

Data Handling

The data files are CSV text files and can be opened in standard spreadsheet programs. Some languages will need to ensure the proper settings are used to import the file.

Device Setup

This section is the most important for participants. Most Apple devices and many Android devices will run the PIEL Survey with no special setup of the device required. However, many Android devices limit behaviour of new apps using battery optimisation. The PIEL app needs to be exempted from this optimisation.