zsasa Python Bindings

Python bindings for zsasa — a high-performance SASA calculator in Zig.

Full Documentation

Installation

pip install zsasa
# or
uv add zsasa

Optional Dependencies

pip install zsasa[gemmi]      # Gemmi integration
pip install zsasa[biopython]  # BioPython integration
pip install zsasa[biotite]    # Biotite integration
pip install zsasa[all]        # All integrations

Quick Start

import numpy as np
from zsasa import calculate_sasa

coords = np.array([[0.0, 0.0, 0.0], [3.0, 0.0, 0.0]])
radii = np.array([1.5, 1.5])
result = calculate_sasa(coords, radii)
print(f"Total SASA: {result.total_area:.2f} Ų")

# With structure file (gemmi)
from zsasa.integrations.gemmi import calculate_sasa_from_structure
result = calculate_sasa_from_structure("protein.cif")
print(f"Total: {result.total_area:.1f} Ų")

Features

  • Two algorithms: Shrake-Rupley and Lee-Richards, with bitmask LUT optimization
  • Selectable precision: f64 (default) or f32
  • Multi-threading: Automatic parallelization
  • Atom classification: NACCESS, ProtOr, OONS classifiers
  • Analysis: Per-residue aggregation, RSA, polar/nonpolar classification
  • Batch processing: process_directory() for proteome-scale datasets
  • MD trajectory: MDTraj and MDAnalysis integrations; use pyztraj for direct trajectory-file I/O
  • Integrations: Gemmi, BioPython, Biotite

See the full API reference for details.

Development

cd python
uv run --with pytest pytest tests/ -v    # Tests
ruff format . && ruff check --fix .      # Lint

License

MIT

Project links

Data verified by PyPI on Jun 30, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.9.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for N283T from gravatar.com N283T

Credits

Author: Tsubasa Nagae

GitHub Statistics

Data verified by PyPI on Jun 30, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

all biopython biotite dev gemmi mdanalysis mdtraj

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zsasa-0.7.1.tar.gz (280.9 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

zsasa-0.7.1-cp313-cp313-win_amd64.whl (1.4 MB view details)

Uploaded CPython 3.13Windows x86-64

zsasa-0.7.1-cp313-cp313-manylinux_2_28_x86_64.whl (4.7 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ x86-64

zsasa-0.7.1-cp313-cp313-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ ARM64

zsasa-0.7.1-cp313-cp313-macosx_11_0_x86_64.whl (1.2 MB view details)

Uploaded CPython 3.13macOS 11.0+ x86-64

zsasa-0.7.1-cp313-cp313-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

zsasa-0.7.1-cp312-cp312-win_amd64.whl (1.4 MB view details)

Uploaded CPython 3.12Windows x86-64

zsasa-0.7.1-cp312-cp312-manylinux_2_28_x86_64.whl (4.7 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ x86-64

zsasa-0.7.1-cp312-cp312-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ ARM64

zsasa-0.7.1-cp312-cp312-macosx_11_0_x86_64.whl (1.2 MB view details)

Uploaded CPython 3.12macOS 11.0+ x86-64

zsasa-0.7.1-cp312-cp312-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

zsasa-0.7.1-cp311-cp311-win_amd64.whl (1.4 MB view details)

Uploaded CPython 3.11Windows x86-64

zsasa-0.7.1-cp311-cp311-manylinux_2_28_x86_64.whl (4.7 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ x86-64

zsasa-0.7.1-cp311-cp311-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ ARM64

zsasa-0.7.1-cp311-cp311-macosx_11_0_x86_64.whl (1.2 MB view details)

Uploaded CPython 3.11macOS 11.0+ x86-64

zsasa-0.7.1-cp311-cp311-macosx_11_0_arm64.whl (1.1 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

File details

Details for the file zsasa-0.7.1.tar.gz.

File metadata

  • Download URL: zsasa-0.7.1.tar.gz
  • Upload date:
  • Size: 280.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for zsasa-0.7.1.tar.gz
Algorithm Hash digest
SHA256 1c909fc30b51932d874b032357fe32225ec28f70e33e11be4e09b021ff108ed9
MD5 6a85afcb1bb0eb70bd60f484f5617bf9
BLAKE2b-256 4d0ea71aec568b4f90703b3fa37e84986f4b8e57e6a6b5d57f784f98fb6bf9c6

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1.tar.gz:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: zsasa-0.7.1-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for zsasa-0.7.1-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 3bd378033b07d22d2b6d3d4eaf2aebc3b469be07df40dbb41f6fe7a6fa3ec44d
MD5 a7d353070e533addbb7fdbf976f8e5a1
BLAKE2b-256 4801ad0ba01fbdc8e737cd0b014a7adae24a51a5e2ba62aa9498263182511840

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp313-cp313-win_amd64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp313-cp313-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp313-cp313-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a1e90fd4717491f0ced08515e9cac46a4315cef94deee7b0318339115d6d1ba6
MD5 e9614215ebb577f01f3ac306adde31b9
BLAKE2b-256 c872621999bfb4187ee1724bf7406f2ec3f68deb8b11daa08ad45a66270421c3

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp313-cp313-manylinux_2_28_x86_64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp313-cp313-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp313-cp313-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 94b993955e497742c18e5908ea1e74cc85bb84270788e6b7238f907a5c7f96ac
MD5 22197d8e3b95b5cd23ab8a8e008bc921
BLAKE2b-256 87aae8570abc0940d8f62900947627f41f02342d94a88679fde25e034a14d5f3

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp313-cp313-manylinux_2_28_aarch64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp313-cp313-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp313-cp313-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 b6d3c5e4237f509e24d8f059f9e6a8291dbe3563efe73f815b77472f8a8eb2db
MD5 9a6520eec8a620899a3f4e8f721c34ac
BLAKE2b-256 f0a4355e4c6c2525aeb3754222fc8fd6bb8557d9063535d767a9c8623cc8b982

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp313-cp313-macosx_11_0_x86_64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 d7eeeaa0662553ae2c9164e5495db0f1a0e3455cc17783f9ab372033ae936b50
MD5 83feab9c034322df64a27eac8cd4acb4
BLAKE2b-256 cb76363b14f6dd4dfa82414e86a03d3f20981d9838bb4f618f157ca318654719

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: zsasa-0.7.1-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for zsasa-0.7.1-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 c327affd1823dd4eb06ef44716a655e9cc85d4af4e3c9cfe433303d922f9028c
MD5 156b739f44644ebf7e11390021313a06
BLAKE2b-256 866f19c602de44fb414157dd622eba420174b107650868daaf53fe4c263c821d

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp312-cp312-win_amd64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp312-cp312-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp312-cp312-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 d440fe7543e0f2ecc1f340859224dd6bf4aa488cfa5ddda015caf0894bbea38a
MD5 5f40c53aa470d9dbe18adcd51e971369
BLAKE2b-256 d6713baf0dad27ec8ac3adea1a1b8f827c53f19463a70b50185bd1e62224a90f

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp312-cp312-manylinux_2_28_x86_64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp312-cp312-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp312-cp312-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 a9ab3918cd02bdeb4df23524ec70ab17c4fa8f610492e572049266e552a59839
MD5 3685f1b0a6072d94dcf0720f475dbb78
BLAKE2b-256 2efe9ddc76815b69f69fff60c188ebf25d94a6a91d27586f7e7520a7ef660dea

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp312-cp312-manylinux_2_28_aarch64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp312-cp312-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp312-cp312-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 10bff1728f2036e500db89a39c5fc50f80e3b37e0a36fddfe513b4aab26ffe08
MD5 02b1802425acc97b62891e5e625eed58
BLAKE2b-256 bce04b5b621a6d9c6c37d2724fb8ee35c1be3d63f4be27fdde2b8d173bf7e694

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp312-cp312-macosx_11_0_x86_64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c2a450c7981db35d3d16f5a76454678c66ef866b9923b6cc4f64ca824bda1abb
MD5 2357bb0546c563f5321e1e257e2a3674
BLAKE2b-256 a9a596b7f1b37084af538ea4f9a33554e499fb221564f129dfaa342dd1208a3f

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: zsasa-0.7.1-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for zsasa-0.7.1-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 20b0f7bea434f3ca18f8d775d8f906f500461dccb04295931b3bf201d9b5eea9
MD5 3753cfbec16b3d6092cdf3081cb69d24
BLAKE2b-256 05c93da2b62551a1ee88f26b6060e53cfec6a11e857cd1329330bbb025d72ed6

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp311-cp311-win_amd64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp311-cp311-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp311-cp311-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 cf2fdaf5a5ece1cbc8b052899b6ce5d887376f5f12db654ab99a3b15cd53c808
MD5 6c74c05d22cd44cc8a2ba239d897137e
BLAKE2b-256 c51d0484d98163ef6eadcedd37c19a2fea7bf7455ebc51b289fcc7c7814398a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp311-cp311-manylinux_2_28_x86_64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp311-cp311-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp311-cp311-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 55d9b14690e855cfc001f15135e54d48c6854ce23373484d2d4336f6e4d6a62c
MD5 c8aa2871426f30fc41fbf231fdeb1a68
BLAKE2b-256 9a29db57ae510d4244c78ad2478be82018a527dba8005ec267979b2b0cd5f7b9

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp311-cp311-manylinux_2_28_aarch64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp311-cp311-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp311-cp311-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 af5ef6f78609a984c6e7c086a162224fa4897de478089bd8a9b3aa8009055e59
MD5 3a8bd9d21da444bc28194dadee2ea7e6
BLAKE2b-256 59d0a5c26b5bbcecf401fccd38b210d1642ea5a32e6972fbd0f8abcd2e4ed5a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp311-cp311-macosx_11_0_x86_64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zsasa-0.7.1-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.1-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 da7ed83c144aa606737b2845962e627c48f219344e1558635d024dcbf9291157
MD5 9cf25602bea0e5390225694fa40e5deb
BLAKE2b-256 e2a7e280e946e00f14915d424a335300354c7b5ca6cd72dae38400b43887d58d

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.1-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: publish.yml on N283T/zsasa

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.9.1

16 files

0.9.0

16 files

0.8.0

16 files

This release

0.7.1 This release

16 files

0.7.0

16 files

0.6.0

16 files

0.5.0

16 files

0.4.0

16 files

0.3.2

16 files

0.3.1

16 files

0.3.0

16 files

0.2.11

16 files

0.2.8

16 files

0.2.7

16 files

0.2.6

16 files

0.2.5

16 files

0.2.4

16 files

0.2.3

16 files

0.2.1

16 files

0.2.0

16 files

0.1.3

16 files

0.1.2

16 files

0.1.1

16 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page