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: CCD, ProtOr, NACCESS, and 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 Jul 1, 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 Jul 1, 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.8.0.tar.gz (289.0 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.8.0-cp313-cp313-win_amd64.whl (1.5 MB view details)

Uploaded CPython 3.13Windows x86-64

zsasa-0.8.0-cp313-cp313-manylinux_2_28_x86_64.whl (4.8 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ x86-64

zsasa-0.8.0-cp313-cp313-manylinux_2_28_aarch64.whl (4.7 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ ARM64

zsasa-0.8.0-cp313-cp313-macosx_11_0_x86_64.whl (1.3 MB view details)

Uploaded CPython 3.13macOS 11.0+ x86-64

zsasa-0.8.0-cp313-cp313-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

zsasa-0.8.0-cp312-cp312-win_amd64.whl (1.5 MB view details)

Uploaded CPython 3.12Windows x86-64

zsasa-0.8.0-cp312-cp312-manylinux_2_28_x86_64.whl (4.8 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ x86-64

zsasa-0.8.0-cp312-cp312-manylinux_2_28_aarch64.whl (4.7 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ ARM64

zsasa-0.8.0-cp312-cp312-macosx_11_0_x86_64.whl (1.3 MB view details)

Uploaded CPython 3.12macOS 11.0+ x86-64

zsasa-0.8.0-cp312-cp312-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

zsasa-0.8.0-cp311-cp311-win_amd64.whl (1.5 MB view details)

Uploaded CPython 3.11Windows x86-64

zsasa-0.8.0-cp311-cp311-manylinux_2_28_x86_64.whl (4.8 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ x86-64

zsasa-0.8.0-cp311-cp311-manylinux_2_28_aarch64.whl (4.7 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ ARM64

zsasa-0.8.0-cp311-cp311-macosx_11_0_x86_64.whl (1.3 MB view details)

Uploaded CPython 3.11macOS 11.0+ x86-64

zsasa-0.8.0-cp311-cp311-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

File details

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

File metadata

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

File hashes

Hashes for zsasa-0.8.0.tar.gz
Algorithm Hash digest
SHA256 f7e4768cfc66399d8336185471c5dd9599c8c8c42a5e89e9470f55f9e09eee6d
MD5 e09bead165b9daefe1b0fe97efd829ed
BLAKE2b-256 c1d2354078baed0121fcc378a84d6c7d648221dc1eb72d97fbc2b8b22bd1eab9

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: zsasa-0.8.0-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 1.5 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.8.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 4eecc2932d78adf9a08da307e27fc11a1c575ea45039d338efe53644dca78b12
MD5 4741367dbfe84ab58024bae0b7b492fd
BLAKE2b-256 6083a09b58ea2e69364801b1337816bbc722fb29abdeff2c0ad5cb6a44d799e0

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp313-cp313-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 6761b874910445bc46a260935411fb21989ecc517ecf6dc1fd2a3b9041570c57
MD5 f95cdb488009d2439365ae77ce82f24c
BLAKE2b-256 cae0bc76f0466f9bd904f6b5083362d18b4c0e45183bb73bbb5e9bf6059d22a1

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp313-cp313-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 593c93bdc66c41edf420e234207d1346d294ec42a2992788dca708833723fe5c
MD5 32a4d402fee912fcc73723f5ac2322c9
BLAKE2b-256 702ec470e6cae243d308660568efd84f80f3323f2736f3ffc42cbc368fa5959d

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp313-cp313-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 e5022a3db9adc1867e2c7a4a4afd4e207e18e5681a41c821e304a436ab696996
MD5 3e61a1642064e52bba91774b1745ebea
BLAKE2b-256 2004cf77b007c3e1f613bdfb5c58e1b1d40918097951757e74b73ec092d3caf3

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c32ca05bd2d1f0f58da8587af613cf4109dbaa8c3d464b59e5856b40b53c3e96
MD5 dade1a9cee51834189e55da4db773f68
BLAKE2b-256 aa6f58a8bec86b4a1b92282e929168082ee72a4d43b471c498dfd2b4a507902f

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: zsasa-0.8.0-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 1.5 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.8.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 b2230f8613b638fb7d95fec964df5de0b6a8c263e8c78f78a68413cf2f2b8be7
MD5 09d6ad6d9ccf5ee5a24cbcd165378351
BLAKE2b-256 0fa916c3495e706aa56a1b29591ee372e25d6f3bb03a742aeb9744f61cd9ff71

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp312-cp312-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a2808403d1f66204a15ef41eefae339a6862a4ec098faa3884fa95344b502901
MD5 3493e4664b7967af72cc52cb7a4ae9ed
BLAKE2b-256 19cb6a73c61194dbf27a7bfdf6c4e98c4606558786d352973c0b6d74dc68e497

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp312-cp312-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 41751868893951db9db4f377ae360d9fda4d768cfaef98c2d1243965e184ef2f
MD5 90f3fc70323e1f5e29aad50077efd0a6
BLAKE2b-256 c6850905d58e57e293b3c7d33ed098057eead1fc06950b4e6d2c476a6597829d

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp312-cp312-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 45ab3bec1d37c621fbb3cf548d9fc34ecee944f903fcdbce6d96dece85ed033e
MD5 dab3dcb59b5d40a12feb748a58919778
BLAKE2b-256 f9c3ead4c61eb17636701d41f775d3b37d3327cf93c450bf20fdf57ca951af48

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 548d271a1fff18cd9b393876fbb844ece5e390738720b383398550bf5403ec86
MD5 caa4d8e4d56c9edc8587dc569a9a5385
BLAKE2b-256 db89e0de9c57b5c211691a057b635b1526bd93b9a973f8b794cc28391295129e

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: zsasa-0.8.0-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 1.5 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.8.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 194a9b79c570cc7ffe1107f3e5b091e7a68d9b5d5a40e658e91c839c07108816
MD5 4740bdc52cb7873ce28079c2f00adce0
BLAKE2b-256 7fef89eced9e9e967019316d033f8625c15663be52e19e84327435c3607849e9

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp311-cp311-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 db639e16fbc70d4aeabb50316ede95379d839d9841b0b0a395eca8431bea4792
MD5 78eb0da3eaaddc9a6c9106b7147062e0
BLAKE2b-256 87b101dc55ccb43103ad0235f1ee2f1321f13c9529e6ee341ae35acd57cac6c8

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp311-cp311-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 ba1eca6bc7523a59b3aa147709b6264d164ff85d3730979ef83c37e5e71599b7
MD5 e188717c64aa418857d1e9dfb2321bf3
BLAKE2b-256 74f43f6b93f4540d91afeaa4aa50edcb330bc1fad6d4be4f82e7372f25cb2fcd

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp311-cp311-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 0ab8787cf76d2e997974f36757b7e32baa3113c82928d2cb60f22019fa67bc69
MD5 21f7598725ab5214407bf1ec9b2178ee
BLAKE2b-256 c10d9d79b38484f4dea7898855416d4ba33bd8aec4ed5fa4d649786ed6ec46e2

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.8.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 4e3b4b3031ce4d6ff62239fd870ce7c268b2bc79a48c6117f508f446146019df
MD5 07a01906537ba6188413337034cd09e2
BLAKE2b-256 cc79d055e3d9fa5adee880afbe22dcb0ea09897beb3211b61b64a33abd5f4b1b

See more details on using hashes here.

Provenance

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

This release

0.8.0 This release

16 files

0.7.1

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