Name matching

Name matching is a Python package for the matching of company names. This package has been developed to match the names of companies from different databases together to allow them to be merged. The package has a number of options to determine how exact the matches should be and also for the selection of different name matching algorithms.

For a more in-depth discussion of the name matching package please see the company name matching medium post

Installation

The package can be installed via PiPy:

pip install name_matching

Alternatively you could install the package by downloading the repo, navigating to the folder and run the setup in pip locally

pip install .

Usage

To see example usage of the package you can use the notebook folder. An example of the usage is also given below

from name_matching.name_matcher import NameMatcher

# initialise the name matcher
matcher = NameMatcher(column='name', 
                      number_of_matches=3, 
                      legal_suffixes=True, 
                      common_words=False, 
                      top_n=50, 
                      verbose=True)

# adjust the distance metrics to use
matcher.set_distance_metrics(discounted_levenshtein=False,
                             bag=True,
                             typo=True,
                             refined_soundex=True)

# load the data to which the names should be matched
matcher.load_and_process_master_data(df_gleif, transform=True)

# perform the name matching on the data you want matched
matches = matcher.match_names(to_be_matched=unknown_counterparties, column_matching='name')

Contributing

All contributions are welcome. For more substantial changes, please open an issue first to discuss what you would like to change.

License

MIT

Thanks

Thanks to the work of implementing name matching algorithms done in the Abydos package. These form the basis of the name matching algorithms used in this package.