NLP Analysis of Weekly Narratives for Dynamic Clinical Assessment in SUD
For patients and families
In plain language
An automatic summary of structured registry data. It is an orientation aid, not a substitute for the official protocol or a physician assessment.
- What is being studied
- The protocol lists: Residential rehabilitation as usual.
- Who it may be relevant to
- Registry conditions: Substance Use Disorder (SUD), Addiction, Anxiety, Emotional Dysregulation. Basic parameters: from 18 years · Male.
- What needs checking
- Age, condition and sex are only basic indicators. Prior treatment, laboratory values and other mandatory requirements appear in the eligibility criteria below.
- Where it takes place
- Mexico
- Next step
- Save the trial, show it to the treating physician, and confirm current recruitment with the study center. Costs, documents and travel →
Unsure about the terms? Read our patient guide →
Official title
Analysis of Weekly Narratives Using Natural Language Processing in Patients Undergoing Residential Rehabilitation: A Hybrid Approach for the Dynamic Assessment of Clinical Processes
Overview
This prospective observational study follows adults undergoing residential rehabilitation for severe substance use disorders at a specialized treatment center in Mexico. Participants provide weekly written narratives describing their emotions, challenges, coping strategies, and treatment experiences, and complete validated psychological questionnaires every two weeks, including the Generalized Anxiety Disorder-7 (GAD-7), Environmental Reward Observation Scale (EROS), Automatic Thoughts Questionnaire-8 (ATQ-8), and Behavioral Activation for Depression Scale (BADS). The study applies natural language processing (NLP) and machine learning methods to analyze participants' narratives and identify emotional, cognitive, and behavioral patterns associated with clinical change over time. Narrative-derived features are combined with questionnaire scores to generate a dynamic clinical risk representation that may help detect early signs of psychological worsening or improvement during residential treatment. Participants continue receiving standard residential care, and the study does not modify treatment decisions or clinical interventions. Up to 35 participants with sufficient longitudinal follow-up data will be included in the primary analysis. Data collection is expected to continue through September 2026.
Detailed description
Patients undergoing treatment for substance use disorders frequently describe changes in mood, motivation, hopelessness, cognitive rigidity, emotional distress, and coping strategies through spontaneous written language. These narratives may contain clinically meaningful indicators associated with psychological deterioration, treatment progress, or relapse vulnerability. However, systematic manual analysis of longitudinal written narratives is difficult to implement in routine clinical practice because of the volume and complexity of the data.
Recent developments in natural language processing (NLP), representation learning, and deep learning provide methods for extracting quantitative linguistic and semantic information from written text. Integrating these features with repeated psychometric assessments may support the development of longitudinal models capable of characterizing changes in mental health status over time in patients receiving residential addiction treatment.
Objectives
The objectives of this study are:
To extract semantic, emotional, and linguistic features from weekly patient narratives using NLP methods, including sentence embeddings, sentiment and emotion classification, and semantic similarity analyses based on Acceptance and Commitment Therapy (ACT) constructs.
To integrate narrative-derived variables with repeated psychometric measures (Generalized Anxiety Disorder-7 (GAD-7), Environmental Reward Observation Scale (EROS), Automatic Thoughts Questionnaire-8 (ATQ-8), and Behavioral Activation for Depression Scale (BADS)) using a multimodal deep learning autoencoder capable of generating a low-dimensional representation of longitudinal clinical status.
To evaluate whether latent representations generated by the autoencoder are associated with periods of clinical worsening or clinical improvement across time using leave-one-patient-out cross-validation procedures.
To develop a dynamic longitudinal risk representation capable of estimating future changes in automatic negative thoughts, measured through subsequent ATQ-8 scores.
Study Design
This study is a prospective observational cohort conducted at a single residential rehabilitation center in Mexico.
Eligible participants are adults aged 18 years or older with a diagnosis of severe substance use disorder who are admitted for residential treatment. Individuals with active psychotic symptoms or cognitive impairment that substantially interferes with the ability to complete written narratives are excluded.
Participants complete:
Weekly digital written narratives using open-ended prompts focused on emotions, challenges, coping responses, interpersonal experiences, and perceived treatment progress.
Biweekly administration of the following validated self-report instruments:
GAD-7
EROS
ATQ-8
BADS
All information is collected through digital forms integrated into routine clinical monitoring procedures at the treatment center.
Participants may contribute data for up to 20 weeks, depending on duration of residential stay. The study began on 25 May 2025, and primary completion is anticipated in September 2026.
Up to 35 participants with sufficient longitudinal observations will be included in the primary analytic cohort.
NLP and Machine Learning Pipeline
Text preprocessing
Narratives are written in Spanish and undergo preprocessing procedures that include:
minimum length filtering, normalization, consolidation of narrative fields into a single weekly text sample, tokenization and linguistic annotation.
Feature extraction
Narrative features include:
Sentiment classification (positive, neutral, negative) Emotion probabilities for joy, sadness, anger, fear, surprise, and disgust using the pysentimiento library
Linguistic variables including:
type-token ratio, mean sentence length, proportion of first-person pronouns, proportion of past-tense verbs, obtained through udpipe
Semantic similarity measures between patient narratives and ACT-related prototype domains including:
experiential avoidance, cognitive fusion, rule-governed behavior, helplessness, achievement orientation, hopefulness
Semantic similarity is computed through cosine similarity between sentence-transformer embeddings and predefined prototype centroids.
Dimensionality reduction procedures using principal component analysis (PCA) are applied to selected linguistic and semantic variables to derive a principal component representing orientation toward internal emotional experience versus external contextual events.
Autoencoder Architecture
The multimodal model receives concatenated longitudinal feature vectors after robust scaling.
The architecture includes:
a bidirectional long short-term memory (BiLSTM) encoder, multi-head attention mechanisms, variational regularization using a β-variational autoencoder (β-VAE) framework, a decoder trained to reconstruct the original temporal feature sequence, and an auxiliary classification component predicting next-period clinical worsening.
The training objective combines:
mean squared reconstruction error, focal loss for classification, Kullback-Leibler divergence, and optional temporal smoothness regularization.
Interventions
- Other Residential rehabilitation as usual
Participants follow the standard residential rehabilitation program provided by the center. This is a naturalistic exposure; the study does not impose any additional intervention. The "intervention" of interest is the routine therapeutic environment and its associated psychological processes (e.g., changes in avoidance, cognitive fusion, hope, and behavioral activation). These processes are measured through weekly written narratives and biweekly validated clinical scales (GAD-7, EROS, ATQ-8, BAD
Primary outcome measures
- Change in negative automatic thoughts measured by the Automatic Thoughts Questionnaire 8-item version [Time frame: Every 2 weeks from baseline until discharge from residential treatment (up to 20 weeks)]
Secondary outcome measures (5)
- Change in generalized anxiety symptoms measured by the Generalized Anxiety Disorder 7 item scale [Time frame: Every 2 weeks from baseline until discharge (up to 20 weeks)]
- Change in environmental reward measured by the Environmental Reward Observation Scale [Time frame: Every 2 weeks from baseline until discharge (up to 20 weeks)]
- Change in behavioral activation and avoidance measured by the Behavioral Activation for Depression Scale [Time frame: Every 2 weeks from baseline until discharge (up to 20 weeks)]
- Weekly self-reported emotional intensity [Time frame: Weekly from baseline until discharge (up to 20 weeks)]
- Weekly self-reported craving intensity [Time frame: Weekly from baseline until discharge (up to 20 weeks)]
Eligibility criteria
Inclusion criteria
- Clinical diagnosis of severe substance use disorder (polydrug use, including cocaine, methamphetamines, alcohol, and/or cannabis), confirmed by the center's admission assessment.
- Male sex (all participants in the center's residential program are male).
- Age 18 years or older.
- Current resident of the participating residential rehabilitation center in Mexico.
- Completed at least four weeks of residential treatment at the time of study enrollment.
- Able to write coherent weekly narratives in Spanish (no severe cognitive impairment or active psychosis).
- Willing to provide written informed consent.
Exclusion criteria
- Presence of acute psychotic symptoms that interfere with the ability to write or understand the study procedures.
- Severe cognitive impairment (e.g., due to traumatic brain injury, intellectual disability) that prevents meaningful narrative production.
- Inability to comply with weekly narrative writing (e.g., illiteracy, severe visual impairment).
- Planned discharge from the residential program within less than 4 weeks from enrollment.
- Enrollment in another interventional clinical trial that could confound the interpretation of outcomes.
Criteria are shown verbatim from the registry (in English). Final eligibility is always assessed by the study center.
Healthy volunteers: No
Study design
- Observational model
- Cohort
Study locations
Mexico · 1 center
- Under The Tree Potrerillos — Potrerillos
Identifiers
NCT: NCT07595614 · SISAP-TUS-HYB/WN-01