Parsigs is an open-source project that aims to extract relevant information from doctors' signature text without compromising privacy and PHI (Protected Health Information) using Natural Language Processing.
If you'd like to participate in the development and maintenance of this plugin, please open a PR or an issue. Help is welcome. Thanks to all who have contributed so far!
- Extracts relevant structured information such as dosage, frequency, drug name from doctors' prescription-sig text.
- Protects patient privacy by not extracting any patient-related information or using any external API.
- Uses NLP techniques to accurately extract information from unstructured text.
For optimal usage, you will need to install the parsigs package and the underlying model
(you can provide a different one by yourself, but this is not
recommended as the model was trained for the specific task of parsing dosage instructions from Sigs)
pip install parsigs
In addition, install the parsigs model:
pip install https://huggingface.co/royashcenazi/en_parsigs/resolve/main/en_parsigs-any-py3-none-any.whl
Here are some examples of how to use the parse_sig method:
from parsigs.parse_sig_api import StructuredSig, SigParser
sig_parser = SigParser()
sig = "Take 1 tablet of ibuprofen 200mg 3 times every day for 3 weeks"
parsed_sig = sig_parser.parse(sig)
expected = StructuredSig(drug="ibuprofen", form="tablet", strength="200mg", frequencyType="Day", interval=3, singleDosageAmount=1.0, periodType='Week', periodAmount=3)
sig2 = "Take 2 tablets 3 times every month"
parsed_sig = sig_parser.parse(sig2)
expected = StructuredSig(drug=None, form='tablets', strength=None, frequencyType='Month', interval=3, singleDosageAmount=2.0, periodType=None, periodAmount=None, takeAsNeeded = False)
The StructuredSig object has the following attributes:
drug: the name of the drugform: the form of the medication (e.g. tablet, solution, pill)strength: the strength of the medication (e.g. 200mg, 500mg)frequencyType: the time-unit of the frequency (e.g. Day, Week, Month)interval: the number of times per frequency time-unitsingleDosageAmount: the amount of the medication to take at each intervalperiodType: the unit-type of the period which indicates for how long medication should be taken (e.g. Day, Week, Month)periodAmount: the number of units perperiodTypetakeAsNeeded: a flag indicating if the instructed dosage should be taken only when the patient needs it
The parse-sig project is developed by using the Named Entity Recognition model for tagging different parts in a dosage instruction (Sig) sentence (Duration, Frequency, Dosage, Drug, Form, Strength). The different tags are than being processed by static rules. You should expect some amount of errors as the model was trained on a large but limited data, as aquiring this type of data for it being private is a task of itself. I do intend to add a Dev set in the future and also more examples other than the ones in the test module.
The main target of the project is to identify and structure dosage instructions, as most prescriptions contain the brand name as a part of the definition, it is less important to structure it than the frequency, dosage and period so expect that part not be as complete as dosage instructions identification (this data is often not provided in the Sig, e.g "Take 1 tablet every day")
If you encounter any more issues or have any questions, please don't hesitate to send me an email or file an issue.
This repository is based on the following resources -