DearScholar

DearScholar: A mobile application to conduct qualitative and quantitative diary research - Published in JOSS (2020)

https://github.com/V69dxz/dearscholar

Science Score: 49.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README
  • Academic publication links
    Links to: joss.theoj.org, zenodo.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.6%) to scientific vocabulary

Keywords from Contributors

mesh
Last synced: 7 months ago · JSON representation

Repository

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

Basic Info
  • Host: GitHub
  • Owner: V69dxz
  • License: gpl-3.0
  • Language: JavaScript
  • Default Branch: master
  • Homepage:
  • Size: 14.4 MB
Statistics
  • Stars: 10
  • Watchers: 1
  • Forks: 4
  • Open Issues: 5
  • Releases: 1
Created almost 6 years ago · Last pushed over 2 years ago
Metadata Files
Readme License Code of conduct

readme.md

status

DOI

Build Status

Notification

Due to some personal and personnel changes, DearScholar is currently offline. Contact me if you want to use the app in your own research. We are exploring ways to relauch DearScholar. Thank you for your interest. 👋

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

2) Pick one of the five test credentials

| Username | Password | | ------------- | ------------- | | test1 | test1 | | test2 | test2 | | test3 | test3 | | test4 | test4 | | test5 | test5 |

3) 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 :rocket:.

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

  • Houtgraaf, G. (in press). Public sector creativity: Triggers, practices and ideas for public sector innovations. Public Management Review, https://www.tandfonline.com/doi/full/10.1080/14719037.2022.2037015
  • Houtgraaf, G., Kruyen, P.M., & Van Thiel. S. (in press). Public Servants’ Creativity: Salient Stimulators and Inhibitors A longitudinal qualitative digital diary study. Public Management Review, https://www.tandfonline.com/doi/full/10.1080/14719037.2022.2103175

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 :icecream:.

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.

Owner

  • Name: V69dxz
  • Login: V69dxz
  • Kind: user

GitHub Events

Total
Last Year

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 536
  • Total Committers: 5
  • Avg Commits per committer: 107.2
  • Development Distribution Score (DDS): 0.317
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
pmkruyen 2****n 366
pmkruyen p****n@g****m 145
dependabot[bot] 4****] 11
Bruno P. Kinoshita k****w 11
DanielPolman 9****n 3

Issues and Pull Requests

Last synced: 7 months ago

All Time
  • Total issues: 11
  • Total pull requests: 29
  • Average time to close issues: 16 days
  • Average time to close pull requests: about 9 hours
  • Total issue authors: 4
  • Total pull request authors: 4
  • Average comments per issue: 8.73
  • Average comments per pull request: 0.34
  • Merged pull requests: 29
  • Bot issues: 0
  • Bot pull requests: 11
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • V69dxz (5)
  • kinow (4)
  • ReneeVermeulen (1)
  • Glenn437 (1)
Pull Request Authors
  • dependabot[bot] (11)
  • V69dxz (10)
  • kinow (6)
  • DanielPolman (2)
Top Labels
Issue Labels
bug (3) enhancement (1) good first issue (1)
Pull Request Labels
dependencies (11) javascript (1) php (1)

Dependencies

App/package-lock.json npm
  • 114 dependencies
App/package.json npm
  • cordova-android ^9.0.0 development
  • cordova-ios ^6.1.0 development
  • cordova-plugin-fingerprint-aio 3.0.1 development
  • cordova-plugin-ionic-keyboard 2.2.0 development
  • cordova-plugin-statusbar 2.4.3 development
  • cordova-plugin-whitelist 1.3.4 development
  • cordova-sqlite-evcore-extbuild-free 0.11.0 development
  • cordova-support-google-services ^1.3.2 development
  • phonegap-plugin-multidex ^1.0.0 development
  • phonegap-plugin-push 2.3.0 development
App/www/lib/framework7/package.json npm
  • dom7 ^2.1.3
  • path-to-regexp ^6.1.0
  • ssr-window ^1.0.1
  • template7 ^1.4.2
testing/phpunit/composer.json packagist
  • guzzlehttp/guzzle ^7.0
  • phpunit/phpunit ^9.3
testing/phpunit/composer.lock packagist
  • doctrine/instantiator 1.3.1
  • guzzlehttp/guzzle 7.0.1
  • guzzlehttp/promises v1.3.1
  • guzzlehttp/psr7 1.8.5
  • myclabs/deep-copy 1.10.1
  • nikic/php-parser v4.8.0
  • phar-io/manifest 2.0.1
  • phar-io/version 3.0.2
  • phpdocumentor/reflection-common 2.2.0
  • phpdocumentor/reflection-docblock 5.2.1
  • phpdocumentor/type-resolver 1.3.0
  • phpspec/prophecy 1.11.1
  • phpunit/php-code-coverage 9.1.4
  • phpunit/php-file-iterator 3.0.4
  • phpunit/php-invoker 3.1.0
  • phpunit/php-text-template 2.0.2
  • phpunit/php-timer 5.0.1
  • phpunit/phpunit 9.3.7
  • psr/http-client 1.0.1
  • psr/http-message 1.0.1
  • ralouphie/getallheaders 3.0.3
  • sebastian/code-unit 1.0.5
  • sebastian/code-unit-reverse-lookup 2.0.2
  • sebastian/comparator 4.0.3
  • sebastian/complexity 2.0.0
  • sebastian/diff 4.0.2
  • sebastian/environment 5.1.2
  • sebastian/exporter 4.0.2
  • sebastian/global-state 5.0.0
  • sebastian/lines-of-code 1.0.0
  • sebastian/object-enumerator 4.0.2
  • sebastian/object-reflector 2.0.2
  • sebastian/recursion-context 4.0.2
  • sebastian/resource-operations 3.0.2
  • sebastian/type 2.2.1
  • sebastian/version 3.0.1
  • symfony/polyfill-ctype v1.18.1
  • theseer/tokenizer 1.2.0
  • webmozart/assert 1.9.1
Dockerfile docker
  • mattrayner/lamp latest-1804 build