Skip to main content

Automatically compensate cavity failures in linacs

Project description

Py versions PyPi Pytest Documentation status pre-commit.ci status License: MIT Code style: black Imports: isort

LightWin

LightWin is a tool to automatically find compensation settings for cavity failures in linacs.

Installation

The full installation instructions are detailed here.

The steps are straightforward and can be summarized as follows:

  1. Create a dedicated Python environment.
  2. Run pip install lightwin

If you want to edit the source code:

  1. Clone the repository: git clone git@github.com:AdrienPlacais/LightWin.git

[!WARNING] If you Download ZIP this repository (which can happen if you don't have access to git), installation will fail at step #3. A workaround is proposed in the documentation.

  1. Create a dedicated Python environment.
  2. From LightWin folder: pip install -e .[test]
  3. Test that everything is working with pytest -m "not tracewin and not implementation".

[!NOTE] If you are completely new to Python and these instructions are unclear, check this tutorial. In particular, you will want to:

  1. Install Python 3.12 or higher.
  2. Learn to use Python environments, pipenv or virtualenv.
  3. Install a Python IDE such as Spyder or VSCode.

[!NOTE] Note that the TraceWin module will not work out of the box. You will need to tell LightWin were to find your TraceWin executables. See dedicated instructions.

Documentation

Documentation is now automatically built and hosted on Read the docs.

How to run

See here.

Example

See the data/example folder.

Future updates

BeamCalculator

  • Beam calculator developed by JM Lagniel for SPIRAL2.
  • Envelope solvers with space-charge.

Quality of life

  • Plotter object.
  • Friendlier Evaluator.
  • Support for SET_SYNC_PHASE (see note).
  • Better handling of TraceWin errors (currently: a single error and whole run is lost).

Optimization

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lightwin-0.11.4.tar.gz (4.0 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

lightwin-0.11.4-cp313-cp313-win_amd64.whl (724.7 kB view details)

Uploaded CPython 3.13Windows x86-64

lightwin-0.11.4-cp313-cp313-musllinux_1_2_x86_64.whl (1.3 MB view details)

Uploaded CPython 3.13musllinux: musl 1.2+ x86-64

lightwin-0.11.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.3 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64

lightwin-0.11.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.3 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ ARM64

lightwin-0.11.4-cp313-cp313-macosx_11_0_arm64.whl (728.9 kB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

lightwin-0.11.4-cp313-cp313-macosx_10_13_x86_64.whl (737.3 kB view details)

Uploaded CPython 3.13macOS 10.13+ x86-64

lightwin-0.11.4-cp312-cp312-win_amd64.whl (724.6 kB view details)

Uploaded CPython 3.12Windows x86-64

lightwin-0.11.4-cp312-cp312-musllinux_1_2_x86_64.whl (1.3 MB view details)

Uploaded CPython 3.12musllinux: musl 1.2+ x86-64

lightwin-0.11.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.3 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

lightwin-0.11.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.3 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ ARM64

lightwin-0.11.4-cp312-cp312-macosx_11_0_arm64.whl (729.8 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

lightwin-0.11.4-cp312-cp312-macosx_10_13_x86_64.whl (738.6 kB view details)

Uploaded CPython 3.12macOS 10.13+ x86-64

File details

Details for the file lightwin-0.11.4.tar.gz.

File metadata

  • Download URL: lightwin-0.11.4.tar.gz
  • Upload date:
  • Size: 4.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for lightwin-0.11.4.tar.gz
Algorithm Hash digest
SHA256 ac418430d7f447260c489861ae147d28a81dc18a2a5c62d627f553ed1a2f73b4
MD5 d72e5a75491327b1f929c95e7155edae
BLAKE2b-256 5cc69efe25e20aed8b2ac7a1b34091e5df986fdc03a80869e4e603e6f7263c47

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4.tar.gz:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: lightwin-0.11.4-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 724.7 kB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for lightwin-0.11.4-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 89b3c48240710d526e8cecb765504caa82a64ab6dbfdabd69461a245475c3f40
MD5 60cd8c951d1fa346f62a3df297649207
BLAKE2b-256 29de22346b8e0130ca97fb58e47ab8c48c92be1d11755c6c3c9373e15c202a66

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp313-cp313-win_amd64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp313-cp313-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.4-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 d9bdecabd699aae75c975ec74ec4c2bf7f61382d092385bc282b53fc0264d30a
MD5 9f58ef4d74ff17e8807aa5ce8fff237a
BLAKE2b-256 923b8fe466539ff7d1284acd4c1ffe2b09e591412ee0dff2a21d780582495c6d

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp313-cp313-musllinux_1_2_x86_64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 3f8b5bfb1954e46199bd652532108f0bc7851cb5e0c4128fbe0343ecc17cb958
MD5 30d916161f4dfa58329ac087078ac9bf
BLAKE2b-256 244bae286be279eedaec6e1a2f7b4647cb862c03e9b7fb02b6ee9250a2b08bca

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 e3408dd17f9cf1c28cfa9c8b6c32286706ba2c13c402a77e43f396420bbe3acc
MD5 fb37259fd5cc07e7595282ca44756e8f
BLAKE2b-256 16ef0cbea0ba993555dc2c87cf54cefc04022609a78ff0366ab38bcb9805562c

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.4-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 9dc8f3eead499f504584efbf84cfbc8967c6c87280985686355baca365ff3a4e
MD5 607e5b9e700d8f1413729ff6be8b3fbc
BLAKE2b-256 79521c1fc7468bdfd82741a45e662e20333cb99fbc204b55edb0dc984ed0f0a9

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp313-cp313-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.4-cp313-cp313-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 5b7147a5d73c17d052245c72e0e6bd5f2e1dcad727ddd06de24bf1671fe112cc
MD5 0964d35ad51fa628fc33867b09bdd2e9
BLAKE2b-256 937bb8b57c1ae1c69b27c93d03bbf110839c5407d0f613f952de0d3b9ae661b0

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp313-cp313-macosx_10_13_x86_64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: lightwin-0.11.4-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 724.6 kB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for lightwin-0.11.4-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 8362c299c4daf3084f6c382d8356ccff5dc422c5db49552243122dd31c7dc6c4
MD5 00f1e47a61f163489a78907c6468ef50
BLAKE2b-256 138ed5b3f670741420a29d975bb26ee62d98da9f2ce1782e25bb46ea5769746d

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp312-cp312-win_amd64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp312-cp312-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.4-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 0110b4b587ecc7664a700a1471493770de23a529cf6e7eb92a9c480fe87f4455
MD5 369496496317145eb7168db4b023b6b4
BLAKE2b-256 68cba783c8c03f6e00c427d757780b70a40bf55767c6ce5cd9d35529e5fe60a9

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp312-cp312-musllinux_1_2_x86_64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 9bebd7c4e10c5522ce8f2ffc0321b3150862632101d53fa53d5c910a34c78abe
MD5 4bb18b68a8b6f1c7e8cc46acc1403fdb
BLAKE2b-256 0b9ada9a380b358730be05ffffcdc68e37a355a4c18a431370e21659c070220b

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 316e76364b3dfc479e90be8985cfa1634809869a6802466a148e8177b2e53e89
MD5 9142cfb2607ebc030b5db6f1d7d707b2
BLAKE2b-256 9a36ed1d990d5f06eb4f9ef4170455e637085d82fc7f41724921d1704a64d6b8

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.4-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e39249aaf93a00295948c28b28cbfb72a5dfa1222dd1a0c54b410c7ba22a6aa7
MD5 7806a064d20803bc2d12609c8f969174
BLAKE2b-256 b8a41d8d5c2dd1be082837d1e9ca6860f24b16278f09a4d08bda56a6128266d3

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightwin-0.11.4-cp312-cp312-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.4-cp312-cp312-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 55e8a8b84146ff75239073548c3c0243e52637a8ec3b8ee3bb0d0d4dc7f34881
MD5 f0506a1c207edf5fcb163a0a78eb37c6
BLAKE2b-256 90d85b418bb62dd76a82867e761c71a928479fd9b61ccc6e4f6859661b8dc792

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.4-cp312-cp312-macosx_10_13_x86_64.whl:

Publisher: release.yml on AdrienPlacais/LightWin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page