NAME

Lingua::PT::ProperNames - Simple module to extract proper names from Portuguese Text

Version

Version 0.10

Synopsis

This module contains simple Perl-based functions to detect and extract proper names from Portuguese text.

  use Lingua::PT::ProperNames;


  printPN(@options);
  printPNstring({ %options... } ,$textstrint);
  printPNstring([ @options... ] ,$textstrint);

  forPN( sub{my ($pn, $contex)=@_;... } ) ;
  forPN( {t=>"double"},
         sub{my ($pn, $contex)=@_;... }, sub{...} ) ;
  $outstr = forPN($instr, sub{my ($pn, $contex)=@_;... }, ... ) ;

  forPNstring(sub{my ($pn, $contex)=@_;... },
         $textstring, regsep) ;


  my $pndict = Lingua::PT::ProperNames->new;

Functions related to ProperNames dictionary

new

Creates a new ProperNames dictionary

is_name

This method checks if a name exists in the Names dictionary as a Given Name.

is_surname

Thie method checks if a name exists in the Names dictionary as a Surname.

Detecting Proper Names

forPN

Substitutes all Proper Names found on STDIN by the result of calling a function <f> with arguments ($propername,$context). The result is sent to STDOUT.

Usage:

   forPN({options...}, sub{ propername processor...})

Optionally you can define input or output files:

   forPN({in=> "inputfile", out => "outputfile" }, sub{...})

Also, <{t = "double"}>> helps to treat in a special way names after punctuation (".", etc). With this options you must provide 2 functions: one for standard Proper Names and one for names after punctuation.

   forPN({t=>"double"}, sub{...}, sub{...})

You can also define record paragraph separator

   forPN({sep=>"\n", t=>"normal"}, sub{...}) ## each line is a par.
   forPN({sep=>""}, sub{...})                ## par. empty lines

forPNstring

   forPNstring( $funref, "textstring" [, regSeparator] )>

Substitutes all propername by funref(propername) in the text string.

printPNstring

   printPNstring("oco")

getPN

printPN

  printPN("oco")

  printPN  - extrai os nomes próprios dum texto.
   -comp    junta certos nomes: Fermat + Pierre de Fermat = (Pierre de) Fermat
   -prof
   -e       "Sebastiao e Silva" "e" como pertencente a PN
   -em      "em Famalicão" como pertencente a PN

Author

José João Almeida, <jj@di.uminho.pt>

Alberto Simões, <ambs@di.uminho.pt>

Bugs

Please report any bugs or feature requests to bug-lingua-pt-propernames@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT & LICENSE

Copyright 2004-2008 Projecto Natura, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

cpanm Lingua::PT::ProperNames

perl -MCPAN -e shell
install Lingua::PT::ProperNames