Welcome to PyhDToolkit’s Documentation!

This package is an all-in-one collection of baseline utilities I use in my PhD work. Most of the codes here have their use in my day-to-day work, but not necessarily in our team’s softwares.

Highlights

  • Conveniently control MAD-X simulations through the cpymad package.

  • Easily plot results of simulations (surveys, lattices, optics functions, phase space, etc).

  • Enjoy data-validated pydantic models of results.

  • Perform mathematical analysis of simulation data.

  • Manage contexts, configurations and logging.

  • Monitor HTCondor jobs.

Useful Quick Links
Getting Started

Check out the quickstart guide, an introduction to the package’s main contents and concepts.

Quickstart

Examples

Access various tutorials showcasing the capabilities of the package, including plots.

Gallery

API Reference

A detailed description of how the methods work and which parameters can be used.

API Reference

Bibliography

A compilation of the various papers referenced throughout this documentaion.

Reference bibliography

Installation

PyhDToolkit is available to install from PyPI or from VCS. Install the package from PyPI:

python -m pip install pyhdtoolkit

To set up a development environment, see the contributing instructions.

Contents

Citing

If you have a use of these codes, please consider citing them. The repository has a DOI provided by Zenodo, and all versions can be cited with the following BibTeX entry:

@software{pyhdtoolkit,
  author       = {Felix Soubelet},
  title        = {fsoubelet/PyhDToolkit},
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.4268804},
  url          = {https://doi.org/10.5281/zenodo.4268804}
}

Acknowledgments

The following people have contributed to the development of PyhDToolkit by contributing code, documentation, comments and/or ideas:

License

The package is licensed under the MIT license.

Indices and tables