Introduction

Why MindLogger?

The purpose of MindLogger is to make it easy for anyone to collect, analyze, and visualize data anywhere using mobile devices. Easy means user-friendly, intuitive, and engaging for the mobile device user and for those who manage users, edit content, and review collected data. To make it easy to get started, we are building a Public Library of open content to select or edit activities. An online interface makes it easy to build new activities on any topic, such as surveys, quizzes, digital diaries, or tasks. If you are a researcher, clinician, or instructor, these activities will appear in a customized mobile app for use by your study participants, patients, students, or yourself.

Why MindLogger instead of an existing platform?

There are many different mobile data collection platforms to choose from. MindLogger distinguishes itself from every other platform by its combination of the following criteria that we feel are important. MindLogger:

  • is freely available
  • is open source
  • makes it easy to configure your own mobile apps
  • has many user response methods (survey lists and tables, slider bars, audio, photos, drawing, etc.)
  • allows user notifications per activity
  • requires no programming or design experience
  • creates cross-platform (iOS and Android) mobile apps
  • SOON: version 2 will generate more attractive and intuitive surveys and other activities
  • SOON: will support a public commons of activities to draw from and contribute to
  • SOON: will abide by open and interoperable standards that respect provenance

However, while we are working on the following, the current version of MindLogger:

  • does not track data passively (consider a platform such as Beiwe for this)
  • is not compatible with wearable devices
  • does not handle proprietary questionnaires or other content in its library
  • will work offline, but needs an Internet connection to register, log in, and update the database
  • is not GDPR compliant (we are working on this, too!)

How can I get involved?

If you would like to try MindLogger, visit the Download page for links to the web panel and to download the mobile apps. No programming or design expertise is required to use MindLogger, but we welcome programmers and designers to help make MindLogger ever more attractive, engaging, intuitive, efficient, and secure. All of the software is open source to welcome the developer community to get involved; please visit the Develop page for links and more information. We also welcome content developers to contribute to the Public Library and to translate existing content into new languages; please visit the Web Admin Panel page to contribute.

Who is responsible for MindLogger?

The creators and primary developers of MindLogger are the MATTER Lab team. The MATTER Lab is a research lab within the Child Mind Institute, a nonprofit research institute in New York City. The Lab builds and applies technologies such as wearable devices, mobile apps, and analytics tools to help diagnose, assess, monitor, and improve mental health.

How to cite MindLogger?

When using MindLogger please include a link to the https://mindlogger.info website.

Why open source?

First, as scientific researchers, we believe that proprietary code hides implementation details that compromise the transparency and integrity of scientific research. Second, when an entire community of distributed programmers is invited to scrutinize and make corrections to a code base, that software will be far less likely to fail than if it were under the auspices of a small team building for limited use cases. We have chosen the Apache v2.0 license because it is liberal and supports broad use and modification of software. The Apache license allows other projects with virtually any license, including GPL, to use our code, and makes it more likely that we will attract support from companies, including open-source software companies, such as Continuum Analytics, Enthought, and Kitware.

MindLogger for Beginners

Where do I start?

Check out the About page for information about the mobile app and the web admin panel.

What features does MindLogger include?

Check out the Features page for current features. Check out the Develop page (particularly the project board and wiki links) for features in the works.

How do I log in?

Once you create an account on the app or admin panel, those credentials will allow you to log in anywhere MindLogger requires authentication.

I clicked “Forgot Password?” and submitted my email address. Where is my reset password email message?

Check your spam or junk folder. If you still can’t find the message, email us.

What if I find a bug or have a suggestion?

Let us know! You can email the team or report the issue on GitHub.

Mobile App

What are the dates and times in the activities list? Why are they in the past and/or future?

At the top of the activities list are any incomplete activities
in blue. Below these are any overdue or scheduled activities for the current day with the scheduled times in grey. Finally, at the bottom are any scheduled activities after today with scheduled dates in grey, followed by any unscheduled activities:
Activities list

Why don’t I see any activities in my app?

Probably you have not been assigned a User role by a Manager to any applets with activities, or you need to refresh with the button in the top right of the screen.

Can I use the same app for more than one user / subject / informant?

Not yet, but eventually.

What phone sensors does MindLogger use?

Right now just the touchscreen, camera, and microphone, and only actively, ie, when you use the app. More will be used in future.

Web Admin Pages

What is an applet / activity / screen / information screen?

Screens are the pages displayed to Users in the app. Activities are sequences of screens. Information screens are special activities that appear when a user taps an information symbol (🛈). Applet information screens appear in the app’s About section and activity information screens are linked from the top right corner of their associated activities.

An applet has 0‒1 applet information screens and 1 or more activities. An activity has 0‒1 activity information screens. All activities are composed of 1 or more screens. Parent entities are created before child entities, so

  • applet before either applet information screens or activity
  • activity before screen or activity information screens Information Screens Entity-Relationship diagram

Web Dashboard & Data Access

Where can I see my data?

The data access dashboard is not quite ready yet.

Can I export my data? What format is my data in?

We don’t have export features built yet. If you want to code your own reports, you can access your data in JSON format through the API endpoints.

Are my data secure?

All data are stored in access-controlled encrypted MongoDB document stores and served with HTTPS protocols. Only authorized viewers and site administrators can access your data. Currently only a site administrator can authorize data access. In future, you will be able to control who can and cannot see your data.

How long will you keep my data?

The current versions of MindLogger are for testing, so data collected in these versions will eventually be purged. If you’d like your data to be deleted sooner, let us know.

Licenses

MindLogger Software License

Except where otherwise noted, all MindLogger software is licensed under the Apache v2.0 license. The usual disclaimer: THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

MindLogger Documentation License

Except where otherwise noted, all MindLogger documentation is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License (CC BY-SA 4.0). All code fragments in the documentation are licensed under our software license.

MindLogger Content Licenses

As MindLogger’s content is user-provided, users are responsible for accurately documenting the relevant licenses of each contributed screen, activity, and applet. All collected data are the property of the contributing user and can be removed by request at any time.