A tool to generate summaries of injuries from PDF medical records
Project description
Injury Summary Generator
This project automates the process of creating a demand letter for a client based on medical records in PDF format. It extracts relevant information from medical records and generates a "Summary of Injuries" section in a table format.
Data Source
The ICD-10 codes used in this project are sourced from the Centers for Medicare & Medicaid Services (CMS) website. You can find the official ICD-10 code lists at:
https://www.cms.gov/medicare/coordination-benefits-recovery/overview/icd-code-lists
This authoritative source ensures that our project uses up-to-date and accurate ICD-10 codes for classifying diagnoses.
Features
- PDF Processing: Reads multiple PDF files containing medical records and extracts text.
- Information Extraction: Extracts key information such as visit dates, diagnoses, and page numbers.
- ICD-10 Code Determination: Determines appropriate ICD-10 codes for extracted diagnoses.
- PDF Generation: Creates a summary PDF with a formatted table of extracted information.
Installation
You can install the Injury Summary Generator using pip:
pip install injury-summary-generator
Usage
After installation, you can run the Injury Summary Generator using the following command:
injury-summary-generator <input_folder> <output_folder>
Where:
<input_folder>
is the path to the folder containing the medical record PDF files.<output_folder>
is the path where the output summary PDF will be saved.
To check the version of the installed package, use:
injury-summary-generator --version
Project Structure
generate_summary_of_injuries/
: Main package directory.__init__.py
: Package initialization file._metadata.py
: Package metadata.main.py
: Entry point for the command-line interface.processor.py
: Main processing logic.pdf_reader.py
: Handles reading PDF files and extracting text.date_extractor.py
: Extracts dates from text.diagnosis_extractor.py
: Extracts diagnoses from text.icd_code_determiner.py
: Determines ICD-10 codes based on diagnoses.pdf_creator.py
: Creates the final summary PDF.data/
: Contains data files used by the project.icd10_codes.csv
: CSV file containing ICD-10 codes and descriptions.
tests/
: Contains unit tests for the project.setup.py
andsetup.cfg
: Configuration files for packaging and distribution.requirements.in
andrequirements.txt
: Lists Python dependencies for the project.MANIFEST.in
: Specifies additional files to include in the package.README.md
: Provides information about the project and how to use it..gitignore
: Specifies files and directories to be ignored by Git.
Development
To set up the development environment:
- Clone the repository:
git clone https://github.com/yourusername/injury-summary-generator.git
- Create a virtual environment:
python -m venv venv
- Activate the virtual environment:
- On Windows:
venv\Scripts\activate
- On macOS and Linux:
source venv/bin/activate
- On Windows:
- Install dependencies:
pip install -r requirements.txt
- Install the package in editable mode:
pip install -e .
Testing
To run the tests, use the following command:
pytest
Contributing
Contributions to this project are welcome. Please follow these steps:
- Fork the repository.
- Create a new branch (
git checkout -b feature/your-feature-name
). - Make your changes and commit them (
git commit -am 'Add some feature'
). - Push to the branch (
git push origin feature/your-feature-name
). - Create a new Pull Request.
Releasing
To create a new release:
- Update the version number in
setup.py
. - Create a new tag with the version number:
git tag v1.0.0
- Push the tag to GitHub:
git push origin v1.0.0
- Create a new release on GitHub, describing the changes and new features.
- Build and upload the package to PyPI:
python setup.py sdist bdist_wheel twine upload dist/*
License
This project is licensed under the MIT License - see the LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for injury_summary_generator-1.1.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | de1d62ac5161eb45911327d90dd4c13d867d4b89e47b9df4edadea2f4219d2ac |
|
MD5 | e22f455147adc6ae31131141fb181aa0 |
|
BLAKE2b-256 | 0b9d2d5af31d6d1e0f860d7cdcf497de0028b56d91f68428108a2d27da0fa059 |
Hashes for injury_summary_generator-1.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 019bef6f84f84dcd7eb71424efa0e493d84ce2496bcc08302762e8ddf3823ac7 |
|
MD5 | 3789a847c1d33f2da80f5231e9ec134f |
|
BLAKE2b-256 | 301c8344e2c51e7d859795f886b219f57bbec8cde5ca982ec23acc7f5f55479c |