hypergraph-drawing/README.md
2022-05-29 15:16:46 +02:00

44 lines
1.3 KiB
Markdown

# Hypergraph drawing using Graphviz and Asymptote
## Usage
Requires Python 3, [pydot](https://pypi.org/project/pydot/) (tested with 1.4.2), [Asymptote](https://asymptote.sourceforge.io/) (tested with 2.67) and LaTeX (tested with TeX Live 2021).
To render a hypergraph specified in `graph.dot`, execute the following:
```bash
cat graph.dot | dot -Tdot | python3 ./dot_hypergraph_to_asymptote.py /dev/stdin > graph.asy
asy -f png graph.asy
```
You may adjust the font size, width/height of the output and more by editing the values at the beginning of the script.
## Example
| Original graph | Asymptote rendering |
| -------------- | ------------------- |
| ![dot rendering](./graph_dot.png) | ![asymptote rendering](./graph.png) |
`graph.dot`:
```
digraph {
edge [dir="back"];
"Node 1" -> "Node 2" [label="Edge 1"]
"Node 1" -> "Node 3" [label="Edge 1"]
"Node 3" -> "Node 4" [label="Edge 2"]
"Node 3" -> "Node 5" [label="Edge 2"]
"Node 5" -> "Node 6" [label="Edge 3"]
"Node 4" -> "Node 6" [label="Edge 3"]
"Node 2" -> "Node 7" [label="Edge 4"]
"Node 6" -> "Node 7" [label="Edge 4"]
"Node 2" -> "Node 8" [label="Edge 5"]
"Node 7" -> "Node 8" [label="Edge 5"]
}
```
## Credits
The generated code is based on https://tex.stackexchange.com/a/108099/185782 by g.kov.
## License
[CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)