Pometry · arienandalibi · May 3, 2025 · May 6, 2025 · May 7, 2025 · May 8, 2025
diff --git a/docs/assets/images/gandalf-importance.png b/docs/assets/images/gandalf-importance.png
diff --git a/docs/reference/graphql/graphql_API.md b/docs/reference/graphql/graphql_API.md
diff --git a/docs/user-guide/algorithms/4_view-algorithms.md b/docs/user-guide/algorithms/4_view-algorithms.md
@@ -1,8 +1,8 @@
-# Running algorithms on GraphViews 
+# Running algorithms on GraphViews
 
-Both `graphwide` and `node centric` algorithms can be run on `GraphViews`. This allows us to see how results change over time, run algorithms on subsets of the layers, or remove specific nodes from the graph to see the impact this has. 
+Both `graphwide` and `node centric` algorithms can be run on `GraphViews`. This allows us to see how results change over time, run algorithms on subsets of the layers, or remove specific nodes from the graph to see the impact this has.
 
-To demonstrate this, the following example shows how you could track Gandalf's importance over the course of the story using rolling windows and the `PageRank` algorithm. 
+To demonstrate this, the following example shows how you could track Gandalf's importance over the course of the story using rolling windows and the `PageRank` algorithm.
 
 Within each windowed graph we use the `NodeState` api to extract Gandalf's score and record it alongside the earliest timestamp in the window, which can then be plotted via matplotlib.
 
@@ -26,12 +26,14 @@ time = []
 for windowed_graph in lotr_graph.rolling(window=2000):
     result = rp.pagerank(windowed_graph)
     importance.append(result.get("Gandalf"))
-    time.append(windowed_graph.earliest_time)
+    time.append(windowed_graph.earliest_time.t)
 
 plt.plot(time, importance, marker="o")
 plt.xlabel("Sentence (Time)")
 plt.ylabel("Pagerank Score")
 plt.title("Gandalf's importance over time")
 plt.grid(True)
 ```
-///
+///
+
+![Gandalf's importance over time](../../assets/images/gandalf-importance.png)
diff --git a/docs/user-guide/export/2_dataframes.md b/docs/user-guide/export/2_dataframes.md
@@ -133,7 +133,6 @@ Finally, we call `to_df()` again, turning off the property history and exploding
 each interaction that occurred between `ANGELE` and `FELIPE`.
 
 !!! info
-
     We have further reduced the graph to only one layer (`Grunting-Lipsmacking`) to reduce the output size.
 
 /// tab | :fontawesome-brands-python: Python
@@ -177,8 +176,8 @@ print(df)
 ///
 
 ```{.python continuation hide}
-assert str(grunting_graph) == "Graph(number_of_nodes=2, number_of_edges=2, number_of_temporal_edges=6, earliest_time=1560526320000, latest_time=1562253540000)"
-assert str(grunting_graph.edges) == "Edges(Edge(source=ANGELE, target=FELIPE, earliest_time=1560526320000, latest_time=1561042620000, properties={Weight: 1}, layer(s)=[Grunting-Lipsmacking]), Edge(source=FELIPE, target=ANGELE, earliest_time=1560526320000, latest_time=1562253540000, properties={Weight: 1}, layer(s)=[Grunting-Lipsmacking]))"
+assert str(grunting_graph) == "Graph(number_of_nodes=2, number_of_edges=2, number_of_temporal_edges=6, earliest_time=EventTime(timestamp=1560526320000, event_id=365), latest_time=EventTime(timestamp=1562253540000, event_id=2531))"
+assert str(grunting_graph.edges) == "Edges(Edge(source=ANGELE, target=FELIPE, earliest_time=EventTime(timestamp=1560526320000, event_id=365), latest_time=EventTime(timestamp=1561042620000, event_id=871), properties={Weight: 1}, layer(s)=[Grunting-Lipsmacking]), Edge(source=FELIPE, target=ANGELE, earliest_time=EventTime(timestamp=1560526320000, event_id=366), latest_time=EventTime(timestamp=1562253540000, event_id=2531), properties={Weight: 1}, layer(s)=[Grunting-Lipsmacking]))"
 ```
 
 !!! Output
@@ -236,8 +235,8 @@ assert str(grunting_graph.edges) == "Edges(Edge(source=ANGELE, target=FELIPE, ea
     13                                    [1560526320000]  
     14                                    [1561110180000]  
 
-    Graph(number_of_nodes=2, number_of_edges=2, number_of_temporal_edges=6, earliest_time=1560526320000, latest_time=1562253540000)
-    Edges(Edge(source=ANGELE, target=FELIPE, earliest_time=1560526320000, latest_time=1561042620000, properties={Weight: 1}, layer(s)=[Grunting-Lipsmacking]), Edge(source=FELIPE, target=ANGELE, earliest_time=1560526320000, latest_time=1562253540000, properties={Weight: 1}, layer(s)=[Grunting-Lipsmacking]))
+    Graph(number_of_nodes=2, number_of_edges=2, number_of_temporal_edges=6, earliest_time=EventTime(timestamp=1560526320000, event_id=365), latest_time=EventTime(timestamp=1562253540000, event_id=2531))
+    Edges(Edge(source=ANGELE, target=FELIPE, earliest_time=EventTime(timestamp=1560526320000, event_id=365), latest_time=EventTime(timestamp=1561042620000, event_id=871), properties={Weight: 1}, layer(s)=[Grunting-Lipsmacking]), Edge(source=FELIPE, target=ANGELE, earliest_time=EventTime(timestamp=1560526320000, event_id=366), latest_time=EventTime(timestamp=1562253540000, event_id=2531), properties={Weight: 1}, layer(s)=[Grunting-Lipsmacking]))
     Exploding the grunting-Lipsmacking layer
         src     dst                 layer  \
     0  ANGELE  FELIPE  Grunting-Lipsmacking   

diff --git a/docs/user-guide/getting-started/20_intro.md b/docs/user-guide/getting-started/20_intro.md
@@ -51,18 +51,17 @@ print(g)
 ///
 
 ```{.python continuation hide}
-assert str(g) == "Graph(number_of_nodes=22, number_of_edges=290, number_of_temporal_edges=3196, earliest_time=1560419400000, latest_time=1562756700000)"
+assert str(g) == "Graph(number_of_nodes=22, number_of_edges=290, number_of_temporal_edges=3196, earliest_time=EventTime(timestamp=1560419400000, event_id=0), latest_time=EventTime(timestamp=1562756700000, event_id=18446744073709551615))"
 ```
 
-You can print the state of the graph object to verify it exists.
+You can print the state of the graph object to verify it exists. Note that the `earliest_time` and `latest_time` are given in Raphtory's `EventTime` format.
 
 !!! Output
 
     ```output
-    Graph(number_of_nodes=22, number_of_edges=290, number_of_temporal_edges=3196, earliest_time=1560419400000, latest_time=1562756700000)
+    Graph(number_of_nodes=22, number_of_edges=290, number_of_temporal_edges=3196, earliest_time=EventTime(timestamp=1560419400000, event_id=0), latest_time=EventTime(timestamp=1562756700000, event_id=18446744073709551615))
     ```
 
-
 For more details, see [Creating a graph](../ingestion/1_intro.md).
 
 ## Query your data

diff --git a/docs/user-guide/ingestion/2_direct-updates.md b/docs/user-guide/ingestion/2_direct-updates.md
@@ -25,18 +25,18 @@ print(v)
 ///
 
 ```{.python continuation hide}
-assert str(g) == "Graph(number_of_nodes=1, number_of_edges=0, number_of_temporal_edges=0, earliest_time=1, latest_time=1)"
-assert str(v) == "Node(name=10, earliest_time=1, latest_time=1)"
+assert str(g) == "Graph(number_of_nodes=1, number_of_edges=0, number_of_temporal_edges=0, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=1, event_id=18446744073709551615))"
+assert str(v) == "Node(name=10, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=1, event_id=0))"
 ```
 
-Printing out the graph and the returned node we can see the update was successful and the earliest/latest time has been
-updated.
+Printing out the graph and the returned node you can see the update was successful and the earliest and latest times have been
+updated. The timestamp you specified is used as the primary index of the `EventTime` object.
 
 !!! Output
 
     ```output
-    Graph(number_of_nodes=1, number_of_edges=0, number_of_temporal_edges=0, earliest_time=1, latest_time=1)
-    Node(name=10, earliest_time=1, latest_time=1)
+    Graph(number_of_nodes=1, number_of_edges=0, number_of_temporal_edges=0, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=1, event_id=18446744073709551615))
+    Node(name=10, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=1, event_id=0))
     ```
 
 ## Adding edges
@@ -62,15 +62,15 @@ print(e)
 ///
 
 ```{.python continuation hide}
-assert str(g) == "Graph(number_of_nodes=2, number_of_edges=1, number_of_temporal_edges=1, earliest_time=1, latest_time=1)"
-assert str(e) == "Edge(source=15, target=16, earliest_time=1, latest_time=1, layer(s)=[_default])"
+assert str(g) == "Graph(number_of_nodes=2, number_of_edges=1, number_of_temporal_edges=1, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=1, event_id=18446744073709551615))"
+assert str(e) == "Edge(source=15, target=16, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=1, event_id=0), layer(s)=[_default])"
 ```
 
 !!! Output
 
     ```output
-    Graph(number_of_nodes=2, number_of_edges=1, number_of_temporal_edges=1, earliest_time=1, latest_time=1)
-    Edge(source=15, target=16, earliest_time=1, latest_time=1, layer(s)=[_default])
+    Graph(number_of_nodes=2, number_of_edges=1, number_of_temporal_edges=1, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=1, event_id=18446744073709551615))
+    Edge(source=15, target=16, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=1, event_id=0), layer(s)=[_default])
     ```
 
 You will notice in the output that the graph has two nodes as well as the edge. Raphtory automatically creates the source and destination nodes at the same time if they do not currently exist in the graph. This is to keep the graph consistent and avoid `hanging edges`. These nodes are empty other than the history of their edges, therefore if you apply filters to exclude all edges these empty nodes will also be excluded from your graph.
@@ -102,17 +102,17 @@ print(g.edge("User 1", "User 2"))
 ///
 
 ```{.python continuation hide}
-assert str(g.node("User 1")) == "Node(name=User 1, earliest_time=123, latest_time=789)"
-assert str(g.node("User 2")) == "Node(name=User 2, earliest_time=456, latest_time=789)"
-assert str(g.edge("User 1", "User 2")) == "Edge(source=User 1, target=User 2, earliest_time=789, latest_time=789, layer(s)=[_default])"
+assert str(g.node("User 1")) == "Node(name=User 1, earliest_time=EventTime(timestamp=123, event_id=0), latest_time=EventTime(timestamp=789, event_id=2))"
+assert str(g.node("User 2")) == "Node(name=User 2, earliest_time=EventTime(timestamp=456, event_id=1), latest_time=EventTime(timestamp=789, event_id=2))"
+assert str(g.edge("User 1", "User 2")) == "Edge(source=User 1, target=User 2, earliest_time=EventTime(timestamp=789, event_id=2), latest_time=EventTime(timestamp=789, event_id=2), layer(s)=[_default])"
 ```
 
 !!! Output
 
     ```output
-    Node(name=User 1, earliest_time=123, latest_time=789)
-    Node(name=User 2, earliest_time=456, latest_time=789)
-    Edge(source=User 1, target=User 2, earliest_time=789, latest_time=789, layer(s)=[_default])
+    Node(name=User 1, earliest_time=EventTime(timestamp=123, event_id=0), latest_time=EventTime(timestamp=789, event_id=2))
+    Node(name=User 2, earliest_time=EventTime(timestamp=456, event_id=1), latest_time=EventTime(timestamp=789, event_id=2))
+    Edge(source=User 1, target=User 2, earliest_time=EventTime(timestamp=789, event_id=2), latest_time=EventTime(timestamp=789, event_id=2), layer(s)=[_default])
     ```
 
 !!! warning
@@ -146,34 +146,34 @@ datetime_obj = datetime(2021, 1, 1, 12, 32, 0, 0)
 g.add_node(timestamp=datetime_obj, id=10)
 
 print(g)
-print(g.node(id=10).history())
-print(g.node(id=10).history_date_time())
+print(g.node(id=10).history.t.collect())
+print(g.node(id=10).history.dt.collect())
 ```
 
 ///
 
 ```{.python continuation hide}
-assert str(g) == "Graph(number_of_nodes=1, number_of_edges=0, number_of_temporal_edges=0, earliest_time=1609504320000, latest_time=1612360860000)"
-assert str(g.node(id=10).history()) == "[1609504320000 1612360860000]"
-assert str(g.node(id=10).history_date_time()) == "[datetime.datetime(2021, 1, 1, 12, 32, tzinfo=datetime.timezone.utc), datetime.datetime(2021, 2, 3, 14, 1, tzinfo=datetime.timezone.utc)]"
+assert str(g) == "Graph(number_of_nodes=1, number_of_edges=0, number_of_temporal_edges=0, earliest_time=EventTime(timestamp=1609504320000, event_id=0), latest_time=EventTime(timestamp=1612360860000, event_id=18446744073709551615))"
+assert str(g.node(id=10).history.t.collect()) == "[1609504320000 1612360860000]"
+assert str(g.node(id=10).history.dt.collect()) == "[datetime.datetime(2021, 1, 1, 12, 32, tzinfo=datetime.timezone.utc), datetime.datetime(2021, 2, 3, 14, 1, tzinfo=datetime.timezone.utc)]"
 ```
 
 !!! Output
 
     ```output
-    Graph(number_of_nodes=1, number_of_edges=0, number_of_temporal_edges=0, earliest_time=1609504320000, latest_time=1612360860000)
+    Graph(number_of_nodes=1, number_of_edges=0, number_of_temporal_edges=0, earliest_time=EventTime(timestamp=1609504320000, event_id=0), latest_time=EventTime(timestamp=1612360860000, event_id=18446744073709551615))
     [1609504320000 1612360860000]
     [datetime.datetime(2021, 1, 1, 12, 32, tzinfo=datetime.timezone.utc), datetime.datetime(2021, 2, 3, 14, 1, tzinfo=datetime.timezone.utc)]
     ```
 
 In the output we can see the `history` of node `10` contains the two times at which we have added it into the graph (
 maintained in ascending order), returned in both unix epoch (integer) and datetime format.
 
+Internally, the [History][raphtory.History] of events is tracked using [EventTime][raphtory.EventTime] objects. However, in this example we use the `.t` and `.dt` methods to get iterables of epochs and datetimes directly from the `History` object and collect the iterables to display simple lists.
+
 ## Properties
 
-Alongside the structural update history, Raphtory can maintain the changing value of [`Properties`][raphtory.Properties] associated with nodes
-and edges. Both the `add_node()` and `add_edge()` functions have an optional parameter `properties` which takes a
-dictionary of key value pairs to be stored at the given timestamp.
+Alongside the structural update history, Raphtory can maintain the changing value of [`Properties`][raphtory.Properties] associated with nodes and edges. Both the `add_node()` and `add_edge()` functions have an optional parameter `properties` which takes a dictionary of key value pairs to be stored at the given timestamp.
 
 The graph itself may also have its own `global properties` added using the `add_properties()` function which takes only
 a `timestamp` and a `properties` dictionary.
@@ -182,7 +182,7 @@ Properties can consist of primitives (`Integer`, `Float`, `String`, `Boolean`, `
 `List`). This allows you to store both basic values as well as do complex hierarchical modelling depending on your use
 case.
 
-In the example below, we are using all of these functions to add a mixture of properties to a node, an edge, and the
+In the example below, we use all of these functions to add a mixture of properties to a node, an edge, and the
 graph.
 
 !!! warning
@@ -249,15 +249,15 @@ print(e)
 ///
 
 ```{.python continuation hide}
-assert str(e) == "Edge(source=User 1, target=User 2, earliest_time=4, latest_time=4, properties={weights: [1, 2, 3]}, layer(s)=[_default])"
+assert str(e) == "Edge(source=User 1, target=User 2, earliest_time=EventTime(timestamp=4, event_id=5), latest_time=EventTime(timestamp=4, event_id=5), properties={weights: [1, 2, 3]}, layer(s)=[_default])"
 ```
 
 !!! Output
 
     ```output
-    Graph(number_of_nodes=2, number_of_edges=1, number_of_temporal_edges=1, earliest_time=1, latest_time=4, properties=Properties({inner data: {fruits: {apple: 5, banana: 3}, date of birth: 2021-01-01 12:32:00}, favourite greetings: [hi, hello, howdy]}))
-    Node(name=User 1, earliest_time=1, latest_time=4, properties=Properties({count: 2, greeting: hello, encrypted: true, balance: 0.9}))
-    Edge(source=User 1, target=User 2, earliest_time=4, latest_time=4, properties={weights: [1, 2, 3]}, layer(s)=[_default])
+    Graph(number_of_nodes=2, number_of_edges=1, number_of_temporal_edges=1, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=4, event_id=18446744073709551615), properties=Properties({inner data: {fruits: {apple: 5, banana: 3}, date of birth: 2021-01-01 12:32:00}, favourite greetings: [hi, hello, howdy]}))
+    Node(name=User 1, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=4, event_id=5), properties=Properties({count: 2, greeting: hello, encrypted: true, balance: 0.9}))
+    Edge(source=User 1, target=User 2, earliest_time=EventTime(timestamp=4, event_id=5), latest_time=EventTime(timestamp=4, event_id=5), properties={weights: [1, 2, 3]}, layer(s)=[_default])
     ```
 
 !!! info
@@ -268,7 +268,7 @@ assert str(e) == "Edge(source=User 1, target=User 2, earliest_time=4, latest_tim
 
 ## Metadata
 
-Raphtory also provides [`metadata`][raphtory.Metadata] associated with nodes and edges which have immutable values. These are useful when you know a value won't change or is not  associated with a specific time.
+Raphtory also provides [`metadata`][raphtory.Metadata] associated with nodes and edges which have immutable values. These are useful when you know a value won't change or is not associated with a specific time.
 
 You can use the `add_metadata()` function, which takes a single `dictionary` argument, to add metadata to a `graph`, `node` and `edge` as demonstrated below.
 
@@ -296,17 +296,17 @@ print(e)
 ///
 
 ```{.python continuation hide}
-assert str(g) == "Graph(number_of_nodes=2, number_of_edges=1, number_of_temporal_edges=1, earliest_time=1, latest_time=2)"
-assert str(v) == "Node(name=User 1, earliest_time=1, latest_time=2)"
-assert str(e) == "Edge(source=User 1, target=User 2, earliest_time=2, latest_time=2, layer(s)=[_default])"
+assert str(g) == "Graph(number_of_nodes=2, number_of_edges=1, number_of_temporal_edges=1, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=2, event_id=18446744073709551615))"
+assert str(v) == "Node(name=User 1, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=2, event_id=1))"
+assert str(e) == "Edge(source=User 1, target=User 2, earliest_time=EventTime(timestamp=2, event_id=1), latest_time=EventTime(timestamp=2, event_id=1), layer(s)=[_default])"
 ```
 
 !!! output
 
     ```output
-    Graph(number_of_nodes=2, number_of_edges=1, number_of_temporal_edges=1, earliest_time=1, latest_time=2)
-    Node(name=User 1, earliest_time=1, latest_time=2)
-    Edge(source=User 1, target=User 2, earliest_time=2, latest_time=2, layer(s)=[_default])
+    Graph(number_of_nodes=2, number_of_edges=1, number_of_temporal_edges=1, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=2, event_id=18446744073709551615))
+    Node(name=User 1, earliest_time=EventTime(timestamp=1, event_id=0), latest_time=EventTime(timestamp=2, event_id=1))
+    Edge(source=User 1, target=User 2, earliest_time=EventTime(timestamp=2, event_id=1), latest_time=EventTime(timestamp=2, event_id=1), layer(s)=[_default])
     ```    
 
 ## Edge Layers
@@ -387,4 +387,4 @@ assert str(layered_edge.properties.temporal.get("weight").values()) == "[20 35]"
     ```output
     [10 13 20 17 35]
     [20 35]
-    ```
+    ```