AutoPumping 0.1.0__py3-none-any.whl

autopumping-0.1.0.dist-info/METADATA

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: AutoPumping
+Version: 0.1.0
+Summary: A tool to automate pumping of vacuum systems
+Author-email: Cameron Devine <cameron.devine@alleninstitute.org>
+License-Expression: BSD-3-Clause
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic
+Requires-Dist: pyyaml
+Requires-Dist: networkx
+Requires-Dist: nicegui
+Requires-Dist: pyvis
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: bump-my-version; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: jsonschema2md; extra == "docs"
+Dynamic: license-file
+
+# Auto Pumping
+
+This Python package is meant to provide a generic system for automating high-vacuum pumping systems.
+
+## Config
+
+To support arbitrary pumping systems, a configuration file format was created where all valid valve, pump, and stage[^1] transition can be enumerated. Using this configuration file, the safety of any given valve transition can be evaluated, and the system automated. This configuration file format is documented [here](docs/config.md).
+
+## Solver
+
+To support automated pumping of the vacuum system a solver was implemented using the information in the configuration file. This information is used to build a directed graph of all valid pumping system states where discretized pressure is included. After this directed graph is built, Dijkstra's algorithm is used for find the optimal method for pumping or venting the system, or reaching any other state. The built graph can be viewed by running: `python -m auto_pumping -c config/config.yaml network`.
+
+## UI
+
+A NiceGUI based UI is also included. It is automatically built based on the configuration file. A dummy pumping system is available as an example and can be run with: `python -m auto_pumping -c config/config.yaml run`.
+
+## Getting Started
+
+To implement automated pumping for your system subclass the `AutoPumping` class and define the following methods:
+
+* `get_valve_state(valve)`
+* `actuate_valve(valve, state)`
+* `get_pump_state(pump)`
+* `set_pump(pump, state)`
+* `get_pump_current(pump)`
+* `get_pump_voltage(pump)`
+* `get_pump_flow(pump)`
+* `get_pump_speed(pump)`
+* `get_gauge_pressure(gauge)`
+* `get_stage_position()`
+* `move_stage(position)`
+
+If you would like to add more fields to the configuration file for your specific hardware, subclass the `Config` class and set the `AutoPumping.CONFIG_CLASS` variable to your new config class.
+
+To allow the system to be easily started, you can use the provided `main()` function. Simply run `main(<your_auto_pumping_subclass>)`, for example:
+
+```python
+from auto_pumping.__main__ import main
+
+
+if __name__ == "__main__":
+    main(<your_auto_pumping_subclass>)
+```
+
+Finally, a diagram can be added to the UI by setting the `AutoPumping.DIAGRAM_PATH` variable to the path to a diagram image of your system.
+
+[^1]: this library was originally written for a custom microscope system.

autopumping-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+auto_pumping/__init__.py,sha256=n_qKZcvuPqE_LTrNT-Q5OY2k_T1oejBa-3ZuEV4wzUQ,3116
+auto_pumping/__main__.py,sha256=EiiYghP6LZ7pAitFG4rX4PkHmlFgUdoy5rjm7mKgS-g,995
+auto_pumping/config.py,sha256=IMhCdM8j6Ylc3--qQAd2PB84kwg06ww1PLVtgb0tRqA,16207
+auto_pumping/dummy.py,sha256=3tOhokI9HzM5fByX75vWCZHZUvfgMHN73o7iJjYp9Ck,1318
+auto_pumping/executor.py,sha256=hAlrHPG_zrYtfd2x8gO3YpFBEsRXxTp1o_fKZsisiSk,6606
+auto_pumping/graph.py,sha256=COU8MHNBp3oHuvC5boRWwC2_txRaG2JqXCbPI_h6W9I,14994
+auto_pumping/safety.py,sha256=etZH-50Wn3Y9vzwsItnteR_5CcwW5LZb7Jg9RO394mM,3455
+auto_pumping/ui.py,sha256=R1gWvYFyV72mEwZtJFPwIfiMhC5NWGy1NjntSrFoud4,30169
+autopumping-0.1.0.dist-info/licenses/LICENSE,sha256=vUYBQ-l3oXhkyJfeP2Zy7RufJ2Md8RHWKQaVxh9oYm0,1502
+autopumping-0.1.0.dist-info/METADATA,sha256=otaNRi6nT_JMGmV8EvDY1AVWq0RCdTeTsNy4lVff4C4,3121
+autopumping-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+autopumping-0.1.0.dist-info/top_level.txt,sha256=SeZ5sWelSkTZ89QQX65re2wzw2Tuq4U2BcOPFgaKqs4,13
+autopumping-0.1.0.dist-info/RECORD,,

autopumping-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

autopumping-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Allen Institute
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

autopumping-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+auto_pumping