NAME

       Biblio::Citation::Compare - Perl extension for performing fuzzy comparisons between bibliographic
       citations

SYNOPSIS

         use Biblio::Citation::Compare 'sameWork','sameAuthors';

         sameWork(
           # first item
           {
               authors => ['Bourget, D','Lukasiak, Zbigniew'],
               title => "A paper with such and such a title",
               date => 2010
           },
           # second item
           {
               authors => ['Bourget, David J. R.','Lukasiak, Zbigniew'],
               title => "A paper with such nd such a tlitle",
               date => undef
           }
         );

         # true!

         sameAuthors(
           ['Dave Bourget','Z Lukasiak'],
           ['Bourget DJR','Zbigniew Z. Lukasiak']
         );

         # true!

DESCRIPTION

       This module exports two subroutines which perform fuzzy comparisons between citations (described using
       Perl hashes) and author lists. The subroutine attempt to determine if the citations and author lists
       refer to the same works and ordered lists of authors, respectively.

SUBROUTINES

   sameWork(hashref citation1, hashref citation2): boolean
       Takes as input two citations in a simple format illustrated in the synopsis. Returns true iff the two
       citations plausibly refer to the same work. A number of factors are taken into account to make the
       evaluation resistant to random variations. Among them: names are normalized and compared fuzzily using
       Text::Names, allowances are made for random typos, allowances are made for short and long versions of
       titles (esp with titles containing a colon), small but important variations as in "Paper title part 1"
       and "Paper title part 2" are taken into account. The algorithm has been used to merge multiple data
       sources on PhilPapers.org.

       Some advanced additional parameters are not explained here; they can only be explained by pointing to the
       source code. Their use should not normally be necessary.

   sameAuthors(arrayref list1, arrayref list2): boolean
       Returns true if the two lists are plausibly lists of the same authors. This is merely a convenient
       wrapper over Text::Names::samePerson.

   EXPORT
       None by default.

SEE ALSO

       See also Text::Names for name normalization.

AUTHOR

       David Bourget, http://www.dbourget.com

COPYRIGHT AND LICENSE

       Copyright (C) 2011 by David Bourget

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl
       itself, either Perl version 5.10.1 or, at your option, any later version of Perl 5 you may have
       available.

perl v5.36.0                                       2023-02-14                     Biblio::Citation::Compare(3pm)