Skip to content

Factors

A factor is a variable numeric value, attached to any entity in the knowledge graph, calculated from one of the following elements:

  • Possible scenarios attached to the entity, discovered and stored through assertions.
  • The entity data values, i.e. elements belonging to the entity itself, based on expressions.

A factor is the traditional way of storing risk scores that are calculated based on the possibile scenarios affecting every entity.

CogTL can optionnally record historical values of factors for every entity, so that it can be accessed through the API or the explorer view. To activate this feature, check Record historical values of this factor for every entity.

Default aggregation

The default aggregation is the function applied to calculate the factor value when multiple different scenarios affect a same entity. Aggregation of multiple instances of the same scenario is parametrized in the scenario configuration screen.

Presentation

The most important element of the presentation is the scale. The scale is a multiplier that will be applied to the value of this factor everytime it needs to be displayed.

It may be important because on every entity, the factor value is multiplied by the possible scenario probability. For example, if a possible scenario has a probability of 10% on day per year, the total probability is already of 10% * 1/365 = 0.027. As it may not be very user friendly to deal with very small numbers, you could thus set a scale of 1000 for this factor, bringing it to a more useable scale.

The presentation part of the factors edition screen allows to set a low and high limit to setup the global gauges displayed on dashboards (and highlight outlying entities).