Musketeer
A software tool for fitting data from titration experiments.
Installation
Windows & MacOS:
You can install the latest .msi or .dmg installer here.
Any platform (requires Python)
Install the latest release of python from the official website. Then, in a terminal window or command prompt, type:
- Mac:
python3 -m pip install musketeer - Windows:
python -m pip install musketeer
You can now run Musketeer any time by typing:
- Mac:
python3 -m musketeer - Windows:
python -m musketeer
Usage Instructions
Example files
Five example .fit files are provided in examples/, together with the .csv files they were created from. For detailed descriptions of the data and models used in each file, please see the paper on Musketeer, where the same files are also provided as part of the Supplementary Information.
Loading titration data
When starting Musketeer, you will see the option to either Create a new fit file or Open an existing file. Musketeer can directly open the following files:
.fitfiles created using Musketeer.csvfiles obtained using Cary UV/Vis spectrometers.csvfiles exported from Mnova as "NMR 1D Peak List"
For other data sources, select Create a new fit file, and click Enter/edit spectroscopic data. This will open a spreadsheet interface where you can type or paste titration data. If you would like to request support for a new file format, please describe it by submitting a feature request!
Model specification
Once a file is loaded, the left side of the window will show a series of dropdown menus. Going from top to bottom, each of these can be adjusted to describe some part of the model:
- The Experiment section allows you to edit the signals to fit, specify the concentrations or cumulative addition volumes for each data point, and whether the system is under fast or slow exchange.
- The Equilibria section allows you to define the complexes formed in your system, and specify known values for equilibrium constants or relationships between them (such as the absence of cooperativity).
- The Spectra section allows you to define which compounds contribute to the observed signal, limit the number of variables by defining specific states that contribute to the signals (e.g. spectroscopically active groups), fix known spectra, or constrain the fitted spectra (e.g. force UV-Vis spectra to be non-negative).
- The Fitting section controls how the fit from different signals is weighted, which is currently only recommended for backwards compatibility.
If a dropdown requires you to input more data, it will show more information at the top of a popup window.
Fitting
When you have selected the appropriate option in each dropdown, press Fit to fit the data. Several tabs will appear, showing the fit to the data points, the calculated speciation, and the fitted equilibrium constants and spectra. The save button to the bottom left of each plot allows you to save it as an image file.
To compare the fit to a different model, Copy fit can create a new tab with the same options, some of which can then be modified. If you change any options, it may be necessary to re-enter the dropdowns below it as well: for example, if you add a new complex, you may need to re-enter which equilibrium constants are fixed.
Finally, the File->Save at the top of the screen allows you to save your work as a .fit file, which you can reopen at another time, or share with others.
Metadata
Release files for musketeer 1.10.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| musketeer-1.10.3.tar.gz | 215.5 kB | Without provenance | Details for musketeer-1.10.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| musketeer-1.10.3-py3-none-any.whl | Python 3 | none | any | Details for musketeer-1.10.3-py3-none-any.whl |
Total release size: 434.6 kB
Release files / musketeer-1.10.3.tar.gz
| Download URL | musketeer-1.10.3.tar.gz |
|---|---|
| Size | 215.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fe5bc2a76851361d62d9e8afe8e820d7944d6fb6f22a9d8f3dd2ce21e0a5eac7
|
|
BLAKE2b-256 checksum How to use checksums |
34aff0f7a4a275a72b5dd3e3357052e70f9f6a067cb2c4815d36536bb5b63aaf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
Release files / musketeer-1.10.3-py3-none-any.whl
| Download URL | musketeer-1.10.3-py3-none-any.whl |
|---|---|
| Size | 219.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9bef9ef6a707267ff1fdedaa2b23b1c2136495607620292270fe2de3b51ff341
|
|
BLAKE2b-256 checksum How to use checksums |
fa0f969d0fbd2797f24409b68fe1c699f951c4116c14e4968ee178b0fd3538d2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.4
|
Security for musketeer 1.10.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.