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 28, 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 28, 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.0.tar.gz (280.3 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.0-cp313-cp313-win_amd64.whl (1.4 MB view details)

Uploaded CPython 3.13Windows x86-64

zsasa-0.7.0-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.0-cp313-cp313-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.13macOS 11.0+ x86-64

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

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

zsasa-0.7.0-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.0-cp312-cp312-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.12macOS 11.0+ x86-64

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

Uploaded CPython 3.12macOS 11.0+ ARM64

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

Uploaded CPython 3.11Windows x86-64

zsasa-0.7.0-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.0-cp311-cp311-manylinux_2_28_aarch64.whl (4.6 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.11macOS 11.0+ x86-64

zsasa-0.7.0-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.0.tar.gz.

File metadata

  • Download URL: zsasa-0.7.0.tar.gz
  • Upload date:
  • Size: 280.3 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.0.tar.gz
Algorithm Hash digest
SHA256 c705916868769cde9e364ee7c5f8c5a15515957f676f1e2e10459b667129b1d1
MD5 c2be568d40f034b2672236fcff563c0c
BLAKE2b-256 0731cd1f16114746c4cf13b1f2eb0088009b0c2ecd4b7bb31055478330b4b823

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0.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.0-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: zsasa-0.7.0-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.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 e1969f60faa55c42c18d83844dc12e7aaefe57f078f5e9e0b5ea13ba3c292272
MD5 c2ed6065a32764ffbff59ec0323365bb
BLAKE2b-256 c82c8138036f3d90d226a6657f067af9c9345b521135a2ed10695d73b7890c8b

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp313-cp313-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp313-cp313-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 4916eb4d9a8bb45b30c241da7290641de94e020df80cf108da01a256767638f7
MD5 436cb6954ca1e94b27259e93c7c8173e
BLAKE2b-256 607a2a213b7f4d945623362ed8558cf7e038ddae74f9036f548edc652f6d07be

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp313-cp313-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp313-cp313-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 4c17d535445cc05df232e179fe531ec190b3f5a1c8ce0b0a9c8342ac37628dfd
MD5 e0f72affc621e351123bd58175ce9be1
BLAKE2b-256 7c1f57bb96161b36ed65cbcd5f5f51a4a39d06741c1f496755f0c0d198a698a4

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp313-cp313-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp313-cp313-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 9b1306f399a46cab8b40fa51b61bfe825557ef922ccd89547385628b0fb4b6d1
MD5 bb8f9045161e0d045771662bb0594088
BLAKE2b-256 b0357c1c49ac386fe307d0c9b58d7542dab41c7ede3a21c7954a39f9c9ecb294

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 d38f9e1d728d5a79d0f5674d18d2bf517e4ff5eaf71e7e68006d443e4b0f31b7
MD5 c56d4ddfc691bfb8b8f5aa49ac9064cc
BLAKE2b-256 8ba95c4428510298390cc4a20860e1b0c5c8bee550f0a8f170ec907e0d09bd2f

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: zsasa-0.7.0-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.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 ae9ca44bf7db2c2e223a30ed76e4373ba9508b9fee892de34279f870acbb3fc2
MD5 b67983014bba0bc493bec81190c27234
BLAKE2b-256 b80b64ae994d41e903b1e5dfd8e1431d6edbe172ec27b71cc41367e4202922b5

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp312-cp312-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp312-cp312-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 142b33996e8df092322af4998b8b6f2f730ed7dafa49e13559144a2cf9a21f7e
MD5 78bda27629fefce123f513711f1d3aef
BLAKE2b-256 9ab98389ff94e0903df1da65c5567b8c72e655240a8c4df8a4c4cfa4e422d2ed

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp312-cp312-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp312-cp312-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 6b99dc95f0e618d4d44a380a9cbef439de0b9e53e01f388cfb058c7ea894d75a
MD5 a691f1b36da5b6028a747f84b5ecc43d
BLAKE2b-256 14859db1c93e9957d6aacaf657a06b3082e374ac1c80ada47525d3fc78ef95c5

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp312-cp312-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp312-cp312-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 c3e027b1b7d9f37c27713980bf8d00e6fa030c728149470537d2e02bf0dffcac
MD5 632fbd31745d81ab0cfe0efb5cdb47d9
BLAKE2b-256 15fe3bd96b648cf1c703251066f81b6617bdbcd4a0f3c55e7b043e4c5b218cc4

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 248b111444d4dfa4c6ae48d39a3adcec2916e8fe174563f213a751d1b099ada1
MD5 7a4275917d19017cb9592256aa1760e3
BLAKE2b-256 5de7cf50e47bbbd29b5a256dc6bc60e53e7f57f8d94758f1109d43d69d8f8a39

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: zsasa-0.7.0-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.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 9808a45545277c4a59d9160d20c84f6ec31f548019d674cb0631f4c9980eb3f1
MD5 a7063569ca6a354b8736cc9b4ac3ccac
BLAKE2b-256 64c3c05bc2fab31c03d3459d3e35ab495880cddd9fd887a23626e86e29a81a98

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp311-cp311-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp311-cp311-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 b80a51d778cc1980d6e0df6d39e833286269107e5a55ce07c5d0dc21a239fcc5
MD5 aaa9e37dd7dac5ea088bf8d6f885a9f6
BLAKE2b-256 775c6c57133d20e9a97598c06a79e8570e0468c5aaab81dc4d6a30931766f6f6

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp311-cp311-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp311-cp311-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 b23e7aaaab73966b43ea0f83889d4d13479b309585f3615f1dab35c30ab4ec28
MD5 53a6e7d49ce2e4e16b8e9930632d4916
BLAKE2b-256 30858a280fc255a2baf19ff98080a6c9925900eed16cfd149ca4c13e9e3287bc

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp311-cp311-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp311-cp311-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 5f1ee08d0d74d307f6409800993303a6e47699cecb4555f65d8f02563be7abee
MD5 02de9b71c534774ae6eee48ff07ee0ec
BLAKE2b-256 3ae6a8d966f1d2b88b9b96af26e137b7ccaaa9997f425ecabacae72bee212dcd

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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.0-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zsasa-0.7.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 94da6b15df2898a057963646e1d235c1218b2125d390048ee9456072e79f771c
MD5 f4092f337bb68fbc93422c2be8fc645f
BLAKE2b-256 2ece5af2330cbce64c2a29e1c78ad2bd1ab9a039e73763ffba214fb232554be5

See more details on using hashes here.

Provenance

The following attestation bundles were made for zsasa-0.7.0-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

0.7.1

16 files

This release

0.7.0 This release

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