NAME

PLN::PT - interface for the http://pln.pt web service

VERSION

version 0.002

SYNOPSIS

# using as a lib
my $pln = PLN::PT->new('http://api.pln.pt');
my $data = $pln->tagger($txt);  # [['A','o',''DA0FS0','0.675415'], ...

# using the pln-pt tool from the command line
$ echo "A Maria tem razão . " | pln-pt tagger
A o DA0FS0 0.675415
Maria maria NCFS000 1
tem ter VMIP3S0 0.999287
razão razão NCFS000 0.65
. . Fp 1

DESCRIPTION

This module implements an interface for the Natural Language Processing (NLP) web service provided by http://pln.pt.

METHODS

new

Create new object, given as argument the base endpoint for the web service.

Once the object is created, a set of methods described below can be used to access several operations in the API. All the methods return a data structure with the corresponding result, typically a list of tokens with some extra information depending on the operation used.

tokenizer

Tokenize the text given as argument, i.e. split the text in tokens (words by default), for more information on the tokenization operation visit http://pln.pt/api.

$ echo "A Maria tem razão ." | pln-pt tokenizer
A
Maria
tem
razão
.

tagger

Part-of-speech tagging the tokens in the text, given as argument, for more information on the tagging operation visit http://pln.pt/api.

$ echo "A Maria tem razão ." | pln-pt tagger
A o DA0FS0 0.675415
Maria maria NCFS000 1
tem ter VMIP3S0 0.999287
razão razão NCFS000 0.65
. . Fp 1

dep_parser

Build a dependency tree for the text given as argument, for more information on the dependency tree visit http://pln.pt/api.

$ echo "A Maria tem razão ." | pln-pt dep_parser
1	A	_	DET	art|<artd>|F|S	(...)	2	det	_	_
2	Maria	_	PROPN	prop|F|S	(...)	3	nsubj	_	_
3	tem	_	VERB	v-fin|PR|3S|IND	(...)	0	ROOT	_	_
4	razão	_	NOUN	n|F|S	(...)	3	dobj	_	_
5	.	_	PUNCT	punc	(...)	3	punct	_

ACKNOWLEDGEMENTS

This work is partially supported by the "Programa Operacional da Região Norte", NORTE2020, in the context of project NORTE-01-0145-FEDER-000037.

AUTHOR

Nuno Carvalho <smash@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 - 2017 by Nuno Carvalho.

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