de.julielab.neo4j.plugins.auxiliaries.semedico

Class TermAggregateBuilder

java.lang.Object

de.julielab.neo4j.plugins.auxiliaries.semedico.TermAggregateBuilder

public class TermAggregateBuilder
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TermAggregateBuilder.CopyAggregatePropertiesStatistics

Constructor Summary

Constructors

Constructor and Description
TermAggregateBuilder()

Method Summary

Modifier and Type	Method and Description
static void	buildAggregatesForEqualNames(org.neo4j.graphdb.GraphDatabaseService graphDb, String termPropertyKey, org.neo4j.shell.util.json.JSONArray propertyValues) Aggregates terms that have equal preferred name and synonyms, after some minor normalization.
static void	buildAggregatesForMappings(org.neo4j.graphdb.GraphDatabaseService graphDb, Set<String> allowedMappingTypes, org.neo4j.graphdb.Label allowedTermLabel, org.neo4j.graphdb.Label aggregatedTermsLabel)
static void	copyAggregateProperties(org.neo4j.graphdb.Node aggregate, String[] copyProperties, TermAggregateBuilder.CopyAggregatePropertiesStatistics copyStats) Fills aggregate with property values from its elements.
static void	deleteAggregates(org.neo4j.graphdb.GraphDatabaseService graphDb, org.neo4j.graphdb.Label aggregateLabel)
protected static void	determineMappedSubgraph(Set<String> allowedMappingTypes, org.neo4j.graphdb.Label allowedTermLabel, org.neo4j.graphdb.Node term, Set<org.neo4j.graphdb.Node> elements, Set<org.neo4j.graphdb.Node> visited)
protected static Set<org.neo4j.graphdb.Node>	getMatchingAggregates(org.neo4j.graphdb.Node conceptNode, Set<String> allowedMappingTypes, org.neo4j.graphdb.Label aggregateLabel) Returns all the aggregate nodes where conceptNode is an element of and where the aggregate is exactly of the mapping types specified in allowedMappingTypes.

Methods inherited from class java.lang.Object

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

Constructor Detail

TermAggregateBuilder

public TermAggregateBuilder()

Method Detail

buildAggregatesForEqualNames

public static void buildAggregatesForEqualNames(org.neo4j.graphdb.GraphDatabaseService graphDb,
                                                String termPropertyKey,
                                                org.neo4j.shell.util.json.JSONArray propertyValues)
                                         throws org.neo4j.shell.util.json.JSONException

Aggregates terms that have equal preferred name and synonyms, after some minor normalization.

Parameters:

graphDb - The graph database to work on.

termPropertyKey - actually not clear right now ;-)

propertyValues - The properties to merge for aggregated nodes.

Throws:

org.neo4j.shell.util.json.JSONException - If propertyValues is not a valid JSON string.

deleteAggregates

public static void deleteAggregates(org.neo4j.graphdb.GraphDatabaseService graphDb,
                                    org.neo4j.graphdb.Label aggregateLabel)

buildAggregatesForMappings

public static void buildAggregatesForMappings(org.neo4j.graphdb.GraphDatabaseService graphDb,
                                              Set<String> allowedMappingTypes,
                                              org.neo4j.graphdb.Label allowedTermLabel,
                                              org.neo4j.graphdb.Label aggregatedTermsLabel)

Parameters:

graphDb - The graph database to work on.

allowedMappingTypes - The mapping types that will be used to build aggregates. This relates to the property of mapping relationships that exposes the type of mapping the relationships is part of. All edges that are of at least one mapping type delivered by this parameter will be traversed to build an aggregate. That means, the more mapping types are allowed, the bigger the aggregates become. Also, each distinguished set of allowed mapping types defines a particular set of aggregations.

allowedTermLabel - Label to restrict the terms for which aggregates are built.

aggregatedTermsLabel - Label for terms that have been processed by the aggregation algorithm. Such terms can be aggregate terms (with the label ConceptManager.TermLabel.AGGREGATE) or just plain terms (with the label ConceptManager.TermLabel.TERM) that are not an element of an aggregate.

determineMappedSubgraph

protected static void determineMappedSubgraph(Set<String> allowedMappingTypes,
                                              org.neo4j.graphdb.Label allowedTermLabel,
                                              org.neo4j.graphdb.Node term,
                                              Set<org.neo4j.graphdb.Node> elements,
                                              Set<org.neo4j.graphdb.Node> visited)

getMatchingAggregates

protected static Set<org.neo4j.graphdb.Node> getMatchingAggregates(org.neo4j.graphdb.Node conceptNode,
                                                                   Set<String> allowedMappingTypes,
                                                                   org.neo4j.graphdb.Label aggregateLabel)

Returns all the aggregate nodes where conceptNode is an element of and where the aggregate is exactly of the mapping types specified in allowedMappingTypes.

Parameters:

conceptNode - The concept node that is an element of the sought aggregates.

allowedMappingTypes - The mapping type for which aggregates are requested.

aggregateLabel - The aggregate label for requested aggregate nodes.

Returns:

Matching aggregates for which conceptNode is an element of.

copyAggregateProperties

public static void copyAggregateProperties(org.neo4j.graphdb.Node aggregate,
                                           String[] copyProperties,
                                           TermAggregateBuilder.CopyAggregatePropertiesStatistics copyStats)

Fills aggregate with property values from its elements. Currently only called separately after all aggregates have been determined to save performance. During the process of aggregate creation, sometimes aggregations are merged. We don't copy all properties again but only merge the elements and compute the property values from the final elements after the aggregation creation process has finished. This has to be done explicitly and is not done automatically.

Parameters:

aggregate - The aggregate node to assembly element properties to.

copyProperties - The properties that should be copied into the aggregate.

copyStats - An object to collect statistics over the copy process.