SpecLog 0.0.6__tar.gz → 0.0.8__tar.gz

{speclog-0.0.6 → speclog-0.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SpecLog
-Version: 0.0.6
+Version: 0.0.8
 Summary: A Python Package for logging data from instrumentations
 Author-email: Yen-Chun Huang <yen-chun.huang@bruker.com>
 License-Expression: MIT
@@ -101,16 +101,14 @@ SpecLogger start
 SpecLogger stop
 ```
 
+These commands control the installed **SpecLogger** scheduled task; they do not
+start a separate logger process. Enable the startup task first if it is not yet
+installed.
+
 You can also use **Start** and **Stop** at the bottom of the configuration
 editor. Current status is shown as **Running**, **Stopped**, or **Status
 unavailable**. Operation results and errors appear in the **Messages** area.
 
-For troubleshooting, start the logger with a visible debug console:
-
-```text
-SpecLogger -debug True
-```
-
 ## Start logging automatically without login
 
 Open a terminal as Administrator and enable system startup:
@@ -135,7 +133,11 @@ SpecLogger -startup False
 ```
 
 The configuration editor also provides **Enable** and **Disable** startup
-buttons. Administrator permission is normally required to use them.
+buttons. Administrator permission is normally required to use them. 
+
+After **Enable**, open **Task Scheduler** and find **Speclogger** task, disable
+**Stop the task if it runs longer than** in **settings**.
+
 
 If the startup task was created by another administrator, a standard account
 may show startup as **Unavailable**. If new log data is still being written, the
@@ -151,10 +153,28 @@ SpecMonitor
 ```
 
 Use the monitoring-item controls to select which measurements are plotted. Use
-the data-selection controls to choose a start time and duration.
-
-To load all available history, leave the date fields at their defaults and click
-**Ok**. The first import may take longer; later queries load only new or changed
+**Historical Data** to open a separate historical-data window. Enter a start time
+and duration, choose curves from the **Items to plot** checklist, then click
+**OK** to plot the selected range in that window. This checklist is independent
+of the main monitor's live-item selection. After data is loaded, checking or
+unchecking an item updates the historical plot immediately without loading the
+files again. The main monitor remains open and
+continues displaying live data. Click **Reset** to cancel the current historical
+request and clear the selection fields and plot.
+
+The historical plot uses a time-only horizontal axis; its title shows the full
+start and end date/time. Click **Save** to export the loaded Date, Time, and
+currently checked measurement items to a CSV file.
+
+Click **Load** in the Historical Data window to open an existing SpecLog CSV
+file in the historical plot. File loading is kept out of the main monitor so its
+graph continues showing live data.
+
+Click **Save Figure** to export the historical plot, including its title, axes,
+curves, and legend, as a PNG image.
+
+To load all available history, leave Start Time empty, keep Duration at **All**,
+and click **OK**. The first import may take longer; later queries load only new or changed
 files.
 
 Start the monitor with a visible debug console when troubleshooting:
@@ -163,6 +183,19 @@ Start the monitor with a visible debug console when troubleshooting:
 SpecMonitor -debug True
 ```
 
+Monitor curves use a high-contrast subset of the packaged Bruker color palette
+that remains visible on a white background. They cycle through solid, dashed,
+dotted, and dash-dot line shapes when additional curve styles are needed. Style
+assignment is recalculated from the currently selected items, so selections that
+fit within the color palette use solid lines only. These
+application styles are stored internally in
+`SpecLog/config/monitor_config.cfg`; they are separate from the public device
+configuration.
+
+Plot legends are displayed below the curves rather than over them. Legend and
+axis text use larger fonts, and long legends automatically use additional
+columns.
+
 ## Common status messages
 
 - **Running**: The logger is active and directly detectable.

{speclog-0.0.6 → speclog-0.0.8}/README.md

@@ -82,16 +82,14 @@ SpecLogger start
 SpecLogger stop
 ```
 
+These commands control the installed **SpecLogger** scheduled task; they do not
+start a separate logger process. Enable the startup task first if it is not yet
+installed.
+
 You can also use **Start** and **Stop** at the bottom of the configuration
 editor. Current status is shown as **Running**, **Stopped**, or **Status
 unavailable**. Operation results and errors appear in the **Messages** area.
 
-For troubleshooting, start the logger with a visible debug console:
-
-```text
-SpecLogger -debug True
-```
-
 ## Start logging automatically without login
 
 Open a terminal as Administrator and enable system startup:
@@ -116,7 +114,11 @@ SpecLogger -startup False
 ```
 
 The configuration editor also provides **Enable** and **Disable** startup
-buttons. Administrator permission is normally required to use them.
+buttons. Administrator permission is normally required to use them. 
+
+After **Enable**, open **Task Scheduler** and find **Speclogger** task, disable
+**Stop the task if it runs longer than** in **settings**.
+
 
 If the startup task was created by another administrator, a standard account
 may show startup as **Unavailable**. If new log data is still being written, the
@@ -132,10 +134,28 @@ SpecMonitor
 ```
 
 Use the monitoring-item controls to select which measurements are plotted. Use
-the data-selection controls to choose a start time and duration.
-
-To load all available history, leave the date fields at their defaults and click
-**Ok**. The first import may take longer; later queries load only new or changed
+**Historical Data** to open a separate historical-data window. Enter a start time
+and duration, choose curves from the **Items to plot** checklist, then click
+**OK** to plot the selected range in that window. This checklist is independent
+of the main monitor's live-item selection. After data is loaded, checking or
+unchecking an item updates the historical plot immediately without loading the
+files again. The main monitor remains open and
+continues displaying live data. Click **Reset** to cancel the current historical
+request and clear the selection fields and plot.
+
+The historical plot uses a time-only horizontal axis; its title shows the full
+start and end date/time. Click **Save** to export the loaded Date, Time, and
+currently checked measurement items to a CSV file.
+
+Click **Load** in the Historical Data window to open an existing SpecLog CSV
+file in the historical plot. File loading is kept out of the main monitor so its
+graph continues showing live data.
+
+Click **Save Figure** to export the historical plot, including its title, axes,
+curves, and legend, as a PNG image.
+
+To load all available history, leave Start Time empty, keep Duration at **All**,
+and click **OK**. The first import may take longer; later queries load only new or changed
 files.
 
 Start the monitor with a visible debug console when troubleshooting:
@@ -144,6 +164,19 @@ Start the monitor with a visible debug console when troubleshooting:
 SpecMonitor -debug True
 ```
 
+Monitor curves use a high-contrast subset of the packaged Bruker color palette
+that remains visible on a white background. They cycle through solid, dashed,
+dotted, and dash-dot line shapes when additional curve styles are needed. Style
+assignment is recalculated from the currently selected items, so selections that
+fit within the color palette use solid lines only. These
+application styles are stored internally in
+`SpecLog/config/monitor_config.cfg`; they are separate from the public device
+configuration.
+
+Plot legends are displayed below the curves rather than over them. Legend and
+axis text use larger fonts, and long legends automatically use additional
+columns.
+
 ## Common status messages
 
 - **Running**: The logger is active and directly detectable.

{speclog-0.0.6 → speclog-0.0.8}/SpecLog/SpecLogger.py

@@ -8,7 +8,6 @@ import argparse
 import shutil
 import subprocess
 from .SpecLog import *
-from .logger_status import is_logger_running
 from .startup_task import (
     TASK_SCHEDULER,
     control_arguments,
@@ -71,12 +70,17 @@ def configure_startup(enabled, executable=None, runner=None):
 
 
 def control_scheduled_logger(action, runner=None):
-    """Start/stop the startup task, or return None when it is not installed."""
+    """Start or stop SpecLogger exclusively through Windows Task Scheduler."""
     query = _run_task_scheduler(
         query_arguments(), runner
     )
     if query.returncode:
-        return None
+        details = (query.stderr or query.stdout).strip()
+        raise RuntimeError(
+            details
+            or "The SpecLogger scheduled task is not installed or is unavailable. "
+            "Enable startup first with 'SpecLogger -startup True'."
+        )
     result = _run_task_scheduler(
         control_arguments(action), runner
     )
@@ -171,28 +175,8 @@ def main_func(argv=None):
         except RuntimeError as error:
             print(f"Could not control SpecLogger scheduled task: {error}", file=sys.stderr)
             return 1
-        if task_message is not None:
-            print(task_message)
-            return 0
-
-    if args.status == "start":
-        if is_logger_running():
-            print("SpecLogger has started already.")
-            return
-        if args.debug == "False":
-            subprocess.Popen(
-                "SpecLogger_running.exe", creationflags=subprocess.CREATE_NO_WINDOW
-            )
-            print("SpecLogger started")
-        elif args.debug == "True":
-            os.startfile("SpecLogger_running.exe")
-            print("SpecLogger debug mode started")
-
-    elif args.status == "stop":
-        os.system("taskkill /im SpecLogger_running.exe /F /t")
-        print("SpecLogger stopped")
-    else:  # ignore
-        return
+        print(task_message)
+        return 0
 
 
 if __name__ == "__main__":

speclog-0.0.8/SpecLog/config/monitor_config.cfg

@@ -0,0 +1,24 @@
+[Bruker Colors]
+BrukerIce = #008DEB
+BrukerPacific = #054169
+BrukerOcean = #0071BC
+BrukerGlacier = #E5F1F8
+BrukerDolomite = #A0A0A0
+BrukerObsidian = #313331
+BrukerGranite = #737373
+BrukerLimestone = #DCDCDC
+BrukerOrange = #FF9300
+BrukerRed = #FF0011
+BrukerGreen = #AFC800
+
+[Roles]
+primary1 = #054169
+primary2 = #0071BC
+secondary1 = #737373
+secondary2 = #A0A0A0
+accent = #FF9300
+
+[Plot]
+color_order = BrukerPacific, BrukerIce, BrukerOrange, BrukerGreen, BrukerObsidian, BrukerGranite
+line_styles = solid, dash, dot, dash_dot
+line_width = 2.5