ai.grakn.graql.internal.analytics

Class Analytics

java.lang.Object

ai.grakn.graql.internal.analytics.Analytics

public class Analytics
extends Object

OLAP computations that can be applied to a Grakn Graph. The current implementation uses the SparkGraphComputer with a Hadoop graph that connects directly to cassandra and de-serialises vertices.

Field Summary

Fields

Modifier and Type	Field and Description
static String	connectedComponent
static String	degree

Constructor Summary

Constructors

Constructor and Description
Analytics(String keySpace, Set<String> subTypeIds, Set<String> statisticsResourceTypeIds) Create a graph computer from a Grakn Graph.

Method Summary

Modifier and Type	Method and Description
Map<String,Set<String>>	connectedComponents() Compute the number of connected components.
Map<String,Long>	connectedComponentsAndPersist() Compute the connected components and persist the component labels
Map<String,Long>	connectedComponentsSize() Compute the number of connected components.
long	count() Count the number of instances in the graph.
Map<Long,Set<String>>	degrees() Compute the number of relations that each instance takes part in.
void	degreesAndPersist() Compute the number of relations that each instance takes part in and persist this information in the graph.
protected GraknComputer	getGraphComputer()
Optional<Number>	max() Maximum value of the selected resource-type.
Optional<Double>	mean() Compute the mean of instances of the selected resource-type.
Optional<Number>	median() Compute the median of instances of the selected resource-type.
Optional<Number>	min() Minimum value of the selected resource-type.
Optional<Double>	std() Compute the standard deviation of instances of the selected resource-type.
Optional<Number>	sum() Sum of values of the selected resource-type.

Methods inherited from class java.lang.Object

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

Field Detail

degree

public static final String degree

See Also:

Constant Field Values

connectedComponent

public static final String connectedComponent

See Also:

Constant Field Values

Constructor Detail

Analytics

public Analytics(String keySpace,
                 Set<String> subTypeIds,
                 Set<String> statisticsResourceTypeIds)

Create a graph computer from a Grakn Graph. The computer operates on the instances of the types provided in the subtypes argument. All subtypes of the given types are included when deciding whether to include an instance.

Parameters:

subTypeIds - the set of type ids the computer will use to filter instances

statisticsResourceTypeIds - the set of resource type ids statistics will be working on

Method Detail

count

public long count()

Count the number of instances in the graph.

Returns:

the number of instances

min

public Optional<Number> min()

Minimum value of the selected resource-type.

Returns:

min

max

public Optional<Number> max()

Maximum value of the selected resource-type.

Returns:

max

sum

public Optional<Number> sum()

Sum of values of the selected resource-type.

Returns:

sum

mean

public Optional<Double> mean()

Compute the mean of instances of the selected resource-type.

Returns:

mean

median

public Optional<Number> median()

Compute the median of instances of the selected resource-type.

Returns:

median

std

public Optional<Double> std()

Compute the standard deviation of instances of the selected resource-type.

Returns:

standard deviation

connectedComponents

public Map<String,Set<String>> connectedComponents()

Compute the number of connected components.

Returns:

a map of set, each set contains all the vertex ids belonging to one connected component

connectedComponentsSize

public Map<String,Long> connectedComponentsSize()

Compute the number of connected components.

Returns:

a map of component size

connectedComponentsAndPersist

public Map<String,Long> connectedComponentsAndPersist()

Compute the connected components and persist the component labels

degrees

public Map<Long,Set<String>> degrees()

Compute the number of relations that each instance takes part in.

Returns:

a map from each instance to its degree

degreesAndPersist

public void degreesAndPersist()

Compute the number of relations that each instance takes part in and persist this information in the graph. The degree is stored as a resource of type "degree" attached to the relevant instance.

getGraphComputer

protected GraknComputer getGraphComputer()