M2C2kit Overview

m2c2kit is a Typescript/Javascript framework for rapid-creation and iteration of cognitive assessments.

For more information about creating your own m2c2kit tasks, visit our documentation:

https://m2c2-project.github.io/m2c2kit/

Overview: Using URL-based approach in your study

The link below is an example of a task demo for the Symbol Search cognitive assessment, with 3 trials

https://prod.m2c2kit.com/m2c2kit/nt/index.html?activity_name=symbol-search&study_id=demo&api_key=demo&number_of_trials=3::int&participant_id=XXX&session_id=XXX&admin_type=metricwire

The rest of this guide (as well as pages linked below) covers additional parameters you may leverage to customize the experience in your study.

Getting Started Workflow

1. Initial interest: If interested in using the M2C2kit assessments with our secure data backend, please fill out this Airtable form to collect information about your study, IRB, and team: Initial interest m2c2kit form.

2. Onboarding: Refer to the appropriate integration guide (e.g., Qualtrics, MetricWire) depending on your study needs. Once you have added your cognitive assessments, you must follow the Authorization Guide. We will then register your study data users and register your study ID on our portal. We will return an API key, Study ID and test URLs containing this information.

   • Parameterizing tasks via URL, available params: docs/api_params.md
   • Qualtrics Integration guide: docs/qualtrics.md
   • Metricwire Integration guide: docs/metricwire.md
   • Authorization Guide: docs/authorization_guide.md

3. Verification: Once your study is configured via your chosen integration partner, we ask that you verify all links and resulting data before launching your study. With our API documentation, you will be able to develop a dashboard if relevant to your project (e.g., in Retool, Streamlit, Dash, etc.).

   • Use our Jupyter Notebook template to get started (requires contact with M2C2 Team to configure access for querying)
     • Required software: Visual Studio Code with Jupyter Notebook Extension or Jupyter Lab (or Anaconda)

4. Liftoff: We will provide a set of Python and R scripts with common data querying use cases addressed. Once your study is complete, we will arrange sharing of all raw data files.

About this Repository of Integration Guides

With the web-based implementation of M2C2kit assessments, it is possible for them to be embedded via Qualtrics, REDCAP, and Metricwire (as well as anything else with a WebView[cite]).

This repository contains implementation guides for using M2C2kit.

The templates folder will contain examples of different ways in which you may configure m2c2kit cognitive assessments, e.g., in Qualtrics.

Table of Contents

• Parameterizing tasks via URL, available params: docs/api_params.md
• Qualtrics Integration guide: docs/qualtrics.md
• Metricwire Integration guide: docs/metricwire.md
• Authorization Guide: docs/authorization_guide.md
• Jupyter Notebook Template: Jupyter Notebook template