Skip to main content

DTree Explorer

Encode a directed tree with DTree's two projections Q1 and Q2 and watch it happen, edge by edge. The Explorer draws the tree, places every node in the plane at its rank in Q1 and Q2, lists both projections with the positions the library stores, and answers reachability questions by clicking: u reaches v exactly when u comes before v in both lists.

Every tree is computed by the published library, dtree-encoding; the Explorer only shows what it computes.

Three ways to use it

Online: dtree.digraphs.net, nothing to install.

As a Python program, offline, with the library installed on your machine:

pip install dtree-explorer
dtree-explorer

The command starts a small server on 127.0.0.1 and opens the page in your browser; stop it with Ctrl+C. Options: --port 8765, --no-browser, --save explorer.html (write the page as one file).

As a single file: download DTree-Explorer.html from the latest release and open it in a browser. It loads Python (Pyodide) from cdn.jsdelivr.net and dtree-encoding from pypi.org, so it needs an internet connection.

Input

One line per instruction; lines starting with # are comments.

Line Meaning
p: c1; c2 c1 and c2 become the last children of p
s > c1; c2 c1 goes directly after its sibling s, then c2 after c1
s < c1; c2 c1 and c2 go directly before s, in that order

The examples include the trees of the paper: the introductory example, Figure 1, the generalized insertion of Section 4.1 (Case A, before; Case B, after) and Appendix A, whose three variants appear twice: once by the order of the input lines, once with < and >. Both give the same projections.

Privacy

Your tree stays on your computer. Only the online copy at dtree.digraphs.net counts visits, with GoatCounter: no cookies, no personal data. The package and the release file count nothing.

Building

Working in this repository needs the library installed: pip install dtree-encoding. src/template.html is the page, dtree_explorer/bridge.py the Python part it runs, src/build.py assembles dtree_explorer/explorer.html (package and release) and site/index.html (dtree.digraphs.net) with the installed dtree-encoding. Tests: python -m unittest discover -s tests.

Background

E. Olgac, "Topology and Structure of Directed Trees: An Incremental Encoding," IntechOpen, 2025. doi: 10.5772/intechopen.1013408.

License

MIT. Design and concept: Enis Olgac. The Explorer was written with Claude (Anthropic).

Metadata

Release files for dtree-explorer 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dtree-explorer 1.0.2
File Size Uploaded Provenance Actions
dtree_explorer-1.0.2.tar.gz 35.4 kB With provenance Details for dtree_explorer-1.0.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for dtree-explorer 1.0.2
File Interpreter ABI Platform Actions
dtree_explorer-1.0.2-py3-none-any.whl Python 3 none any Details for dtree_explorer-1.0.2-py3-none-any.whl

Total release size: 69.1 kB

Release files / dtree_explorer-1.0.2.tar.gz

Download URL dtree_explorer-1.0.2.tar.gz
Size 35.4 kB
Tags Source
SHA-256 checksum
How to use checksums
8638c786fc2c621d26ef85ef5e120f815d56c13190293b52d293d40e8d402b7e
BLAKE2b-256 checksum
How to use checksums
f95a6d22370802f40bc59765d336142fc41f7a346e9f3c426bb698329081a46c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

Release files / dtree_explorer-1.0.2-py3-none-any.whl

Download URL dtree_explorer-1.0.2-py3-none-any.whl
Size 33.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b34bc72a981449973cb391169280047be1b046a5f9c521985dcd2bc29e9ad8ce
BLAKE2b-256 checksum
How to use checksums
4dcefffddfe5a10ec94e1960cc302fff3b7f72b7a366d38d723893f66f96dc18
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

Security for dtree-explorer 1.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for dtree_explorer-1.0.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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