You can deploy this model and start earning money today!

plandes/
sdoh-llama-3-1-8b

Name: sdoh-llama-3-1-8b
Availability: InStock

meta-llama/Llama-3.1-8B-Instruct

adapter

mit

Views

No views yet

Model Card for Model ID

Social determinants of health (SDoHs) are economic, social and personal circumstances that affect or influence an individual's health status. This model inferences as a multilabel classification at the sentence level and supervised-fined on the Amended dataset from the paper "Integration of Large Language Models and Traditional Deep Learning for Social Determinants of Health Prediction" (arXiv).

The model is to be used on clinical text to classify zero or more SDoH labels. Typical users of this model are clinical informatics physicians or biomedical NLP researchers.

The traditional deep learning model is available on [Zenodo].

Model Details

The model was trained the training and validation splits of the combined MIMIC-III and synthetic datasets provided by Guevara et AL..

Developed by: Paul Landes
Funded by: Center for Health Equity using Machine Learning & Artificial Intelligence (CHEMA) postdoctoral funding award.
Language(s) (NLP): English
License: MIT
Finetuned from model [optional]: Llama 3.1 8B Instruct

Usage

The model is available with PyHealth (pip install pyhealth) or by using the code snippet below.

The model is used by inferencing with the supervised-fine tuned prompt, then parsing the output. This creates a pipeline and uses the LLM to generate output from the supervised fine tuned model. It then parses the output into SDOH labels.

python

import re
import torch
import transformers
from transformers import AutoModelForCausalLM, AutoTokenizer
from peft import PeftModelForCausalLM


# parse the LLM response
def parse_response(text):
    res_regs = (re.compile(r'(?:.*?`([a-z,` ]{3,}`))', re.DOTALL),
                re.compile(r'.*?[`#-]([a-z, \t\n\r]{3,}?)[`-].*', re.DOTALL))
    matched: str = ''
    for pat in res_regs:
        m: re.Match = pat.match(text)
        if m is not None:
            matched = m.group(1)
            break
    return sorted(set(filter(lambda s: matched.find(s) > -1, labels)))


# the prompt and role used to supervised-fine tune the model
_PROMPT: str = """\
Classify sentences for social determinants of health (SDOH).

Definitions SDOHs are given with labels in back ticks:

* `housing`: The status of a patient’s housing is a critical SDOH, known to affect the outcome of treatment.

* `transportation`: This SDOH pertains to a patient’s inability to get to/from their healthcare visits.

* `relationship`: Whether or not a patient is in a partnered relationship is an abundant SDOH in the clinical notes.

* `parent`: This SDOH should be used for descriptions of a patient being a parent to at least one child who is a minor (under the age of 18 years old).

* `employment`: This SDOH pertains to expressions of a patient’s employment status. A sentence should be annotated as an Employment Status SDOH if it expresses if the patient is employed (a paid job), unemployed, retired, or a current student.

* `support`: This SDOH is a sentence describes a patient that is actively receiving care support, such as emotional, health, financial support.  This support comes from family and friends but not health care professionals.

* `-`: If no SDOH is found.

Classify sentences for social determinants of health (SDOH) as a list labels in three back ticks. The sentence can be a member of multiple classes so output the labels that are mostly likely to be present.

### Sentence: {sent}
### SDOH labels:"""
role = 'You are a social determinants of health (SDOH) classifier.'

# output classes
labels = 'transportation housing relationship employment support parent'.split()

# example sentence
sent = 'Pt is homeless and has no car and has no parents or support'

base_model_id = 'meta-llama/Llama-3.1-8B-Instruct'
adapter_model_id = 'plandes/sdoh-llama-3-1-8b'
base_model = AutoModelForCausalLM.from_pretrained(base_model_id)
model = PeftModelForCausalLM.from_pretrained(base_model, adapter_model_id)
tokenizer = AutoTokenizer.from_pretrained(base_model_id)

# create a pipeline for inferencing
pipeline = transformers.pipeline(
    'text-generation',
    model=model,
    tokenizer=tokenizer,
    model_kwargs={'torch_dtype': torch.bfloat16},
    device_map='auto')

# prompt used by the chat template
messages = [
    {'role': 'system', 'content': 'You are a social determinants of health (SDOH) classifier.'},
    {'role': 'user', 'content': _PROMPT.format(sent=sent)}]

# inference the LLM
outputs = pipeline(
    messages,
    max_new_tokens=512,
    eos_token_id=[
        pipeline.tokenizer.eos_token_id,
        pipeline.tokenizer.convert_tokens_to_ids('<|eot_id|>'),
    ],
    pad_token_id=pipeline.tokenizer.eos_token_id,
    do_sample=True,
    temperature=0.01)

# print the textual LLM output
output = outputs[0]['generated_text'][-1]['content']
print('model response:', output)

# print the parsed labels from the LLM outupt
print('labels:', parse_response(output))

Citation

bibtex

@article{landesSunCross2025,
  title={Integration of Large Language Models and Traditional Deep Learning for Social Determinants of Health Prediction},
  url={https://arxiv.org/abs/2505.04655},
  DOI={10.48550/arXiv.2505.04655},
  number={arXiv:2505.04655},
  publisher={arXiv},
  author={Landes, Paul and Sun, Jimeng and Cross, Adam},
  year={2025},
  month={May}
}