Skip to content
Richard Darst edited this page Jan 8, 2020 · 13 revisions

This is the main documentation of the Koota project. This repository contains the server, but this wiki also coordinates among all related projects. Everything should be considered currently under development.

Table of contents:

  • Features
  • User guide - if you are collecting data
    • UserGuide - for people collecting their own data.
    • For information on specific devices, see the DataSources part below.
  • Data sources
    • Murata sleep sensors
    • Mobile devices via the Aware Framework
      • Aware - general user instructions.
      • Data sources can be found on the Aware sensors page. Our converters are generally a thin wrapper over these raw columns.
      • (developer focused) AwareSettings - How to send special settings to the app via Koota. This is still confusing and you want to ask before doing.
      • (developer focused) AwareDev - our Aware development scratch space. Not useful for users.
      • Source repos: our forks are in the CxAalto group on github, and upstream Android and iOS.
    • Actiwatch
    • Surveys - undocumented. Web surveys via Koota.
    • (obsolete) PurpleRobot (Android) - now mostly replaced by Aware, don't use for new projects.
    • (unused) Facebook, Twitter, Instagram via OAuth linking (half-finished. Could be used more eventually).
    • (obsolete) FunfJournal (Android) - obsolete and never really used* Researcher guide - if you are making sense of data
  • Researchers and those analyzing data
    • ResearcherGuide - for people looking at data, either their own or as part of a study
    • niimpy is a Pytho nlibarry for analyzing data.
    • For information on understanding data from specific devices, see the relevant section on each data sources's page.
  • The group system - how studies work
  • DevGuide - high level technical overview, how to work on the code, hints on installation
    • ToDo (but check the last modified date, short-term issues in issue tracker)

About

Koota is a research data collection system. Data is collected from various devices, mostly from human subjects. There are three main use cases: Individuals actively collecting their own data, research studies involving researchers learning from many subjects, and finally a hybrid: individuals collect their own data, and donate it to research groups as they see fit, after it has been collected. There is a strong emphasis on privacy, transparency, and flexibility.

This project is under active development, and this repository should be considered a development repo. Currently, this source code is synonymous with the master instance. Future deployments will require some splitting of certain components.

This project is developed in the Complex Systems Group, CS Department, Aalto University, Finland.

Reference

If you are using Koota, please do not forget to reference it as:

Aledavood T, Triana Hoyos AM, Alakörkkö T, Kaski K, Saramäki J, Isometsä E, Darst RK Data Collection for Mental Health Studies Through Digital Platforms: Requirements and Design of a Prototype JMIR Res Protoc 2017;6(6):e110 URL: http://www.researchprotocols.org/2017/6/e110 DOI: 10.2196/resprot.6919 PMID: 28600276 PMCID: 5483244