pvplot 1.6.3__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.
@@ -0,0 +1,5 @@
1
+ {
2
+ "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
3
+ "python.terminal.activateEnvironment": true,
4
+ "pylint.importStrategy": "fromEnvironment"
5
+ }
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
+ ![pvplot](docs/pvplotx.jpg)
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
+ ![pvplot](docs/pvplotx.jpg)
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
+ ```
@@ -0,0 +1,4 @@
1
+ #__all__ = ['liteaccess']
2
+ from .liteaccess import __version__, PVs, Access, unsubscribe_all, \
3
+ formattedTime, printi, printw, printe, printv, printvv
4
+
@@ -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