Skip to main content

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

  • src/: Contains the source code for the project.
    • generate_summary_of_injuries.py: Main script that orchestrates the entire process.
    • pdf_reader.py: Handles reading PDF files and extracting text.
    • date_extractor.py: Extracts dates from PDF text.
    • diagnosis_extractor.py: Extracts diagnoses from PDF text.
    • icd_code_determiner.py: Determines ICD-10 codes based on diagnoses.
    • pdf_creator.py: Creates the final summary PDF.
  • tests/: Contains unit tests for the project.
  • setup.py: Configuration file for packaging and distribution.
  • requirements.txt: Lists all Python dependencies for the project.
  • README.md: Provides information about the project and how to use it.
  • .gitignore: Specifies files and directories to be ignored by Git.

Contributing (if you want to, and if I make it open source)

Contributions to this project are welcome. Please follow these steps:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/your-feature-name).
  3. Make your changes and commit them (git commit -am 'Add some feature').
  4. Push to the branch (git push origin feature/your-feature-name).
  5. Create a new Pull Request.

Releasing

To create a new release:

  1. Update the version number in setup.py.
  2. Create a new tag with the version number: git tag v1.0.0
  3. Push the tag to GitHub: git push origin v1.0.0
  4. Create a new release on GitHub, describing the changes and new features.
  5. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

injury_summary_generator-1.0.4.tar.gz (17.8 kB view hashes)

Uploaded Source

Built Distribution

injury_summary_generator-1.0.4-py3-none-any.whl (21.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page