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

Uploaded CPython 3.13Windows x86-64

lightwin-0.11.2-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.2-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.2-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.2-cp313-cp313-macosx_11_0_arm64.whl (725.8 kB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

lightwin-0.11.2-cp313-cp313-macosx_10_13_x86_64.whl (734.2 kB view details)

Uploaded CPython 3.13macOS 10.13+ x86-64

lightwin-0.11.2-cp312-cp312-win_amd64.whl (721.4 kB view details)

Uploaded CPython 3.12Windows x86-64

lightwin-0.11.2-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.2-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.2-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.2-cp312-cp312-macosx_11_0_arm64.whl (726.6 kB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

lightwin-0.11.2-cp312-cp312-macosx_10_13_x86_64.whl (735.4 kB view details)

Uploaded CPython 3.12macOS 10.13+ x86-64

File details

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

File metadata

  • Download URL: lightwin-0.11.2.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.2.tar.gz
Algorithm Hash digest
SHA256 21f670fe3e950b5810ec136d38c02227ce91c31fa822cce554e068dd7fbe89bd
MD5 460b69630811d1df8095ac19f49c40e9
BLAKE2b-256 67ea996ba89fe4ac57e0fa3047b65425ece8d5602cc0705293235b8e07a5b525

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: lightwin-0.11.2-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 721.5 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.2-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 bbd6d5ab2f0b102b95abbdf2c181c054c2b5131aaa68df03ec561ed1bb0b00cf
MD5 5c0e1677c9db6cb4db99cc3259163227
BLAKE2b-256 5f90eeb39d823d4800cc5a9f74fea4f769df1054518fe0631f2dce7c28a09612

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for lightwin-0.11.2-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 dec6455d5876b0cba85edc2520d329892a9a892d273b082ca040e6d8931ae236
MD5 07f4865d9c2a8d7c325bc40f120a4653
BLAKE2b-256 fbaf9ed653beb576b3fb7ab2a356873943658e1623e55934325e6150c0c6c001

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for lightwin-0.11.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 53f0f111258fc355ff3649a661118032dc70fb7bbf70565b906a858ef1d6ade4
MD5 ead7064f2fac2ea850e407cbf66d0e23
BLAKE2b-256 f06636f8914b27ebaa70adc722a09ca6516aa610f891799a92f2716387276f42

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for lightwin-0.11.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 1c4f7a80ddc6dcc9be99a6c92479f1aa35eaa088706c1620ab018e81710114de
MD5 3921dadcbb39ba325510c0935849eb9a
BLAKE2b-256 e73376551323396c8a0e5cef36e1d1298419f8651085da905e731d8dfc3dc248

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for lightwin-0.11.2-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 a696426e051a9d56cbae49cf5fb27cf59fdf41a8223c8f95c02c0bcde1c11539
MD5 ae8c88cb236c795c0307633d6c0396b3
BLAKE2b-256 a334e36ede8acf314e9269c11e5d8a590b6c07bc313bcc8c7a785341c617f20f

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for lightwin-0.11.2-cp313-cp313-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 ee15c7415078a260c4234d4c17db6eaf171161925fc748b4f22c390e53cf36cb
MD5 dfe65ce5721d43ad72b648521c939845
BLAKE2b-256 eed842a3a51d1e342b401b72a37fc47b326e2978973d1a4b3f520ff790ae26e4

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: lightwin-0.11.2-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 721.4 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.2-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 6dd9454167f5544700052789b20d3f5738706d5581972e69bb4d8ef1ccd4f29a
MD5 f5f843c7fb99174f74c7b3409558fc23
BLAKE2b-256 41ea192ce869c3713c3974a68baedd54c2b5bb3d367dab62d010edafa68deed1

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for lightwin-0.11.2-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 3d9b59ca87705921af4454b2aeaad3fe74052df39453550d6b07c4aedfc1b7de
MD5 6bb000ef81d73739efc05ff26dd5ef97
BLAKE2b-256 0afb0324bb6bc0fd62a235ec9a2626fa33c6c6c9651f3ab45bfb67ed18e792c8

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for lightwin-0.11.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 ab6bccc90bff1e831c70c8000adbefae3071d5aaac609f2e95b972441f70fd14
MD5 ec362f3403ee0cbad7be1ba0c181caf0
BLAKE2b-256 43e04726ac560798a24ad6a3de6769828cd51a20522472f1c9237c2831fe8ba8

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for lightwin-0.11.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 883e74aaa3af80ad28878cfb07f21de339b36ef62dc0f47a6122900a13abedd2
MD5 c6d9942dec11b6967532d4dd25aa6ab6
BLAKE2b-256 6722b15d72ecf1b4369a87400eb21488b8d5da352855a6b1b08b8ef4888a3fcf

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for lightwin-0.11.2-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 af35b2b00a5cd80191c06b62a5d4b576062a4b25fe4eb2ef124bb5a649f4bc09
MD5 6fa3f526c59907f39e2937745cf5fcac
BLAKE2b-256 40c9233f4ce08d5f79936521949b31259139214653c34fa4a8014800b9d863d4

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for lightwin-0.11.2-cp312-cp312-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 9865919d3a58cce4631e8a4a4e98915ae5e4f062ec6d6ed60ddbbb301aeb7410
MD5 eaed5638a7b4d7b609b431817ce16ab6
BLAKE2b-256 e0551b0bd325029c098ead1ae6b641a1a7872a5670fbcc352dc207dbdc2af701

See more details on using hashes here.

Provenance

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