thzdaq 0.0.6b4__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,25 @@
1
+ .idea
2
+ venv
3
+ .venv
4
+ .uv-cache
5
+ build
6
+ dist
7
+ *__pycache__
8
+ *.log
9
+ *.DS_Store
10
+ *.spec
11
+ !ThzDAQ.spec
12
+ *.ipynb
13
+ .env
14
+ /data/
15
+ # What a daemon run from sources keeps between runs
16
+ /daemon.json
17
+ /daemon-sim.json
18
+ # Window layout and perspectives of a local run
19
+ /settings.ini
20
+ # What a daemon run from sources keeps of instruments (a grid's angle)
21
+ /state.json
22
+ /state-sim.json
23
+ # The program's own measurements and the profiles' previous versions
24
+ /measurements/
25
+ stations/.history/
thzdaq-0.0.6b4/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 yarvod
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,86 @@
1
+ Metadata-Version: 2.5
2
+ Name: thzdaq
3
+ Version: 0.0.6b4
4
+ Summary: ThzDAQ: SIS mixer bench control and measurements (command, client library, extras)
5
+ Project-URL: Homepage, https://github.com/yarvod/ThzDAQ
6
+ Project-URL: Documentation, https://github.com/yarvod/ThzDAQ/blob/master/docs/daemon.md
7
+ Project-URL: Issues, https://github.com/yarvod/ThzDAQ/issues
8
+ Project-URL: Releases, https://github.com/yarvod/ThzDAQ/releases
9
+ Author: yarvod
10
+ License-Expression: MIT
11
+ License-File: LICENSE
12
+ Classifier: Development Status :: 3 - Alpha
13
+ Classifier: Intended Audience :: Science/Research
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3 :: Only
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Topic :: Scientific/Engineering :: Physics
19
+ Requires-Python: >=3.11
20
+ Requires-Dist: thzdaq-api==0.0.6b4
21
+ Requires-Dist: thzdaq-cli==0.0.6b4
22
+ Provides-Extra: all
23
+ Requires-Dist: thzdaq-analysis==0.0.6b4; extra == 'all'
24
+ Requires-Dist: thzdaq-daemon==0.0.6b4; extra == 'all'
25
+ Requires-Dist: thzdaq-gui==0.0.6b4; extra == 'all'
26
+ Requires-Dist: thzdaq-mcp==0.0.6b4; extra == 'all'
27
+ Provides-Extra: analysis
28
+ Requires-Dist: thzdaq-analysis==0.0.6b4; extra == 'analysis'
29
+ Provides-Extra: daemon
30
+ Requires-Dist: thzdaq-daemon==0.0.6b4; extra == 'daemon'
31
+ Provides-Extra: gui
32
+ Requires-Dist: thzdaq-gui==0.0.6b4; extra == 'gui'
33
+ Provides-Extra: mcp
34
+ Requires-Dist: thzdaq-mcp==0.0.6b4; extra == 'mcp'
35
+ Description-Content-Type: text/markdown
36
+
37
+ # thzdaq
38
+
39
+ ThzDAQ controls a SIS mixer bench and measures it: bias, LO, IF power, temperatures,
40
+ I-V and noise-temperature measurements. A daemon holds the instruments; the window, the
41
+ `thzdaq` command, agents (Claude Code, Codex) and your scripts are its clients.
42
+
43
+ This package is the client: the `thzdaq` command and the library for scripts
44
+ (`from thzdaq import connect`). It is light, without instrument drivers or numpy.
45
+
46
+ ```bash
47
+ uv tool install thzdaq # the thzdaq command
48
+ uv add thzdaq # or pip install thzdaq: in your project or notebook
49
+ ```
50
+
51
+ | Extra | What it adds |
52
+ |---|---|
53
+ | `thzdaq[analysis]` | analysis functions for your own calculations (numpy only) |
54
+ | `thzdaq[daemon]` | the bench daemon with instrument drivers: a bench on plain Python |
55
+ | `thzdaq[mcp]` | `thzdaq mcp`, the bench's tools for Claude Code and Codex |
56
+ | `thzdaq[gui]` | the ThzDAQ window (Python 3.11) |
57
+ | `thzdaq[all]` | all of the above |
58
+
59
+ The daemon serves only this machine. Without `thzdaq[daemon]` a client starts the
60
+ [ThzDAQ build](https://github.com/yarvod/ThzDAQ/releases) installed here (it notes
61
+ itself at its first start), or connects to the daemon already running. Take the version
62
+ of the build: `pip install thzdaq==<version>`; client and daemon check that they speak
63
+ the same contract.
64
+
65
+ ```bash
66
+ thzdaq --simulate devices # instruments on simulators
67
+ thzdaq procedures # what can be measured
68
+ thzdaq run sis.current_vs_voltage --set voltage=0:7:351
69
+ ```
70
+
71
+ ```python
72
+ from thzdaq import connect
73
+
74
+ lab = connect() # finds the daemon, or starts it
75
+ bias = lab["sis_bias_1"]
76
+ bias.voltage_set = "2.3mV" # = thzdaq set sis_bias_1 voltage_set 2.3mV
77
+ print(bias.read()) # SI values that know their unit
78
+ run = lab.run("sis.current_vs_voltage", bias=bias, voltage="0:7:351")
79
+ run.wait()
80
+ iv = run.table("iv")
81
+ ```
82
+
83
+ Documentation: [docs/daemon.md](https://github.com/yarvod/ThzDAQ/blob/master/docs/daemon.md)
84
+ (in Russian). The packages behind this one: `thzdaq-api` (contract and client),
85
+ `thzdaq-cli`, `thzdaq-analysis`, `thzdaq-core`, `thzdaq-instruments`, `thzdaq-daemon`,
86
+ `thzdaq-mcp`, `thzdaq-gui`; all of one release share its version.
@@ -0,0 +1,50 @@
1
+ # thzdaq
2
+
3
+ ThzDAQ controls a SIS mixer bench and measures it: bias, LO, IF power, temperatures,
4
+ I-V and noise-temperature measurements. A daemon holds the instruments; the window, the
5
+ `thzdaq` command, agents (Claude Code, Codex) and your scripts are its clients.
6
+
7
+ This package is the client: the `thzdaq` command and the library for scripts
8
+ (`from thzdaq import connect`). It is light, without instrument drivers or numpy.
9
+
10
+ ```bash
11
+ uv tool install thzdaq # the thzdaq command
12
+ uv add thzdaq # or pip install thzdaq: in your project or notebook
13
+ ```
14
+
15
+ | Extra | What it adds |
16
+ |---|---|
17
+ | `thzdaq[analysis]` | analysis functions for your own calculations (numpy only) |
18
+ | `thzdaq[daemon]` | the bench daemon with instrument drivers: a bench on plain Python |
19
+ | `thzdaq[mcp]` | `thzdaq mcp`, the bench's tools for Claude Code and Codex |
20
+ | `thzdaq[gui]` | the ThzDAQ window (Python 3.11) |
21
+ | `thzdaq[all]` | all of the above |
22
+
23
+ The daemon serves only this machine. Without `thzdaq[daemon]` a client starts the
24
+ [ThzDAQ build](https://github.com/yarvod/ThzDAQ/releases) installed here (it notes
25
+ itself at its first start), or connects to the daemon already running. Take the version
26
+ of the build: `pip install thzdaq==<version>`; client and daemon check that they speak
27
+ the same contract.
28
+
29
+ ```bash
30
+ thzdaq --simulate devices # instruments on simulators
31
+ thzdaq procedures # what can be measured
32
+ thzdaq run sis.current_vs_voltage --set voltage=0:7:351
33
+ ```
34
+
35
+ ```python
36
+ from thzdaq import connect
37
+
38
+ lab = connect() # finds the daemon, or starts it
39
+ bias = lab["sis_bias_1"]
40
+ bias.voltage_set = "2.3mV" # = thzdaq set sis_bias_1 voltage_set 2.3mV
41
+ print(bias.read()) # SI values that know their unit
42
+ run = lab.run("sis.current_vs_voltage", bias=bias, voltage="0:7:351")
43
+ run.wait()
44
+ iv = run.table("iv")
45
+ ```
46
+
47
+ Documentation: [docs/daemon.md](https://github.com/yarvod/ThzDAQ/blob/master/docs/daemon.md)
48
+ (in Russian). The packages behind this one: `thzdaq-api` (contract and client),
49
+ `thzdaq-cli`, `thzdaq-analysis`, `thzdaq-core`, `thzdaq-instruments`, `thzdaq-daemon`,
50
+ `thzdaq-mcp`, `thzdaq-gui`; all of one release share its version.
@@ -0,0 +1,55 @@
1
+ [project]
2
+ name = "thzdaq"
3
+ version = "0.0.6b4"
4
+ description = "ThzDAQ: SIS mixer bench control and measurements (command, client library, extras)"
5
+ readme = "README.md"
6
+ requires-python = ">=3.11"
7
+ license = "MIT"
8
+ license-files = ["LICENSE"]
9
+ authors = [{ name = "yarvod" }]
10
+ classifiers = [
11
+ "Development Status :: 3 - Alpha",
12
+ "Intended Audience :: Science/Research",
13
+ "Operating System :: OS Independent",
14
+ "Programming Language :: Python :: 3",
15
+ "Programming Language :: Python :: 3 :: Only",
16
+ "Programming Language :: Python :: 3.11",
17
+ "Topic :: Scientific/Engineering :: Physics",
18
+ ]
19
+ dependencies = [
20
+ "thzdaq-api==0.0.6b4",
21
+ "thzdaq-cli==0.0.6b4",
22
+ ]
23
+
24
+ [project.urls]
25
+ Homepage = "https://github.com/yarvod/ThzDAQ"
26
+ Documentation = "https://github.com/yarvod/ThzDAQ/blob/master/docs/daemon.md"
27
+ Issues = "https://github.com/yarvod/ThzDAQ/issues"
28
+ Releases = "https://github.com/yarvod/ThzDAQ/releases"
29
+
30
+ [project.optional-dependencies]
31
+ analysis = ["thzdaq-analysis==0.0.6b4"]
32
+ daemon = ["thzdaq-daemon==0.0.6b4"]
33
+ gui = ["thzdaq-gui==0.0.6b4"]
34
+ mcp = ["thzdaq-mcp==0.0.6b4"]
35
+ all = [
36
+ "thzdaq-analysis==0.0.6b4",
37
+ "thzdaq-daemon==0.0.6b4",
38
+ "thzdaq-gui==0.0.6b4",
39
+ "thzdaq-mcp==0.0.6b4",
40
+ ]
41
+
42
+ [tool.uv.sources]
43
+ thzdaq-analysis = { workspace = true }
44
+ thzdaq-api = { workspace = true }
45
+ thzdaq-cli = { workspace = true }
46
+ thzdaq-daemon = { workspace = true }
47
+ thzdaq-gui = { workspace = true }
48
+ thzdaq-mcp = { workspace = true }
49
+
50
+ [build-system]
51
+ requires = ["hatchling>=1.27"]
52
+ build-backend = "hatchling.build"
53
+
54
+ [tool.hatch.build.targets.wheel]
55
+ packages = ["src/thzdaq"]
@@ -0,0 +1,42 @@
1
+ """ThzDAQ for users and scripts: the client of thzdaq-api under one name.
2
+
3
+ from thzdaq import connect, device, value
4
+
5
+ bias = device("SIS bias", kind="sis_bias") # declared: a form in the window
6
+ voltage = value("Bias voltage", "2:3:51", unit="mV")
7
+
8
+ lab = connect()
9
+ with lab.measurement("pv_fine", devices=[bias], exclusive=[bias]) as m:
10
+ for v in m.sweep(voltage):
11
+ ...
12
+ """
13
+
14
+ from thzdaq_api.data import Measured
15
+ from thzdaq_api.declare import device, instrument, plot, value
16
+ from thzdaq_api.errors import ErrorCode, LabError
17
+ from thzdaq_api.lab import Bench, Device, Readout, Run, connect
18
+ from thzdaq_api.measurement_file import Column, read_measurement
19
+ from thzdaq_api.raw import RawInstrument, reading, setting
20
+ from thzdaq_api.script import Cancelled, Session
21
+
22
+ __all__ = [
23
+ "Bench",
24
+ "Cancelled",
25
+ "Column",
26
+ "Device",
27
+ "ErrorCode",
28
+ "LabError",
29
+ "Measured",
30
+ "RawInstrument",
31
+ "Readout",
32
+ "Run",
33
+ "Session",
34
+ "connect",
35
+ "device",
36
+ "instrument",
37
+ "plot",
38
+ "read_measurement",
39
+ "reading",
40
+ "setting",
41
+ "value",
42
+ ]