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}
}
1 maintainer
Metadata
1 maintainer
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 | |
|---|---|---|---|
| dotmotif-0.18.0.tar.gz | 104.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dotmotif-0.18.0-py3-none-any.whl | Python 3 | none | any | Details |
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}
|
