You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@stanbol.apache.org by bu...@apache.org on 2012/11/23 14:14:59 UTC
svn commit: r839314 - in /websites/staging/stanbol/trunk/content: ./
docs/trunk/components/enhancer/nlp/analyzedtext.html
Author: buildbot
Date: Fri Nov 23 13:14:59 2012
New Revision: 839314
Log:
Staging update by buildbot for stanbol
Modified:
websites/staging/stanbol/trunk/content/ (props changed)
websites/staging/stanbol/trunk/content/docs/trunk/components/enhancer/nlp/analyzedtext.html
Propchange: websites/staging/stanbol/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Nov 23 13:14:59 2012
@@ -1 +1 @@
-1412873
+1412874
Modified: websites/staging/stanbol/trunk/content/docs/trunk/components/enhancer/nlp/analyzedtext.html
==============================================================================
--- websites/staging/stanbol/trunk/content/docs/trunk/components/enhancer/nlp/analyzedtext.html (original)
+++ websites/staging/stanbol/trunk/content/docs/trunk/components/enhancer/nlp/analyzedtext.html Fri Nov 23 13:14:59 2012
@@ -201,35 +201,39 @@
</pre></div>
-<ol>
+</li>
<li>
<p>Defined <em>Annotation</em> are used to add information to an <em>Annotated</em> instance (like a Span). For adding annotations the use of _Annotation_s is required to ensure type safety. The following code snippet shows how to add an PosTag with the probability 0.95.</p>
-<p>:::java
-PosTag tag = new PosTag("N"); //a simple POS tag
-Token token; //The Token we want to add the tag
-token.addAnnotations(POS_ANNOTATION,Value.value(tag),0.95);
-3. For consuming annotations there are two options. First the possibility to use the <em>Annotation</em> object and second by directly using the key. While the 2nd option is not as nicely to use (as it does not provide type safety) it allows consuming annotations without the need to have the used <em>Annotation</em> in the classpath. The following examples show both options</p>
-<p>:::java
-Iterator<Token> tokens = sentence.getTokens();
-while(tokens.hasNext){
- Token token = tokens.next();
- //use the POS_ANNOTATION to get the PosTag
- PosTag tag = token.getAnnotation(POS_ANNOTATION);
- if(tag != null){
- log.info("{} has PosTag {}",token,tag.value());
- } else {
- log.infor("{} has no PosTag",token);
- }
- //(2) use the key to retrieve values
- String key = "urn:test-dummy";
- Value<?> value = token.getValue(key);
- //the programmer needs to know the type!
- if(v.probability() > 0.5){
- log.info("{}={}",key,value.value());
- }
-}</p>
+<div class="codehilite"><pre><span class="n">PosTag</span> <span class="n">tag</span> <span class="o">=</span> <span class="k">new</span> <span class="n">PosTag</span><span class="o">(</span><span class="s">"N"</span><span class="o">);</span> <span class="c1">//a simple POS tag</span>
+<span class="n">Token</span> <span class="n">token</span><span class="o">;</span> <span class="c1">//The Token we want to add the tag</span>
+<span class="n">token</span><span class="o">.</span><span class="na">addAnnotations</span><span class="o">(</span><span class="n">POS_ANNOTATION</span><span class="o">,</span><span class="n">Value</span><span class="o">.</span><span class="na">value</span><span class="o">(</span><span class="n">tag</span><span class="o">),</span><span class="mf">0.95</span><span class="o">);</span>
+</pre></div>
+
+
</li>
-</ol>
+<li>
+<p>For consuming annotations there are two options. First the possibility to use the <em>Annotation</em> object and second by directly using the key. While the 2nd option is not as nicely to use (as it does not provide type safety) it allows consuming annotations without the need to have the used <em>Annotation</em> in the classpath. The following examples show both options</p>
+<div class="codehilite"><pre><span class="n">Iterator</span><span class="o"><</span><span class="n">Token</span><span class="o">></span> <span class="n">tokens</span> <span class="o">=</span> <span class="n">sentence</span><span class="o">.</span><span class="na">getTokens</span><span class="o">();</span>
+<span class="k">while</span><span class="o">(</span><span class="n">tokens</span><span class="o">.</span><span class="na">hasNext</span><span class="o">){</span>
+ <span class="n">Token</span> <span class="n">token</span> <span class="o">=</span> <span class="n">tokens</span><span class="o">.</span><span class="na">next</span><span class="o">();</span>
+ <span class="c1">//use the POS_ANNOTATION to get the PosTag</span>
+ <span class="n">PosTag</span> <span class="n">tag</span> <span class="o">=</span> <span class="n">token</span><span class="o">.</span><span class="na">getAnnotation</span><span class="o">(</span><span class="n">POS_ANNOTATION</span><span class="o">);</span>
+ <span class="k">if</span><span class="o">(</span><span class="n">tag</span> <span class="o">!=</span> <span class="kc">null</span><span class="o">){</span>
+ <span class="n">log</span><span class="o">.</span><span class="na">info</span><span class="o">(</span><span class="s">"{} has PosTag {}"</span><span class="o">,</span><span class="n">token</span><span class="o">,</span><span class="n">tag</span><span class="o">.</span><span class="na">value</span><span class="o">());</span>
+ <span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
+ <span class="n">log</span><span class="o">.</span><span class="na">infor</span><span class="o">(</span><span class="s">"{} has no PosTag"</span><span class="o">,</span><span class="n">token</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="c1">//(2) use the key to retrieve values</span>
+ <span class="n">String</span> <span class="n">key</span> <span class="o">=</span> <span class="s">"urn:test-dummy"</span><span class="o">;</span>
+ <span class="n">Value</span><span class="o"><?></span> <span class="n">value</span> <span class="o">=</span> <span class="n">token</span><span class="o">.</span><span class="na">getValue</span><span class="o">(</span><span class="n">key</span><span class="o">);</span>
+ <span class="c1">//the programmer needs to know the type!</span>
+ <span class="k">if</span><span class="o">(</span><span class="n">v</span><span class="o">.</span><span class="na">probability</span><span class="o">()</span> <span class="o">></span> <span class="mf">0.5</span><span class="o">){</span>
+ <span class="n">log</span><span class="o">.</span><span class="na">info</span><span class="o">(</span><span class="s">"{}={}"</span><span class="o">,</span><span class="n">key</span><span class="o">,</span><span class="n">value</span><span class="o">.</span><span class="na">value</span><span class="o">());</span>
+ <span class="o">}</span>
+<span class="o">}</span>
+</pre></div>
+
+
</li>
</ol>
<p>The <em>Annotated</em> interface supports multi valued annotations. For that it defines methods for adding/setting and getting multiple values. Values are sorted first by the probability (unknown probability last) and secondly by the insert order (first in first out). So calling the single value getAnnotation() method on a multi valued field will return the first item (highest probability and first added in case of multiple items with the same/no probabilities)</p>