Packages

•  package root

  Definition Classes

  root

•  package ch

  Definition Classes

  root

•  package usi

  Definition Classes

  ch

•  package inf

  Definition Classes

  usi

•  package reveal

  Definition Classes

  inf

•  package parsing

  Definition Classes

  reveal

•  package units

  Provides classes representing information units (structured and textual units) and meta information (like tf vectors and type mentions).

  Provides classes representing information units (structured and textual units) and meta information (like tf vectors and type mentions).

  Overview

  Information units (implementing the trait InformationUnit) represent paragraphs in a given document, which can be narrative text (NaturalLanguageTaggedUnit) or structured fragments (CodeTaggedUnit). Each information unit exports a set of meta-information (implementing the MetaInformation trait), which are ready made semantic data for simple analyses. This version of StORMeD provides the following meta-information:

  • NaturalLanguageMetaInformation for a natural language view of the information unit (can be used also for code);
  • CodeTypesMetaInformation providing the mentioned types in the unit;
  • CodeVariablesMetaInformation providing the mentioned variables;
  • CodeInvocationMetaInformation providing the invoked methods in the unit.

  In the case a meta information is not provided for a unit, a AbsentMetaInformation object can be also provided.

  Tutorial

  Suppose you want to get all the types mentioned in a question. First, you retrieve all its information units:

  scala> val questionUnits = question.units
  questionUnits: Seq[ch.usi.inf.reveal.parsing.units.InformationUnit] = ...

  Instead of using the visitor to on all the HASTs, you can exploit the ready made data provided by the meta information. For example, to get all the meta information for units, you can use flatMap:

  scala> import ch.usi.inf.reveal.parsing.units._
  import ch.usi.inf.reveal.parsing.units._
  
  scala> val questionMetaInfos = questionUnits.flatMap { _.metaInformation }
  questionMetaInfos: Seq[ch.usi.inf.reveal.parsing.units.MetaInformation] = List(...)

  You need now to filter to get only the CodeTypesMetaInformation, and then you can get, for example, the mentioned qualified Types:

  scala> val codeTypesMetaInfos = questionMetaInfos.filter { _.isInstanceOf[CodeTypesMetaInformation] }.asInstanceOf[Seq[CodeTypesMetaInformation]]
  codeTypesMetaInfos: Seq[ch.usi.inf.reveal.parsing.units.CodeTypesMetaInformation] = List(...)
  
  scala> val types = codeTypesMetaInfos.flatMap { _.qualifiedTypes }.distinct
  types: Seq[ch.usi.inf.reveal.parsing.model.java.ReferenceTypeNode] = List(...)

  Definition Classes

  parsing

•  package similarity

  Definition Classes

  units

• ASTNodeCollectorVisitor
• InformationUnitSimilarity
• MetaComparable
• MetaInformationFeatures
• MetaInformationSimilarities
• NaturalLanguageTaggedUnitFactory
• NlpUtils
• NonSequenceVisitor
• SimilarityParameters

ch.usi.inf.reveal.parsing.units.similarity

NlpUtils 