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 15, 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 15, 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.9.0.tar.gz (295.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.9.0-cp313-cp313-win_amd64.whl (1.5 MB view details)

Uploaded CPython 3.13Windows x86-64

zsasa-0.9.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.9.0-cp313-cp313-manylinux_2_28_aarch64.whl (4.8 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.13macOS 11.0+ x86-64

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

Uploaded CPython 3.13macOS 11.0+ ARM64

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

Uploaded CPython 3.12Windows x86-64

zsasa-0.9.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.9.0-cp312-cp312-manylinux_2_28_aarch64.whl (4.8 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.12macOS 11.0+ x86-64

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

Uploaded CPython 3.12macOS 11.0+ ARM64

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

Uploaded CPython 3.11Windows x86-64

zsasa-0.9.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.9.0-cp311-cp311-manylinux_2_28_aarch64.whl (4.8 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ ARM64

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

Uploaded CPython 3.11macOS 11.0+ x86-64

zsasa-0.9.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.9.0.tar.gz.

File metadata

  • Download URL: zsasa-0.9.0.tar.gz
  • Upload date:
  • Size: 295.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.9.0.tar.gz
Algorithm Hash digest
SHA256 64a123de784bb958370a7351a55f98e2ead1c1a38f3982edbb79f8607c9130a8
MD5 5b70077b6bc4931efad7b3ad7a45a421
BLAKE2b-256 ddb0f4049ce206bc3009490c967e53bdef5a56d204a8b2ea8160602aa29f5ce6

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: zsasa-0.9.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.9.0-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 235d84be72e0d7065e7915676319b2f725f6384710cdd2e6339add6527dd1762
MD5 b02fddbbbfbd295487555aae62afd4b5
BLAKE2b-256 3aaf419de686867bff0baa6649cdff46467cdaab00f94a20001ae98afc8647ab

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp313-cp313-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 41addf1be5356e3951e185d46099eeaf6a637112bd499a78adcc16a70cf619e9
MD5 74c069db3e6df18084f4c4d54b8b6a48
BLAKE2b-256 dbea5171b31ae3f85b1f84266379f4c5fb291f80ab98c20455352b68c9b2664f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp313-cp313-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 bd4414209c5bd8f7668761bbb2a48afbb9e9e739ae9a769a0f475aab40e40c4e
MD5 7882f72857d97e7ece828a54ed990616
BLAKE2b-256 45569978214f7f34b53ade1a0a9b32f65738cb0af5ccc9de4347ffe175693417

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp313-cp313-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 7e6380bb6639e5aee0406ae3ed6c7743c0e840dabc9dd03abb9e2653c4bd33b4
MD5 9dc9fe425f80f70200428eb48024c4ea
BLAKE2b-256 d4fc4a7a7e59d8bc14d9058ec1dffbb2018f3151baf4c0257300774e664c1e29

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 71895579ebecab2532d3cb84e661ed0bba8226e2da783b5b186e3d00f51dac66
MD5 068243ce987a774301c3d287ecb7f619
BLAKE2b-256 d17c2af399eac9e97edc0b87d006848189f2b1e6e52de315746e283cf14fc01e

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: zsasa-0.9.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.9.0-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 bdbb60bdc9fd05f7f290550c8d38df22c0fdcc33a8c76d3d2a63ff8f0cac3a04
MD5 4e8b9dd8e862a57fd922c44661493268
BLAKE2b-256 5e23e7d36a3cf7882f43634dac67cb3d48dff966252a38c49172fbd1ff750430

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp312-cp312-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 a495c8b85aeabf7fb77b7e77f7a6716551f865667e0f5fe902b6c9b4b82675fb
MD5 9f23b5cb08b9cabca5ffbedcb065faee
BLAKE2b-256 d7c5ebe5ae3e1679536828b7f28629d7788db9bb2d9d41e1fe8baed32474386a

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp312-cp312-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 c846c413a75fabcd07f1081b95050c7429cc91336261fd68301a884a30c3351d
MD5 dcf66809f973e38814f2b1ebd375a4a4
BLAKE2b-256 0b29c407111542efbb0ee0c25943d477d248c46160329efe0ab2bcf873584b02

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp312-cp312-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 939de543ba954a72146587ff82a821fc4eafe5d69c53b42248dacf4bd1344dbf
MD5 32cde679696bbb05dba42d770652ee7a
BLAKE2b-256 f3fd9c3744c2bb64f1efe1ad020b63c1c24c63c6567003fac8c12b83119d27ae

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 1551ccda13186b5d4fe6ff79601fd6ba9ed7238897b4aad39ee8c919ef6391e5
MD5 b6cb35b057f52cae2224c182d596f096
BLAKE2b-256 fec94a77c341ba3d77afe37023a9bdffcbae04106c666fc362100891e4a2e117

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: zsasa-0.9.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.9.0-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 7e4307970f3c09b491119e1f88535939e6e6c882806a3ee21b82bda16883da5f
MD5 0d4c3e66536a21755b9e7742a5214ff1
BLAKE2b-256 44dbd19ab0a142511a5713408745e7a4a980b40a79d6d072b3212fe4d2584ebd

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp311-cp311-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 cfb91d3f2b32a3335b479d03cdf3b16c082824b08d45fdc3bb9cdc55c38a3d4e
MD5 c2e4d5e06dcb906090dd5b51bbb315fc
BLAKE2b-256 cd3a9a1d0fda545be93a73928fe9e62f8e80ca3627a5341e151e7f1ebbb2047f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp311-cp311-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 68e19782b1ada2c9e55058aae875dd733435ba0e9ef4fffbcbf6c094b03843fd
MD5 77807457854ddb64634b71d6dbcc3c8b
BLAKE2b-256 99703203b6b0d3dc2ea432873b2eb8cde17cc5535ca908f78f0435f69899b132

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp311-cp311-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 5a1ee8e62928fc25f76438dbf87f1f42e39cbd20ebc5bd934a1616ff4f4eb091
MD5 c519a46d652afdc623ea37d68b87b2f6
BLAKE2b-256 9bb3679ef03dbdbdc91a80f24b5362433468bdf6d0994363570da8d09607afa9

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for zsasa-0.9.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 350c46b2bea6fdfe210c3d8553d7edd415c434d4728128435366db460ed3a0d6
MD5 3d178fbe828b5d900d57e0e51a1ebc63
BLAKE2b-256 93623e533b2e49bff99f5284e296064126dc4742f0ac2d92000c42d5eceedfc9

See more details on using hashes here.

Provenance

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

This release

0.9.0 This release

16 files

0.8.0

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