org.molgenis.data.semanticsearch.service.impl

Class SemanticSearchServiceImpl

java.lang.Object

org.molgenis.data.semanticsearch.service.impl.SemanticSearchServiceImpl

All Implemented Interfaces:

SemanticSearchService

public class SemanticSearchServiceImpl
extends Object
implements SemanticSearchService

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_NUM_TAGS

Constructor Summary

Constructors

Constructor and Description
SemanticSearchServiceImpl(DataService dataService, OntologyService ontologyService, MetaDataService metaDataService, SemanticSearchServiceHelper semanticSearchServiceHelper, ElasticSearchExplainService elasticSearchExplainService)

Method Summary

Modifier and Type	Method and Description
Hit<String>	bestMatchingSynonym(OntologyTerm ontologyTerm, Set<String> searchTerms) Computes the best matching synonym which is closest to a set of search terms. Will stem the OntologyTerm 's synonyms and the search terms, and then compute the maximum StringDistance between them.
Set<ExplainedQueryString>	convertAttributeEntityToExplainedAttribute(Entity attributeEntity, EntityMetaData sourceEntityMetaData, Map<String,String> collectExpanedQueryMap, List<QueryRule> finalQueryRules) A helper function to explain each of the matched attributes returned by the explain-API
Set<String>	createLexicalSearchQueryTerms(AttributeMetaData targetAttribute, Set<String> searchTerms) A helper function to create a list of queryTerms based on the information from the targetAttribute as well as user defined searchTerms.
Map<AttributeMetaData,ExplainedAttributeMetaData>	decisionTreeToFindRelevantAttributes(EntityMetaData sourceEntityMetaData, AttributeMetaData targetAttribute, Collection<OntologyTerm> ontologyTermsFromTags, Set<String> searchTerms) A decision tree for getting the relevant attributes 1.
Map<AttributeMetaData,ExplainedAttributeMetaData>	findAttributes(EntityMetaData sourceEntityMetaData, Set<String> queryTerms, Collection<OntologyTerm> ontologyTerms) Find all relevant source attributes with an explanation based on ontology terms and search terms
Hit<OntologyTerm>	findTags(AttributeMetaData attribute, List<String> ontologyIds) Finds OntologyTerms for an attribute.
Map<AttributeMetaData,Hit<OntologyTerm>>	findTags(String entity, List<String> ontologyIds) Finds OntologyTerms that can be used to tag an attribute.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAX_NUM_TAGS

public static final int MAX_NUM_TAGS

See Also:

Constant Field Values

Constructor Detail

SemanticSearchServiceImpl

@Autowired
public SemanticSearchServiceImpl(DataService dataService,
                                            OntologyService ontologyService,
                                            MetaDataService metaDataService,
                                            SemanticSearchServiceHelper semanticSearchServiceHelper,
                                            ElasticSearchExplainService elasticSearchExplainService)

Method Detail

findAttributes

public Map<AttributeMetaData,ExplainedAttributeMetaData> findAttributes(EntityMetaData sourceEntityMetaData,
                                                                        Set<String> queryTerms,
                                                                        Collection<OntologyTerm> ontologyTerms)

Description copied from interface: SemanticSearchService

Find all relevant source attributes with an explanation based on ontology terms and search terms

Specified by:

findAttributes in interface SemanticSearchService

Returns:

AttributeMetaData of resembling attributes, sorted by relevance

decisionTreeToFindRelevantAttributes

public Map<AttributeMetaData,ExplainedAttributeMetaData> decisionTreeToFindRelevantAttributes(EntityMetaData sourceEntityMetaData,
                                                                                              AttributeMetaData targetAttribute,
                                                                                              Collection<OntologyTerm> ontologyTermsFromTags,
                                                                                              Set<String> searchTerms)

Description copied from interface: SemanticSearchService

A decision tree for getting the relevant attributes 1. First find attributes based on searchTerms. 2. Second find attributes based on ontology terms from tags 3. Third find attributes based on target attribute label.

Specified by:

decisionTreeToFindRelevantAttributes in interface SemanticSearchService

Returns:

AttributeMetaData of resembling attributes, sorted by relevance

createLexicalSearchQueryTerms

public Set<String> createLexicalSearchQueryTerms(AttributeMetaData targetAttribute,
                                                 Set<String> searchTerms)

A helper function to create a list of queryTerms based on the information from the targetAttribute as well as user defined searchTerms. If the user defined searchTerms exist, the targetAttribute information will not be used.

Parameters:

targetAttribute -

searchTerms -

Returns:

list of queryTerms

convertAttributeEntityToExplainedAttribute

public Set<ExplainedQueryString> convertAttributeEntityToExplainedAttribute(Entity attributeEntity,
                                                                            EntityMetaData sourceEntityMetaData,
                                                                            Map<String,String> collectExpanedQueryMap,
                                                                            List<QueryRule> finalQueryRules)

A helper function to explain each of the matched attributes returned by the explain-API

Parameters:

attributeEntity -

sourceEntityMetaData -

collectExpanedQueryMap -

finalQueryRules -

Returns:

findTags

public Map<AttributeMetaData,Hit<OntologyTerm>> findTags(String entity,
                                                         List<String> ontologyIds)

Description copied from interface: SemanticSearchService

Finds OntologyTerms that can be used to tag an attribute.

Specified by:

findTags in interface SemanticSearchService

Parameters:

entity - name of the entity

Returns:

Map of Hits for OntologyTerm results

findTags

public Hit<OntologyTerm> findTags(AttributeMetaData attribute,
                                  List<String> ontologyIds)

Description copied from interface: SemanticSearchService

Finds OntologyTerms for an attribute.

Specified by:

findTags in interface SemanticSearchService

Parameters:

attribute - AttributeMetaData to tag

ontologyIds - IDs of ontologies to take the OntologyTerms from.

Returns:

List of Hits for OntologyTerms found, most relevant first

bestMatchingSynonym

public Hit<String> bestMatchingSynonym(OntologyTerm ontologyTerm,
                                       Set<String> searchTerms)

Computes the best matching synonym which is closest to a set of search terms.
Will stem the OntologyTerm 's synonyms and the search terms, and then compute the maximum StringDistance between them. 0 means disjunct, 1 means identical

Parameters:

ontologyTerm - the OntologyTerm

searchTerms - the search terms

Returns:

the maximum StringDistance between the ontologyterm and the search terms