pvplot 1.6.4__tar.gz → 1.7.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- pvplot-1.7.0/.vscode/settings.json +5 -0
- pvplot-1.7.0/PKG-INFO +120 -0
- pvplot-1.7.0/README.md +99 -0
- pvplot-1.7.0/liteaccess/__init__.py +4 -0
- {pvplot-1.6.4 → pvplot-1.7.0}/pvplot/__main__.py +1 -0
- {pvplot-1.6.4 → pvplot-1.7.0}/pvplot/pvplot.py +279 -168
- {pvplot-1.6.4 → pvplot-1.7.0}/pyproject.toml +14 -2
- pvplot-1.7.0/uv.lock +2105 -0
- pvplot-1.6.4/PKG-INFO +0 -30
- pvplot-1.6.4/README.md +0 -15
- {pvplot-1.6.4 → pvplot-1.7.0}/LICENSE +0 -0
- {pvplot-1.6.4 → pvplot-1.7.0}/config/peakSimulator_pvp.py +0 -0
- {pvplot-1.6.4 → pvplot-1.7.0}/docs/peakSimulator_pvp.png +0 -0
- {pvplot-1.6.4 → pvplot-1.7.0}/docs/pvplotx.jpg +0 -0
- {pvplot-1.6.4 → pvplot-1.7.0}/pvplot/__init__.py +0 -0
- {pvplot-1.6.4 → pvplot-1.7.0}/pvplot/cad_epics.py +0 -0
- {pvplot-1.6.4 → pvplot-1.7.0}/pvplot/cad_pvaccess.py +0 -0
- {pvplot-1.6.4 → pvplot-1.7.0}/pvplot/helptxt.py +0 -0
pvplot-1.7.0/PKG-INFO
ADDED
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: pvplot
|
|
3
|
+
Version: 1.7.0
|
|
4
|
+
Summary: Plotting tool for EPICS PVs, ADO and LITE parameters
|
|
5
|
+
Project-URL: Homepage, https://github.com/ASukhanov/pvplot
|
|
6
|
+
Project-URL: Bug Tracker, https://github.com/ASukhanov/pvplot/issues
|
|
7
|
+
Author-email: Andrey Sukhanov <cyxandr@gmail.com>
|
|
8
|
+
License-File: LICENSE
|
|
9
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
10
|
+
Classifier: Operating System :: OS Independent
|
|
11
|
+
Classifier: Programming Language :: Python :: 3
|
|
12
|
+
Requires-Python: >=3.7
|
|
13
|
+
Requires-Dist: caproto
|
|
14
|
+
Requires-Dist: liteaccess
|
|
15
|
+
Requires-Dist: numpy
|
|
16
|
+
Requires-Dist: p4p
|
|
17
|
+
Requires-Dist: pyqt5
|
|
18
|
+
Requires-Dist: pyqtgraph
|
|
19
|
+
Requires-Dist: qtpy
|
|
20
|
+
Description-Content-Type: text/markdown
|
|
21
|
+
|
|
22
|
+
# pvplot
|
|
23
|
+
|
|
24
|
+
`pvplot` is a dynamic plotting application for control-system data. It supports EPICS Channel Access (CA), EPICS PVAccess (PVA), LiteServer data objects, and ADO parameters.
|
|
25
|
+
|
|
26
|
+

|
|
27
|
+
|
|
28
|
+
## Installation
|
|
29
|
+
|
|
30
|
+
Create and activate a virtual environment, then install the package:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
python -m venv .venv
|
|
34
|
+
source .venv/bin/activate
|
|
35
|
+
python -m pip install -e .
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Run `pvplot --help` to display the command-line options.
|
|
39
|
+
|
|
40
|
+
## Basic usage
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
python -m pvplot -a 'E:testAPD:scope1:' 'Waveform_RBV[1:500]'
|
|
44
|
+
python -m pvplot -aV:image:0: 'oneRowMean oneRowStd oneRowPeak2Peak'
|
|
45
|
+
python -m pvplot -aV:image:0: oneRow[90:120]
|
|
46
|
+
python -m pvplot -a 'L:localhost:dev1:' 'temp1 temp2'
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Correlation plot — plot the parameter after the comma against the parameter before the comma:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
python -m pvplot -a 'L:localhost;9710:dev1:' 'x,y'
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Array data can be sliced using `name[start:end]`, for example `Waveform_RBV[1:500]`.
|
|
56
|
+
|
|
57
|
+
## Namespaces
|
|
58
|
+
|
|
59
|
+
Add a namespace prefix to parameter names to select an access method:
|
|
60
|
+
|
|
61
|
+
- `E:` — EPICS Channel Access
|
|
62
|
+
- `V:` — EPICS PVAccess
|
|
63
|
+
- `L:` — LiteServer, for example `L:localhost:dev1:`
|
|
64
|
+
- `A:` — ADO
|
|
65
|
+
|
|
66
|
+
## Command-line options
|
|
67
|
+
|
|
68
|
+
- `-a, --prefix` — Prefix applied to parameter names.
|
|
69
|
+
- `-c, --configDir` — Directory containing a configuration module.
|
|
70
|
+
- `-f, --file` — Configuration module name.
|
|
71
|
+
- `-l, --limit` — Maximum number of points retained per dataset.
|
|
72
|
+
- `-s, --sleepTime` — Update interval in seconds.
|
|
73
|
+
- `-v, --verbose` — Show more debug messages; use `-vv` for even more.
|
|
74
|
+
- `-x, --xscale` — LiteServer parameter providing dynamic X-axis scaling.
|
|
75
|
+
- `-X, --xrange` — Fixed X-axis range, for example `-X 10:20`.
|
|
76
|
+
- `-y, --yscale` — Parameter providing dynamic Y-axis scaling.
|
|
77
|
+
- `-Y, --yrange` — Fixed Y-axis range, for example `-Y 1000:4095`.
|
|
78
|
+
- `-z, --zoomin` — Scale the application window.
|
|
79
|
+
- `-#, --dock` — Assign parameters to named docks.
|
|
80
|
+
|
|
81
|
+
## Configuration file
|
|
82
|
+
|
|
83
|
+
Use `-c` and `-f` to load a Python configuration module:
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
python -m pvplot -c config -f peakSimulator_pvp
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
The configuration module may define `DOCKS`, `POINTS`, `TITLE`, `XLABEL`, and `YLABEL`.
|
|
90
|
+
|
|
91
|
+
## Plot controls
|
|
92
|
+
|
|
93
|
+
- Right-click a plot and select **Datasets Options** to enable/disable curves or change their color, width, and symbols.
|
|
94
|
+
- Use **Mean, sigma** to show dataset statistics.
|
|
95
|
+
- Use **Y Projection** to show a histogram of the visible Y range.
|
|
96
|
+
- Use **UnZoom** to restore the previous view range.
|
|
97
|
+
- Press `Ctrl+H` for help, `Ctrl+M` for statistics, `Ctrl+S` to stop/resume updates, or `Ctrl+U` to unzoom.
|
|
98
|
+
|
|
99
|
+
## Examples
|
|
100
|
+
|
|
101
|
+
- Two docks with an array plot and a strip chart:
|
|
102
|
+
```bash
|
|
103
|
+
python -m pvplot -c /operations/app_store/pvplot -f peakSimulator_pvp
|
|
104
|
+
```
|
|
105
|
+
- Sliced EPICS Channel Access waveform:
|
|
106
|
+
```bash
|
|
107
|
+
python -m pvplot -s 0.01 -a 'E:testAPD:scope1:' 'Waveform_RBV[1:500]'
|
|
108
|
+
```
|
|
109
|
+
- EPICS PVAccess waveform for `python -m epicsdev.imagegen -r30:
|
|
110
|
+
```bash
|
|
111
|
+
python -m pvplot -aV:image:0: -#0'oneRow' -#1'oneRowMean oneRowStd oneRowPeak2Peak'
|
|
112
|
+
```
|
|
113
|
+
- LiteServer correlation plot:
|
|
114
|
+
```bash
|
|
115
|
+
python -m pvplot -s 0.01 -a 'L:localhost;9710:dev1:' 'x,y'
|
|
116
|
+
```
|
|
117
|
+
- LabJack U3-HV analog inputs served by LiteServer:
|
|
118
|
+
```bash
|
|
119
|
+
python -m pvplot -a 'L:localhost:dev1:' 'tempU3 ADC_HV[0] ADC_HV[1] ADC_HV[2] ADC_HV[3] ADC_LV'
|
|
120
|
+
```
|
pvplot-1.7.0/README.md
ADDED
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
# pvplot
|
|
2
|
+
|
|
3
|
+
`pvplot` is a dynamic plotting application for control-system data. It supports EPICS Channel Access (CA), EPICS PVAccess (PVA), LiteServer data objects, and ADO parameters.
|
|
4
|
+
|
|
5
|
+

|
|
6
|
+
|
|
7
|
+
## Installation
|
|
8
|
+
|
|
9
|
+
Create and activate a virtual environment, then install the package:
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
python -m venv .venv
|
|
13
|
+
source .venv/bin/activate
|
|
14
|
+
python -m pip install -e .
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Run `pvplot --help` to display the command-line options.
|
|
18
|
+
|
|
19
|
+
## Basic usage
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
python -m pvplot -a 'E:testAPD:scope1:' 'Waveform_RBV[1:500]'
|
|
23
|
+
python -m pvplot -aV:image:0: 'oneRowMean oneRowStd oneRowPeak2Peak'
|
|
24
|
+
python -m pvplot -aV:image:0: oneRow[90:120]
|
|
25
|
+
python -m pvplot -a 'L:localhost:dev1:' 'temp1 temp2'
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Correlation plot — plot the parameter after the comma against the parameter before the comma:
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
python -m pvplot -a 'L:localhost;9710:dev1:' 'x,y'
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Array data can be sliced using `name[start:end]`, for example `Waveform_RBV[1:500]`.
|
|
35
|
+
|
|
36
|
+
## Namespaces
|
|
37
|
+
|
|
38
|
+
Add a namespace prefix to parameter names to select an access method:
|
|
39
|
+
|
|
40
|
+
- `E:` — EPICS Channel Access
|
|
41
|
+
- `V:` — EPICS PVAccess
|
|
42
|
+
- `L:` — LiteServer, for example `L:localhost:dev1:`
|
|
43
|
+
- `A:` — ADO
|
|
44
|
+
|
|
45
|
+
## Command-line options
|
|
46
|
+
|
|
47
|
+
- `-a, --prefix` — Prefix applied to parameter names.
|
|
48
|
+
- `-c, --configDir` — Directory containing a configuration module.
|
|
49
|
+
- `-f, --file` — Configuration module name.
|
|
50
|
+
- `-l, --limit` — Maximum number of points retained per dataset.
|
|
51
|
+
- `-s, --sleepTime` — Update interval in seconds.
|
|
52
|
+
- `-v, --verbose` — Show more debug messages; use `-vv` for even more.
|
|
53
|
+
- `-x, --xscale` — LiteServer parameter providing dynamic X-axis scaling.
|
|
54
|
+
- `-X, --xrange` — Fixed X-axis range, for example `-X 10:20`.
|
|
55
|
+
- `-y, --yscale` — Parameter providing dynamic Y-axis scaling.
|
|
56
|
+
- `-Y, --yrange` — Fixed Y-axis range, for example `-Y 1000:4095`.
|
|
57
|
+
- `-z, --zoomin` — Scale the application window.
|
|
58
|
+
- `-#, --dock` — Assign parameters to named docks.
|
|
59
|
+
|
|
60
|
+
## Configuration file
|
|
61
|
+
|
|
62
|
+
Use `-c` and `-f` to load a Python configuration module:
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
python -m pvplot -c config -f peakSimulator_pvp
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
The configuration module may define `DOCKS`, `POINTS`, `TITLE`, `XLABEL`, and `YLABEL`.
|
|
69
|
+
|
|
70
|
+
## Plot controls
|
|
71
|
+
|
|
72
|
+
- Right-click a plot and select **Datasets Options** to enable/disable curves or change their color, width, and symbols.
|
|
73
|
+
- Use **Mean, sigma** to show dataset statistics.
|
|
74
|
+
- Use **Y Projection** to show a histogram of the visible Y range.
|
|
75
|
+
- Use **UnZoom** to restore the previous view range.
|
|
76
|
+
- Press `Ctrl+H` for help, `Ctrl+M` for statistics, `Ctrl+S` to stop/resume updates, or `Ctrl+U` to unzoom.
|
|
77
|
+
|
|
78
|
+
## Examples
|
|
79
|
+
|
|
80
|
+
- Two docks with an array plot and a strip chart:
|
|
81
|
+
```bash
|
|
82
|
+
python -m pvplot -c /operations/app_store/pvplot -f peakSimulator_pvp
|
|
83
|
+
```
|
|
84
|
+
- Sliced EPICS Channel Access waveform:
|
|
85
|
+
```bash
|
|
86
|
+
python -m pvplot -s 0.01 -a 'E:testAPD:scope1:' 'Waveform_RBV[1:500]'
|
|
87
|
+
```
|
|
88
|
+
- EPICS PVAccess waveform for `python -m epicsdev.imagegen -r30:
|
|
89
|
+
```bash
|
|
90
|
+
python -m pvplot -aV:image:0: -#0'oneRow' -#1'oneRowMean oneRowStd oneRowPeak2Peak'
|
|
91
|
+
```
|
|
92
|
+
- LiteServer correlation plot:
|
|
93
|
+
```bash
|
|
94
|
+
python -m pvplot -s 0.01 -a 'L:localhost;9710:dev1:' 'x,y'
|
|
95
|
+
```
|
|
96
|
+
- LabJack U3-HV analog inputs served by LiteServer:
|
|
97
|
+
```bash
|
|
98
|
+
python -m pvplot -a 'L:localhost:dev1:' 'tempU3 ADC_HV[0] ADC_HV[1] ADC_HV[2] ADC_HV[3] ADC_LV'
|
|
99
|
+
```
|
|
@@ -44,6 +44,7 @@ def main():
|
|
|
44
44
|
parser.add_argument('parms', nargs = '?', default='yMax yMin',
|
|
45
45
|
help='''For stripchart: space-separated list, for correlation plot: comma-separated list of data objects.''')
|
|
46
46
|
pargs = parser.parse_args()
|
|
47
|
+
|
|
47
48
|
PVPlot = pvplot.PVPlot
|
|
48
49
|
PVPlot.pargs = pargs
|
|
49
50
|
|