aisp 0.3.21__py3-none-any.whl → 0.4.0__py3-none-any.whl

aisp/utils/sanitizers.py

@@ -1,6 +1,9 @@
 """Utility functions for validation and treatment of parameters."""
 
-from typing import TypeVar, Iterable, Callable, Any, Optional
+from typing import TypeVar, Iterable, Callable, Any, Optional, Dict
+
+import numpy as np
+import numpy.typing as npt
 
 T = TypeVar('T')
 
@@ -62,3 +65,52 @@ def sanitize_seed(seed: Any) -> Optional[int]:
         The original seed if it is a non-negative integer, or None if it is invalid.
     """
     return seed if isinstance(seed, int) and seed >= 0 else None
+
+
+def sanitize_bounds(bounds: Any, problem_size: int) -> Dict[str, npt.NDArray[np.float64]]:
+    """Validate and normalize feature bounds.
+
+    Parameters
+    ----------
+    bounds : Any
+        The input bounds, which must be either None or a dictionary with 'low'
+        and 'high' keys.
+    problem_size : int
+        The expected length for the normalized bounds lists, corresponding to
+        the number of features in the problem.
+
+    Returns
+    -------
+    Dict[str, list]
+        Dictionary {'low': [low_1, ..., low_N], 'high': [high_1, ..., high_N]}.
+
+    Raises
+    ------
+    TypeError
+        If `bounds` is not None and not a dict with 'low'/'high', or if items are non-numeric.
+    ValueError
+        If provided iterables have the wrong length.
+    """
+    if bounds is None or not isinstance(bounds, dict) or set(bounds.keys()) != {'low', 'high'}:
+        raise ValueError("bounds expects a dict with keys 'low' and 'high'")
+    result = {}
+
+    for key in ['low', 'high']:
+        value = bounds[key]
+        if isinstance(value, (float, int)):
+            result[key] = np.array([value] * problem_size).astype(dtype=np.float64)
+        else:
+            if not isinstance(value, (list, np.ndarray)):
+                raise TypeError(
+                    f"{key} must be a list or numpy array, got {type(value).__name__}"
+                )
+            if not all(isinstance(i, (float, int)) for i in value):
+                raise TypeError(f"All elements of {key} must be numeric")
+
+            value = np.array(value).astype(dtype=np.float64)
+            if len(value) != problem_size:
+                raise ValueError(
+                    f"The size of {key} must be equal to the size of the problem ({problem_size})"
+                )
+            result[key] = value
+    return result

aisp/utils/types.py

@@ -8,6 +8,12 @@ FeatureType : Literal["binary-features", "continuous-features", "ranged-features
     - "binary-features": Features with binary values (e.g., 0 or 1).
     - "continuous-features": Features with continuous numeric values.
     - "ranged-features": Features represented by ranges or intervals.
+FeatureTypeAll : Literal["binary-features", "continuous-features", "ranged-features"]
+    Specifies the type of features in the input data. Can be one of:
+    - "binary-features": Features with binary values (e.g., 0 or 1).
+    - "continuous-features": Features with continuous numeric values.
+    - "ranged-features": Features represented by ranges or intervals.
+    - "permutation-features": Features represented by permutation.
 
 MetricType : Literal["manhattan", "minkowski", "euclidean"]
     Specifies the distance metric to use for calculations. Possible values:
@@ -20,12 +26,14 @@ MetricType : Literal["manhattan", "minkowski", "euclidean"]
 """
 
 
-from typing import Literal, TypeAlias
-
+from typing import Literal, TypeAlias, Union
 
 FeatureType: TypeAlias = Literal[
     "binary-features",
     "continuous-features",
     "ranged-features"
 ]
+
+FeatureTypeAll: TypeAlias = Union[FeatureType, Literal["permutation-features"]]
+
 MetricType: TypeAlias = Literal["manhattan", "minkowski", "euclidean"]

{aisp-0.3.21.dist-info → aisp-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aisp
-Version: 0.3.21
+Version: 0.4.0
 Summary: Package with techniques of artificial immune systems.
 Author-email: João Paulo da Silva Barros <jpsilvabarr@gmail.com>
 Maintainer-email: Alison Zille Lopes <alisonzille@gmail.com>
@@ -86,6 +86,7 @@ Artificial Immune Systems (AIS) are inspired by the vertebrate immune system, cr
 > - [x] [**Negative Selection.**](https://ais-package.github.io/docs/aisp-techniques/negative-selection/)
 > - [x] [**Clonal Selection Algorithms.**](https://ais-package.github.io/docs/aisp-techniques/clonal-selection-algorithms/)
 >     * [AIRS - Artificial Immune Recognition System](https://ais-package.github.io/docs/aisp-techniques/clonal-selection-algorithms/airs/)
+>     * [CLONALG - Clonal Selection Algorithm](https://ais-package.github.io/docs/aisp-techniques/clonal-selection-algorithms/clonalg)
 > - [ ] *Danger Theory.*
 > - [x] [*Immune Network Theory.*](https://ais-package.github.io/docs/aisp-techniques/immune-network-theory/)
 >   - [AiNet - Artificial Immune Network para Clustering and Compression](https://ais-package.github.io/docs/aisp-techniques/immune-network-theory/ainet)

aisp-0.4.0.dist-info/RECORD

@@ -0,0 +1,35 @@
+aisp/__init__.py,sha256=9HfYCxZnkj-4R6uZX6ZM6mJt93qzkDo3_h_UwjY6FW0,1244
+aisp/exceptions.py,sha256=I9JaQx6p8Jo7qjwwcrqnuewQgyBdUnOSSZofPoBeDNE,1954
+aisp/base/__init__.py,sha256=NioBFTZmfG6SVk29kH2aQGqpWjvsNlEqY_sMmYLDdFg,763
+aisp/base/_base.py,sha256=uTVh__hQJGe8RCOzCet4ZV3vQbwgj5fXAt4Jdf0x1r0,1792
+aisp/base/_classifier.py,sha256=XibBY-1xPPc-AX6rJaxTOqSQ-7thzAgeR9VggBX8hYk,3536
+aisp/base/_clusterer.py,sha256=-wzZ4vSI_ZtPvLYryfJ75VaKcp67jxl92lJxfjopVYc,2468
+aisp/base/_optimizer.py,sha256=81nRa_KJqw-UZ4IYUFvWWq6bpOR5TMCKr41MNet6oj8,6517
+aisp/base/mutation.py,sha256=S-oh8O0ndMOE8bYIhhKhzxCS99r3nefFVEZ3cb7X3ps,7522
+aisp/base/populations.py,sha256=5y125iJgTu_S0XI1BlAECZLSFua75l3Oo47x_3uI7ss,1750
+aisp/csa/__init__.py,sha256=8e6zUPxZAlQ4NDpDhM4symeewzAwk8-CkqYfeBiPvGQ,799
+aisp/csa/_ai_recognition_sys.py,sha256=00swgeB2CgpQ4zz2bvuVk50jN7839g9pbb33_9cdsv0,18947
+aisp/csa/_base.py,sha256=CIj6NDNAH-GCuZpDXAHEWe7jSHUum7mUOnnvXnkEy60,3593
+aisp/csa/_cell.py,sha256=KS0zqJ4JVipUI6oikDUkzeL2Ayml_GtCQ_HjDQB-HQc,1879
+aisp/csa/_clonalg.py,sha256=Y-WOy27HmstMamyTBg4K1kqXlrxy7iahS4TmfAcc-kM,13770
+aisp/ina/__init__.py,sha256=D69sBmTCa0LYd_dzTbb0QvhgMpWWztD2VIjLCZig2c4,392
+aisp/ina/_ai_network.py,sha256=fmi7wt8EJPuZKmv-iB6J2HDDv0c4lKED-xknmxy-45o,21497
+aisp/ina/_base.py,sha256=O-jiCgqQG_QnG1xlp7mv5u9BZTmuW4pnAV09L9HvjBE,2797
+aisp/nsa/__init__.py,sha256=33RJ5yDW2W-J5ZdUBB1Fk_XFw4bv8AXWvO_amkm79xA,713
+aisp/nsa/_base.py,sha256=3YKlZzA3yhP2uQHfhyKswbHUutlxkOR4wn6N10nSO-w,4119
+aisp/nsa/_binary_negative_selection.py,sha256=Fj8TnS1E9zJOlEKUW4AREYaqftSCO7DSc7lU4L0s_cc,9767
+aisp/nsa/_negative_selection.py,sha256=u3-dKRA-o5J6PUwsazD0lSG3NuUFrsDXZ08jPeU0LsA,18791
+aisp/nsa/_ns_core.py,sha256=SXkZL-p2VQygU4Pf6J5AP_yPzU4cR6aU6wx-e_vlm-c,5021
+aisp/utils/__init__.py,sha256=RzpKhkg8nCZi4G0C4il97f3ESYs7Bbxq6EjTeOQQUGk,195
+aisp/utils/_multiclass.py,sha256=ZC7D2RG1BgkpzjZMU4IHC6uAKyFcqCx10d2jbxCM9xE,1136
+aisp/utils/display.py,sha256=bKRGaB_VVHtKLbJE_XDJXD2fVR1qYX0wxKOlLAqVdYw,5752
+aisp/utils/distance.py,sha256=Ad9wnNL3TwBTk-Tav0jMuuUWWiPxTkFhIYmgepq5Y0Q,6556
+aisp/utils/metrics.py,sha256=zDAScDbHRnfu24alRcZ6fEIUaWNoCD-QCtOCFBWPPo8,1277
+aisp/utils/sanitizers.py,sha256=-ZMn8L5nnRNhtJ3GNr4KkS9383du6B6QkV48xQl3fzw,3771
+aisp/utils/types.py,sha256=LV2J1m-VG-55CHoLGOqONr3OKsrwqTI2e5APSNr2si4,1833
+aisp/utils/validation.py,sha256=RqcS2VdFXkNcOH_7Y3yPi7FBoGWR_ReLBPDBx0UMCqI,1431
+aisp-0.4.0.dist-info/licenses/LICENSE,sha256=fTqV5eBpeAZO0_jit8j4Ref9ikBSlHJ8xwj5TLg7gFk,7817
+aisp-0.4.0.dist-info/METADATA,sha256=RJHKap1PrJm0DGmSQYjDWRz70HF8vgPnUirnJT7DK5s,5292
+aisp-0.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aisp-0.4.0.dist-info/top_level.txt,sha256=Q5aJi_rAVT5UNS1As0ZafoyS5dwNibnoyOYV7RWUB9s,5
+aisp-0.4.0.dist-info/RECORD,,

aisp-0.3.21.dist-info/RECORD

@@ -1,31 +0,0 @@
-aisp/__init__.py,sha256=LuDzEKwj0mzm-0Xqv79qvYMJc7eroVZaHfWRQQRlgFY,708
-aisp/exceptions.py,sha256=I9JaQx6p8Jo7qjwwcrqnuewQgyBdUnOSSZofPoBeDNE,1954
-aisp/base/__init__.py,sha256=b-YzeW1iIAEp7JReS6TVzTeBZwFVsfxtOqG9W4gDvdc,211
-aisp/base/_base.py,sha256=uTVh__hQJGe8RCOzCet4ZV3vQbwgj5fXAt4Jdf0x1r0,1792
-aisp/base/_classifier.py,sha256=xmD7SlPFjdWdrK7dkK8GzLFGOq5w_4jkzK4J-eqHlwA,3375
-aisp/base/_clusterer.py,sha256=-wzZ4vSI_ZtPvLYryfJ75VaKcp67jxl92lJxfjopVYc,2468
-aisp/base/mutation.py,sha256=MJ5BZmJlV2BiECUbo-d4HKJ6MeTI5KuZQqRzevVcF-4,4762
-aisp/csa/__init__.py,sha256=708jwpqia10bqmh-4-_srwwNuBh7jf2Zix-u8Hfbzmk,348
-aisp/csa/_ai_recognition_sys.py,sha256=00swgeB2CgpQ4zz2bvuVk50jN7839g9pbb33_9cdsv0,18947
-aisp/csa/_base.py,sha256=CIj6NDNAH-GCuZpDXAHEWe7jSHUum7mUOnnvXnkEy60,3593
-aisp/csa/_cell.py,sha256=GUxnzvPyIbBm1YYkMhSx0tcV_oyDhJ7wAo5gtr_1CoY,1845
-aisp/ina/__init__.py,sha256=cOnxGcxrBdg6lLv2w2sdlToMahKMh_Gw57AfUUPQjMo,329
-aisp/ina/_ai_network.py,sha256=4OXqr08RBLt0ZcNwBZHsAyolbnw4eM6wAoVwtaklcgs,21416
-aisp/ina/_base.py,sha256=ckKStxiuuwz8O3O2KEb4JFLIifH3I-4O3rhfrmH9oMU,4402
-aisp/nsa/__init__.py,sha256=vL_HbASV6aGiiHAMx0UShqkL-ly-OYcqQLasKdu9p-M,425
-aisp/nsa/_base.py,sha256=3YKlZzA3yhP2uQHfhyKswbHUutlxkOR4wn6N10nSO-w,4119
-aisp/nsa/_binary_negative_selection.py,sha256=Fj8TnS1E9zJOlEKUW4AREYaqftSCO7DSc7lU4L0s_cc,9767
-aisp/nsa/_negative_selection.py,sha256=u3-dKRA-o5J6PUwsazD0lSG3NuUFrsDXZ08jPeU0LsA,18791
-aisp/nsa/_ns_core.py,sha256=SXkZL-p2VQygU4Pf6J5AP_yPzU4cR6aU6wx-e_vlm-c,5021
-aisp/utils/__init__.py,sha256=RzpKhkg8nCZi4G0C4il97f3ESYs7Bbxq6EjTeOQQUGk,195
-aisp/utils/_multiclass.py,sha256=ZC7D2RG1BgkpzjZMU4IHC6uAKyFcqCx10d2jbxCM9xE,1136
-aisp/utils/distance.py,sha256=Ad9wnNL3TwBTk-Tav0jMuuUWWiPxTkFhIYmgepq5Y0Q,6556
-aisp/utils/metrics.py,sha256=zDAScDbHRnfu24alRcZ6fEIUaWNoCD-QCtOCFBWPPo8,1277
-aisp/utils/sanitizers.py,sha256=u1GizdJ-RKfPWJLnuFiM09lpItZMhDR_EvK8YdVHwDk,1858
-aisp/utils/types.py,sha256=cDZHpkzETtVa2rJOB0jBXqjWMNJXhCcWsw8-jvMRRkQ,1306
-aisp/utils/validation.py,sha256=RqcS2VdFXkNcOH_7Y3yPi7FBoGWR_ReLBPDBx0UMCqI,1431
-aisp-0.3.21.dist-info/licenses/LICENSE,sha256=fTqV5eBpeAZO0_jit8j4Ref9ikBSlHJ8xwj5TLg7gFk,7817
-aisp-0.3.21.dist-info/METADATA,sha256=ex0Zb0CWU403OoOogGunOH8p6JauAr3tyxXjBQ-txJ8,5157
-aisp-0.3.21.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aisp-0.3.21.dist-info/top_level.txt,sha256=Q5aJi_rAVT5UNS1As0ZafoyS5dwNibnoyOYV7RWUB9s,5
-aisp-0.3.21.dist-info/RECORD,,