LightWin
LightWin is a tool to automatically find compensation settings for cavity failures in linacs.
Installation
The full installation instructions are detailed in the documentation.
The steps are straightforward and can be summarized as follows:
Users
- Create a dedicated Python environment.
- Run
pip install lightwin[cython]
Developers
- Clone the repository:
git clone git@github.com:AdrienPlacais/LightWin.git
[!WARNING] If you
Download ZIPthis repository (which can happen if you don't have access togit), installation will fail at step #3. A workaround is proposed in the documentation.
- Create a dedicated Python environment.
- From LightWin folder:
pip install -e .[test, cython] - 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:
- Install Python 3.12 or higher.
- Learn to use Python environments,
pipenvorvirtualenv.- 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 documentation.
Example
See the data/example folder.
1 maintainer
Release files for LightWin 0.16.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| lightwin-0.16.5.tar.gz | 1.0 MB | Details |
Built distributions (wheels)
Total release size: 27.1 MB
Release files / lightwin-0.16.5.tar.gz
| Download URL | lightwin-0.16.5.tar.gz |
|---|---|
| Size | 1.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
715c334c03f7e90c5fa67759ff1b977bf5cf7a8932717f07871ec046a66ee00b
|
|
BLAKE2b-256 checksum How to use checksums |
39dbe40a715c4a149d245667f36adfa71f6978066ec3f6445d2b39fc6ea105cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp314-cp314-win_amd64.whl
| Download URL | lightwin-0.16.5-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3506fae9a1e1b311713488b27c1cf43ce61edbb70f2a875f30ad47a97e91a37d
|
|
BLAKE2b-256 checksum How to use checksums |
75eab2e3d20fa509c2356b250ac4ffd1c53d621350227b9ee97616efbad95257
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp314-cp314-musllinux_1_2_x86_64.whl
| Download URL | lightwin-0.16.5-cp314-cp314-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.14 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
d41ab02eca565366afca39a493912619120401f37895baaa207ccc5c836e6818
|
|
BLAKE2b-256 checksum How to use checksums |
3c78abe4a095b9cc2f7c2cd162a9881ebc6dad0f89eb84b51073954d7884b847
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | lightwin-0.16.5-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
9b251f40d0f847ffd93fd715c465ca3c19bbfc8efd09968c14993bcbd436950d
|
|
BLAKE2b-256 checksum How to use checksums |
115b30eb0c5f03d9cdca7268e1edcd2d221eb97a81d916cd399d576ebf86b874
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | lightwin-0.16.5-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
6fc7f1641870d8f15217f2a515a81081de813d0e0e59f533f27b41fce34565fc
|
|
BLAKE2b-256 checksum How to use checksums |
ec0120d1ce886b5f438143b3a13b19bb758f0e53fa1191b66bba0eeda058313e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | lightwin-0.16.5-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
534c077bde0f4fc948902af45f2fd65b82801fe1682758f9cf5d269c2777309f
|
|
BLAKE2b-256 checksum How to use checksums |
3c6bab330f74fdc4bc1da5173a11971234b384b0b67b99fc16b9a2e9c68e2d43
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp313-cp313-win_amd64.whl
| Download URL | lightwin-0.16.5-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
54663b09a1b83d4aed9ca4b4d0d1961f20ee07eb7e11c7301b546d99dcb2cfba
|
|
BLAKE2b-256 checksum How to use checksums |
dd3b498af9a711b5afb9fbaefbb973195bccdb6e19d0550bdaa24cefca209f10
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp313-cp313-musllinux_1_2_x86_64.whl
| Download URL | lightwin-0.16.5-cp313-cp313-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.13 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
c3a99026a07708534b2cbe9a2c4c9f7863dd7534f663a7aec472660e7ca0654e
|
|
BLAKE2b-256 checksum How to use checksums |
214eda087e4cacb3839b3d4a6aaf61ad16120a7ec18e859c8d024952830c83ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | lightwin-0.16.5-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
cb023ed9e4dc137c76d88e499a0c84ce8af595c0e81547ea148f6b4edb874d60
|
|
BLAKE2b-256 checksum How to use checksums |
6ee45a7a6b1f78d1e18ae84b04ad703134dbfeb45f6684d13fbbbb8ac41db70c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | lightwin-0.16.5-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
cbb18a7b88d9fe23044a60907f65e5cd2cbbfbd74841e461605ea71b524b239a
|
|
BLAKE2b-256 checksum How to use checksums |
eb6615a134c162f4982d47f395e63c8755869041c8a90e105e0f7515cf28f71d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | lightwin-0.16.5-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a132769b9ec2edcf3fea31729d6ac72e3b57fa27782fb24dd565ccf441b8efb9
|
|
BLAKE2b-256 checksum How to use checksums |
e50829535ee952feaf55010971bd8261e651be92cf0e1588a9c5bd8589547562
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp312-cp312-win_amd64.whl
| Download URL | lightwin-0.16.5-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
5b6accaecade3c3bbf4970f918061ca0e7e82ba2c245f175dc38774ad5382b4c
|
|
BLAKE2b-256 checksum How to use checksums |
a1b084852145c810bf0168e8340f473e2bdabf7fb0e11dd0cc63b98419cdc4db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp312-cp312-musllinux_1_2_x86_64.whl
| Download URL | lightwin-0.16.5-cp312-cp312-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.12 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
dde0d197df73a6f79a8b298975fc3a9bf69cea5c3ea8adba3564ce633cc2206d
|
|
BLAKE2b-256 checksum How to use checksums |
6e4e6f29989323a50e87e18d76665f8065602121114330015e01a0942b7a451b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | lightwin-0.16.5-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
0929e9c778d92cd63703b2aefaf512970e4ceb3f8979c483e7822bd3885ef3a6
|
|
BLAKE2b-256 checksum How to use checksums |
5116ad1e32891da63ab8362bb24b3c49138a2a7bc994d14ca822d4b64b77dd58
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | lightwin-0.16.5-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 2.2 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
b01f30a1dffd95e756ed33e49848d875eaa9c0929cb6ebf8437ab7eb919be0c2
|
|
BLAKE2b-256 checksum How to use checksums |
dbaf9f529972e93acc9eb5d51a9a2434624ad6b0bdefc4d3686daf6857beba0f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / lightwin-0.16.5-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | lightwin-0.16.5-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.1 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
41439e6b7914b02519f7aee10d9a74729912400330480ae298c8f039c3c7d5b5
|
|
BLAKE2b-256 checksum How to use checksums |
0b2bc9c52c692978cd771112419319a842e5c0eb86ab614fb8173d1a80cf142d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency log
