Inferensys

Glossary

TimeML Annotation

A markup language standard for representing temporal events, time expressions, and their linking relationships within a document to enable automated temporal reasoning.
Stylish WeWork-like workspace with hot desks and document wall, professional searching through enterprise knowledge base on a mounted ultrawide display, warm industrial pendants overhead.
TEMPORAL MARKUP LANGUAGE

What is TimeML Annotation?

A standardized markup language for identifying and linking temporal expressions, events, and their relationships within a document to enable automated temporal reasoning.

TimeML Annotation is a specification language for marking up events, time expressions, and their temporal links in natural language text. It transforms unstructured narratives into structured temporal graphs by tagging four core entity types: EVENT (actions or states), TIMEX3 (dates, times, durations), SIGNAL (linguistic cues like 'before' or 'during'), and LINK (relations such as TLINK, SLINK, and ALINK that establish chronological, subordination, and aspectual connections between entities).

The annotation standard enables machines to perform temporal closure reasoning—inferring unstated chronological relationships from explicitly tagged ones. In legal contexts, TimeML allows systems to automatically order contractual obligations, detect temporal contradictions, and answer point-in-time queries by grounding narrative sequences in a formal, computationally traversable timeline.

ANNOTATION PRIMITIVES

Core Components of TimeML

The foundational tag set and linking structures that enable machines to parse and reason about the temporal fabric of a document.

01

TIMEX3: Temporal Expressions

The tag used to annotate explicit time references, normalizing them to a standard value for machine processing.

  • Types: Date, Time, Duration, and Set (e.g., 'every month').
  • Normalization: The value attribute converts 'October 26, 2023' to 2023-10-26.
  • Anchoring: The anchorTimeID attribute links relative expressions like 'last week' to a reference point.
  • Modifiers: Captures quantifiers such as 'approximately' or 'more than'.
ISO 8601
Standard Value Format
02

EVENT: Occurrences & States

The tag for annotating situations that happen or hold true, serving as the nodes in a temporal graph.

  • Classes: OCCURRENCE, STATE, REPORTING, I_STATE, I_ACTION, ASPECTUAL.
  • Tense & Aspect: Attributes capture grammatical cues like tense=PAST and aspect=PERFECTIVE.
  • Polarity: The polarity=NEG attribute explicitly marks negated events (e.g., 'did not pay').
  • Modality: Captures the context of possibility or necessity (e.g., 'shall deliver').
7
Core Event Classes
03

TLINK: Temporal Links

The relation tag that establishes the chronological order between two events or an event and a time expression.

  • Core Relations: Encodes Allen's interval algebra primitives like BEFORE, AFTER, INCLUDES, and SIMULTANEOUS.
  • Graph Construction: TLINKs create the directed temporal dependency graph required for critical path analysis.
  • Inference: Enables reasoning about the happens-before relationship between contractual obligations.
13
Allen Relations Supported
04

SIGNAL: Linguistic Cues

The tag that marks function words and phrases indicating the nature of a temporal relation.

  • Examples: 'during', 'before', 'after', 'while', 'until'.
  • Disambiguation: Resolves ambiguous TLINKs by providing the lexical evidence for the link.
  • Scope: The SIGNAL tag is linked to a TLINK via its signalID attribute, grounding the relation in explicit text.
05

ALINK: Aspectual Links

A relation tag specifically for linking an aspectual event to its argument event, encoding the internal temporal structure.

  • Phases: Distinguishes between the INITIATES, CULMINATES, TERMINATES, and CONTINUES phases of an event.
  • Example: In 'started to perform the audit', an ALINK connects 'started' to 'perform' with the INITIATES relation.
  • Obligation Lifecycle: Critical for modeling the state machine of a contractual duty from inception to fulfillment.
06

SLINK: Subordination Links

The relation tag that connects a modal or evidential event to its subordinate event, capturing context like modality and factuality.

  • Modality: Links 'shall' to 'deliver' to encode a deontic obligation.
  • Factuality: Distinguishes between factual, counterfactual, and conditional events.
  • Legal Relevance: Essential for parsing deontic logic structures like permissions and prohibitions in regulatory text.
TIMEML ANNOTATION FAQ

Frequently Asked Questions

Clear, technical answers to the most common questions about the TimeML markup language and its role in automated temporal reasoning for legal documents.

TimeML is a robust markup language standard designed to represent temporal events, time expressions, and their linking relationships within a document. It works by annotating text with specific XML tags to identify four core temporal elements: EVENT (actions or states), TIMEX3 (dates, times, and durations), SIGNAL (linguistic cues like 'before' or 'during'), and LINK (the relations connecting them). By explicitly encoding that 'Event A happened before Event B' or 'Event C includes Event D,' TimeML transforms unstructured narrative text into a machine-readable temporal knowledge graph, enabling automated temporal reasoning and contradiction detection.

Prasad Kumkar

About the author

Prasad Kumkar

CEO & MD, Inference Systems

Prasad Kumkar is the CEO & MD of Inference Systems and writes about AI systems architecture, LLM infrastructure, model serving, evaluation, and production deployment. Over 5+ years, he has worked across computer vision models, L5 autonomous vehicle systems, and LLM research, with a focus on taking complex AI ideas into real-world engineering systems.

His work and writing cover AI systems, large language models, AI agents, multimodal systems, autonomous systems, inference optimization, RAG, evaluation, and production AI engineering.