logo Netzschleuder network catalog, repository, and centrifuge

History of email_enron_core

The changes to the source code of this entry in the repository, newest first, each with the differences it made to the entry's files. They are also listed on GitLab.

[entries] Add the date when each entry was added, and remove icon_hash by Tiago de Paula Peixoto beff7c9
The dates are those of the commits that first added the entries' files
(2020-08-11 for the entries of the initial commit); renamed entries keep
the date of their first name.

Changed: none
diff --git a/entries/email_enron_core/__init__.py b/entries/email_enron_core/__init__.py
index 2e78420..4f3d201 100644
--- a/entries/email_enron_core/__init__.py
+++ b/entries/email_enron_core/__init__.py
@@ -30,7 +30,7 @@ tags = ['Social', 'Communication', 'Unweighted', 'Timestamps', 'Metadata']
 url = 'https://www.cs.cornell.edu/~arb/data/email-Enron/'
 citation = [('A. R. Benson, R. Abebe, M. T. Schaub, A. Jadbabaie, J. Kleinberg, "Simplicial closure and higher-order link prediction." Proceedings of the National Academy of Sciences 115(48), E11221-E11230 (2018)', 'https://doi.org/10.1073/pnas.1800683115'),
             ('B. Klimt, Y. Yang, "The Enron Corpus: A New Dataset for Email Classification Research." Machine Learning: ECML 2004, Lecture Notes in Computer Science 3201, 217-226 (2004)', 'https://doi.org/10.1007/978-3-540-30115-8_22')]
-icon_hash = None
+date_added = '2026-10-25'
 upstream_license = None
 upstream_prefix = 'gdrive://'
 files = [(('118tda4_E7ebtTNhKj12IJ9Y71rtJ7UP6:tar.gz:email-Enron-full/email-Enron-full-nverts.txt',
[entries] Prefix the properties in the descriptions with (Node), (Edge) or (Graph) by Tiago de Paula Peixoto bc3dbbd
The lists of properties at the end of the descriptions marked edge
properties with "Edge" but left node properties unmarked, or grouped
them in "Nodes: `a`, ...; `b`, ..." items, so the kind of a property
was often unclear. Every item now starts with (Node), (Edge) or (Graph),
followed by the property names, a colon and the explanation, one item
per property or group of properties; qualifications (kinds of nodes,
networks) follow the names in parentheses. Properties that were only
named got a short explanation, and a few items that named the wrong
kind of property were corrected.
diff --git a/entries/email_enron_core/__init__.py b/entries/email_enron_core/__init__.py
index 1b3ede12..2e78420 100644
--- a/entries/email_enron_core/__init__.py
+++ b/entries/email_enron_core/__init__.py
@@ -23,9 +23,9 @@ description = """A bipartite network of Enron employees and the emails they exch
 
 The network has the following properties:
 
-- `is_email`, whether the node is an email (otherwise an employee).
-- Employee nodes: `name`, the email address of the employee.
-- Email nodes: `time`, the time the email was sent, in Unix time (seconds since 1970-01-01), converted from the millisecond timestamps of the source (the source does not document how the time zones of the original email headers were handled)."""
+- (Node) `is_email`: whether the node is an email (otherwise an employee).
+- (Node) `name` (employees): the email address of the employee.
+- (Node) `time` (emails): the time the email was sent, in Unix time (seconds since 1970-01-01), converted from the millisecond timestamps of the source (the source does not document how the time zones of the original email headers were handled)."""
 tags = ['Social', 'Communication', 'Unweighted', 'Timestamps', 'Metadata']
 url = 'https://www.cs.cornell.edu/~arb/data/email-Enron/'
 citation = [('A. R. Benson, R. Abebe, M. T. Schaub, A. Jadbabaie, J. Kleinberg, "Simplicial closure and higher-order link prediction." Proceedings of the National Academy of Sciences 115(48), E11221-E11230 (2018)', 'https://doi.org/10.1073/pnas.1800683115'),
[entries] Remove unneeded code from the entries by Tiago de Paula Peixoto 2c69f19
Unneeded "global files" statements, unused imports and variables,
f-strings without placeholders, duplicate keys in foodweb_little_rock
(keeping the order and the values used), and the second definition of
get_lines() in twitter_higgs. Nothing changes in the networks or
descriptions.

Changed: none
diff --git a/entries/email_enron_core/__init__.py b/entries/email_enron_core/__init__.py
index 86b9725..1b3ede12 100644
--- a/entries/email_enron_core/__init__.py
+++ b/entries/email_enron_core/__init__.py
@@ -51,7 +51,6 @@ def fetch_upstream(force=False):
 @coerce_props()
 @annotate()
 def parse(alts=None):
-    global files
     name = __name__.split(".")[-1]
     for fnames, alt, fmt in files:
         if alts is not None and alt not in alts:
[entries] New entry: email_enron_core by Tiago de Paula Peixoto 676595b
diff --git a/entries/email_enron_core/__init__.py b/entries/email_enron_core/__init__.py
new file mode 100644
index 0000000..86b9725
--- /dev/null
+++ b/entries/email_enron_core/__init__.py
@@ -0,0 +1,76 @@
+#! /usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2020-2026 Tiago de Paula Peixoto <tiago@skewed.de>
+#
+# This program is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, either version 3 of the License, or (at your option) any
+# later version.
+#
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License along
+# with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+from .. import *
+
+title = "Enron core employee emails (1998-2002)"
+description = """A bipartite network of Enron employees and the emails they exchanged, constructed by Benson et al. from the Enron email corpus distributed by William Cohen at Carnegie Mellon University. The corpus contains the mailboxes of about 150 Enron employees, mostly senior management, which were made public by the US Federal Energy Regulatory Commission during its investigation of the company. Only the email addresses of a core set of 148 employees are included, and only emails sent by one of them to at least one other of them; recipients outside this set are not represented. Each email node is connected to its sender and to its recipients from the core set (the source data do not distinguish the sender from the recipients). The emails span November 1998 to June 2002. This is the version of the data without restriction on the number of participants (at most 37 per email). 431 emails have a single participant, i.e. an employee who emailed themselves. Five of the 148 addresses do not take part in any email and are not included.
+
+The network has the following properties:
+
+- `is_email`, whether the node is an email (otherwise an employee).
+- Employee nodes: `name`, the email address of the employee.
+- Email nodes: `time`, the time the email was sent, in Unix time (seconds since 1970-01-01), converted from the millisecond timestamps of the source (the source does not document how the time zones of the original email headers were handled)."""
+tags = ['Social', 'Communication', 'Unweighted', 'Timestamps', 'Metadata']
+url = 'https://www.cs.cornell.edu/~arb/data/email-Enron/'
+citation = [('A. R. Benson, R. Abebe, M. T. Schaub, A. Jadbabaie, J. Kleinberg, "Simplicial closure and higher-order link prediction." Proceedings of the National Academy of Sciences 115(48), E11221-E11230 (2018)', 'https://doi.org/10.1073/pnas.1800683115'),
+            ('B. Klimt, Y. Yang, "The Enron Corpus: A New Dataset for Email Classification Research." Machine Learning: ECML 2004, Lecture Notes in Computer Science 3201, 217-226 (2004)', 'https://doi.org/10.1007/978-3-540-30115-8_22')]
+icon_hash = None
+upstream_license = None
+upstream_prefix = 'gdrive://'
+files = [(('118tda4_E7ebtTNhKj12IJ9Y71rtJ7UP6:tar.gz:email-Enron-full/email-Enron-full-nverts.txt',
+           '118tda4_E7ebtTNhKj12IJ9Y71rtJ7UP6:tar.gz:email-Enron-full/email-Enron-full-simplices.txt',
+           '118tda4_E7ebtTNhKj12IJ9Y71rtJ7UP6:tar.gz:email-Enron-full/email-Enron-full-times.txt',
+           '118tda4_E7ebtTNhKj12IJ9Y71rtJ7UP6:tar.gz:email-Enron-full/email-Enron-full-node-labels.txt'),
+          None, None)]
+
+# The times are Julia DateTime values: milliseconds since 0000-12-31T00:00.
+# This is the Unix epoch in that scale:
+JULIA_UNIX_EPOCH = 62135683200000
+
+def fetch_upstream(force=False):
+    return fetch_upstream_files(__name__.split(".")[-1], upstream_prefix, files,
+                                force)
+
+@cache_network()
+@coerce_props()
+@annotate()
+def parse(alts=None):
+    global files
+    name = __name__.split(".")[-1]
+    for fnames, alt, fmt in files:
+        if alts is not None and alt not in alts:
+            continue
+        with ExitStack() as stack:
+            fs = [stack.enter_context(open_upstream_file(name, fn, "r")) for fn in fnames]
+            groups, members = read_simplices(fs[0], fs[1])
+            times = read_ints(fs[2])
+            labels = {}
+            for line in fs[3]:
+                vid, addr = line.split()
+                labels[int(vid) - 1] = addr
+            # Only the addresses that occur in some email
+            used, members = numpy.unique(members, return_inverse=True)
+            g = bipartite_graph(groups, members, len(times), len(used),
+                                "is_email")
+            g.vp.name = g.new_vp("string")
+            for v, vid in enumerate(used):
+                g.vp.name[v] = labels[int(vid)]
+            g.vp.time = g.new_vp("int64_t")
+            g.vp.time.a[len(used):] = (times - JULIA_UNIX_EPOCH) // 1000
+        yield alt, g