tidypptsdm 1.1.0__tar.gz

tidypptsdm-1.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+build/
+dist/
+site/
+.pytest_cache/
+*.spec.bak

tidypptsdm-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Meng Guo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tidypptsdm-1.1.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.5
+Name: tidypptsdm
+Version: 1.1.0
+Summary: Daily monitoring of pig performance testing stations (NEDAP and FIRE)
+Project-URL: Homepage, https://tony2015116.github.io/tidypptsdm-py/
+Project-URL: Source, https://github.com/tony2015116/tidypptsdm-py
+Project-URL: Issues, https://github.com/tony2015116/tidypptsdm-py/issues
+Project-URL: R package, https://github.com/tony2015116/tidypptsdm
+Author-email: Meng Guo <tony2015116@163.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: FIRE,NEDAP,feeding station,livestock,monitoring,performance test,pig
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.10
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: numpy>=1.24
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: pandas>=2.0
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.25; extra == 'docs'
+Provides-Extra: exe
+Requires-Dist: pyinstaller>=6.0; extra == 'exe'
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == 'test'
+Description-Content-Type: text/markdown
+
+# tidypptsdm (Python) <img src="docs/assets/logo.svg" align="right" height="120" alt="logo" />
+
+[![tests](https://github.com/tony2015116/tidypptsdm-py/actions/workflows/tests.yml/badge.svg)](https://github.com/tony2015116/tidypptsdm-py/actions/workflows/tests.yml)
+[![docs](https://github.com/tony2015116/tidypptsdm-py/actions/workflows/docs.yml/badge.svg)](https://tony2015116.github.io/tidypptsdm-py/)
+
+**种猪性能测定站日常监控**：读取 NEDAP 或 FIRE 测定站的导出文件，按测定站、栋、猪和小时汇总最近几天的数据，列出最后一天的警报（测定站停机、耳标读不到、采食量骤降、猪不来吃料或吃得太少），并生成可以逐站翻页浏览的 HTML 报告和带色阶的 Excel 工作簿。
+
+Daily monitoring of automatic pig feeding stations (NEDAP and FIRE): daily
+tables per station, house, pig and hour, alerts of the last day, an offline
+HTML report and an Excel workbook.
+
+这是 R 包 [tidypptsdm](https://github.com/tony2015116/tidypptsdm) 的 Python 版本，**计算结果与 R 版逐表一致**（测试中用两份示例数据对比）。
+
+文档：<https://tony2015116.github.io/tidypptsdm-py/>
+
+## 三种用法
+
+### 1. 桌面程序（Windows，不需要安装 Python）
+
+从 [Releases](https://github.com/tony2015116/tidypptsdm-py/releases) 下载 `tidypptsdm-windows.zip`，解压后双击 `tidypptsdm.exe`：选择导出文件夹和结果文件夹，点“运行监控”，报告自动在浏览器中打开；点“设为每天定时”即可每天自动生成报告。
+
+### 2. 命令行
+
+```bash
+pip install tidypptsdm
+tidypptsdm run D:/nedap/exports --out D:/nedap/monitor --days 7
+tidypptsdm schedule D:/nedap/exports --out D:/nedap/monitor --time 07:30
+```
+
+### 3. Python
+
+```python
+import tidypptsdm as tp
+
+mon = tp.run_monitor("D:/nedap/exports", days=7)   # or tp.load_example("nedap")
+mon.alerts
+tp.wide_table(mon.stations, "feed_kg")
+tp.write_monitor_report(mon, "monitor/2024-05-25", open=True)
+tp.write_monitor_tables(mon, "monitor/2024-05-25")
+```
+
+## 依赖
+
+pandas、numpy、matplotlib、openpyxl。图形界面用 Python 自带的 tkinter。

tidypptsdm-1.1.0/README.md

@@ -0,0 +1,44 @@
+# tidypptsdm (Python) <img src="docs/assets/logo.svg" align="right" height="120" alt="logo" />
+
+[![tests](https://github.com/tony2015116/tidypptsdm-py/actions/workflows/tests.yml/badge.svg)](https://github.com/tony2015116/tidypptsdm-py/actions/workflows/tests.yml)
+[![docs](https://github.com/tony2015116/tidypptsdm-py/actions/workflows/docs.yml/badge.svg)](https://tony2015116.github.io/tidypptsdm-py/)
+
+**种猪性能测定站日常监控**：读取 NEDAP 或 FIRE 测定站的导出文件，按测定站、栋、猪和小时汇总最近几天的数据，列出最后一天的警报（测定站停机、耳标读不到、采食量骤降、猪不来吃料或吃得太少），并生成可以逐站翻页浏览的 HTML 报告和带色阶的 Excel 工作簿。
+
+Daily monitoring of automatic pig feeding stations (NEDAP and FIRE): daily
+tables per station, house, pig and hour, alerts of the last day, an offline
+HTML report and an Excel workbook.
+
+这是 R 包 [tidypptsdm](https://github.com/tony2015116/tidypptsdm) 的 Python 版本，**计算结果与 R 版逐表一致**（测试中用两份示例数据对比）。
+
+文档：<https://tony2015116.github.io/tidypptsdm-py/>
+
+## 三种用法
+
+### 1. 桌面程序（Windows，不需要安装 Python）
+
+从 [Releases](https://github.com/tony2015116/tidypptsdm-py/releases) 下载 `tidypptsdm-windows.zip`，解压后双击 `tidypptsdm.exe`：选择导出文件夹和结果文件夹，点“运行监控”，报告自动在浏览器中打开；点“设为每天定时”即可每天自动生成报告。
+
+### 2. 命令行
+
+```bash
+pip install tidypptsdm
+tidypptsdm run D:/nedap/exports --out D:/nedap/monitor --days 7
+tidypptsdm schedule D:/nedap/exports --out D:/nedap/monitor --time 07:30
+```
+
+### 3. Python
+
+```python
+import tidypptsdm as tp
+
+mon = tp.run_monitor("D:/nedap/exports", days=7)   # or tp.load_example("nedap")
+mon.alerts
+tp.wide_table(mon.stations, "feed_kg")
+tp.write_monitor_report(mon, "monitor/2024-05-25", open=True)
+tp.write_monitor_tables(mon, "monitor/2024-05-25")
+```
+
+## 依赖
+
+pandas、numpy、matplotlib、openpyxl。图形界面用 Python 自带的 tkinter。

tidypptsdm-1.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["hatchling>=1.24"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tidypptsdm"
+dynamic = ["version"]
+description = "Daily monitoring of pig performance testing stations (NEDAP and FIRE)"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Meng Guo", email = "tony2015116@163.com" }]
+requires-python = ">=3.10"
+keywords = ["pig", "performance test", "feeding station", "NEDAP", "FIRE", "livestock", "monitoring"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Science/Research",
+  "Natural Language :: Chinese (Simplified)",
+  "Natural Language :: English",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Topic :: Scientific/Engineering :: Information Analysis",
+]
+dependencies = [
+  "pandas>=2.0",
+  "numpy>=1.24",
+  "matplotlib>=3.7",
+  "openpyxl>=3.1",
+]
+
+[project.optional-dependencies]
+test = ["pytest>=7"]
+docs = ["mkdocs-material>=9.5", "mkdocstrings[python]>=0.25"]
+exe = ["pyinstaller>=6.0"]
+
+[project.scripts]
+tidypptsdm = "tidypptsdm.cli:main"
+
+[project.gui-scripts]
+tidypptsdm-gui = "tidypptsdm.gui:main"
+
+[project.urls]
+Homepage = "https://tony2015116.github.io/tidypptsdm-py/"
+Source = "https://github.com/tony2015116/tidypptsdm-py"
+Issues = "https://github.com/tony2015116/tidypptsdm-py/issues"
+"R package" = "https://github.com/tony2015116/tidypptsdm"
+
+[tool.hatch.version]
+path = "src/tidypptsdm/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tidypptsdm"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "README.md", "LICENSE", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+filterwarnings = ["error::FutureWarning"]

tidypptsdm-1.1.0/src/tidypptsdm/__init__.py

@@ -0,0 +1,28 @@
+"""tidypptsdm: daily monitoring of pig performance testing stations.
+
+The Python version of the R package tidypptsdm: read NEDAP or FIRE exports,
+compute the daily tables per station, house, pig and hour, list the alerts
+of the last day, and write an HTML report and an Excel workbook.
+"""
+
+from ._messages import Abort
+from ._monitor import (Monitor, monitor_hours, monitor_houses, monitor_pigs,
+                       monitor_stations, run_monitor, wide_table)
+from ._plots import StationPlot, plot_monitor, save_monitor_plots
+from ._prep import prep_visits
+from ._report import write_monitor_report
+from ._schedule import monitor_to_folder, schedule_monitor, unschedule_monitor
+from ._station import read_station, station_format
+from ._tables import write_monitor_tables
+from .datasets import load_example, write_example
+
+from ._version import __version__
+
+__all__ = [
+    "Abort", "Monitor", "StationPlot", "load_example", "monitor_hours",
+    "monitor_houses", "monitor_pigs", "monitor_stations", "monitor_to_folder",
+    "plot_monitor", "prep_visits", "read_station", "run_monitor",
+    "save_monitor_plots", "schedule_monitor", "station_format",
+    "unschedule_monitor", "wide_table", "write_example",
+    "write_monitor_report", "write_monitor_tables",
+]

tidypptsdm-1.1.0/src/tidypptsdm/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())

tidypptsdm-1.1.0/src/tidypptsdm/_messages.py

@@ -0,0 +1,82 @@
+"""Console messages with three verbosity levels, as in the R packages.
+
+0: silent, 1: summary (default), 2: details. Messages go to stderr so that
+the standard output stays free for data.
+"""
+
+from __future__ import annotations
+
+import contextlib
+import sys
+from typing import Iterator
+
+_state = {"verbose": 1}
+
+_SYMBOLS = {
+    "info": "i",
+    "success": "v",
+    "warning": "!",
+    "danger": "x",
+}
+
+
+class Abort(ValueError):
+    """Error raised for bad input, with a message meant for the user."""
+
+
+def check_verbose(verbose: int) -> int:
+    if verbose not in (0, 1, 2) or isinstance(verbose, bool):
+        raise Abort("`verbose` must be 0 (silent), 1 (summary) or 2 (details).")
+    return int(verbose)
+
+
+@contextlib.contextmanager
+def local_verbose(verbose: int) -> Iterator[int]:
+    """Set the verbosity until the block exits."""
+    verbose = check_verbose(verbose)
+    old = _state["verbose"]
+    _state["verbose"] = verbose
+    try:
+        yield verbose
+    finally:
+        _state["verbose"] = old
+
+
+def current_verbose() -> int:
+    return _state["verbose"]
+
+
+def _write(text: str) -> None:
+    stream = sys.stderr
+    if stream is None:  # a windowed exe without console and without a log file
+        return
+    try:
+        stream.write(text + "\n")
+    except UnicodeEncodeError:  # e.g. a Windows console in a legacy code page
+        enc = getattr(stream, "encoding", None) or "ascii"
+        stream.write(text.encode(enc, "replace").decode(enc) + "\n")
+    stream.flush()
+
+
+def msg(text: str, kind: str = "info", level: int = 1) -> None:
+    """Print a message if the verbosity is at least `level`."""
+    if _state["verbose"] < level:
+        return
+    if kind == "h1":
+        line = "-" * max(0, 72 - len(text) - 4)
+        _write(f"\n-- {text} {line}")
+    else:
+        _write(f"{_SYMBOLS.get(kind, 'i')} {text}")
+
+
+def bullets(lines: list[tuple[str, str]], level: int = 1) -> None:
+    """Print indented lines, each with a kind ("danger", "warning", ...)."""
+    if _state["verbose"] < level:
+        return
+    for kind, text in lines:
+        _write(f"  {_SYMBOLS.get(kind, '*')} {text}")
+
+
+def plural(n: int, word: str, plural_word: str | None = None) -> str:
+    """`3 pigs`, `1 pig`."""
+    return f"{n:,} {word if n == 1 else (plural_word or word + 's')}"