System to match records utilizing demographic data.
To build the project you need the .NET 8 SDK. You can download it from here.
Build the cli tool utilizing the following command:
dotnet publish -c Release src/Biomatch.CLIThis will create a "matching" executable file for your current architecture. To build for other architectures, pass the -r parameter as the following example:
dotnet publish -c Release -r linux-x64 src/Biomatch.CLI -o biomatchFor more information on the -r parameter, see the dotnet publish documentation. For a list of supported runtimes, see the dotnet RID catalog.
The cli tool has a help command that will list all available commands and their parameters.
biomatch --helpThe template command will create a template file for the matching engine. The template file is a csv utf-8 file. The template file is used for most matching commands. The template file has the following columns:
| Column Name | Type | Description |
|---|---|---|
| RecordId | string | The unique id of the record in the source. |
| FirstName | string | First name of person. |
| MiddleName | string | Middle name of person. |
| LastName | string | Last name of person. |
| SecondLastName | string | Second last name of person. |
| Birthdate | DateTime | Birth date of person. |
| City | string | Physical residence city of person. |
| PhoneNumber | string | Primary phone number of person. |
biomatch template generate -o <output file path>Create or use an existing template. (See Template section for more information)
biomatch template generate -o <output file path>Create word frequency dictionary based on sample data to improve matching accuracy.
biomatch dictionary generate <templateFilePath> -o <output folder path>Find matches between 2 files with a score threshold of 0.85. The following command assumes that the Dictionary has already been generated and is located in the same directory as the executable.
biomatch find matches <templateFilePath1> <templateFilePath2> -o <output file path> --score 0.85This will generate a file with all matches found and scores for each one. The higher the score, the more likely the records match.
Create or use an existing template. (See Template section for more information)
biomatch template generate -o <output file path>Create word frequency dictionary based on sample data to improve matching accuracy.
biomatch dictionary generate <templateFilePath> -o <output folder path>Find duplicates between 2 files with a score threshold of 0.85. The following command assumes that the Dictionary has already been generated and is located in the same directory as the executable.
biomatch find duplicates <templateFilePath1> <templateFilePath2> -o <output file path> --score 0.85This will generate a file with all duplicates found and scores for each one. The higher the score, the more likely the records are duplicates.