Release 0.4.0

Release 0.4.0 is a feature release:

• Added:

  • 2D amplitude detuning analysis and 3D plotting of the results
  • Converter for amp.det. analysis from bbs to omc3
  • general typehinting/doc/unification of entrypoint parameters/saving

• Fixed:

  • Switched action-tune planes in ampdet-kick file header-names
  • Deprecated way of pandas indexing (.loc for nearest points)
  • Allow different sized kick-files for amp.det. analysis

  All changes: 0.3.0...0.4.0

Release 0.3.0

Release 0.3.0 comes with a new script.

• Added:
  • The omc3.scripts.linfile_clean script, which allows one to perform cleaning of TFS linfiles output by harpy, and potentially reverting the changes.

What's Changed

• Quick clean by @JoschD in #376

Full Changelog: 0.2.7...0.3.0

Release 0.2.7

Release 0.2.7 is an addition but will count as a patch release since it is here to fix some issues for the coupling server.

• Added:
  • There is now an option, coupling_pairing, for the BPM pairing in coupling calculation, to let the user choose the number of BPMs instead of the usual "best candidate" method.

What's Changed

• add coupling pairing option by @awegsche and @fsoubelet in #371

Full Changelog: 0.2.6...0.2.7

Release 0.2.6

Release 0.2.6 is a patch release.

• Fixed:
  • Only perform index merging on the NAME column during coupling calculation. This solves an (at the moment) un-understood issue where some BPMs would have different S values in different files.

What's Changed

• remove S intersection while merging in coupling by @awegsche in #368

Full Changelog: 0.2.5...0.2.6

Release 0.2.5

Release 0.2.5 is a patch release.

Fixed:

• An additionnal knob and macros definition file has been added to reflect the knobs used by OP in the LHC Run 3. This makes sure any omc3.model_creator run for the LHC with year >= 2022 has correct knobs.

Full Changelog Since 0.2.4: 0.2.4...0.2.5

Release 0.2.4

Release 0.2.4 is a patch release.

In this patch, the jpype1 package is not a default dependency anymore, and is instead included as a dependency in the cern and test extras. Its import is mocked where needed in omc3.

Release 0.2.3

Release 0.2.3 is a patch release:

• Fixed:
  • The coupling calculation now includes additional columns in the output dataframes, which were missing while being needed later on by the correction calculation.

Release 0.2.2

Release 0.2.2 is a patch release.

• Fixed:
  • Sequences for K-Modulation are now properly included in the files package when installing from PyPI.
  • Default errors in K-Modulation are now properly taken into account

Release 0.2.1

This is a dummy release for Zenodo to pick up the .zenodo.json configuration file and create a DOI for the package.

No functionality has changed since omc3 v0.2.0.

First Release - omc3 v0.2.0

This is the first published release of omc3 to Github and PyPI! Find the documentation at https://pylhc.github.io/omc3/

Please note that since the codes have been used before this release, and to keep things consistent with the logging of algorithms versions, the version number is 0.2.0.

Version 0.2.0 comes with the following functionality out of the box:

Main Functionality:

• Optics models creation for various accelerators (omc3.model_creator module)
• Frequency and optics analysis from turn by turn BPM data (omc3.hole_in_one module)
• Full response files creation for futher correction of a given accelerator (omc3.response_creator module)
• Global corrections calculation for a given accelerator (omc3.global_correction module)
• K-Modulation analysis returning optics functions (omc3.run_kmod module)
• Amplitude detuning analysis with tune correction (omc3.amplitude_detuning_analysis module)
• BPM turn by turn files convertion to SDDS data format with noise, averaging and mode (omc3.tbt_converter module )
• MAD-X scripts and commands wrapping (omc3.madx_wrapper module)

Utility Scripts:

• Merging K-Modulation results of different IPs into a single file, with luminosity imbalance (omc3.scripts.merge_kmod_results module)
• Creating a fake measurement file from an optics model's TWISS output (omc3.scripts.fake_measurement_from_model module)
• MAD-X tracking macros generation with observation points from a twiss file (omc3.scripts.write_madx_macros module)
• Conversion of old BetaBeat.src analysis results to the new codes' format (omc3.scripts.betabeatsrc_output_converter module)
• Natural tune columns updating in .lin* files from peak detection (omc3.scripts.update_nattune_in_linfile module)

Plotting Functionality:

• General purpose TFS files plotting (omc3.plotting.plot_tfs module)
• Optics measurements plotting (omc3.plotting.plot_optics_measurements module)
• Amplitude detuning analysis plotting (omc3.plotting.plot_amplitude_detuning module)
• Spectrum plotting (omc3.plotting.plot_spectrum module)
• LHC BBQ analysis plotting (omc3.plotting.plot_bbq module)

We welcome feedback from our users.