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, triordinal-dtree from Triordinal (formerly 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 triordinal-dtree 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 triordinal-dtree. 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 triordinal-dtree. 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.
Citation
E. Olgac, DTree Explorer: Watching the Incremental Encoding of Directed Trees, software, 2026. doi: 10.5281/zenodo.23701538 (all versions). See CITATION.cff.
License
MIT. Design and concept: Enis Olgac. The Explorer was written with Claude (Anthropic).
1 maintainer
Metadata
1 maintainer
Release files for dtree-explorer 1.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| dtree_explorer-1.2.1.tar.gz | 39.5 kB | With provenance | Details for dtree_explorer-1.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| dtree_explorer-1.2.1-py3-none-any.whl | Python 3 | none | any | Details for dtree_explorer-1.2.1-py3-none-any.whl |
Total release size: 77.1 kB
Release files / dtree_explorer-1.2.1.tar.gz
| Download URL | dtree_explorer-1.2.1.tar.gz |
|---|---|
| Size | 39.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
99ba6d55ae9fada237d9a42c03e8ef3a8f0043a3565812c2025d2bb4042e041b
|
|
BLAKE2b-256 checksum How to use checksums |
f5711e51bf053766792ab9927b5c1eb947aa6020fa6b99db7dccf4af4ef86157
|
| 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 29, 2026.
Transparency logRelease files / dtree_explorer-1.2.1-py3-none-any.whl
| Download URL | dtree_explorer-1.2.1-py3-none-any.whl |
|---|---|
| Size | 37.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fd06c1f8ad6d209ebef43dfc25077a95d5b02883e7995fb4114f9beee71a2d8b
|
|
BLAKE2b-256 checksum How to use checksums |
45e9c9a360a7df222f0670efa41f3dc24022e7763510415e1261f40f8b341b50
|
| 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 29, 2026.
Transparency logSecurity for dtree-explorer 1.2.1
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.
Attestation for dtree_explorer-1.2.1.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 29, 2026.
Transparency logA 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.
