Skip to content

chriskisskiss/dearscholar

 
 

Repository files navigation

status

DOI

Build Status

Overview

Because collecting longitudinal data becomes more important in academic research nowadays and because limitations with available tools, DearScholar has been developed.

DearScholar allows researchers to easily and orderly collect rich and diverse qualitative and quantitative data over short and long periods of time to answer research questions about inter- and intra-individual changes, developments, and processes.

Developed as hybrid app in Cordova (using html, javascript, and css), DearScholar can be used to collect data on iOS devices (iPhones and iPads), Android devices, and--in the future--in web browsers too.

This page provides testing instructions and general information about the app, including an overview of current features.

The Wiki section provides installation guidelines, an overview of the settings and options, (automatic) testing options, and other details.

Testing

  1. Download the app on the App Store or Google Play:
  • For iOS devices (iPhones and iPads), download the app on the App Store;
  • For Android devices, download the app on Google Play.
  • Or scan this QR code to install DearScholar directly on your device:

QR code App Store and Google Play

  1. Pick one of the five test credentials
Username Password
test1 test1
test2 test2
test3 test3
test4 test4
test5 test5
  1. Hit "Log in met Touch ID of gezichtsherkenning" or "Kies PIN" (depending on your device's capabilities and settings), accept the 'mock consent form' and start testing 🚀.

Troubleshooting

👉 While the survey questions can be programmed in any language, the 'Landing page','Menu', and warning messages are in Dutch. If you would like to use DearScholar in another language, please contact the main author, so we can adapt these texts to your needs.

👉 The test credentials are reset every night. In case all the five test credentials have been used, the 'mock consent form' isn't presented and no survey questions are shown when logged in, go to 'Instellingen' (via the 'Menu') and hit 'Reset Dearscholar' to manually reset your picked test credentials.

👉 Contact the main author at peter.kruyen@ru.nl or open an Issue in case of (additional) issues, questions, or ideas.

Interested in using DearScholar in your academic research project?

  • In the latest version of dearscholar.php (1.3) DearScholar was updated so that the app can redirect users to get and store questions from your own research server (based on a contribution by Michael Polman and Daniel Polman). Users are redirected on basis of the first five (fixed) characters of usernames (for now see the comments in the code of dear_config.php and the latest version of dearscholar.php to learn more about how this works). You can set up the necessary MySQL (or MariaDB) databases on your own server following the instructions in the Wiki, and contact the main author (peter.kruyen@ru.nl) to register your project to the app.

Current research projects

DearScholar is used in the following projects:

  • Diary study on public servants' creativity (2020 - 2021) by Glenn Houtgraaf MSc, dr. Peter M. Kruyen, and prof. dr. Sandra van Thiel.
  • Diary study on creativity in local-care teams (2021 - 2022) by Liesbeth Faas MSc, dr. Peter M. Kruyen, and prof. dr. Sandra van Thiel.
  • Diary study on nurses' work engagement (2022) by Renée Vermeulen MSc and Evelien van Leeuwen MSc.
  • Diary study on the effects of political motivation and social context on consumption choices (2022) by dr. Daniel Polman, dr. Joana Wensing, and dr. Jose Lopez Rivas.

Publications

Interested in contributing to DearScholar?

Super cool. Head to the Wiki section for the installation instructions, settings and options, (automatic) testing, and other details. Clone the project, post issues, and commit updates 🍦.

Acknowledgement

DearScholar is developed within the context of the research program "The creative public servant: Observations, explanations and consequences" with project number 406.18.R8.028, financed by the Dutch Research Council (NWO). The author wants to express his gratitude to Prof. Dr. Sandra van Thiel for her encouragements; to Glenn Houtgraaf MSc, Liesbeth Faas MSc, the ICT Services (Radboud University, Nijmegen, the Netherlands), and both reviewers and the editor at the Journal of Open Source Software for their advice, testing, and feedback; and last, but not least, all (pilot) respondents for their effort and feedback during the developmental process.

License

Copyright (c) 2022 P.M. Kruyen, Institute for Management Research, Radboud University, the Netherlands. This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (GPL3) as published by the Free Software Foundation. Radboud University, hereby disclaims all copyright interest in the program “DearScholar” (which offers an app to conduct longitudinal qualitative and quantitative diary, log and survey research) written by P.M. Kruyen. Commercial license available, please contact Radboud Innovation, Radboud University, the Netherlands. Radboud Innovation – Technology Transfer Office.

Citation

Kruyen, P. M., (2020). DearScholar: A mobile application to conduct qualitative and quantitative diary research. Journal of Open Source Software, 5(55), 2506, https://doi.org/10.21105/joss.02506

Current features

Let respondents install DearScholar on their mobile device

  1. A respondent has to download DearScholar from the App Store (iPhones and iPads) or Google Play (Android devices);
  2. When opening DearScholar for the first time (left screenshot below), a respondent is asked to:
    • allow push notifications;
    • fill out the username and password that (s)he has received from the researcher;
    • choose a 4-digit PIN if the device does not support Touch ID or Face Recognition; and
    • agree to the informed consent form.
  3. When everything goes well, DearScholar pulls the required survey tables and settings from the server, and the respondent is directed to the measurement schedule (homepage, right screenshot below).

Let respondents answer questions

When logging in to DearScholar, a respondent is directed to the measurement schedule (homepage) with all measurement occasions (dates). Future measurement occasions—measurement occasions beyond the current date—are locked and marked with a 'closed lock' icon.

When a respondent clicks on a particular measurement occasion in the measurement schedule, (s)he is directed to a survey screen that displays all survey modules for that measurement date. Each module can be opened by clicking on the designated icon (see the screenshot below).

DearScholar supports an unlimited number of survey modules, unlimited number of question pages in each module, a specification of which questions to appear on which page, simple branching and skipping logic, and different types of questions (binary questions, open questions, multiple-choice items, and rating sliders) to collect both quantitative and qualitative data (see the screenshots below for two examples). Researchers can make certain questions mandatory. Respondents can type their answers in the answer boxes... or--because DearScholar works with speech recognition--dictate their answers.

When a respondent has completed a module (i.e., for that module, all questions have been answered and the data has been successfully uploaded to the server) the module icon turns green on the survey page. If all mandatory modules have been completed, the link to the measurement occasion turns grey and is marked with a 'sun' icon on the homepage.

DearScholar also includes links to additional, optional survey modules which can be found on the homepage's menu. Respondents can start these additional modules in between measurement occasions to report their thoughts once they occur (cf. event-sampling).

Respondents’ answers are not only stored on a server upon submission, but also saved in the DearScholar App. Respondents can access their previous answers by clicking on completed measurement modules, facilitating respondents to keep track of, and reread their own responses.

Push notifications

DearScholar can be used with Google's Firebase to get the push notifications working or alternatively, a private push notification server can be used (using Node.JS for example). Contact the main author for advice on setting up such a server.

If you are interested in scheduling and randomizing user notifications, you may want to check out Daniel Polman's github page for setting up SMS notification schedule.

Additional features

DearScholar has the capacity to send short in-app messages to specific respondents. For example, respondents can be sent thank-you messages to show engagement, small encouragements when respondents have missed a measurement occasions, ask follow-up questions, or invited respondents to elaborate on particular answers over the phone or through email. These in-app messages are displayed on a separate message screen. An envelope icon appears in the app’s status bar when new messages have been sent. When respondents have read the message, the researcher is noted.

About

DearScholar: An open-source smartphone app for longitudinal scientific qualitative and quantitative (self-report) diary, log and survey research

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 70.3%
  • CSS 21.5%
  • Less 7.2%
  • PHP 0.5%
  • HTML 0.2%
  • SCSS 0.2%
  • Other 0.1%