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.3.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.3-cp313-cp313-win_amd64.whl (724.1 kB view details)

Uploaded CPython 3.13Windows x86-64

lightwin-0.11.3-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.3-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.3-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.3-cp313-cp313-macosx_11_0_arm64.whl (728.4 kB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

lightwin-0.11.3-cp313-cp313-macosx_10_13_x86_64.whl (736.8 kB view details)

Uploaded CPython 3.13macOS 10.13+ x86-64

lightwin-0.11.3-cp312-cp312-win_amd64.whl (724.0 kB view details)

Uploaded CPython 3.12Windows x86-64

lightwin-0.11.3-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.3-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.3-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.3-cp312-cp312-macosx_11_0_arm64.whl (729.2 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

lightwin-0.11.3-cp312-cp312-macosx_10_13_x86_64.whl (738.0 kB view details)

Uploaded CPython 3.12macOS 10.13+ x86-64

File details

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

File metadata

  • Download URL: lightwin-0.11.3.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.3.tar.gz
Algorithm Hash digest
SHA256 36b9536c3ba9e0ddbf5614d652fd756037682b61de88d846b4a83a142661352d
MD5 a94363f95e9688330ef380122bb88c1e
BLAKE2b-256 1140885c5a59ce54e9b843bbf6df2a97f6818b20ca61cefecc272cf669f66de8

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3.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.3-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: lightwin-0.11.3-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 724.1 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.3-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 d6e2c7a57627d28245c6bb90f54d694a72304bf5a8dc6885a232ca7e832eae20
MD5 80d06da2344b70cdf390aee71ce4e7d0
BLAKE2b-256 f71612afea7918491079ef4788e549834fd5d669ba90a921d14d0fe76d5e9073

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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.3-cp313-cp313-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.3-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 9f2916d4554f30e36f89eee5b61f80b2854a12b352d14239c68df3d90c442829
MD5 befbc259de11fd983740b53113b8f3d3
BLAKE2b-256 cb209b03d83f722705ec4161c3cec661d8dad2250c29bd7f7c8376a5e21bccc5

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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.3-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.3-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 6e0cb5b712bcbb628805a15d06360f5085016c33ceb5770ec07f56d2ac941372
MD5 906aaffac6db1ef6ba410b482231fe03
BLAKE2b-256 f8c12e062d43afeb3012726f2a9cdf87524c7e8dcb877260a02619e9b667dbab

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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.3-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.3-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 336950c9dbd9fd6eaac8f15bfc297f7c10b2e59ffd4c4be6a56a1c2dd5aa6b1e
MD5 0c69faee1962d28002f90e4054c8dfcc
BLAKE2b-256 7bc7dce582ce3fa5a0311cc9a793f8a5f269b09f51add0524d2fafbdcf74e0fe

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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.3-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.3-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 4ce0c5ca4f5969963ead565b9bdda8e2fe791066a1c644a830e97c2b7b5bab1d
MD5 404f87e875e5b5022e5d81867b652cbc
BLAKE2b-256 3f212a2145a6ac24f9f8122ecece5974c5b532b0a97d14ceb4c338193d1bc6ae

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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.3-cp313-cp313-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.3-cp313-cp313-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 83baf816311e8723912bf311cf790e2f0cce15f32c73b14416436e74234fa06f
MD5 db7c1db8baaf586238b9e3090e1eca99
BLAKE2b-256 150b761c9f2b6ba3ebdfc294e19cc03378aeeef118d9579d63f6842dbfb3e3f0

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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.3-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: lightwin-0.11.3-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 724.0 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.3-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 84d9e9f73778144e697583efe9b85802343c0bf49bd0719557d2430bf2d38047
MD5 143100271cb18c7f17bcd5f1f8053d4f
BLAKE2b-256 03b845a80707c61aa879a8739bf310a45a944aea5b131c53af9ef1faf60b9fe2

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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.3-cp312-cp312-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.3-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 f0eb9436c42ed81ffc7dd5b3a689627912aac07eebbeca53ba252c1962a24011
MD5 e03fa0cee36c9b6afeb05e97e068a06b
BLAKE2b-256 d8d042dd10c0cd20ba0c3d934a3b62a2cbfd1f0df86a8b53730aa648acfda2b3

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 e9fe1da819db8dd46a7ffbb318aa792c9f1134247d848c2a692462ec8521a47c
MD5 45825667118211ed474a3f048654341e
BLAKE2b-256 a59f0ef801cc66d94b0a23110cacf39df8807f80b3cc440ddd219613e3885791

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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.3-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.3-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 b0fc5acb37352830cd628398e23cdaa40a1a35a43f565453d56c402890332089
MD5 706da80f071dee435517a575b6739229
BLAKE2b-256 061b79f945ef21d533e24fbb158fc81bbf058247ad094519120daf7b8c1387c9

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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.3-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.3-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 ba104f0f6a5da56b9eeb8da6be62009a7706835a38d6e1f6d1c4ade7e29b0f59
MD5 fd59a9674a0e42cb9eaf241c6d84ab9d
BLAKE2b-256 9a5c2a990729b7811318ef42c7534a3e24c2770fbc960d7b0cb36be1c07afd6d

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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.3-cp312-cp312-macosx_10_13_x86_64.whl.

File metadata

File hashes

Hashes for lightwin-0.11.3-cp312-cp312-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 5dcdb71215d8bcab16ac9c0a66ac5b4540dcb7d3d85ae1d725b8bb6a42047d3e
MD5 ec110bd450aa87a6f787f2ae0f7dd6f7
BLAKE2b-256 cd70ac72d5291cc202be63580d5bbe3196937c6b317f56df03cd9af481401fc9

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightwin-0.11.3-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