d o t m o t i f
Find graph motifs using intuitive notation
DotMotif is a library that identifies subgraphs or motifs in a large graph. It looks like this:
# Look for all motifs of the form,
# Neuron A synapses on Neuron B:
A -> B
# ...and B inhibits C:
B -> C [type = "inhibitory"]
Examples
| Notebook | Description |
|---|---|
| Looking for motifs in the IARPA MICrONS Pinky100 Dataset | |
| Motif search in a custom graph | |
| Subgraph search in the Janelia Hemibrain dataset |
Get Started
If you have DotMotif, a NetworkX graph, and a curious mind, you already have everything you need to start using DotMotif:
from dotmotif import Motif, GrandIsoExecutor
executor = GrandIsoExecutor(graph=my_networkx_graph)
triangle = Motif("""
A -> B
B -> C
C -> A
""")
results = executor.find(triangle)
Parameters
You can also pass optional parameters into the constructor for the dotmotif object. Those arguments are:
| Argument | Type, Default | Behavior |
|---|---|---|
ignore_direction |
bool: False |
Whether to disregard direction when generating the database query |
limit |
int: None |
A limit (if any) to impose on the query results |
enforce_inequality |
bool: False |
Whether to enforce inequality; in other words, whether two nodes should be permitted to be aliases for the same node. For example, in A->B->C; if A!=C, then set to True |
exclude_automorphisms |
bool: False |
Whether to return only a single example for each detected automorphism. See more in the documentation |
For more details on how to write a query, see Getting Started.
Citing
If this tool is helpful to your research, please consider citing it with:
# https://doi.org/10.1038/s41598-021-91025-5
@article{Matelsky_Motifs_2021,
title={{DotMotif: an open-source tool for connectome subgraph isomorphism search and graph queries}},
volume={11},
ISSN={2045-2322},
url={http://dx.doi.org/10.1038/s41598-021-91025-5},
DOI={10.1038/s41598-021-91025-5},
number={1},
journal={Scientific Reports},
publisher={Springer Science and Business Media LLC},
author={Matelsky, Jordan K. and Reilly, Elizabeth P. and Johnson, Erik C. and Stiso, Jennifer and Bassett, Danielle S. and Wester, Brock A. and Gray-Roncal, William},
year={2021},
month={Jun}
}
Metadata
Release files for dotmotif 0.18.0
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 |
|---|---|---|---|---|
| dotmotif-0.18.0.tar.gz | 104.4 kB | Without provenance | Details for dotmotif-0.18.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| dotmotif-0.18.0-py3-none-any.whl | Python 3 | none | any | Details for dotmotif-0.18.0-py3-none-any.whl |
Total release size: 139.8 kB
Release files / dotmotif-0.18.0.tar.gz
| Download URL | dotmotif-0.18.0.tar.gz |
|---|---|
| Size | 104.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7b56645a532163898e6aa5615e29fc39ee0185acf8a96a71acee7f05a43d3606
|
|
BLAKE2b-256 checksum How to use checksums |
d5d414ae4870e35f464823dd263247acd220e74433cd6149c7f6852bb258f96c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / dotmotif-0.18.0-py3-none-any.whl
| Download URL | dotmotif-0.18.0-py3-none-any.whl |
|---|---|
| Size | 35.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
121d12b275aeafb046e36847b3a030117f77058d78fc7599ca8d53e0e00374cf
|
|
BLAKE2b-256 checksum How to use checksums |
c7e9e6654a693039c9d20abf6ac07249765e80f07d8a66f1ad3029a5e6be2fbd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for dotmotif 0.18.0
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
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.