Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

What is An Event?

Events are 

Basic Event Specification

The following code demonstrates how to specify a basic event (Note: The sample event specification and sample event output below is extracted from a MySql Database Source the full content of which can be viewed here.):

Basic Event Specification Example
{
    ...
    "events" : [
      {
        "entity1" : "$metadata.offense,$metadata.method",
        "verb" : "reported",
        "verb_category" : "crime",
        "time_start" : "$metadata.reportdatetime", 
        "geo_index" : "Location",
        "geotag" : {
           "latitude" : "$metadata.latitude",
           "longitude" : "$metadata.longitude"}
      },
    ],
    ...
}

In the basic example above the following fields have been specified:

  • entity1
    A free form text field containing information about the event "subject", i.e. an entity's disambiguous name. 
  • entity1_index
    If present this is the "gazateer_index" field of the entity matching the entity1 disambiguous name above.
  • verb
    A free form text field describing the event "verb"
  • verb_category
    Also a free form text field describing the event "verb", but intended to group related verbs together (eg "travel" for verbs: "flew", "drove")
  • geoindex
    If the event geotag maps into an entity from the parent document then this field is the "gazateer_index" of that entity
  • geotag
    • latitude
      String containing a floating point representation of latitude
    • longitude
      String containing a floating point representation of longitude

The result of the event specification above can be seen in the sample output below:

Example Event Output
{
    ...
    "events" : [
      {
         "entity1" : "robbery gun",
         "entity1_index" : "robbery gun/criminalactivity",
         "verb" : "reported",
         "verb_category" : "crime",
         "geotag" : {
             "latitude" : "38.9051666534795",
             "longitude" : "-77.0121735726172"
         },
         "geo_index" : "1100 b/o 1st st nw washington dc/place",
         "event_type" : "Event"
      }
    ],
    ...
}

In the sample output above please note that the Infinit.e harvester automatically generates the following fields as appropriate:

  • event_type
    "Event", "Fact", "Summary"
    The "event_type" field sub-categorizes the "event" object into one of three types, "Event", "Fact", or "Summary". Examples provided below should make the distinction clearer, but it can be simply described as follows:
    • "Event": link multiple entities (via "entity1_index", "entity2_index", "geo_index") and represent a transient activity (eg travel)
    • "Fact": link multiple entities like "Events" but represent (transient or permanent) relationships (eg being president)
    • "Summary": generally link 1 entity to a free text (eg a quotation: "Obama says...").
Specifying Additive Events

The Structured Analysis Harvester supports the specification of events...

Specifying Multiplicative Events

The Structured Analysis Harvester supports the creation of events that are specified 

Basic Event Specification Example
{
    ...
    "events" : [
       {
          "iterateOver" : "entity1/entity2/geo_index",
          "verb" : "attacked",
          "verb_category" : "assault/attack",
          "entity1" : "PersonPerpetrator",
          "entity2" : "VictimType",
          "geo_index" : "Location",
          "time_start" : "$SCRIPT( return _doc.metadata.incidentdate[0]; )"
       },
    ],
    ...
}
Further Reading
  • No labels