You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+20-11Lines changed: 20 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@
10
10
This is the python-tool package of the Optics Measurements and Corrections team (OMC) at CERN.
11
11
12
12
Most of the codes are generic and not limited to CERN accelerators, and the package can easily be used for your favorite circular accelerator.
13
-
To see how to adapt this for your machine, see our [documentation](https://pylhc.github.io/omc3/), `Model` section.
13
+
To see how to adapt this for your machine, see our [documentation](https://pylhc.github.io/omc3/), `Model` section.
14
14
To contribute, see [our guidelines](https://pylhc.github.io/packages/development/contributing/) on the OMC website.
15
15
16
16
## Documentation
@@ -20,26 +20,27 @@ To contribute, see [our guidelines](https://pylhc.github.io/packages/development
20
20
21
21
## Installing
22
22
23
-
Installation is easily done via `pip`:
23
+
The package is deployed on `PyPI` and can easily be installed via `pip`:
24
24
25
-
```
26
-
pip install omc3
25
+
```bash
26
+
python -m pip install omc3
27
27
```
28
28
29
+
For development purposes, we recommend creating a new virtual environment and installing from VCS in editable mode with all extra dependencies (`cern` for packages only available in the CERN GPN, `test` for `pytest` and relevant plugins, and `doc` for packages needed to build documentation).
29
30
30
-
For development purposes, we recommend creating a new virtual environment and installing from VCS in editable mode with all extra dependencies (`cern` for packages only available in the CERN GPN, `test` for `pytest` and relevant plugins, and `doc` for packages needed to build documentation)
31
31
```bash
32
32
git clone https://github.com/pylhc/omc3
33
-
pip install --editable "omc3[all]"
33
+
python -m pip install --editable "omc3[all]"
34
34
```
35
35
36
-
Codes can then be run with either `python -m omc3.SCRIPT --FLAG ARGUMENT` or calling the `.py` file directly.
37
-
38
36
## Functionality
39
37
40
-
#### Main Scripts
38
+
Codes can then be run with either `python -m omc3.SCRIPT --FLAG ARGUMENT` or calling the `.py` file directly.
39
+
40
+
<details> <summary><b>Main Scripts</b></summary>
41
41
42
42
Main scripts to be executed lie in the [`/omc3`](omc3) directory. These include:
43
+
43
44
-`hole_in_one.py` to perform frequency analysis on turn by turn BPM data and infer optics (and more) for a given accelerator.
44
45
-`kmod_importer.py` to average, import and calculate lumi-imbalace K-modulation results.
45
46
-`knob_extractor.py` to extract from `NXCALS` the value of given knobs in the machine at a given time.
@@ -50,19 +51,25 @@ Main scripts to be executed lie in the [`/omc3`](omc3) directory. These include:
50
51
-`amplitude_detuning_analysis.py` to perform amp. det. analysis on optics data with tune correction.
51
52
-`madx_wrapper.py` to start a `MAD-X` run with a file or string as input.
Plotting scripts for analysis outputs can be found in [`/omc3/plotting`](omc3/plotting):
59
+
56
60
-`plot_spectrum.py` to generate plots from files generated by frequency analysis.
57
61
-`plot_bbq.py` to generate plots from files generated by BBQ analysis.
58
62
-`plot_amplitude_detuning.py` to generate plots from files generated by amplitude detuning analysis.
59
63
-`plot_optics_measurements.py` to generate plots from files generated by optics_measurements.
60
64
-`plot_tfs.py` all-purpose tfs-file plotter.
61
65
-`plot_kmod_results.py` to plot the beta and waist of the K-modulation results.
62
66
63
-
#### Other Scripts
67
+
</details>
68
+
69
+
<details> <summary><b>Other Scripts</b></summary>
64
70
65
71
Other general utility scripts are in [`/omc3/scripts`](omc3/scripts):
72
+
66
73
-`update_nattune_in_linfile.py` to update the natural tune columns in the lin files by finding the highest peak in the spectrum in a given interval.
67
74
-`write_madx_macros.py` to generate `MAD-X` tracking macros with observation points from a TWISS file.
68
75
-`merge_kmod_results.py` to merge LSA results files created by kmod, and add the luminosity imbalance if the 4 needed IP/Beam files combination are present.
@@ -77,6 +84,8 @@ Other general utility scripts are in [`/omc3/scripts`](omc3/scripts):
77
84
Example use for these scripts can be found in the [`tests`](tests) files.
78
85
Documentation including relevant flags and parameters can be found at <https://pylhc.github.io/omc3/>.
79
86
87
+
</details>
88
+
80
89
## License
81
90
82
91
This project is licensed under the `MIT License` - see the [LICENSE](LICENSE) file for details.
0 commit comments