Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

Multiplicative Events:Multiplicative

events can be created using a combination of the followingeee

Example: In the Multiplicative Event Specification shown above an event will be created for each combination of the following entity types: PersonPerpetrator, VictimType, and Location. Using the event source found below the Structured Analysis Harvester will generate a total of two (2) events based on the following math: 1 Perpetrator X 2 Victims X 1 Location = 2 Events.

In the example source below Multiplicative Events are specified by specifying which entity types to use to populate the entity1, entity2, geo_index, time_start, and time_end fields of the events created. The iterateOver field is used to specify the order in which the entity types to use are multiplied to determine the total number of events to create.

  • iterateOver
    The iterateOver field specifies the order in which the Structured Analysis Harvester multiplies each field in order to create the right number and type of events. Each of the entity fields to use are separated by the '/' character and specifies the entity type used to populate the matching field in the event object.

In the example source below there are four entities that are being shown: one location entity, two victim entities, and one perpetrator entity. These visible entities are the entities referenced in the example specification above.

Code Block
titleMultiplicative Event Source Example
{
    ...
    "entities" : [
       {
            "actual_name" : "Batticaloa,North Eastern Province,Sri Lanka",
            "dimension" : "Where",
            "disambiguous_name" : "Batticaloa,North Eastern Province,Sri Lanka",
            "doccount" : NumberLong(18),
            "frequency" : 1,
            "gazateer_index" : "batticaloa,north eastern province,sri lanka/location",
            "geotag" : {
               "latitude" : "7.7166667",
               "longitude" : "81.7"
            },
            "totalfrequency" : NumberLong(18),
            "type" : "Location"
       },
       {
            "actual_name" : "Targeted, Police, Adult from Sri Lanka",
            "dimension" : "Who",
            "disambiguous_name" : "Targeted, Police, Adult from Sri Lanka",
            "doccount" : NumberLong(47),
            "frequency" : 3,
            "gazateer_index" : "targeted, police, adult from sri lanka/victimtype",
            "totalfrequency" : NumberLong(161),
            "type" : "VictimType"
       },
       {
            "actual_name" : "Targeted, Military, Adult, Combatant from Sri Lanka",
            "dimension" : "Who",
            "disambiguous_name" : "Targeted, Military, Adult, Combatant from Sri Lanka",
            "doccount" : NumberLong(20),
            "frequency" : 1,
            "gazateer_index" : "targeted, military, adult, combatant from sri lanka/victimtype",
            "totalfrequency" : NumberLong(147),
            "type" : "VictimType"
       },
       {
            "actual_name" : "Secular/Political/Anarchist from Sri Lanka",
            "dimension" : "Who",
            "disambiguous_name" : "Secular/Political/Anarchist from Sri Lanka",
            "doccount" : NumberLong(200),
            "frequency" : 1,
            "gazateer_index" : "secular/political/anarchist from sri lanka/personperpetrator",
            "totalfrequency" : NumberLong(200),
            "type" : "PersonPerpetrator"
        },
        ...
    ],
    ...
}

...