thzdaq 0.0.6b3__py3-none-any.whl

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.
thzdaq/__init__.py ADDED
@@ -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
+ ]
@@ -0,0 +1,86 @@
1
+ Metadata-Version: 2.5
2
+ Name: thzdaq
3
+ Version: 0.0.6b3
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.6b3
21
+ Requires-Dist: thzdaq-cli==0.0.6b3
22
+ Provides-Extra: all
23
+ Requires-Dist: thzdaq-analysis==0.0.6b3; extra == 'all'
24
+ Requires-Dist: thzdaq-daemon==0.0.6b3; extra == 'all'
25
+ Requires-Dist: thzdaq-gui==0.0.6b3; extra == 'all'
26
+ Requires-Dist: thzdaq-mcp==0.0.6b3; extra == 'all'
27
+ Provides-Extra: analysis
28
+ Requires-Dist: thzdaq-analysis==0.0.6b3; extra == 'analysis'
29
+ Provides-Extra: daemon
30
+ Requires-Dist: thzdaq-daemon==0.0.6b3; extra == 'daemon'
31
+ Provides-Extra: gui
32
+ Requires-Dist: thzdaq-gui==0.0.6b3; extra == 'gui'
33
+ Provides-Extra: mcp
34
+ Requires-Dist: thzdaq-mcp==0.0.6b3; 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,5 @@
1
+ thzdaq/__init__.py,sha256=FEFo23mqkb2gyESIIqEP0ypI5aBMzPIvssYfQdiVfl0,1113
2
+ thzdaq-0.0.6b3.dist-info/METADATA,sha256=MeAiW0nnfjjotSpm-uY4pjZBmJXzk4Q7C95Ios_iB0U,3732
3
+ thzdaq-0.0.6b3.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
4
+ thzdaq-0.0.6b3.dist-info/licenses/LICENSE,sha256=jXHKk1r0G-rRjWXmfQVbjBzee356QkXdR3C8GExo_V0,1063
5
+ thzdaq-0.0.6b3.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.33.0
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -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.