stepss 3.76__tar.gz → 3.77__tar.gz

{stepss-3.76/stepss.egg-info → stepss-3.77}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stepss
-Version: 3.76
+Version: 3.77
 Summary: Python interface to the STEPSS power-system simulation platform.
 Home-page: https://stepss.sps-lab.org
 Author: Petros Aristidou

{stepss-3.76 → stepss-3.77}/stepss/__init__.py

@@ -17,12 +17,13 @@ Public API exported by this package:
 
 Module-level flags set at import time:
 
-- ``__runTimeObs__`` - ``True`` when gnuplot is available on the system PATH and runtime
-  observable plots are therefore enabled; ``False`` otherwise.
+- ``__runTimeObs__`` - always ``True``. Run-time observables no longer depend on
+  anything being installed, so this flag has nothing left to report. It is kept
+  because it is public, and it is deprecated: do not branch on it.
 """
 
 __package_name__ = "stepss"
-__version__ = '3.76'
+__version__ = '3.77'
 __author__ = "Petros Aristidou"
 __copyright__ = "Petros Aristidou"
 __license__ = "Apache-2.0"
@@ -31,12 +32,9 @@ __email__ = "apetros@pm.me"
 __url__ = "https://stepss.sps-lab.org"
 __status__ = "5 - Production/Stable"
 
-import sys
-from warnings import warn
-
 from . import globals as _globals
 from .cases import cfg
-from .globals import __which, HeliosError
+from .globals import HeliosError
 from .simulator import sim
 from .extractor import extractor, curplot, cur
 from . import helios
@@ -47,17 +45,14 @@ from ._bundled import HELIOS_VERSION as __helios_version__
 __all__ = ["cfg", "sim", "extractor", "cur", "curplot", "helios",
            "HeliosSession", "HeliosError"]
 
-# Detect gnuplot at import time; propagate result to globals so that cases.py
-# (which reads __runTimeObs__ from globals at import time) also gets the correct value.
-if sys.platform in ('win32', 'cygwin'):
-    checkGnuplot = __which('gnuplot.exe')
-else:
-    checkGnuplot = __which('gnuplot')
-if checkGnuplot is None:
-    warn("RAMSES: Gnuplot executable could not be found in the system path, so the runtime observables are disabled.")
-    _globals.__runTimeObs__ = False
-else:
-    _globals.__runTimeObs__ = True
-
-# Re-export the (now-updated) flag under the expected public name.
+# No gnuplot probe. This package has always plotted with matplotlib, through
+# curplot; the probe existed because RAMSES used to draw run-time observables
+# itself by piping to gnuplot, so a machine without gnuplot could not produce
+# them. RAMSES no longer does that: it writes the observable file and calls
+# nothing, so gnuplot's presence has no bearing on anything here.
+#
+# Leaving the probe in place was not merely untidy. addRunObs() gated on this
+# flag and became a silent no-op when the probe failed, so every user without
+# gnuplot installed lost run-time observables for a reason that no longer
+# existed. Kept as a name, always True, because it is documented public API.
 __runTimeObs__ = _globals.__runTimeObs__

{stepss-3.76 → stepss-3.77}/stepss/_bundled.py

@@ -9,5 +9,5 @@ RAMSES_VERSION is also what the stepss version number is built from, so the
 leading components of __version__ always name the library bundled here.
 """
 
-RAMSES_VERSION = "v3.76"
+RAMSES_VERSION = "v3.77"
 HELIOS_VERSION = "v1.4.1"

{stepss-3.76 → stepss-3.77}/stepss/cases.py

@@ -36,7 +36,7 @@ class cfg(object):
     - ``_disc`` (*list of str*) — path for the discrete events trace output.
     - ``_obs`` (*list of str*) — observables definition file (.dat or .obs).
     - ``_trj`` (*list of str*) — Fortran binary trajectory output file (.trj).
-    - ``_runobs`` (*list of str*) — runtime observable descriptors for gnuplot.
+    - ``_runobs`` (*list of str*): runtime observable descriptors.
     - ``_out`` (*list of str*) — execution log / output trace file.
 
     :Example:
@@ -393,7 +393,7 @@ class cfg(object):
     def addRunObs(self, runobs):
         """Add runtime observable.
         
-        This defines some states that will be displayed during the simulation using gnuplot.
+        This defines some states the engine records while the simulation runs.
         
         :param str runobs: Description of runtime observable as defined in the RAMSES userguide
         
@@ -426,11 +426,13 @@ class cfg(object):
 
 
         """
-        if _globals.__runTimeObs__:
-            if runobs not in self._runobs:
-                self._runobs.append(runobs)
-        else:
-            warnings.warn('Gnuplot is not the path, so runtime observables are disabled.')
+        # Unconditional. This used to be gated on a gnuplot PATH probe, from
+        # when RAMSES drew run-time observables itself by piping to gnuplot, and
+        # the else branch made this method a silent no-op for anyone without
+        # gnuplot installed. The engine writes the observable file and calls
+        # nothing, so there is no longer a condition to test.
+        if runobs not in self._runobs:
+            self._runobs.append(runobs)
 
     def clearRunObs(self):
         """Remove all runtime observable descriptors from the case."""

{stepss-3.76 → stepss-3.77/stepss.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stepss
-Version: 3.76
+Version: 3.77
 Summary: Python interface to the STEPSS power-system simulation platform.
 Home-page: https://stepss.sps-lab.org
 Author: Petros Aristidou