plasma-app 2.2.2__tar.gz → 2.2.4__tar.gz

{plasma_app-2.2.2 → plasma_app-2.2.4}/PKG-INFO

@@ -1,10 +1,15 @@
 Metadata-Version: 2.4
 Name: plasma-app
-Version: 2.2.2
+Version: 2.2.4
 Summary: PLASMA — Platform for LSL-based Acquisition of Sensor Metrics and Analytics
 License: MIT
 Project-URL: Homepage, https://github.com/YuyiChang/PLASMA
 Project-URL: Repository, https://github.com/YuyiChang/PLASMA
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -54,10 +59,30 @@ PLASMA: Platform for LSL-based Acquisition of Sensor Metrics and Analytics
 configure, pair MSense wristbands, run a session, read the memo panel, recover
 from faults.
 
+[![PyPI version](https://img.shields.io/pypi/v/plasma-app.svg)](https://pypi.org/project/plasma-app/)
+[![Python](https://img.shields.io/pypi/pyversions/plasma-app.svg)](https://pypi.org/project/plasma-app/)
+[![License](https://img.shields.io/github/license/yuyichang/PLASMA.svg)](LICENSE)
+[![GitHub Release](https://img.shields.io/github/v/release/yuyichang/PLASMA)](https://github.com/yuyichang/PLASMA/releases/latest)
+
+
+## Download
+
+| Platform | Architecture | Download |
+|---|---|---|
+| macOS | Apple Silicon (arm64) | [Download `.dmg`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_MacOS_arm64.dmg) |
+| Windows | x64 | [Download Installer `.exe`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_Windows_x64_Setup.exe) |
+| Linux | x64 | [Download `.tar.gz`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_Linux_x64.tar.gz) |
+| Linux | ARM64 | [Download `.tar.gz`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_Linux_arm64.tar.gz) |
+
+> For other packages and previous versions, see [GitHub Releases](https://github.com/YuyiChang/PLASMA/releases).
+
+
 ## quickstart
 
 **macOS: `brew install --cask yuyichang/plasma/plasma`** is the recommended
-way to get PLASMA — no Python, no `liblsl`, no Gatekeeper dance. See
+way to get PLASMA — no Python, no `liblsl`, no Gatekeeper dance. **Windows:
+`scoop bucket add plasma https://github.com/YuyiChang/scoop-plasma` then
+`scoop install plasma`** does the same, without the SmartScreen warning. See
 [Install & first launch](https://yuyichang.github.io/PLASMA/playbook/install/)
 for that and every other install path (prebuilt binaries, PyPI, from source).
 
@@ -101,7 +126,7 @@ plugins: `msense`, `qb2`, `pupil`, `shimmer`, `obs` (and `all`).
 - [x] linux aarch64 build — `PLASMA_Linux_arm64` for Jetson Orin (JetPack 6); CI job `build-linux-arm64`
 - [ ] infrequent stream (e.g., PLASMA journaler) shows green after recording stop
 - [ ] doc for msense workflow with better screenshots
-- [ ] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
+- [x] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
 
 ## developing a sensor plugin
 

{plasma_app-2.2.2 → plasma_app-2.2.4}/README.md

@@ -6,10 +6,30 @@ PLASMA: Platform for LSL-based Acquisition of Sensor Metrics and Analytics
 configure, pair MSense wristbands, run a session, read the memo panel, recover
 from faults.
 
+[![PyPI version](https://img.shields.io/pypi/v/plasma-app.svg)](https://pypi.org/project/plasma-app/)
+[![Python](https://img.shields.io/pypi/pyversions/plasma-app.svg)](https://pypi.org/project/plasma-app/)
+[![License](https://img.shields.io/github/license/yuyichang/PLASMA.svg)](LICENSE)
+[![GitHub Release](https://img.shields.io/github/v/release/yuyichang/PLASMA)](https://github.com/yuyichang/PLASMA/releases/latest)
+
+
+## Download
+
+| Platform | Architecture | Download |
+|---|---|---|
+| macOS | Apple Silicon (arm64) | [Download `.dmg`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_MacOS_arm64.dmg) |
+| Windows | x64 | [Download Installer `.exe`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_Windows_x64_Setup.exe) |
+| Linux | x64 | [Download `.tar.gz`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_Linux_x64.tar.gz) |
+| Linux | ARM64 | [Download `.tar.gz`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_Linux_arm64.tar.gz) |
+
+> For other packages and previous versions, see [GitHub Releases](https://github.com/YuyiChang/PLASMA/releases).
+
+
 ## quickstart
 
 **macOS: `brew install --cask yuyichang/plasma/plasma`** is the recommended
-way to get PLASMA — no Python, no `liblsl`, no Gatekeeper dance. See
+way to get PLASMA — no Python, no `liblsl`, no Gatekeeper dance. **Windows:
+`scoop bucket add plasma https://github.com/YuyiChang/scoop-plasma` then
+`scoop install plasma`** does the same, without the SmartScreen warning. See
 [Install & first launch](https://yuyichang.github.io/PLASMA/playbook/install/)
 for that and every other install path (prebuilt binaries, PyPI, from source).
 
@@ -53,7 +73,7 @@ plugins: `msense`, `qb2`, `pupil`, `shimmer`, `obs` (and `all`).
 - [x] linux aarch64 build — `PLASMA_Linux_arm64` for Jetson Orin (JetPack 6); CI job `build-linux-arm64`
 - [ ] infrequent stream (e.g., PLASMA journaler) shows green after recording stop
 - [ ] doc for msense workflow with better screenshots
-- [ ] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
+- [x] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
 
 ## developing a sensor plugin
 

{plasma_app-2.2.2 → plasma_app-2.2.4}/plasma/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "2.2.2"
+__version__ = "2.2.4"
 
 # Short git commit hash baked in by CI (.github/workflows/build.yml) just
 # before a release build is frozen with PyInstaller — a frozen bundle ships no

{plasma_app-2.2.2 → plasma_app-2.2.4}/plasma/devices/msense/config.py

@@ -46,7 +46,12 @@ def merge_msense_records(existing, scanned, overwrite):
 
     ``overwrite=True``  → one fresh record per scanned device, nothing kept.
     ``overwrite=False`` → ``existing`` plus a record for every scanned address
-    not already listed (case-insensitive on "UUID / MAC Address").
+    not already listed (case-insensitive on "UUID / MAC Address"). A scanned
+    address that IS already listed has that record's Name refreshed to the
+    freshly advertised name instead — Nickname/Enabled/IMU Stream are left
+    alone — so a firmware update that changes the advertised name reaches the
+    table via Append without needing Overwrite (which would also reset those
+    per-device toggles for every other configured wristband).
 
     Fresh records use the advertised name as Name, blank Nickname, Enabled on,
     IMU Stream off. Returns ``(records, summary_str)``.
@@ -64,13 +69,30 @@ def merge_msense_records(existing, scanned, overwrite):
         records = [_fresh(dev) for dev in scanned]
         return records, f"Overwrote table with {len(records)} scanned wristband(s)"
 
+    scanned_by_addr = {dev["address"].strip().upper(): dev for dev in scanned}
+    records = []
+    renamed = 0
+    for rec in existing:
+        dev = scanned_by_addr.get(str(rec.get("UUID / MAC Address", "")).strip().upper())
+        if dev and dev["name"] != rec.get("Name", ""):
+            rec = {**rec, "Name": dev["name"]}
+            renamed += 1
+        records.append(rec)
+
     have = {str(rec.get("UUID / MAC Address", "")).strip().upper() for rec in existing}
     added = [_fresh(dev) for dev in scanned if dev["address"].strip().upper() not in have]
-    skipped = len(scanned) - len(added)
-    msg = f"Appended {len(added)} new wristband(s)"
-    if skipped:
-        msg += f" ({skipped} already listed)"
-    return list(existing) + added, msg
+    records += added
+
+    unchanged = len(scanned) - len(added) - renamed
+    parts = []
+    if added:
+        parts.append(f"{len(added)} new")
+    if renamed:
+        parts.append(f"{renamed} renamed")
+    if unchanged:
+        parts.append(f"{unchanged} unchanged")
+    msg = "Appended " + ", ".join(parts) if parts else "No changes"
+    return records, msg
 
 
 # ── device_info.json import (YAMS provisioning format) ───────────────────────

{plasma_app-2.2.2 → plasma_app-2.2.4}/plasma/devices/msense/device.py

@@ -74,6 +74,10 @@ BATTERY_CHAR_UUID = "00002a19-0000-1000-8000-00805f9b34fb"
 
 SQC_MIN_MTU = 128
 SQC_DEBUG = True  # emit per-notification telemetry (printed off the BLE thread)
+# devices with no active SQC/live session still get unsolicited NUS traffic
+# (boot chatter, or firmware that exposes the NUS char but doesn't speak the
+# SQC/live protocol) — coalesce that noise instead of one debug line/packet
+NUS_IDLE_LOG_WINDOW_S = 5.0
 
 # NOTE: the overall per-transaction backstop timeout stays DISABLED — the real
 # BLE data rate is far slower than the handoff doc's provisional 35/45 s
@@ -173,6 +177,11 @@ class MotionSenseHRV(PlasmaDevice):
         # addr -> live INFINITY-stream state (see _new_live_state); only ever
         # one NUS stream (SQC snapshot OR live) active per wristband at a time.
         self.live_state = {}
+        # addr -> {"count", "bytes", "window_start"} — coalesces the
+        # "ignored (no active stream)" debug line so a chatty/idle wristband
+        # doesn't flood the console one line per notification (see
+        # _log_nus_ignored / NUS_IDLE_LOG_WINDOW_S)
+        self._nus_idle_rx = {}
         # addr -> {"status": confirmed|unconfirmed|unverifiable|unknown,
         #          "checked_at": ts} — set by collection_ctl(addr, False), see
         # _confirm_acq_stopped. Cleared on the next collection_ctl(addr, True).
@@ -1325,7 +1334,7 @@ class MotionSenseHRV(PlasmaDevice):
             elif live and live.get("session") and not live["session"].is_terminal:
                 self._handle_live_notification(live, name, bytes(data), now, t_entry)
             else:
-                self._sqc_debug(name, f"rx {len(data)}B ignored (no active stream)")
+                self._log_nus_ignored(name, len(data))
         except Exception as e:
             self.info(f"Error handling NUS data from {name}: {e}")
 
@@ -1520,6 +1529,28 @@ class MotionSenseHRV(PlasmaDevice):
         except queue.Full:
             pass  # never block the BLE thread on a slow console
 
+    def _log_nus_ignored(self, name, nbytes):
+        # first notification in a window prints immediately (so isolated,
+        # one-off chatter is still visible); anything after that within
+        # NUS_IDLE_LOG_WINDOW_S is tallied silently and flushed as one
+        # rolled-up line — keeps a continuously-chattering/no-session
+        # wristband (e.g. firmware that exposes NUS but doesn't speak the
+        # SQC/live protocol) from spamming a line per packet
+        st = self._nus_idle_rx.setdefault(name, {"count": 0, "bytes": 0, "window_start": 0.0})
+        now = time.time()
+        st["count"] += 1
+        st["bytes"] += nbytes
+        if now - st["window_start"] < NUS_IDLE_LOG_WINDOW_S:
+            return
+        if st["count"] > 1:
+            self._sqc_debug(
+                name, f"rx {st['count']}x ({st['bytes']}B total) ignored (no active stream)")
+        else:
+            self._sqc_debug(name, f"rx {nbytes}B ignored (no active stream)")
+        st["count"] = 0
+        st["bytes"] = 0
+        st["window_start"] = now
+
     def _sqc_diag_summary(self, name, store=None):
         d = (store or self.sqc_state).get(name, {}).get("diag")
         if not d:

{plasma_app-2.2.2 → plasma_app-2.2.4}/plasma/devices/msense/extract/pipeline.py

@@ -316,19 +316,19 @@ class DataExtractor():
                                       out_dir=self.out_dir, id=id)
 
     def generate_csv_for_pattern(self, in_dir, type_prefix: str, search_key: str, out_dir="./", id=-1):
-        # 1. Ignore ID Parsing Handling
-        if self.ignore_id_parsing:
-            file_name = type_prefix  # Defaults to id + "ac.csv" or ".pkl"
+        # An empty ID means the binary starts with its sensor tag (e.g.
+        # ppg1047.bin), so there is no participant encoding to expand.
+        if self.ignore_id_parsing or id == "":
+            file_name = type_prefix
         else:
             if str(id) in self.encoding_alias.keys():
                 alias = self.encoding_alias[str(id)]
                 print('=====', id, alias)
-                file_name = f"{type_prefix}".replace(id, alias)
             else:
                 sub_id = str(id)[:-2]
                 ses_id = str(id)[-2:]
                 alias = f"sub-{sub_id}_ses-{ses_id}_{self.note}_"
-                file_name = f"{type_prefix}".replace(id, alias)
+            file_name = alias + type_prefix[len(str(id)):]
 
         print(type_prefix, search_key, '********')
         # session_dfs: one DataFrame per distinct recording/session sharing this

{plasma_app-2.2.2 → plasma_app-2.2.4}/plasma/devices/msense/panels/extractor.py

@@ -15,6 +15,27 @@ from ..extract.options import (
 from ..extract.pipeline import extract_dir, extract_zip, get_session_encoding
 
 
+_SAVE_FORMATS = ("feather", "csv", "pickle")
+_PREF_CONFIG_KEY = "msense_extraction"
+
+
+def _saved_save_format():
+    from plasma.config import device_config
+    blob = device_config.get_plugin_config(_PREF_CONFIG_KEY)
+    saved = blob.get("save_format") if isinstance(blob, dict) else None
+    return saved if saved in _SAVE_FORMATS else ExtractionOptions().save_format
+
+
+def _save_save_format(value):
+    from plasma.config import device_config
+    if value not in _SAVE_FORMATS:
+        raise ValueError(f"Unsupported extraction save format: {value}")
+    existing = device_config.get_plugin_config(_PREF_CONFIG_KEY)
+    blob = dict(existing) if isinstance(existing, dict) else {}
+    blob["save_format"] = value
+    device_config.update_plugin_config(_PREF_CONFIG_KEY, blob)
+
+
 class ExtractionOptionsPanel:
     """The advanced-options accordion. Build one inside each Blocks context.
 
@@ -32,8 +53,11 @@ class ExtractionOptionsPanel:
             with gr.Row():
                 self.legacy_fs = gr.Checkbox(False, label="(Uncommon) legacy sampling rate")
                 self.save_format = gr.Radio(
-                    ["feather", "csv", "pickle"], value="feather", label="Save format",
-                    info="feather (fast, binary) · csv (plain text, needed for clocksync) · pickle")
+                    _SAVE_FORMATS, value=_saved_save_format(), label="Save format",
+                    info="feather (fast, binary) · csv (plain text, needed for clocksync) · "
+                         "pickle · selection saved for future launches")
+                self.save_format.change(_save_save_format, inputs=self.save_format,
+                                        outputs=None)
                 self.ignore_id_parsing = gr.Checkbox(False, label="Ignore subject/session ID parsing")
             with gr.Row():
                 self.ppg_format = gr.Dropdown(PPG_FORMAT_CHOICES, value="auto",

{plasma_app-2.2.2 → plasma_app-2.2.4}/plasma_app.egg-info/PKG-INFO

@@ -1,10 +1,15 @@
 Metadata-Version: 2.4
 Name: plasma-app
-Version: 2.2.2
+Version: 2.2.4
 Summary: PLASMA — Platform for LSL-based Acquisition of Sensor Metrics and Analytics
 License: MIT
 Project-URL: Homepage, https://github.com/YuyiChang/PLASMA
 Project-URL: Repository, https://github.com/YuyiChang/PLASMA
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -54,10 +59,30 @@ PLASMA: Platform for LSL-based Acquisition of Sensor Metrics and Analytics
 configure, pair MSense wristbands, run a session, read the memo panel, recover
 from faults.
 
+[![PyPI version](https://img.shields.io/pypi/v/plasma-app.svg)](https://pypi.org/project/plasma-app/)
+[![Python](https://img.shields.io/pypi/pyversions/plasma-app.svg)](https://pypi.org/project/plasma-app/)
+[![License](https://img.shields.io/github/license/yuyichang/PLASMA.svg)](LICENSE)
+[![GitHub Release](https://img.shields.io/github/v/release/yuyichang/PLASMA)](https://github.com/yuyichang/PLASMA/releases/latest)
+
+
+## Download
+
+| Platform | Architecture | Download |
+|---|---|---|
+| macOS | Apple Silicon (arm64) | [Download `.dmg`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_MacOS_arm64.dmg) |
+| Windows | x64 | [Download Installer `.exe`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_Windows_x64_Setup.exe) |
+| Linux | x64 | [Download `.tar.gz`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_Linux_x64.tar.gz) |
+| Linux | ARM64 | [Download `.tar.gz`](https://github.com/YuyiChang/PLASMA/releases/latest/download/PLASMA_Linux_arm64.tar.gz) |
+
+> For other packages and previous versions, see [GitHub Releases](https://github.com/YuyiChang/PLASMA/releases).
+
+
 ## quickstart
 
 **macOS: `brew install --cask yuyichang/plasma/plasma`** is the recommended
-way to get PLASMA — no Python, no `liblsl`, no Gatekeeper dance. See
+way to get PLASMA — no Python, no `liblsl`, no Gatekeeper dance. **Windows:
+`scoop bucket add plasma https://github.com/YuyiChang/scoop-plasma` then
+`scoop install plasma`** does the same, without the SmartScreen warning. See
 [Install & first launch](https://yuyichang.github.io/PLASMA/playbook/install/)
 for that and every other install path (prebuilt binaries, PyPI, from source).
 
@@ -101,7 +126,7 @@ plugins: `msense`, `qb2`, `pupil`, `shimmer`, `obs` (and `all`).
 - [x] linux aarch64 build — `PLASMA_Linux_arm64` for Jetson Orin (JetPack 6); CI job `build-linux-arm64`
 - [ ] infrequent stream (e.g., PLASMA journaler) shows green after recording stop
 - [ ] doc for msense workflow with better screenshots
-- [ ] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
+- [x] memo `stage` transition logic optimization (e.g., timing of "ready to start" msg wrt sensor init status)
 
 ## developing a sensor plugin
 

{plasma_app-2.2.2 → plasma_app-2.2.4}/pyproject.toml

@@ -15,6 +15,13 @@ dependencies = [
     "pylsl",
     "numpy",
 ]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
 
 [project.urls]
 Homepage = "https://github.com/YuyiChang/PLASMA"