Skip to main content

Getting Started with Cortex

Cortex is the open-source Python library for analyzing data collected through mindLAMP.

Installation​

pip install lamp-cortex

Requires Python 3.8+ and a connection to a mindLAMP server.

Environment Setup​

Set the following environment variables to connect Cortex to your LAMP server:

export LAMP_ACCESS_KEY="your_email@address.com"
export LAMP_SECRET_KEY="your_password"
export LAMP_SERVER_ADDRESS="api.lamp.digital"
VariableDescription
LAMP_ACCESS_KEYLogin email or access key
LAMP_SECRET_KEYPassword or secret key
LAMP_SERVER_ADDRESSServer address (e.g., api.lamp.digital)

Or configure in Python:

import cortex
import LAMP
LAMP.connect('email@address.com', 'password', 'api.lamp.digital')

Quick Example​

import cortex

# Compute screen duration for a participant over one week
result = cortex.secondary.screen_duration.screen_duration(
    id="U1234567890",
    start=1638248400000,
    end=1638248400000 + 7 * 86400000
)

Next Steps​

  • Running Cortex — Use cortex.run() to process multiple participants and features at once, with full parameter reference.
  • Cortex Features — The three-tier pipeline: raw, primary, and secondary features.
  • Cortex Visualizations — Built-in plotting functions.