Examples of org.apache.uima.analysis_engine.ResultSpecification

org.apache.uima.analysis_engine.ResultSpecification
A ResultSpecification is a set of desired outputs from a Analysis Engine or Annotator. Each output is a reference to either a {@link org.apache.uima.cas.Type} or a{@link org.apache.uima.cas.Feature}.
Annotator implementations may, but are not required to, check the ResultSpecification passed as a parameter to their {@link AnalysisComponent#setResultSpecification(ResultSpecification)}}, and produce only those Types and Features that are part of the ResultSpecification. Annotators can call the {@link #containsType(String)} and{@link #containsFeature(String)} to determine which types and features belong to thisResultSpecification and should be produced.
The containsType(...) method also returns true for subtypes of types specified in the result specification. The containsFeature(...) method also returns true for all features of a type if the type's allAnnotatorFeatures flag is set. As a corner case, the containsFeature may return true in this case even if the feature is not actually part of the type system.
ResultSpecifications are language enabled to allow different values to be set and returned, based on a ISO language identifier. There are two styles of the get and add methods that add these specifications to an instance of a ResultSpecification: one takes an additional parameter specifying the language(s), the other doesn't have this parameter. Using the one without the language parameter is equivalent to using the "x-unspecified" language. The functions that add ResultSpecifications can do this for multiple languages at once because the language parameter is an array of strings. The functions to retrieve a ResultSpecification specify one particular language.
Result Specifications for particular types or features have an associated set of languages which they are set for. That associated set of languages can include the "x-unspecified" language; if it does, then a query for that feature for any language will match.
If a type or feature's set of languages does not include "x-unspecified", then a query using "x-unspecified" (either as the language passed, or by default, if no language is passed) returns false.
A result specification entry having a language set may contain languages with country codes, such as zh-cn for example. A query for zh-cn would match, but a query for zh would not match, if this entry only had the zh-cn language specified.
But, a result specification entry having a language set containing just zh will match queries that specify zh-cn as the language, because a result-specification of zh is implied to mean the language zh regardless of the country.
Sometimes the methods to change the result specification replace the language(s), other times, the language(s) are merged with any existing specification already present in the result specification for the particular type or feature.
- Methods to "set" result types and/or features (or both) replace the current settings, for all languages.
- Methods to "add" 1 type or feature, with no language(s) specified replace the current language setting for that type or feature with x-unspecified, except for the following 2 methods
- Methods addResultType and addFeatureType, with languages specified, augment any existing languages that might already be specified for that type or feature.
Prior to any querying using the containsType or containsFeature methods, the type system in use for this result specification may be specified by calling setTypeSystem(typeSystem). If it is available, the results of the containsType and containsFeature methods will be true for subtypes of the original types. The language specification in the ResultSpecification for a derived sub type is computed as the union of all of the langauges specified for its supertypes. Likewise, the The allAnnotatorFeatures flag of a subtype is the logical union of this property for all of its supertypes.
The computation to enable this behavior for subtypes is called "compiling" the result specification, and is done automatically, but only when needed, and when there is an available type system specified for this result specification object, using the setTypeSystem or compile methods. The result of this computation is "cached". If the result specification is subsequently updated in such a way as to make this computation invalid, the cache is invalidated, and another compile operation will be transparently done, when and if needed.

      // System.out.println("Processing text: \"" + text + "\"");
      // Set the document text on the CAS.
      cas.setDocumentText(text);
      cas.setDocumentLanguage("ja");
      // Process the sample document.
      ResultSpecification resultSpec = UIMAFramework.getResourceSpecifierFactory()
              .createResultSpecification();
      resultSpec.addCapabilities(ae.getAnalysisEngineMetaData().getCapabilities());
      ae.process(cas, resultSpec);
      // check fileoutput
      Assert.assertTrue(FileCompare.compare(outputReferenceFile, JUnitExtension
              .getFile("SequencerTest/SequencerCapabilityLanguageExpectedJaResultSpec.txt")));
      outputReferenceFile.delete();

View Full Code Here

      // System.out.println("Processing text: \"" + text + "\"");
      // Set the document text on the CAS.
      cas.setDocumentText(text);
      cas.setDocumentLanguage("x-unspecified");
      // Process the sample document.
      ResultSpecification resultSpec = UIMAFramework.getResourceSpecifierFactory()
              .createResultSpecification();
      resultSpec.addCapabilities(ae.getAnalysisEngineMetaData().getCapabilities());
      ae.process(cas, resultSpec);
      // check fileoutput
      Assert.assertTrue(FileCompare.compare(outputReferenceFile, JUnitExtension
              .getFile("SequencerTest/SequencerCapabilityLanguageExpectedXunSpec.txt")));
      outputReferenceFile.delete();

View Full Code Here

      // System.out.println("Processing text: \"" + text + "\"");
      // Set the document text on the CAS.
      cas.setDocumentText(text);
      cas.setDocumentLanguage("foo-BAR");
      // Process the sample document.
      ResultSpecification resultSpec = UIMAFramework.getResourceSpecifierFactory()
              .createResultSpecification();
      resultSpec.addCapabilities(ae.getAnalysisEngineMetaData().getCapabilities());
      ae.process(cas, resultSpec);
      // check fileoutput
      Assert.assertTrue(FileCompare.compare(outputReferenceFile, JUnitExtension
              .getFile("SequencerTest/SequencerCapabilityLanguageExpectedEsUnknown.txt")));
      outputReferenceFile.delete();

View Full Code Here

      // System.out.println("Processing text: \"" + text + "\"");
      // Set the document text on the CAS.
      cas.setDocumentText(text);
      cas.setDocumentLanguage("zh-cn");
      // Process the sample document.
      ResultSpecification resultSpec = UIMAFramework.getResourceSpecifierFactory()
              .createResultSpecification();
      resultSpec.addCapabilities(ae.getAnalysisEngineMetaData().getCapabilities());
      ae.process(cas, resultSpec);
      // check fileoutput
      Assert.assertTrue(FileCompare.compare(outputReferenceFile, JUnitExtension
              .getFile("SequencerTest/SequencerCapabilityLanguageExpectedEsZhCNResultSpec.txt")));
      outputReferenceFile.delete();

View Full Code Here

    // does nothing by default (for service adapters)
    // overridden in both primitive and aggregate AE implementations
  }


  public void resetResultSpecificationToDefault() {
    ResultSpecification resultSpec = new ResultSpecification_impl();
    resultSpec.addCapabilities(this.getAnalysisEngineMetaData().getCapabilities());
    setResultSpecification(resultSpec);
  }

View Full Code Here


        // current analysis node which contains the current analysis engine
        AnalysisSequenceCapabilityNode node;


        // result spec for the current analysis engine
        ResultSpecification currentAnalysisResultSpec = null;


        // flag if current analysis engine should be called or not
        boolean shouldEngineBeCalled = false;


        // check output capabilites from the current result spec
        do {
          // get next analysis engine from the sequence node
          node = (AnalysisSequenceCapabilityNode) mNodeList.get(mIndex++);


          // get capability container from the current analysis engine
          CapabilityContainer capabilityContainer = node.getCapabilityContainer();


          // create current analysis result spec without any language information
          currentAnalysisResultSpec = UIMAFramework.getResourceSpecifierFactory()
                  .createResultSpecification();


          // check if engine should be called - loop over all ouput capabilities of the result spec
          for (int i = 0; i < ouputCapabilities.length; i++) {
            // check if current ToF can be produced by the current analysis engine
            if (capabilityContainer.hasOutputTypeOrFeature(ouputCapabilities[i], documentLanguage,
                    true)) {
              currentAnalysisResultSpec.addResultTypeOrFeature(ouputCapabilities[i]);
              shouldEngineBeCalled = true;


              // remove current ToF from the result spec
              mResultSpec.removeTypeOrFeature(ouputCapabilities[i]);
            }

View Full Code Here

      
      //Check TestAnnotator fields only at the very end of processing,
      //we can't test from the threads themsleves since the state of
      //these fields is nondeterministic during the multithreaded processing.
      assertEquals("testing...", TestAnnotator.getLastDocument());
      ResultSpecification resultSpec = new ResultSpecification_impl();
      resultSpec.addResultType("NamedEntity", true);
      assertEquals(resultSpec, TestAnnotator.getLastResultSpec());


    } catch (Exception e) {
      JUnitExtension.handleException(e);
    }

View Full Code Here

    tae.process(tcas);
    assertEquals("new test", TestAnnotator.lastDocument);
    tcas.reset();


    // process(CAS,ResultSpecification)
    ResultSpecification resultSpec = new ResultSpecification_impl();
    resultSpec.addResultType("NamedEntity", true);


    tcas.setDocumentText("testing...");
    tae.process(tcas, resultSpec);
    assertEquals("testing...", TestAnnotator.lastDocument);
    assertEquals(resultSpec, TestAnnotator.lastResultSpec);

View Full Code Here

        tcas.setDocumentText("new test");
        mAE.process(tcas);
        tcas.reset();


        // process(CAS,ResultSpecification)
        ResultSpecification resultSpec = new ResultSpecification_impl();
        resultSpec.addResultType("NamedEntity", true);


        tcas.setDocumentText("testing...");
        mAE.process(tcas, resultSpec);
        tcas.reset();

View Full Code Here

    } else {
      // To form the result spec that will be passed down to each component,
      // we take the union aResultSpec with the inputs of all components in this
      // aggregate. This forms the complete list of types that any component in
      // this aggregate might ever need to produce.
      ResultSpecification resultSpecForComponents = (ResultSpecification) aResultSpec.clone();
      resultSpecForComponents.addCapabilities(getAllComponentCapabilities(), false);


      // now iterate over components and call their setResultSpecification methods
      Iterator componentIter = _getASB().getComponentAnalysisEngines().values().iterator();
      while (componentIter.hasNext()) {
        AnalysisEngine ae = (AnalysisEngine) componentIter.next();

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of org.apache.uima.analysis_engine.ResultSpecification

org.apache.uima.analysis_engine.asb.impl.ASB_impl$AggregateCasIterator

org.apache.uima.analysis_engine.impl.AggregateAnalysisEngine_impl

org.apache.uima.analysis_engine.impl.AnalysisEngine_implTest

org.apache.uima.analysis_engine.impl.AnalysisEngineImplBase

org.apache.uima.analysis_engine.impl.compatibility.AnnotatorAdapter

org.apache.uima.analysis_engine.impl.MultiprocessingAnalysisEngine_implTest

org.apache.uima.analysis_engine.impl.MultiprocessingAnalysisEngine_implTest$ProcessThread

org.apache.uima.analysis_engine.impl.MultiprocessingAnalysisEngine_implTest$ProcessThreadMany

org.apache.uima.analysis_engine.impl.PrimitiveAnalysisEngine_impl

org.apache.uima.analysis_engine.impl.ResultSpecification_implTest

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.