🗜️ PyCoMSA

Cython bindings and Python interface to CoMSA, a compressor for multiple-sequence alignments.

🗺️ Overview

CoMSA is a compression method for multiple sequence alignments developed by Sebastian Deorowicz et al.[1]. It compresses sequence data using a combination of positional Burrows-Wheeler transform (pBWT)[2], weighted-frequency-count transform (WFC)[3], zero-run-length-encoding transform (RLE), and a range coder[4]. It outperforms general-purpose Lempel-Ziv compression algorithms[5] for MSA compression.

PyCoMSA is a Python module that provides bindings to CoMSA using Cython.It directly interacts with the CoMSA internals, allowing to read files into Python objects, or write files directly from memory, without having to read or write intermediate, non-compressed files.

📋 Features

The library implements the following features:

Alignment decoding from FASTA or Stockholm encoded files.
Automated detection of compressed file formats.
Indexed access to Stockholm encoded files.
Compression interface for Stockholm encoded files.

🔧 Installing

This project is supported on Python 3.7 and later.

Until a release is made to PyPI, you will have to install the project from source:

$ pip install pycomsa

Check the install page of the documentation for other ways to install PyCoMSA on your machine.

💡 Example

Use the pycomsa.open method to open a file for reading a MSA, using automatic format detection. The readers implement the Sequence interface, allowing out-of-order access in the file, or just plain iteration.

import pycomsa

with pycomsa.open("src/pycomsa/tests/data/trimal.msac") as reader:
    print(len(reader))   # show the number of families in the file
    msa = reader[0]      # load family by positional index
    print(msa.names)     # get the list of files in the alignment
    print(msa.sequences) # get the list of sequences in the alignment

To write a MSA to a compressed file, used the same function in writing mode:

with pycomsa.open("test.msac", "w") as writer:
    writer.write(msa)

Note that pycomsa.open also supports file-like objects opened in binary mode, and supporting the seek method when reading CoMSA files.

💭 Feedback

⚠️ Issue Tracker

Found a bug ? Have an enhancement request ? Head over to the GitHub issue tracker if you need to report or ask something. If you are filing in on a bug, please include as much information as you can about the issue, and try to recreate the same bug in a simple, easily reproducible situation.

🏗️ Contributing

Contributions are more than welcome! See CONTRIBUTING.md for more details.

📋 Changelog

This project adheres to Semantic Versioning and provides a changelog in the Keep a Changelog format.

⚖️ License

This library is provided under the GNU General Public License v3.0. The CoMSA code was written by Sebastian Deorowicz and is distributed under the terms of the GPLv3 as well.

This project is in no way not affiliated, sponsored, or otherwise endorsed by the REFRESH-BIO laboratory. It was developed by Martin Larralde during his PhD project at the Leiden University Medical Center in the Zeller team.

📚 References

[1] Deorowicz, S., Walczyszyn, J., & Debudaj-Grabysz, A. (2019). CoMSA: Compression of protein multiple sequence alignment files. Bioinformatics, 35(2), 227–234. doi:10.1093/bioinformatics/bty619
[2] Durbin, R. (2014). Efficient haplotype matching and storage using the positional Burrows–Wheeler transform (PBWT). Bioinformatics, 30(9), 1266–1272. doi:10.1093/bioinformatics/btu014
[3] Deorowicz, S. (2002). Second step algorithms in the Burrows–Wheeler compression algorithm. Software: Practice and Experience, 32(2), 99–111. doi:10.1002/spe.426
[4] Salomon, D., & Motta, G. (2010). Handbook of Data Compression. Springer Science & Business Media. ISBN:978-1-84882-903-9
[5] Ziv, J., & Lempel, A. (1977). A universal algorithm for sequential data compression. IEEE Transactions on Information Theory, 23(3), 337–343. IEEE Transactions on Information Theory. doi:10.1109/TIT.1977.1055714

Download files

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

Source Distribution

pycomsa-0.1.2.tar.gz (7.9 MB view details)

Uploaded Aug 25, 2026 Source

Built Distributions

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pycomsa-0.1.2-pp310-pypy310_pp73-win_amd64.whl (362.3 kB view details)

Uploaded Aug 25, 2026 PyPyWindows x86-64

pycomsa-0.1.2-pp39-pypy39_pp73-win_amd64.whl (361.0 kB view details)

Uploaded Aug 25, 2026 PyPyWindows x86-64

pycomsa-0.1.2-pp38-pypy38_pp73-win_amd64.whl (355.5 kB view details)

Uploaded Aug 25, 2026 PyPyWindows x86-64

pycomsa-0.1.2-pp37-pypy37_pp73-win_amd64.whl (371.2 kB view details)

Uploaded Aug 25, 2026 PyPyWindows x86-64

pycomsa-0.1.2-cp315-cp315t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (454.2 kB view details)

Uploaded Aug 25, 2026 CPython 3.15tmanylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pycomsa-0.1.2-cp315-cp315t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl (429.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.15tmanylinux: glibc 2.24+ ARM64manylinux: glibc 2.28+ ARM64

pycomsa-0.1.2-cp315-cp315t-macosx_11_0_arm64.whl (380.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.15tmacOS 11.0+ ARM64

pycomsa-0.1.2-cp315-cp315t-macosx_10_15_x86_64.whl (404.9 kB view details)

Uploaded Aug 25, 2026 CPython 3.15tmacOS 10.15+ x86-64

pycomsa-0.1.2-cp314-cp314t-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (452.5 kB view details)

Uploaded Aug 25, 2026 CPython 3.14tmanylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pycomsa-0.1.2-cp314-cp314t-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl (428.5 kB view details)

Uploaded Aug 25, 2026 CPython 3.14tmanylinux: glibc 2.24+ ARM64manylinux: glibc 2.28+ ARM64

pycomsa-0.1.2-cp314-cp314t-macosx_11_0_arm64.whl (382.4 kB view details)

Uploaded Aug 25, 2026 CPython 3.14tmacOS 11.0+ ARM64

pycomsa-0.1.2-cp314-cp314t-macosx_10_15_x86_64.whl (406.0 kB view details)

Uploaded Aug 25, 2026 CPython 3.14tmacOS 10.15+ x86-64

pycomsa-0.1.2-cp311-abi3-win_amd64.whl (365.7 kB view details)

Uploaded Aug 25, 2026 CPython 3.11+Windows x86-64

pycomsa-0.1.2-cp311-abi3-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (449.4 kB view details)

Uploaded Aug 25, 2026 CPython 3.11+manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pycomsa-0.1.2-cp311-abi3-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl (424.8 kB view details)

Uploaded Aug 25, 2026 CPython 3.11+manylinux: glibc 2.24+ ARM64manylinux: glibc 2.28+ ARM64

pycomsa-0.1.2-cp311-abi3-macosx_11_0_arm64.whl (348.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.11+macOS 11.0+ ARM64

pycomsa-0.1.2-cp311-abi3-macosx_10_9_x86_64.whl (372.9 kB view details)

Uploaded Aug 25, 2026 CPython 3.11+macOS 10.9+ x86-64

pycomsa-0.1.2-cp310-cp310-win_amd64.whl (377.2 kB view details)

Uploaded Aug 25, 2026 CPython 3.10Windows x86-64

pycomsa-0.1.2-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (468.8 kB view details)

Uploaded Aug 25, 2026 CPython 3.10manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pycomsa-0.1.2-cp310-cp310-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl (442.7 kB view details)

Uploaded Aug 25, 2026 CPython 3.10manylinux: glibc 2.24+ ARM64manylinux: glibc 2.28+ ARM64

pycomsa-0.1.2-cp310-cp310-macosx_11_0_arm64.whl (367.2 kB view details)

Uploaded Aug 25, 2026 CPython 3.10macOS 11.0+ ARM64

pycomsa-0.1.2-cp310-cp310-macosx_10_9_x86_64.whl (393.1 kB view details)

Uploaded Aug 25, 2026 CPython 3.10macOS 10.9+ x86-64

pycomsa-0.1.2-cp39-cp39-win_amd64.whl (377.6 kB view details)

Uploaded Aug 25, 2026 CPython 3.9Windows x86-64

pycomsa-0.1.2-cp39-cp39-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (468.7 kB view details)

Uploaded Aug 25, 2026 CPython 3.9manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

pycomsa-0.1.2-cp39-cp39-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl (443.2 kB view details)

Uploaded Aug 25, 2026 CPython 3.9manylinux: glibc 2.24+ ARM64manylinux: glibc 2.28+ ARM64

pycomsa-0.1.2-cp39-cp39-macosx_11_0_arm64.whl (367.7 kB view details)

Uploaded Aug 25, 2026 CPython 3.9macOS 11.0+ ARM64

pycomsa-0.1.2-cp39-cp39-macosx_10_9_x86_64.whl (393.9 kB view details)

Uploaded Aug 25, 2026 CPython 3.9macOS 10.9+ x86-64

pycomsa-0.1.2-cp38-cp38-win_amd64.whl (370.5 kB view details)

Uploaded Aug 25, 2026 CPython 3.8Windows x86-64

pycomsa-0.1.2-cp37-cp37m-win_amd64.whl (384.5 kB view details)

Uploaded Aug 25, 2026 CPython 3.7mWindows x86-64

File details

Details for the file pycomsa-0.1.2.tar.gz.

File metadata

Download URL: pycomsa-0.1.2.tar.gz
Upload date: Aug 25, 2026
Size: 7.9 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pycomsa-0.1.2.tar.gz
Algorithm	Hash digest
SHA256	`23e2c99dab867cd75bf5405985723602662f1cd72cf29b02ec594876bf6ab1b3`
MD5	`1f434c56335e90a37b21b63680c88e04`
BLAKE2b-256	`777bd19bd5c6c80314719d1888f248b3fc1dd6b298aace7e11e230ef9855bc20`

Algorithm	Hash digest
SHA256	`f29248b6d0c4a24a60233094b0b8e35326db82a9173808e00d45e59bc7e9a642`
MD5	`4791ee16c87187b8148ff1379d9b6b2b`
BLAKE2b-256	`fc8919f29394004cb8b7d018e342f77192ca84533dfcb0c0476e6add3f5a3803`

Algorithm	Hash digest
SHA256	`b5a82827a4e6403da10c1da06083d94d8c6942ac413585123733b8e5b46315bc`
MD5	`abbcda21d42b43a62858a85a06b90be3`
BLAKE2b-256	`0e06a9884454394f1da3804e3a4409c64cfc6eacbd03706da26476211dfa9242`

Algorithm	Hash digest
SHA256	`26d22e5de97348de4e5378c19c6d885754f3ea139db9bcc6909396217b31be05`
MD5	`cf88844cbf7832d3fb6718b703e3eca5`
BLAKE2b-256	`39200a5f599e5e9b3e375b9a820c02a0636d3787442475a72dc01626740aadd4`

Algorithm	Hash digest
SHA256	`8665e6112937146a84819aa3d575934244e587a9beeda0c8164b3695fea02c5b`
MD5	`4d3e5706cfb9669a63c5978c31d02884`
BLAKE2b-256	`375d6dda6d57b016e265547e59916460d451b2fe8bab91e3eb26a457625c53b2`

Algorithm	Hash digest
SHA256	`bc31f35258d1876289a7431b903a8a0553d4a6a46f3b246410f0e39244381562`
MD5	`836c9fd21eb66aa39ba486a36d6d5dd5`
BLAKE2b-256	`6c41f1427db16113074f1f4fa0dc4167183bb061895781d5b98cf3840e4447ad`

Algorithm	Hash digest
SHA256	`dc827b231bef88240449b09375e63e8a1095d36ab1261207185cff1c04fafa33`
MD5	`2177073c806b267b4d7e9cd42a6ef8b9`
BLAKE2b-256	`cb822ef637733234d0133207d59d82cfca02ae7fa6134a967bb52c9835229bc7`

Algorithm	Hash digest
SHA256	`298d3d595b348985a0f5ad04ff30d34c5dd7003ad8134e529d26676aa5c1c272`
MD5	`fa32b5443407d0a7c0cc1f0c8c2bf20a`
BLAKE2b-256	`86c7b44f0bc8ee70b93552790034cd6fc0b69a45909b4a0d217a867e114cb044`

Algorithm	Hash digest
SHA256	`0575f2d51e6906e9c4318eb8a107614b14e387cf09ab244af51f46d32a0f0e19`
MD5	`be69ec71091ee1578b2e11a3ed9b2993`
BLAKE2b-256	`2a64f76d6c8468ad9945507ef0ee13ea5ac7b725daa0273a1aa8483a747037c7`

Algorithm	Hash digest
SHA256	`54a9fbabe68576666c966cc204492fc62155a310c67ba77ceb60c20914e8929f`
MD5	`9a3eb57eedf4931a9de1807031242009`
BLAKE2b-256	`412fe19629f936b064d0d7f88964a276b072d4cfa0fa456f90413969cf7608d7`

Algorithm	Hash digest
SHA256	`328ce601fb8c918b64cb5a468323f06636d873120251c737afde2c54ed9ef0f8`
MD5	`cdc6d9ea13a8b85dc1a79be2d7c2cb0d`
BLAKE2b-256	`e1e5718f7f6a9be3ea1a9222954a46c836b598f0f5afe33a1d1857d78f455fb8`

Algorithm	Hash digest
SHA256	`13df52d2e0d5c98c7beb1bd730cb97e3eb4e49403b161013984cf3d1ab317b2c`
MD5	`391612a2a77c3b8b0815d1ab50342137`
BLAKE2b-256	`85a67fb873dacf8b96a3847b86926b001ba4253a5841bc5cad4591d546e3132a`

Algorithm	Hash digest
SHA256	`10965a3e968cc1a05e4f73af90ada7b3961609373f474d2b3304e8dfb8a8a9d1`
MD5	`354b47d31b72d2b983319a586c07d432`
BLAKE2b-256	`916f877ab5d245f9b1adce243a819d956a4f7bad4666a35c83e7189f33a29bb6`

Algorithm	Hash digest
SHA256	`5dbf0a0fba08b9f8f33f8e782f4ee53007eec8f067cd5307fe7b18910effbab9`
MD5	`b4d10bde34b2d8f0b137baad5cc5ae45`
BLAKE2b-256	`c8310016095b66ade824229e6587e34f4bc3e8f3460935ab5f612d259e0264f1`

Algorithm	Hash digest
SHA256	`32a3398a24210a8bc859cfb3b6dc7da9b826b15f2144f9abe34e03378dcf2bb9`
MD5	`5f3758c762ab84fcbab0ad31fa3b234b`
BLAKE2b-256	`f063292d9237b4625d5773be579ee5f2c3c8f5997b73036284b96e94a341bd58`

Algorithm	Hash digest
SHA256	`770ad96ad35b658bc306fb2f89ddeba8032c46911fe9861d654f74fb236060e2`
MD5	`a4edafd2ad1da14ad1a30ecc077bae5f`
BLAKE2b-256	`f86fcc8a1e8e855204b23309e361ad9655c8cdd35f215fc85529d1f6721714bb`

Algorithm	Hash digest
SHA256	`3d02cb12a80d5e0009a1338cb5a9d395c411f7c8414b97b00ef5bf8002a5d135`
MD5	`a7250239b5417ad3ace1aa9c0f8ab4c8`
BLAKE2b-256	`68d55e1e6fbe8de035f8c7643bbd426f7c0a8002e08aedb98cb7a9a864abec3e`

Algorithm	Hash digest
SHA256	`911cad6018fc44014ae2779e7d3ffa8258f68b5f51d827efdab9af6008a12eab`
MD5	`a3452c72993440fcd16cf61296ddbcce`
BLAKE2b-256	`4e2dfafccb9cfc3a30a1d50d10c8275dceee4a9c418b4e058736a98bbb63dc46`

Algorithm	Hash digest
SHA256	`8753e515ab249a59f04607732e0fa9e8f3bc8baea1cbbf5397f33ad6b15ba49e`
MD5	`1a59599179deeda4a97227dfe515d055`
BLAKE2b-256	`285bc4851d3d40acc2e8c8a5d81d8cb82bbd80b835e82a6fb7092c018048a7d5`

Algorithm	Hash digest
SHA256	`0bbcc1278dd5b6503b7bdf87d8ec61117c2a4754b86cfdba278e9caf6f882369`
MD5	`35291a80c912f65a2e9d34b262c0baca`
BLAKE2b-256	`420005d71fd98474a57b12c02baccd192a4eb7671d7cfa588982391cf78909d0`

Algorithm	Hash digest
SHA256	`8953d2d6c96c7f78ddc59f723e4225406d4340009ab143456d6061555efff105`
MD5	`5a9824cb7dbb2984734719cfca56d744`
BLAKE2b-256	`73aff31e0e4a414f256f4c11247b9283f0bb0d44ef132e54b4074859cdf90193`

pycomsa 0.1.2

🗜️ PyCoMSA

🗺️ Overview

📋 Features

🔧 Installing

💡 Example

💭 Feedback

⚠️ Issue Tracker

🏗️ Contributing

📋 Changelog

⚖️ License

📚 References

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Algorithm	Hash digest
SHA256	`81496291b3223c308ee5335d0936645720babb70af9b6863b04c9d4a5f34edb5`
MD5	`63dcdd62e5362e182cb00340e720f0ce`
BLAKE2b-256	`d414edde93c8ee460c7ca6b627ec2c1149357a608bf8dc4f47cc5f8f3f34023c`

Algorithm	Hash digest
SHA256	`971b6d8a74cc9c6473fcdadece3ee3f3c176c0ea46d51f17dd29ca988ff88a00`
MD5	`2ac5120817509a3faa04df0b425dc786`
BLAKE2b-256	`0f9c998cb6924695c2ca43e603576bd60a878cbedb13d5c8d4a0940d378f4bc9`

Algorithm	Hash digest
SHA256	`ef9ccc3a970a656dceec0d37333ac52a4d34b59d6a3421a7c1e60bf7871bcbda`
MD5	`69c4f00b1344f83869cf8e26acde92ff`
BLAKE2b-256	`03f2ac661ffc49d128e1d469fb4fdb5aaf7351acd7e13766a1ed974bb15e31ae`

Algorithm	Hash digest
SHA256	`094123daba9259a7e79d17510b959b6da62f9b5b3ec28fe2ecd19b184292744d`
MD5	`030b3e9529fdbe1e4edffe437d395d76`
BLAKE2b-256	`aefa1ce9479b9e8b8df2927c44f8427fadfc3c81ee7e20dcccda11780b2abf59`

Algorithm	Hash digest
SHA256	`92408a64f91087f786f2a26162dca87d836235f71296e73d63341186056d68ab`
MD5	`9e04852278132f4406d366d585b6d24c`
BLAKE2b-256	`29ba082839a47e97670fa19bc93e0aa0a210d4c76ac40f48796fdc5ce59364bc`

Algorithm	Hash digest
SHA256	`e81878a3066170642d835be799889245cd112d07a5af68b3b127b3cd6b26ff35`
MD5	`9e36f4c5253934996bbf4dfcab6d2a2d`
BLAKE2b-256	`208510c78d9116be77f65b825d43348550b9f1f967c20c4dfb8dc14e8b1f3eff`

Algorithm	Hash digest
SHA256	`7461ea5880f9ecef0e0af41142dfc853abf983a8448fd32b31234780ee982b25`
MD5	`b25ca1fb14e436e6a92c20d6f750c2b9`
BLAKE2b-256	`9a43d412d40639e52dbf9f719a3d3df2428a397383cbed093150780976a9a14d`

Algorithm	Hash digest
SHA256	`e300d55e791e1bd7f21c608ecc6dd756a71b1070a8f103077b01267f8f56c0fb`
MD5	`8d62898d28631d674bfd27eaf770e29f`
BLAKE2b-256	`6c65a23af241774a64c46932780b8118fda3c7380687fe2f9c301cb998af80cf`

Algorithm	Hash digest
SHA256	`3072a8554ea31ea57f74da65dc7c0b68693c84d7dd777c7a5fa3a5602cbcd43c`
MD5	`c05d1f0b04fecb711e42b140df004052`
BLAKE2b-256	`2d4833533a065106b84144b0208262764118c1900befcbeeddceb654639420c8`