{"id":28033,"library":"passagemath-plantri","title":"passagemath-plantri","description":"A Python interface to plantri and fullgen for generating planar triangulations, cubic planar graphs, and other planar graph families. Part of the passagemath ecosystem. Current version 10.8.4, requires Python 3.11-3.14. Releases follow passagemath release cycle.","status":"active","version":"10.8.4","language":"python","source_language":"en","source_url":"https://github.com/passagemath/passagemath-plantri","tags":["plantri","fullgen","planar graphs","graph generation","passagemath"],"install":[{"cmd":"pip install passagemath-plantri","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Base library providing graph objects and caching infrastructure","package":"passagemath-core","optional":false},{"reason":"Third-party binary (plantri/fullgen) must be available in PATH or configured","package":"plantri","optional":true}],"imports":[{"note":"The library is a submodule of passagemath, not a standalone package","wrong":"import plantri","symbol":"planar_triangulations","correct":"from passagemath.plantri import planar_triangulations"},{"note":"","wrong":null,"symbol":"PlantriOptions","correct":"from passagemath.plantri import PlantriOptions"}],"quickstart":{"code":"from passagemath.plantri import planar_triangulations\nfor g in planar_triangulations(6):\n    print(g.graph6_string())\n","lang":"python","description":"Generate all planar triangulations on 6 vertices (2 connected, 3-connected) and print each as graph6 string."},"warnings":[{"fix":"Install plantri binary (e.g., 'sudo apt install plantri' on Debian/Ubuntu, or download from https://users.cecs.anu.edu.au/~bdm/plantri/)","message":"The `plantri` and `fullgen` binaries must be installed separately (e.g., via system package manager or by downloading from plantri website) and placed in PATH. Wrapper does NOT bundle them.","severity":"gotcha","affected_versions":"all"},{"fix":"Use PlantriOptions(n=6, ...) and pass to functions","message":"Passing integer arguments directly to plantri functions (e.g., planar_triangulations(6)) is deprecated. Use PlantriOptions class instead.","severity":"deprecated","affected_versions":">=10.8"},{"fix":"Update imports: from passagemath.plantri import ...","message":"Before passagemath 10.0, the library was named 'plantri' on PyPI and imported as 'import plantri'. Now it's 'passagemath-plantri' and imported from passagemath.plantri.","severity":"breaking","affected_versions":">=10.0"},{"fix":"Use methods like g.graph6_string() or g.to_networkx() if passagemath-networkx installed","message":"Generated graphs are passagemath Graph objects, not networkx or igraph. Use .graph6_string() or adjacency_matrix() to convert.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Install plantri system-wide (e.g., 'apt install plantri' or download from official site and add to PATH). Verify by typing 'plantri' in terminal.","cause":"The plantri/fullgen executable is not installed or not in PATH.","error":"RuntimeError: plantri binary not found"},{"fix":"Run 'pip install passagemath-plantri' and import as 'from passagemath.plantri import ...'.","cause":"Missing passagemath-plantri installation or wrong import statement.","error":"ImportError: No module named 'passagemath.plantri'"},{"fix":"Check documentation for minimum n; for planar_triangulations start at n>=4.","cause":"Minimum vertex count constraints vary by graph family (e.g., planar triangulations require n>=4).","error":"ValueError: n must be at least ..."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}