Skip to main content

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:

  • .fit files created using Musketeer
  • .csv files obtained using Cary UV/Vis spectrometers
  • .csv files 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)

Source distribution for musketeer 1.10.3
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)

Table of built distributions (wheels) for musketeer 1.10.3
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

1.10.3 This release

2 release files No provenance

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