graph_ics
A visual art project and Python library for growing sprawling graph compositions. Shape networks with text, polygon boundaries, density maps, angle constraints and cooperating or competing colonies. Export PNG, SVG and recorded growth animations.
Website and gallery · User guide · Source and runnable examples
Installation
Requires Python 3.11–3.15. Install graph-graphics for geometry and graph generation, or graph-graphics[render] for images, text measurement and GIF export:
python -m pip install "graph-graphics[render]"
graph-ics render --example sprawl --palette porcelain --output graph.png
graph-ics list
Pycairo may need system Cairo development libraries when a compatible wheel is unavailable. Python 3.15 users may need PYYAML_FORCE_LIBYAML=0 during installation to use PyYAML without its optional C extension. See the installation guide.
from graph_ics import GraphStyle, build_example, export_graph
graph = build_example('density', palette='porcelain', seed=7)
graph.build()
export_graph(graph, 'density.svg', frame='region', background=GraphStyle.named('porcelain').background)
Run graph-ics gallery --quick --output my-gallery to generate local visual examples. The complete documentation website and extensive pre-generated artwork are maintained in the source repository rather than bundled in the wheel.
Scope and limits
This is an early library. Generation uses finite budgets and cannot guarantee complete packing. Narrow contours and small islands may remain incomplete; boundary following and terminal anchoring are experimental. Font availability affects glyph geometry. Population maps are artistic logarithmic mappings, not one node per person.
Licensing
Code: PolyForm Noncommercial 1.0.0. Project-owned artwork and documentation: CC BY-NC 4.0. Third-party data retains its own terms. Commercial use requires separate permission from Johannes Pippidis Lorentzen. Read the licensing scope.
Started in 2022 to create graphics for a presentation about money laundering and anti-money laundering, graph_ics developed through several iterations into this generative art library.
1 maintainer
Metadata
1 maintainer
Release files for graph-graphics 0.0.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 | |
|---|---|---|---|---|
| graph_graphics-0.0.1.tar.gz | 556.5 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| graph_graphics-0.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / graph_graphics-0.0.1.tar.gz
| Download URL | graph_graphics-0.0.1.tar.gz |
|---|---|
| Size | 556.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ee992b1fb06f305996ab5fab2782520cde02d62971ce785971ea789ea6e50db1
|
|
BLAKE2b-256 checksum How to use checksums |
29022d462516f1ac4d666e2545e77929b0c7022d8787999ca1a9b295481dbcf2
|
| 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 24, 2026.
Transparency logRelease files / graph_graphics-0.0.1-py3-none-any.whl
| Download URL | graph_graphics-0.0.1-py3-none-any.whl |
|---|---|
| Size | 564.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a82b8b58c80c45a86a3492c98d80142d00f662629a7ea2e9a41ac51ddad35221
|
|
BLAKE2b-256 checksum How to use checksums |
8d3074c8f941c0f2bbadabee1e02872ee893ee0b8bf3978195a90c84fb481a5c
|
| 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 24, 2026.
Transparency logSecurity for graph-graphics 0.0.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 graph_graphics-0.0.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 24, 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.
