For grant-funded principal investigators operating under IRB or ethics committee protocols with multi-site data collection.
Using the MAP and PEACS instruments on the ATLAS platform
PI-[INST]-XXXX-2026) and Letter of Permission from keys.adherence.cc; (2) sign in with key + email verification (OTP); (3) provision site coordinator keys linked to your PI key — see § 3; (4) confirm each coordinator can sign in and that a test submission appears in your PI dashboard; (5) delete test records before enrollment begins. Your site coordinators start each patient encounter with Start New Patient Session in their dashboard — see § 6 for the full data collection procedure.
This Standard Operating Procedure governs the use of the ATLAS platform (Adherence Tracking and Longitudinal Assessment System) for multi-site medication adherence data collection in research studies. It covers workspace setup, role assignments, data collection procedures, quality assurance, and export protocols.
This document is intended to accompany the study's primary IRB protocol as a technical appendix describing the digital data collection platform. It does not replace the protocol itself.
MAP (Multidimensional Adherence Parameters) is the 8-item, cross-sectional adherence instrument administered through ATLAS for institutional data collection. It provides a validated snapshot of medication adherence behaviour and is the intellectual property of Adherence Inc. (© TX 8-632-533). Use on ATLAS is governed by a licensing agreement between the study institution and Adherence Inc.
Every workspace key issued through ATLAS includes a Letter of Permission specific to the named PI, institution, and study title. This letter must be retained in the study's regulatory binder and submitted with ethics applications.
Available on the PI tier and above, the PE Domain Analysis applies the Theory of Predictive Emergence (TPE) to each patient's MAP response profile. It computes three behavioural domain scores from the Q1–Q8 responses already collected, then derives a composite PE score: PE = (A × E × C)1/3.
PE domain values are stored on each assessment record and exported as mmas_pe, mmas_a, mmas_e, mmas_c columns in the MAP CSV. They are computed from the same Q responses already required for the standard instrument — no additional patient-facing questions are involved. PE is computable retroactively on all historical records in the cohort. The PI dashboard includes a PE Domain Analysis panel showing cohort-level domain averages and a lowest-PE patient table for intervention prioritisation.
The Predictive Emergence Assessment for Clinical Services (PEACS v2.0) is a three-dimension instrument developed by Philip Morisky, Founder of Adherence Inc., based on the Theory of Predictive Emergence (DOI: 10.5281/zenodo.18209699). It is available on the PI and Institution tiers. PEACS data is collected at the same session as the MMAS-8 and stored in a separate data node.
The MMAS-8 has been validated in over 3,000 published studies across 100+ countries. MAP (Multidimensional Adherence Parameters) administered through ATLAS uses the original validated wording. The ATLAS platform itself has been used in institutional research at the University of Nicosia, Democritus University of Thrace, NUST Oman, and multiple clinical sites in Italy (SIMAT partnership).
The PI receives a PI-tier workspace key (format: PI-[INST]-XXXX-2026) upon purchase at keys.adherence.cc. This key provides access to the full ATLAS dataset including all sub-site data, the multi-site dashboard, bulk upload, IRB-grade export, and PE Domain Analysis.
Each data collection site should have its own workspace key (typically Researcher tier). This allows:
Sub-site keys are issued as Researcher tier and linked to your PI key as the Parent Institution Key — their data flows into your multi-site dashboard automatically. Contact info@adherence.cc to provision sub-site keys, providing: site name, coordinator name, and coordinator email. If your study is operating under an Institution account, sub-site Researcher seats are included in the institutional plan (5 seats in base, additional at $39/seat/month) — no separate subscription required per coordinator.
Email info@adherence.cc: site name, coordinator name, coordinator email, estimated patient volume, and your PI key prefix.
The site-specific key is emailed to the coordinator with instructions. Their Letter of Permission names the PI's study title and their institution.
When the coordinator first signs in, they enter their workspace key and then receive a 6-digit one-time code to their registered email. This two-step sign-in applies to all keyed workspace roles. Ensure the coordinator's correct email is on file before they attempt first login — contact info@adherence.cc to update if needed.
Have the coordinator submit one test assessment. Verify it appears under their workspace key in the PI dashboard. Use Patient ID "TEST-SITE-001" for test records — document this in your protocol deviation log.
Email info@adherence.cc to remove test records. Include workspace key prefix and Patient IDs of test submissions.
| Capability | Student (STU-) | Clinician · Researcher (NP- · PA- · RN- · MD- · PHRM- · CC- · RES-) | PI (PI-) | Institution (INST-) |
|---|---|---|---|---|
| Sign-in MFA (OTP email) | ✓ Required | ✓ Required | ✓ Required | ✓ Required |
| Administer MAP | ✓ | ✓ | ✓ | ✓ |
| Administer PEACS | Snapshot only | ✓ Full longitudinal | ✓ Full + stratification | ✓ |
| ZOE voice assessment | ✓ | ✓ | ✓ | ✓ |
| ZOE SOAP notes | – | ✓ | ✓ | ✓ |
| MTM Session Timer | – | ✓ (clinician · researcher tier) | ✓ (clinician · researcher tier) | ✓ |
| MTM Audit Log | – | ✓ | ✓ | ✓ |
| Sentinel alerts | – | ✓ Own cohort | ✓ All sites | ✓ All sites |
| CSV export | 100/month | Unlimited | Unlimited | Unlimited |
| IRB-grade export headers | – | – | ✓ | ✓ |
| Blinded export (hashed patient IDs) | – | – | ✓ | ✓ |
| Dataset lock · frozen snapshots | – | – | ✓ | ✓ |
| Workspace audit log | – | – | ✓ | ✓ |
| IRB Study Package generator | – | – | ✓ | ✓ |
| Bulk upload (XLSM) | ✓ | ✓ | ✓ | ✓ |
| MAP PE Domain Analysis | – | ✓ Cohort PE panel | ✓ Cohort PE panel | ✓ + per-site breakdown |
| Cross-site PE heatmap | – | – | ✓ All child sites | ✓ |
| Enrollment velocity tracking | – | – | ✓ | ✓ |
| Self-service site provisioning | – | – | ✓ Up to 5 sites | ✓ |
| Multi-site dashboard | – | – | ✓ (via parent key) | ✓ |
| API access | – | – | ✓ Rate-limited | ✓ |
| Population Health Command Center | – | – | – | ✓ |
institution_codealerts/{workspace} nodeEach workspace key creates an isolated data namespace. A coordinator with key RES-SITE1-XXXX-2026 can only see records tagged with that key. The PI with key PI-INST-XXXX-2026 can see records tagged with either the PI key directly or any child workspace registered under it.
| Field | Required | Patient-provided | Notes |
|---|---|---|---|
| MMAS-8 scores (Q1–Q8) | Yes | Yes | Core instrument data |
| Timestamp | Yes | No (system) | Unix milliseconds, UTC |
| Workspace key | Yes | No (system) | Identifies cohort/site |
| Country | No | Yes | Free text, patient-reported |
| City | No | Yes | City level only |
| Patient ID | No | No (researcher assigns) | Your anonymisation code |
| Condition | No | Yes | Self-reported diagnosis |
| Medication name | No | Yes | Self-reported drug name |
| Demographics | No | Yes | Age range, gender, education — not name or DOB |
| Geolocation | No | Yes (browser prompt) | City-level, used for map only |
mmas_pe | No (derived) | No (computed) | PE composite score 0–1; derived from Q1–Q8 via TPE formula. PI tier+. |
mmas_a | No (derived) | No (computed) | Architecture domain — mean(Q2,Q3,Q6). PI tier+. |
mmas_e | No (derived) | No (computed) | Execution domain — mean(Q1,Q4,Q5,Q8). PI tier+. |
mmas_c | No (derived) | No (computed) | Context domain — Q7 value. PI tier+. |
When ATLAS records are submitted to or used in support of FDA-regulated studies (IND, NDA, 510(k)) or GCP-compliant clinical research, the platform operates under FDA 21 CFR Part 11. The following controls are active in the platform:
| Control | Regulatory basis |
|---|---|
| Immutable audit trail — every record create / update / delete logged with actor, timestamp, and SHA-256 payload hash | §11.10(d)(e) |
| Two-component electronic signature on data submission: email + password re-authentication at time of signing | §11.200(b) / §11.50 |
Electronic signature on record deletion (Mission Control); signature_id stored on target record | §11.70 / §11.50 |
| 30-minute inactivity session timeout with audit entry on expiry | §11.10(f) |
| Failed login events logged to audit trail | §11.10(d) |
| Read-only Audit Log Viewer (superadmin) — no delete or edit controls | §11.10(d) |
| System validation documentation: IQ / OQ / PQ / SRS / RTM prepared | §11.10(a) |
For studies requiring FDA submission, contact info@adherence.cc to request the system validation documentation package (IQ/OQ/PQ) for inclusion in your regulatory binder.
Every assessment begins with the Start New Patient Session workflow. The session modal requires the researcher to select the instrument(s) before the patient touches the screen, ensuring the correct assessment pathway is loaded and a unique Patient ID is generated prior to consent.
| Selection | Assessment sequence | When to use per protocol |
|---|---|---|
| MMAS-8 Only | Consent → MMAS-8 → result | Cross-sectional adherence studies; when PEACS is not in scope |
| PEACS Only | Consent → PEACS → result | When MMAS-8 has been collected separately and PEACS dimension data is needed |
| MMAS-8 + PEACS | Consent → SDoH → MMAS-8 → PEACS → result | Combined sessions; SDoH answered once and applied to both instrument records |
Clicking Continue to Informed Consent → generates an auto-assigned Patient ID (e.g. PT-A3F7). The researcher must record this ID in the CRF immediately — it is the link between the ATLAS record and all other study data. This ID cannot be changed after the session begins.
Document any departure from this SOP in your study's deviation log, including: assessments completed without Patient ID assignment, technical failures requiring manual re-entry, or patients who completed assessment in incorrect language. These should be noted but do not invalidate the data.
The Clinical Study Module is accessed via the Study tab in the Institution dashboard. It provides a unified research operations view with the following components:
Before collecting data, complete the Study Config (gear icon in the Study tab). Required fields: Study Name/Title, Principal Investigator, Institution, IRB Number. Optional but recommended: ClinicalTrials.gov ID, Protocol Version, Sponsor, enrollment target and visit schedule.
A world map displays all registered study sites colour-coded by status (Pending / Active / Closed). Add sites via the Add Site button. Site coordinates and status are stored locally and reflected on the map in real time.
The module tracks enrolled patients against target, flags patients who are Lost to Follow-Up (LTFU) based on their expected visit window, and logs protocol deviations.
Opens a 5-tab auto-populated IRB document template drawing from your Study Config. Tabs: Protocol Summary, Informed Consent, Risks & Benefits, Privacy & Data, Timeline & Sites. Each section is editable and the complete document exports as a structured .txt file suitable for submission or paste into your IRB system.
Bulk upload allows researchers to import patient assessment records from a structured CSV file directly into the ATLAS platform. The current template version includes study-level metadata for regulatory traceability.
The PI (or designated data manager) should review the dashboard weekly during active collection to:
The Active Patients table can be searched by Patient ID. If the same Patient ID appears more than once with the same timestamp, this may be a duplicate. Contact info@adherence.cc to review and remove confirmed duplicates from your dataset.
The export CSV includes a timestamp column. Use this to verify all sites are submitting data within expected windows. Gaps may indicate technical issues, coordinator absences, or site-level protocol deviations that require follow-up.
The PI Research Dashboard is a dedicated panel at the top of your researcher view, visible only to PI-tier workspaces. It loads automatically when you sign in and consolidates the key governance metrics for your study in one place.
The four KPI cells at the top of the panel show: total enrolled participants, current weekly enrollment rate (calculated over the last 8 weeks), projected completion date (based on current rate toward your target), and the data retention deadline (computed from study end date plus the mandated retention period for your funding source — 7 years for NIH/NSF/DoD/PCORI, 10 years for industry-sponsored, 5 years for all others).
Set your enrollment target using the target input field. The progress bar fills as you approach your goal. Projected completion updates in real time as new records arrive.
Below the KPI strip, the PE heatmap shows one row per collection site (including your own PI workspace). Each cell displays the mean Architecture, Execution, and Context domain score for that site, colour-coded from red (constraint present) to green (domain healthy). This makes cross-site adherence barrier patterns immediately visible without exporting data.
Sites with fewer than 3 records are greyed out — insufficient data for meaningful domain averages. The heatmap refreshes each time the dashboard loads.
The Dataset Lock section allows you to create an immutable copy of all assessment records at a specific point in time. Use this for:
Click ⊘ Lock Current Dataset to create a snapshot. The platform confirms the record count before locking. Each snapshot is permanently stored and listed with its creation date, MMAS count, and PEACS count. Use the ↓ CSV button next to any snapshot to download that frozen dataset.
The Audit Log displays the last 50 timestamped events for your workspace, newest first. Events recorded include: key issuance, key verification (each sign-in), data exports, dataset lock operations, site provisioning, electronic signatures, and failed login attempts. This log is suitable for inclusion in a regulatory binder as evidence of controlled access and data handling.
The audit log is append-only — entries cannot be deleted or edited. It persists for the lifetime of your subscription. All clinical record write operations (create, update, delete) generate a CFR-11 audit entry with a SHA-256 payload hash, satisfying FDA 21 CFR Part 11 §11.10(d)(e) requirements for tamper-evident, computer-generated, time-stamped records.
The PI tier includes IRB-grade export headers — additional metadata columns added to the CSV that are not present in the standard Researcher export.
| Column | Contents |
|---|---|
institution_code | Workspace key of submitting site — identifies which site collected the record |
parent_institution | PI key (if sub-site keys are used) — links site records to the study |
consent_version | Version of consent text the patient accepted |
assessment_type | Manual / ZOE voice / Daily intake rapid screen |
zoe_session | Boolean — whether ZOE was used for this assessment |
soap_note_generated | Boolean — whether a SOAP note was generated |
mmas_pe | PE composite score (0–1) computed from Q1–Q8 via TPE formula — PI tier and above |
mmas_a | Architecture domain score — mean(Q2, Q3, Q6) |
mmas_e | Execution domain score — mean(Q1, Q4, Q5, Q8) |
mmas_c | Context domain score — Q7 value |
The ⊘ Blinded Export button (in the MMAS-8 panel footer, visible to PI accounts) generates a CSV in which all patient IDs are replaced with deterministic hash codes. The same patient will always receive the same hash code within your workspace, so longitudinal records remain linkable — but the original patient numbers are not recoverable from the export. Use this format when sharing datasets with collaborators who do not need to know your patient numbering scheme.
Before cancelling, use ⊘ Lock Current Dataset in the PI Research Dashboard to create a permanent snapshot of all records. This snapshot survives subscription cancellation requests and constitutes your archived dataset for the regulatory binder.
Use the ↓ CSV button next to the locked snapshot to download the frozen dataset. Store in your institution's approved research data repository.
Click Generate Study Package in the PI Research Dashboard to produce a printable summary page containing: study metadata, enrollment summary, PE domain breakdown, snapshot record counts, and audit log. Print to PDF and file in your regulatory binder alongside the permission letter.
Use the Session Certificate button in the MMAS-8 panel to generate a timestamped audit document covering the full history of assessments. Print to PDF and attach to your binder.
Email info@adherence.cc with your PI key prefix and study end date. Data deletion is completed within 30 days and confirmed by email.
| Event | First response | Escalation | Timeline |
|---|---|---|---|
| Sentinel alert — Urgent (red) | Site coordinator reviews and contacts patient | PI informed if no resolution within 48h | Act within 7 days |
| Site data gap (>3 days no submissions) | PI contacts site coordinator | Protocol deviation log entry | Within 24h of detection |
| Workspace key compromised (shared unauthorised) | Email info@adherence.cc for immediate revocation | Issue new key to site. Log as protocol deviation. | Immediate |
| Platform unavailability (>2h) | Check status at atlas.adherence.cc. Use paper backup CRF. | Email info@adherence.cc. Document downtime period. | Immediate, log in deviation record |
| Patient distress during assessment | Stop assessment. Provide clinical support per protocol. | Document incident. Assess need for SAE reporting. | Immediate |
| IRB query about platform | Refer to this SOP and the ATLAS privacy documentation | Contact info@adherence.cc for technical support letter | Within IRB response deadline |
Use this section for IND, NDA, 510(k), or GCP-compliant studies where the FDA 21 CFR Part 11 electronic records requirement applies.
Your Letter of Permission (LOP) is issued at workspace key activation and records your subscription activation date. It covers data collected during your active subscription period only. It does not reach backward. If your subscription lapses at any point, the LOP expires for that gap period — data collected after reactivation is covered from that new activation date forward.
For PI-tier studies funded by grants, contracts, or institutional budgets, a standard subscription covers your data collection period while the subscription is active. If your study spans multiple years and you maintain continuous subscription coverage, your LOP remains valid throughout. If your study began before you subscribed to ATLAS, only the post-activation portion of your data is covered under the subscription LOP.
If you need publication rights covering a study that predates your ATLAS subscription — for example, you conducted a funded study before the platform was available and are now seeking to publish — contact info@adherence.cc with your study title, funding source, IRB number, and data-collection dates. Publication rights for funded studies are priced by study duration, not a flat rate.
| Path | Who it is for | How to obtain |
|---|---|---|
| Letter of Permission (MAP- key) | Any active workspace subscriber — student, clinician, researcher, PI, institution | Issued automatically at key activation. Download from your dashboard → Publish tab. |
| Student Publication License (PUB- key) | Students and self-funded researchers with a completed thesis or dissertation and no active subscription | atlas.adherence.cc?publish=1 — one-time flat rate, instant issuance ($49–$249 by N) |
| Funded Study Publication Rights | PIs and researchers whose data collection was grant or institutionally funded | Email info@adherence.cc — duration-based pricing, custom quote |
If your subscription lapses before your manuscript is submitted, your Letter of Permission expires. To restore publication coverage you have two options: reactivate your subscription (LOP reissued immediately, covers data from reactivation forward), or contact info@adherence.cc to discuss duration-based publication rights for the completed study period.
This SOP should be updated when any of the following occur:
All amendments should be dated, versioned, and re-signed. Previous versions should be retained in the study regulatory binder. Notify info@adherence.cc of any material amendments to ensure platform support is aligned with updated procedures.
| Version | Date | Change | Author |
|---|---|---|---|
| 2026.04 | April 2026 | Initial version — covers MAP, PEACS v2.0, MTM audit, Sentinel alerts. Updated § 6 for Start New Patient Session modal workflow and auto-generated Patient ID handling. | Adherence Cartography |
| 2026.04.1 | April 2026 | Added § 2 MAP PE Domain Analysis (TPE layer): formula, three domain definitions, export columns (mmas_pe/a/e/c). Updated § 5 data elements table and § 9 IRB export columns to include PE fields. Added PE Domain Analysis row to § 4 role matrix. | Adherence Cartography |
| 2026.04.2 | April 2026 | Added new § 8 PI Research Dashboard covering: enrollment velocity KPIs, data retention deadline, cross-site PE heatmap, dataset lock / frozen snapshots, and workspace audit log. Updated § 9 export section to document blinded export, dataset lock closeout procedure, and IRB Study Package. Updated TOC and § 4 role matrix with new PI capabilities: blinded export, dataset lock, audit log, IRB Study Package, enrollment velocity, cross-site heatmap, self-service site provisioning. Renumbered §§ 8–12 accordingly. | Adherence Cartography |
| 2026.05 | May 2026 | Terminology update: MMAS-8R retired; replaced with MAP (Multidimensional Adherence Parameters) throughout. Updated metadata block instrument(s) field and subtitle. Added §§ 6a–6b: Clinical Study Module — Research Operations (Study Config, Site Activation Tracker, Enrollment/LTFU, IRB Submission Assistant) and Bulk Upload v2 Template — Study Provenance. Added ZOE Remote Mode callout to § 6 data collection. Updated TOC. Footer and amendment log updated to reflect MAP terminology. | Adherence Cartography |
| 2026.05.1 | May 2026 | Added § 12a Publication Rights and Licensing: LOP activation-date coverage policy, retroactive coverage prohibition, multi-year funded study guidance, three-path publication rights table (LOP / Student Publication License / Funded Study inquiry), subscription-lapse guidance, and dataset lock best practice. Updated TOC. Reflects new student-only flat-rate Publication License policy and duration-based pricing for funded research. | Adherence Cartography |
| 2026.05.2 | May 2026 | Added 21 CFR Part 11 (FDA Electronic Records & Electronic Signatures) coverage throughout. § 5 Data Flow: new CFR-11 controls subsection with 7-item table (audit trail, e-signatures, session timeout, failed login logging, validation docs). § 8 Workspace Audit Log: enhanced description noting CFR-11 SHA-256 payload hashing and §11.10(d)(e) compliance. § 11 IRB Submission Language: added FDA-regulated study boilerplate (electronic records attestation, §11.200(b), §11.50, §11.70, §11.10(f) citations). Footer updated to v2026.05.2. | Adherence Cartography |