Ruby bindings to the Stanford Core NLP tools (English, French, German).
Ruby bindings to the Stanford Core NLP tools (English, French, German).
Warning: This gem is unmaintained.
Ruby bindings for the Stanford CoreNLP Toolchain.
This gem provides high-level Ruby bindings to the Stanford CoreNLP package, a set natural language processing tools for tokenization, sentence segmentation, part-of-speech tagging, lemmatization, and parsing of English, French and German. The package also provides named entity recognition and coreference resolution for English.
This gem is compatible with Ruby 2.3 and 2.4 as well as JRuby 1.7 and 9.
Older Ruby version should work as well.
You need Java 8 for the latest CoreNLP version (since 3.5.0, 2014-10-31), earlier versions are tested on both Java 6 and Java 7.
The version schema has been changed to reflect the development of Stanford CoreNLP itself. We'll release a gem for every new version from Stanford.
We strive to support all languages Stanford CoreNLP can work with.
Annotator
ar
zh
en
fr
de
es
Tokenize / Segment
✔
✔
✔
✔
✔
Sentence Split
✔
✔
✔
✔
✔
✔
Part of Speech
✔
✔
✔
✔
✔
✔
Lemma
✔
Named Entities
✔
✔
✔
✔
Constituency Parsing
✔
✔
✔
✔
✔
✔
Dependency Parsing
✔
✔
✔
✔
Sentiment Analysis
✔
Mention Detection
✔
✔
Coreference
✔
✔
Open IE
✔First, install the gem: gem install stanford-core-nlp.
Then, download the Stanford Core NLP JAR and model files:
Stanford CoreNLP
Place the contents of the extracted archive inside the /bin/ folder of
the stanford-core-nlp gem (e.g. [...]/gems/stanford-core-nlp-0.x/bin/).
You may want to set some optional configuration options. Here are some examples:
……Important: You need to load the StanfordCoreNLP pipeline before using the StanfordCoreNLP::Annotation class.
The Ruby symbol (e.g. :named_entity_tag) corresponding to a Java annotation
class is the snake_case of the class name, with 'Annotation' at the end removed.
For example, NamedEntityTagAnnotation translates to :named_entity_tag,
PartOfSpeechAnnotation to :part_of_speech, etc.
A good reference for names of annotations are the Stanford Javadocs
for CoreAnnotations, CoreCorefAnnotations, and TreeCoreAnnotations. For a full list of all possible annotations, see the config.rb file inside the gem.
Loading specific classes
You may want to load additional Java classes (including any class from the Stanford NLP packages). The gem provides an API for this:
# Default base class is edu.stanford.nlp.pipeline.
StanfordCoreNLP.load_class('PTBTokenizerAnnotator')
puts StanfordCoreNLP::PTBTokenizerAnnotator.inspect
# => #
# Here, we specify another base class.
StanfordCoreNLP.load_class('MaxentTagger', 'edu.stanford.nlp.tagger')
puts StanfordCoreNLP::MaxentTagger.inspect
# => Here is a full list of annotator classes provided by the Stanford Core NLP package.
You can load these classes individually using StanfordCoreNLP.load_class
(see above). Once this is done, you can use them like you would from
a Java program. Refer to the Java documentation for a list of functions provided
by each of these classes.
Here is a full list of the default models for the Stanford Core NLP pipeline. You can change these models individually using StanfordCoreNLP.set_model (see above).
To run the specs for each language (after copying the JARs into the bin folder):
rake spec[english]
rake spec[german]
rake spec[french]Using the latest version of the Stanford CoreNLP (version 3.5.0 as of 31/10/2014) requires some additional manual steps:
StanfordCoreNLP.use :english
StanfordCoreNLP.model_files = {}
StanfordCoreNLP.default_jars = [
'joda-time.jar',
'xom.jar',
'stanford-corenlp-3.5.0.jar',
'stanford-corenlp-3.5.0-models.jar',
'jollyday.jar',
'bridge.jar'
]Or configure your setup (for French) as follows:
StanfordCoreNLP.use :french
StanfordCoreNLP.model_files = {}
StanfordCoreNLP.set_model('pos.model', 'french.tagger')
StanfordCoreNLP.default_jars = [
'joda-time.jar',
'xom.jar',
'stanford-corenlp-3.5.0.jar',
'stanford-corenlp-3.5.0-models.jar',
'jollyday.jar',
'bridge.jar'
]Or configure your setup (for German) as follows:
StanfordCoreNLP.use :german
StanfordCoreNLP.model_files = {}
StanfordCoreNLP.set_model('pos.model', 'german-fast.tagger')
StanfordCoreNLP.default_jars = [
'joda-time.jar',
'xom.jar',
'stanford-corenlp-3.5.0.jar',
'stanford-corenlp-3.5.0-models.jar',
'jollyday.jar',
'bridge.jar'
]We are very glad to see you in this section and highly appreciate any help!
If you want to contribute please agree that your work will be published
under the terms of the GPL v.3.0 license.
Some of the open tasks for contributors are listed on the issues page. You may want to start there.
Then feel free to fork the code and send us a pull request.
stanford-core-nlp by Louis-Antoine Mullie,
Andrei Beliankou and
Contributors.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see .
No open issues yet, or sync has not completed.