Molass Library is a rewrite of MOLASS, a tool for the analysis of SEC-SAXS experiment data currently hosted at the Japanese synchrotron radiation facilities, Photon Factory and SPring-8
Tested Platforms
Continuous integration tests run on:
- Python 3.12, 3.13, 3.14 on Ubuntu (latest)
- Python 3.12, 3.13, 3.14 on Windows (latest)
Installation
Requirements: Python 3.12, 3.13, or 3.14
Linux (Ubuntu/Debian) prerequisites:
Before installing on Linux, ensure system build tools are available (needed to compile C extensions such as ultranest):
sudo apt install build-essential python3-dev
To install this package, use pip as follows:
pip install -U molass
pip install molass_data # Sample datasets for tutorials and testing
For development (requires molass-legacy as a sibling directory):
git clone https://github.com/biosaxs-dev/molass-library
git clone https://github.com/biosaxs-dev/molass-legacy
cd molass-library
pip install -e ".[testing]"
pip install molass_data
Quick Start
For a hands-on introduction, see the tutorial's Quick Start section, or run the corresponding test file:
pytest tests/tutorial/01-quick_start.py -v
Note: Running tests requires the development install. See CONTRIBUTING.md for setup instructions.
The molass-beginner repository provides an interactive onboarding experience in VS Code Agent mode.
Documentation
- Beginner Onboarding: https://github.com/biosaxs-dev/molass-beginner — Agent-mode first-run guide, for first-time users
- Tutorial: https://biosaxs-dev.github.io/molass-tutorial — practical usage, for beginners
- Essence: https://biosaxs-dev.github.io/molass-essence — theory, for researchers
- Technical Report: https://biosaxs-dev.github.io/molass-technical — technical details, for advanced users
- Reference: https://biosaxs-dev.github.io/molass-library — function reference, for coding
- Legacy Repository: https://github.com/biosaxs-dev/molass-legacy — legacy code
Community
To join the community, see:
- Handbook: https://biosaxs-dev.github.io/molass-develop — maintenance, for developers
- Contributing: CONTRIBUTING.md — how to contribute
- Support: GitHub Issues — questions, bugs, and feature requests
Especially for testing, see the first two sections in
Copilot Usage
Context is auto-loaded from .github/copilot-instructions.md when using GitHub Copilot in Agent mode (AI Context Standard).
For behavioral rules and user-type guidance, see Copilot/copilot-guidelines.md.
Optional Features
Excel reporting (Windows only):
If you want to use Excel reporting features (Windows only) for backward compatibility, install with the excel extra:
pip install -U molass[excel]
Note: The
excelextra installspywin32, which is required for Excel reporting and only works on Windows.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file molass-1.0.2.tar.gz.
File metadata
- Download URL: molass-1.0.2.tar.gz
- Upload date:
- Size: 1.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
54269512667c13bea462c97177282328fa774ad7946230481265ef4e1a9cec49
|
|
| MD5 |
35552ce8a11753fd6779188b5682352b
|
|
| BLAKE2b-256 |
2c37c0eec1149c7f929638e4ab406931e2c124b38c24d749c3b69f9c38671859
|
Provenance
The following attestation bundles were made for molass-1.0.2.tar.gz:
Publisher:
upload_to_pypi.yml on biosaxs-dev/molass-library
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
molass-1.0.2.tar.gz -
Subject digest:
54269512667c13bea462c97177282328fa774ad7946230481265ef4e1a9cec49 - Sigstore transparency entry: 2187919545
- Sigstore integration time:
-
Permalink:
biosaxs-dev/molass-library@3f52654350d26cdad587f4a1cc1d7b27c6762080 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/biosaxs-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
upload_to_pypi.yml@3f52654350d26cdad587f4a1cc1d7b27c6762080 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file molass-1.0.2-py3-none-any.whl.
File metadata
- Download URL: molass-1.0.2-py3-none-any.whl
- Upload date:
- Size: 1.1 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5421847eb8db5fb157cf4c482a1674a7113c63bce5da00b7773289d00b959378
|
|
| MD5 |
a302b5779849d3ae2ca014c3a652f586
|
|
| BLAKE2b-256 |
89c890dac06978281c421537a434ff91593e229ecca8c932f26e590a5038584a
|
Provenance
The following attestation bundles were made for molass-1.0.2-py3-none-any.whl:
Publisher:
upload_to_pypi.yml on biosaxs-dev/molass-library
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
molass-1.0.2-py3-none-any.whl -
Subject digest:
5421847eb8db5fb157cf4c482a1674a7113c63bce5da00b7773289d00b959378 - Sigstore transparency entry: 2187919563
- Sigstore integration time:
-
Permalink:
biosaxs-dev/molass-library@3f52654350d26cdad587f4a1cc1d7b27c6762080 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/biosaxs-dev
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
upload_to_pypi.yml@3f52654350d26cdad587f4a1cc1d7b27c6762080 -
Trigger Event:
workflow_dispatch
-
Statement type:
