Skip to main content

Pyckett

Pyckett is a python wrapper around the SPFIT/SPCAT package (H. M. Pickett, "The Fitting and Prediction of Vibration-Rotation Spectra with Spin Interactions," J. Mol. Spectrosc. 148, 371-377 (1991)).

Install the package with pip by using the following command

pip install pyckett

If SPFIT and SPCAT cannot be executed via the commands spfit and spcat (if they are not in your PATH or have different names) point to them by setting the PYCKETT_SPFIT_PATH and PYCKETT_SPCAT_PATH environment variables to their full paths.

If you want to acknowledge LLWP, please cite the paper On the Spectroscopy of Phosphaalkynes: Millimeter- and Submillimeter-Wave Study of C2H5CP.

Documentation

Currently, the documentation is limited to the docstrings of the main library. To easily access the docstrings you can run

pip install pdoc
pdoc pyckett

after having installed Pyckett.

The CLI tools provide help texts via the -h or --help flags.

GUI

Pyckett also provides a graphical user interface that can be started by running

pyckett

It lets you work on several projects at once, each with its own tabs for .par/.lin/.int files (and read-only tabs for .var/.cat/.egy/SPFIT-SPCAT output), run SPFIT/SPCAT virtually without touching disk, and includes an Actions tab for removing duplicate assignments and testing which parameters to add or omit. Every change to a project's .par/.lin/*.int content is versioned, so you can step back to an earlier point at any time.

CLI Tools

Pyckett provides a set of command line utilities which perform common steps of an iterative fitting process.

pyckett_add helps adding new parameters to the fit, pyckett_omit is used for evaluating which parameters can be omitted.

pyckett_separatefits can be used to separate a global fit into separate fits for each state.

pyckett_uncertainties evaluates the uncertainties of the parameters.

pyckett_partitionfunction or pyckett_qrot calculates the rotational partition function for different temperatures.

pyckett_vibpartitionfunction or pyckett_qvib calculates the vibrational partition function for different temperatures.

pyckett_auto automatically builds up the Hamiltonian step by step.

pyckett_fit and pyckett_cat are shortcuts to SPFIT and SPCAT, respectively.

pyckett_pmix quickly prints the mixing coefficients of an *.egy file to identify interaction regions.

pyckett_report gives a summary of your *.lin (and *.cat) file.

pyckett_duplicates removes any duplicated entries from your *.lin file.

See the respective help functions (by adding --help after the command) to see their syntax.

Examples

You can read files from the SPFIT/SPCAT universe with the following syntax

var_dict = pyckett.parvar_to_dict(r"path/to/your/project/molecule.var")
par_dict = pyckett.parvar_to_dict(r"path/to/your/project/molecule.par")
int_dict = pyckett.int_to_dict(r"path/to/your/project/molecule.int")
lin_df = pyckett.lin_to_df(r"path/to/your/project/molecule.lin")
cat_df = pyckett.cat_to_df(r"path/to/your/project/molecule.cat")
egy_df = pyckett.egy_to_df(r"path/to/your/project/molecule.egy")

erham_df = pyckett.erhamlines_to_df(r"path/to/your/project/molecule.in")

Finalize cat file

This function merges the cat and lin dataframes, sums up duplicate values in the cat file and allows to translate quantum numbers:

fin_cat_df, fin_lin_df = pyckett.finalize(cat_df, lin_df, qn_tdict, qn)

Find candidates for double-resonance measurements

This function finds possible transition arrangements for double-resonance measurements. Input two cat dataframes with the transitions that are in the range of your probe and pump source.

results_df = pyckett.get_dr_candidates(cat_df1, cat_df2)

Check Crossings

pyckett.check_crossings(egy_df, [1], range(10))

Plot Mixing Coefficients

pyckett.mixing_coefficient(egy_df, "qn4 == 1 and qn2 < 20 and qn1 < 20 and qn1==qn2+qn3")

Metadata

Release files for pyckett 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyckett 0.2.2
File Size Uploaded Provenance
pyckett-0.2.2.tar.gz 1.8 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for pyckett 0.2.2
File Interpreter ABI Platform
pyckett-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 3.6 MB

Release files / pyckett-0.2.2.tar.gz

Download URL pyckett-0.2.2.tar.gz
Size 1.8 MB
Tags Source
SHA-256 checksum
How to use checksums
bb00c9b6c99765f7b82cc304aa318aa8c004f2df83d93cd369b59a340b34e9a2
BLAKE2b-256 checksum
How to use checksums
3c283eeaafb97654d6279634ed66da2b86805cec6df539c33ffdb053c2f57acc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.13.0

Release files / pyckett-0.2.2-py3-none-any.whl

Download URL pyckett-0.2.2-py3-none-any.whl
Size 1.8 MB
Tags Python 3
SHA-256 checksum
How to use checksums
770e9c531ffda4119e4cb9bfadeba357947c7f88f0454db8183fbad6f2779877
BLAKE2b-256 checksum
How to use checksums
4b045a5a21c740ba97774a154aefbf320e5ba04a5be08c6600a01401bb253229
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.0.1 CPython/3.13.0

Security for pyckett 0.2.2

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.

Release history Release notifications | RSS feed

This release

0.2.2 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