FreeTool
vorpy
by jackericson98 · version 2.0.0 · updated 3 days ago
No reviews yet
- Downloads
- 0
- Reviews
- 0
- Size
- 34.3 MB
- Code check
- Clean
- Licence
- MIT
- Released
- Nov 2026
Molecular partitioning tool for simulated atoms using Delaunay, Power and Voronoi cells
VorPy
Quantitative molecular geometry through three-dimensional spatial partitioning
Overview
VorPy is a Python framework for constructing and analyzing three-dimensional Voronoi partitions of molecular and other spherical systems.
VorPy represents atoms or other objects as spheres and partitions space using three complementary geometric schemes:
VorPy provides both a graphical user interface (GUI) for interactive analysis and a command-line interface (CLI) for reproducible, automated, and large-scale workflows.
Conda
Development checkout
To run the current code from a clone, including the new Analysis Studio GUI,
install the checkout in editable mode with its GUI dependencies:
Alpha-complex workflows that use GUDHI are optional:
The core physical geometry path does not require GUDHI. The published GUI
extra installs PySide6, PyVista, and PyVistaQt; the Conda package currently
follows the core/headless dependency contract.
This keeps the installed
contains double-clickable application launchers:
automatically when needed. The first run displays installation progress and may
take several minutes. Later launches skip setup, detach from the terminal, and
show a VorPy splash while the 3D stack loads. A lightweight installer window
shows the VorPy logo and package installation log during first-time setup.
Intel Macs automatically use the final Numba release that provides native
Intel macOS wheels, avoiding a local LLVM/CMake build.
On GNOME-based Linux desktops, a newly cloned
trusted once before it can be opened by double-clicking:
Your file manager may also offer this as Allow Launching in the launcher's
right-click menu. If launching
disabled, run
application menu.
VorPy currently targets Python 3.10+. Explicit multi-version support will be listed here once the test suite and end-to-end regression suite have been validated across supported interpreters and platforms.
Quick Start
Launch the graphical interface:
Open the file browser:
Analyze a structure directly:
VorPy currently supports
Spatial Partitioning Schemes**Additively weighted Voronoi (
Accounts directly for sphere radii through distance to sphere surfaces, making it well suited to radius-aware molecular geometry.
**Power / Laguerre (
Incorporates sphere size through power distance while retaining planar cell boundaries.
**Primitive (
Depends only on generator positions. Sphere radii do not affect boundary placement, making it useful as an unweighted geometric reference.
VorPy supports direct comparison between these schemes so the effects of the chosen spatial model can be evaluated explicitly.
Molecular Geometry
Depending on the requested analysis and exports, VorPy can provide information about:
Interface analysis is one of VorPy's central molecular-analysis capabilities.
Groups of atoms can be defined independently and their shared Voronoi boundaries analyzed as explicit geometric interfaces. This supports protein-protein, protein-DNA, protein-RNA, protein-ligand, solute-solvent, chain-chain, residue-residue, and arbitrary user-defined interfaces.
Because interfaces are derived from shared Voronoi boundaries, VorPy can describe not only which atoms are neighbors, but also the geometry and area of the boundary shared between them.
See [
Groups and Selections
VorPy analyses can operate on the full structure or on selected subsets.
Selections can be based on:
The exact CLI syntax for identity-based selectors is being expanded and will be documented in the full
…
Quantitative molecular geometry through three-dimensional spatial partitioning
Overview
VorPy is a Python framework for constructing and analyzing three-dimensional Voronoi partitions of molecular and other spherical systems.
VorPy represents atoms or other objects as spheres and partitions space using three complementary geometric schemes:
- Additively weighted (AW) Voronoi diagrams
- Power (Laguerre) diagrams
- Primitive (unweighted) Voronoi diagrams
VorPy provides both a graphical user interface (GUI) for interactive analysis and a command-line interface (CLI) for reproducible, automated, and large-scale workflows.
Molecular structure is fundamentally geometric. Changes in packing, exposure, local contacts, and intermolecular interfaces alter how atoms occupy and share space. VorPy provides a common spatial framework for quantifying these relationships.InstallationPyPI
pip install vorpy3Conda
conda install vorpy3Development checkout
To run the current code from a clone, including the new Analysis Studio GUI,
install the checkout in editable mode with its GUI dependencies:
git clone https://github.com/jackericson98/vorpy.git
cd vorpy
python -m pip install -e ".[gui]"Alpha-complex workflows that use GUDHI are optional:
python -m pip install "vorpy3[gudhi]"The core physical geometry path does not require GUDHI. The published GUI
extra installs PySide6, PyVista, and PyVistaQt; the Conda package currently
follows the core/headless dependency contract.
This keeps the installed
vorpy command connected to the checkout, so futuregit pull updates take effect without reinstalling. The repository root alsocontains double-clickable application launchers:
- Linux:
vorpy-linux.desktop(or run./vorpy-linux) - macOS:
vorpy-mac.command - Windows:
vorpy-windows.bat
.venv and installs the GUI dependenciesautomatically when needed. The first run displays installation progress and may
take several minutes. Later launches skip setup, detach from the terminal, and
show a VorPy splash while the 3D stack loads. A lightweight installer window
shows the VorPy logo and package installation log during first-time setup.
Intel Macs automatically use the final Numba release that provides native
Intel macOS wheels, avoiding a local LLVM/CMake build.
On GNOME-based Linux desktops, a newly cloned
.desktop file may need to betrusted once before it can be opened by double-clicking:
chmod +x vorpy-linux.desktop vorpy-linux
gio set -t string vorpy-linux.desktop metadata::trusted trueYour file manager may also offer this as Allow Launching in the launcher's
right-click menu. If launching
.desktop files directly from a folder isdisabled, run
./vorpy-linux or install the desktop entry into the system'sapplication menu.
VorPy currently targets Python 3.10+. Explicit multi-version support will be listed here once the test suite and end-to-end regression suite have been validated across supported interpreters and platforms.
Quick Start
Launch the graphical interface:
vorpyOpen the file browser:
vorpy browseAnalyze a structure directly:
vorpy path/to/structure.pdbVorPy currently supports
.pdb, .cif, .mol, .mol2, and .gro files.Spatial Partitioning Schemes**Additively weighted Voronoi (
aw)**Accounts directly for sphere radii through distance to sphere surfaces, making it well suited to radius-aware molecular geometry.
**Power / Laguerre (
pow)**Incorporates sphere size through power distance while retaining planar cell boundaries.
**Primitive (
prm)**Depends only on generator positions. Sphere radii do not affect boundary placement, making it useful as an unweighted geometric reference.
VorPy supports direct comparison between these schemes so the effects of the chosen spatial model can be evaluated explicitly.
Molecular Geometry
Depending on the requested analysis and exports, VorPy can provide information about:
- Voronoi cell volume
- molecular and cell surface area
- neighboring atoms and cells
- contact topology
- interfacial surface area
- solvent-facing exposure
- cell shape descriptors
- local and integrated curvature
- triangulated surfaces
- edges and vertices
- atom, residue, chain, group, and system summaries
Interface analysis is one of VorPy's central molecular-analysis capabilities.
Groups of atoms can be defined independently and their shared Voronoi boundaries analyzed as explicit geometric interfaces. This supports protein-protein, protein-DNA, protein-RNA, protein-ligand, solute-solvent, chain-chain, residue-residue, and arbitrary user-defined interfaces.
Because interfaces are derived from shared Voronoi boundaries, VorPy can describe not only which atoms are neighbors, but also the geometry and area of the boundary shared between them.
See [
docs/molecular_analysis/interfaces.md](https://github.com/jackericson98/vorpy/blob/master/docs/molecular_analysis/interfaces.md).Groups and Selections
VorPy analyses can operate on the full structure or on selected subsets.
Selections can be based on:
- atom indices
- residue indices
- chain indices
- molecule indices
- molecular classes such as protein, ligand, DNA, and RNA
- structural identities such as a specific chain or residue
protein
dna
chain A
THY 124The exact CLI syntax for identity-based selectors is being expanded and will be documented in the full
…