Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
app
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

deidentify

npm version dependencies Status devDependencies Status

De-Identification of Free-Text Medical Record Data

File Processing Batch Processing
file batch

Table of Contents

About

deidentify is a tool to remove personal identifiers from free-text medical record data. Detected identifiers are replaced by randomly generated substitutes. Consistency of the data is preserved as the same name, phone number or location will always be mapped to the same replacement.

Features

  • Facilities to remove all relevant identifiers of individuals from medical record information to comply with the HIPAA "Safe Harbor" rule
  • Single file and batch processing
  • Customizable options
  • Persistent data store ensures consistency of mappings and allows re-identification of the de-identified data

Made using

The deidentify tool uses several open-source projects.

The desktop application was created with nw.js, formerly called node-webkit, and is entirely written in JavaScript.

Our de-identification procedure combines hand-crafted regular expressions with the named entity recognizer (NER) developed by the Stanford Natural Language Processing Group, which provides a Conditional Random Field (CRF) model for detecting the three classes PERSON, ORGANIZATION, LOCATION.

Reference:

Finkel, J. R., Grenager, T., & Manning, C. (2005). Incorporating non-local information into information extraction systems by gibbs sampling. In Acl, (1995), 363 – 370. doi:10.3115/1219840.1219885

To generate random replacements for detected identifiers, the chance.js library is used. NeDB is used as a data store, keeping track of the mappings from original identifiers to replacements.

Other used libraries include

Prerequisites

This software uses the Stanford NER tool, which requires Java 1.8 or later.

Install

Installers for Windows, MacOS and Linux can be downloaded from the releases page.

Build from source

Clone the repository via the following command:

git clone --recursive https://github.com/Planeshifter/deidentify.git

Change into the newly created directory, install npm dependencies and run the init script:

npm install
npm run init

Run

Start the program by executing the following command from the project directory:

npm start

License

This project is licensed under the GNU General Public License v2.0.

Copyright

Copyright © 2015-2018. Philipp Burckhardt.

About

De-identification of Protected Health Information according to HIPAA Privacy Rule

Resources

License

Packages

No packages published