Skip to main content

🌬️ Zeph

Tests Coverage PyPI

Zeph is a reinforcement learning based algorithm for selecting prefixes to probe based on previous measurements in order to maximize the number of nodes and links discovered. Zeph can be used on top of the Iris platform.

🚀 Quickstart

Zeph has a command line interface to configure and run the algorithm.

First, install the Zeph package:

pip install dioptra-zeph

Zeph takes as input a list of /24 (IPv4) or /64 (IPv6) prefixes:

# prefixes.txt
8.8.8.0/24
2001:4860:4860::/64

To start a measurement from scratch:

zeph prefixes.txt

To start from a previous measurement:

zeph prefixes.txt UUID

Zeph relies on iris-client and pych-client for communicating with Iris and ClickHouse. See their respective documentation to know how to specify the credentials.

✨ Generate prefix lists from BGP RIBs

You can create an exhaustive list of /24 prefixes from a BGP RIB dump:

pyasn_util_download.py --latest
# Connecting to ftp://archive.routeviews.org
# Finding most recent archive in /bgpdata/2022.05/RIBS ...
# Downloading ftp://archive.routeviews.org//bgpdata/2022.05/RIBS/rib.20220524.1000.bz2
#  100%, 659KB/s
# Download complete.
zeph-bgp-convert --print-progress rib.20220524.1000.bz2 prefixes.txt

📚 Publications

@article{10.1145/3523230.3523232,
    author = {Gouel, Matthieu and Vermeulen, Kevin and Mouchet, Maxime and Rohrer, Justin P. and Fourmaux, Olivier and Friedman, Timur},
    title = {Zeph & Iris Map the Internet: A Resilient Reinforcement Learning Approach to Distributed IP Route Tracing},
    year = {2022},
    issue_date = {January 2022},
    publisher = {Association for Computing Machinery},
    address = {New York, NY, USA},
    volume = {52},
    number = {1},
    issn = {0146-4833},
    url = {https://doi.org/10.1145/3523230.3523232},
    doi = {10.1145/3523230.3523232},
    journal = {SIGCOMM Comput. Commun. Rev.},
    month = {mar},
    pages = {2–9},
    numpages = {8},
    keywords = {active internet measurements, internet topology}
}

🧑‍💻 Authors

Iris is developed and maintained by the Dioptra group at Sorbonne Université in Paris, France.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dioptra_zeph-1.3.11.tar.gz (11.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dioptra_zeph-1.3.11-py3-none-any.whl (15.4 kB view details)

Uploaded Python 3

File details

Details for the file dioptra_zeph-1.3.11.tar.gz.

File metadata

  • Download URL: dioptra_zeph-1.3.11.tar.gz
  • Upload date:
  • Size: 11.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for dioptra_zeph-1.3.11.tar.gz
Algorithm Hash digest
SHA256 a182f0907e83ab638fb62d1a3bcd987f5e9706cbd136c62cc12af723cc82181a
MD5 bf95597e6f6bdeef2e84130e617e7648
BLAKE2b-256 10e8527368d0690e064b90818bf4eb1a03b3f841ab990e98d1fc108cb2c381b3

See more details on using hashes here.

File details

Details for the file dioptra_zeph-1.3.11-py3-none-any.whl.

File metadata

  • Download URL: dioptra_zeph-1.3.11-py3-none-any.whl
  • Upload date:
  • Size: 15.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for dioptra_zeph-1.3.11-py3-none-any.whl
Algorithm Hash digest
SHA256 4c349c462f1446b5207602e3af0918c802c0f42c20630c2c441ff58e5631174b
MD5 c9c8123bfa6d8cae3d19df5ac8c163ec
BLAKE2b-256 43df938afc8b0414eed1da9e4a5adb72465ad74ef0af2399db1fa4e7e569f7b1

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.3.11 This release

2 files

1.3.10

2 files

1.3.9

2 files

1.3.8

2 files

1.3.7

2 files

1.3.6

2 files

1.3.5

2 files

1.3.4

2 files

1.3.3

2 files

1.3.2

2 files

1.3.1

2 files

1.3.0

2 files

1.2.6

2 files

1.2.5

2 files

1.2.4

2 files

1.2.3

2 files

1.2.2

2 files

1.2.1

2 files

1.2.0

2 files

1.1.0

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page