Logging message enhancement

andes/core/discrete.py

@@ -494,8 +494,8 @@ def do_adjust_lower(self, val, lower, allow_adjust=True, adjust_lower=False):
         """
 
         if allow_adjust:
-            mask = (val < lower)
-
+            ue = self.owner.services.get('ue', self.owner.params.get('u', np.ones(self.owner.n))).v
+            mask = np.logical_and(val < lower, ue)
             if sum(mask) == 0:
                 return
 
@@ -540,7 +540,8 @@ def do_adjust_upper(self, val, upper, allow_adjust=True, adjust_upper=False):
         """
 
         if allow_adjust:
-            mask = (val > upper)
+            ue = self.owner.services.get('ue', self.owner.params.get('u', np.ones(self.owner.n))).v
+            mask = (val >= ue * upper)
             if sum(mask) == 0:
                 return
 

andes/core/param.py

@@ -435,6 +435,9 @@ def __init__(self,
         self.vin = None  # values from input
         self.vrange = vrange
         self.vtype = vtype
+        self._non_zero_warning_issued = False
+        self._non_positive_warning_issued = False
+        self._non_negative_warning_issued = False
 
     def add(self, value=None):
         """
@@ -465,20 +468,29 @@ def add(self, value=None):
         if isinstance(value, float):
             # check for non-zero
             if value == 0.0 and self.get_property('non_zero'):
-                logger.warning('Non-zero parameter %s.%s corrected to %s',
-                               self.owner.class_name, self.name, self.default)
+                if not self._non_zero_warning_issued:
+                    logger.warning('Non-zero parameter %s.%s corrected to %s. '
+                                   'This warning will be shown only once.',
+                                   self.owner.class_name, self.name, self.default)
+                    self._non_zero_warning_issued = True
                 value = self.default
 
             # check for non-positive
             if value > 0.0 and self.get_property('non_positive'):
-                logger.warning('Non-Positive parameter %s.%s corrected to %s',
-                               self.owner.class_name, self.name, self.default)
+                if not self._non_positive_warning_issued:
+                    logger.warning('Non-Positive parameter %s.%s corrected to %s. '
+                                   'This warning will be shown only once.',
+                                   self.owner.class_name, self.name, self.default)
+                    self._non_positive_warning_issued = True
                 value = self.default
 
             # check for non-negative
             if value < 0.0 and self.get_property('non_negative'):
-                logger.warning('Non-negative parameter %s.%s corrected to %s',
-                               self.owner.class_name, self.name, self.default)
+                if not self._non_negative_warning_issued:
+                    logger.warning('Non-negative parameter %s.%s corrected to %s. '
+                                   'This warning will be shown only once.',
+                                   self.owner.class_name, self.name, self.default)
+                    self._non_negative_warning_issued = True
                 value = self.default
 
         super(NumParam, self).add(value)

andes/core/service.py

@@ -1237,9 +1237,18 @@ def check(self):
             if limit is None:
                 continue
 
+            # Determine the operational status of devices, use ue when applicable
+            ue = self.owner.services.get('ue', self.owner.params.get('u', np.ones(self.owner.n))).v
+
+            # Identify online devices
+            online_devices = np.where(ue == 1)[0]
+
+            # Update the flag for devices violating the condition
             self.v[:] = np.logical_or(self.v, func(self.u.v, limit.v))
 
-            pos = np.argwhere(func(self.u.v, limit.v)).ravel()
+            # Find positions of online devices violating the condition
+            violating_devices = np.argwhere(func(self.u.v, limit.v)).ravel()
+            pos = np.intersect1d(violating_devices, online_devices)
 
             if len(pos) == 0:
                 continue

docs/source/release-notes.rst

@@ -15,6 +15,8 @@ v1.9.4 (2025-xx-xx)
   list.
 - Fix a bug in line model that causes incorrect admittance matrix.
 - Correct a typo in the PSSE DYR parser, changing "Tprod" to "Tpord".
+- Skip InitChecker logging and limiter adjust for offline devices.
+- In one model, issue a warning only once for NumParam value checks.
 
 v1.9.3 (2025-01-05)
 -------------------

tests/test_numparam.py

@@ -0,0 +1,16 @@
+import andes
+
+
+def test_numparam_online(caplog):
+    """
+    Ensure In one model, issue a warning only once for NumParam value checks.
+    """
+    case = andes.get_case("GBnetwork/GBnetwork.m")
+    mpc = andes.io.matpower.m2mpc(case)
+
+    mpc['branch'][2:5, 3] = 0
+
+    ss = andes.system.System()
+    with caplog.at_level("WARNING"):
+        andes.io.matpower.mpc2system(mpc, ss)
+        assert caplog.text.count("Non-zero parameter Line.x corrected to 1e-08.") == 1

tests/test_services.py

@@ -100,3 +100,37 @@ def test_no_find_or_add(self):
 
         # test if the flag for `am` is set to 0 to disable `am` measurement
         self.assertEqual(ss.REGCP1.zam.v[0], 0)
+
+
+def test_init_checker_online(caplog):
+    """
+    Test the initialization checker for online devices.
+
+    This test ensures that the initialization checker raises a warning
+    when a device's parameters are out of the typical range during TDS
+    initialization process.
+    """
+    ss = andes.run(andes.get_case("npcc/npcc.xlsx"),
+                   setup=True,
+                   default_config=True,
+                   no_output=True)
+    with caplog.at_level("WARNING"):
+        ss.TDS.init()
+        assert "GENCLS (vf range) out of typical lower limit." in caplog.text
+
+
+def test_init_checker_offline(caplog):
+    """
+    Test the initialization checker for offline devices.
+
+    This test ensures that the initialization checker does not raise warnings
+    for devices that are offline.
+    """
+    ss = andes.run(andes.get_case("npcc/npcc.xlsx"),
+                   setup=True,
+                   default_config=True,
+                   no_output=True)
+    ss.GENCLS.set(src='u', attr='v', idx=['GENCLS_3', 'GENCLS_4', 'GENCLS_16'], value=0)
+    with caplog.at_level("WARNING"):
+        ss.TDS.init()
+        assert "GENCLS (vf range) out of typical lower limit." not in caplog.text