kevin-toolbox-dev 1.3.6__py3-none-any.whl → 1.3.8__py3-none-any.whl

kevin_toolbox/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.3.6"
+__version__ = "1.3.8"
 
 
 import os
@@ -12,5 +12,5 @@ os.system(
 os.system(
     f'python {os.path.split(__file__)[0]}/env_info/check_validity_and_uninstall.py '
     f'--package_name kevin-toolbox-dev '
-    f'--expiration_timestamp 1735563213 --verbose 0'
+    f'--expiration_timestamp 1739089473 --verbose 0'
 )

kevin_toolbox/computer_science/algorithm/registration/registry.py

@@ -283,17 +283,25 @@ class Registry:
             #   （快速判断）判断该模块所在目录是否在 path_set 中
             if loader.path not in path_set:
                 continue
+
+            # 使用 find_spec 代替 find_module
+            module_spec = loader.find_spec(module_name)
+            if module_spec is None:
+                continue
+            path = module_spec.origin  # 获取模块的路径
+
             # is_pkg:
             #   - 为 True 时表示当前遍历到的模块是一个包（即一个包含其他模块或子包的目录）
             #   - 为 False 时表示当前模块是一个普通的 Python 模块（文件），不包含其他模块或子包。
             if is_pkg:
                 #   若是目录形式的 package，判断是否满足 Path_Ignorer 中的 dirs 对应的规则
-                path = os.path.dirname(loader.find_module(module_name).path)
+                # path = os.path.dirname(loader.find_module(module_name).path)
+                path = os.path.dirname(path)
                 if path_ignorer(Ignore_Scope.DIRS, True, os.path.islink(path), path):
                     continue
             else:
                 #   若该模块是 module，判断该模块的文件路径是否满足 Path_Ignorer 中的 files 对应的规则
-                path = loader.find_module(module_name).path
+                # path = loader.find_module(module_name).path
                 if path_ignorer(Ignore_Scope.FILES, False, os.path.islink(path), path):
                     continue
                 #   若该模块与调用的文件相同，则报错。

kevin_toolbox/nested_dict_list/serializer/write.py

@@ -211,6 +211,7 @@ def write(var, output_dir, settings=None, traversal_mode=Traversal_Mode.BFS, b_p
                 file_path=os.path.join(temp_output_dir, "record.json"), b_use_suggested_converter=True)
 
     # 打包成 .tar 文件
+    for_os.remove(path=tgt_path, ignore_errors=True)
     if b_pack_into_tar:
         for_os.pack(source=temp_output_dir)
         os.rename(temp_output_dir + ".tar", output_dir + ".tar")

kevin_toolbox/patches/for_matplotlib/__init__.py

@@ -1,4 +1,4 @@
 from .arrow3d import Arrow3D
 from .add_trajectory_2d import add_trajectory_2d
 from .add_trajectory_3d import add_trajectory_3d
-from .generate_color_list import generate_color_list
+from .clear_border_of_axes import clear_border_of_axes

kevin_toolbox/patches/for_matplotlib/clear_border_of_axes.py

@@ -0,0 +1,34 @@
+def clear_border_of_axes(ax):
+    """
+        用于清除 ax 中的坐标轴和 ticks
+    """
+    ax.set_xticks([])
+    ax.set_yticks([])
+    ax.spines['left'].set_color('none')
+    ax.spines['right'].set_color('none')
+    ax.spines['bottom'].set_color('none')
+    ax.spines['top'].set_color('none')
+    return ax
+
+
+if __name__ == '__main__':
+    import matplotlib.pyplot as plt
+
+    #
+    fig, ax = plt.subplots()
+
+    x = [1, 4]
+    y = [1, 10]
+    ax.plot(x, y)
+
+    # 设置坐标轴的范围，以便更好地展示直线
+    ax.set_xlim([0, 5])
+    ax.set_ylim([0, 15])
+
+    # 添加标题和坐标轴标签
+    ax.set_xlabel('X')
+    ax.set_ylabel('Y')
+    clear_border_of_axes(ax)
+
+    # 显示图形
+    plt.show()

kevin_toolbox/patches/for_matplotlib/color/__init__.py

@@ -0,0 +1,4 @@
+from .color_format import Color_Format
+from .get_format import get_format
+from .convert_format import convert_format
+from .generate_color_list import generate_color_list

kevin_toolbox/patches/for_matplotlib/color/color_format.py

@@ -0,0 +1,7 @@
+from enum import Enum
+
+
+class Color_Format(Enum):
+    HEX_STR = "hex_str"  # 例如 '#FF573380'
+    RGBA_ARRAY = "rgba_array"  # 例如 (255, 87, 51, 0.5)
+    NATURAL_NAME = "natural_name"  # 例如 'red'

kevin_toolbox/patches/for_matplotlib/color/convert_format.py

@@ -0,0 +1,108 @@
+from kevin_toolbox.patches.for_matplotlib.color import Color_Format, get_format
+
+
+def hex_to_rgba(hex_color):
+    hex_color = hex_color.lstrip('#')
+    assert len(hex_color) in (6, 8), \
+        f'hex_color should be 6 or 8 characters long (not including #). but got {len(hex_color)}'
+    res = list(int(hex_color[i * 2:i * 2 + 2], 16) for i in range(len(hex_color) // 2))
+    if len(res) not in (3, 4):
+        breakpoint()
+    if len(res) == 4:
+        res[3] /= 255
+    return tuple(res)
+
+
+def rgba_to_hex(rgba):
+    assert len(rgba) in (3, 4), \
+        f'rgba should be 3 or 4 elements long. but got {len(rgba)}'
+    if len(rgba) == 4:
+        rgba = list(rgba)
+        rgba[3] = max(0, min(255, int(255 * rgba[3])))
+    res = "#"
+    for i in rgba:
+        res += f'{i:02X}'
+    return res
+
+
+NAME_TO_HEX = {
+    'blue': '#0000FF',
+    'red': '#FF0000',
+    'green': '#008000',
+    'orange': '#FFA500',
+    'purple': '#800080',
+    'yellow': '#FFFF00',
+    'brown': '#A52A2A',
+    'pink': '#FFC0CB',
+    'gray': '#808080',
+    'olive': '#808000',
+    'cyan': '#00FFFF'
+}
+HEX_TO_NAME = {v: k for k, v in NAME_TO_HEX.items()}
+
+
+def natural_name_to_hex(name):
+    global NAME_TO_HEX
+    name = name.lower()
+    assert name in NAME_TO_HEX, \
+        f'{name} is not a valid color name.'
+    return NAME_TO_HEX[name]
+
+
+def hex_to_natural_name(hex_color):
+    global HEX_TO_NAME
+    hex_color = hex_color.upper()[:7]
+    assert hex_color in HEX_TO_NAME, \
+        f'{hex_color} does not has corresponding color name.'
+    return HEX_TO_NAME[hex_color]
+
+
+CONVERT_PROCESS_S = {
+    (Color_Format.HEX_STR, Color_Format.NATURAL_NAME): hex_to_natural_name,  # (from, to): process
+    (Color_Format.HEX_STR, Color_Format.RGBA_ARRAY): hex_to_rgba,
+    (Color_Format.NATURAL_NAME, Color_Format.HEX_STR): natural_name_to_hex,
+    (Color_Format.NATURAL_NAME, Color_Format.RGBA_ARRAY): lambda x: hex_to_rgba(natural_name_to_hex(x)),
+    (Color_Format.RGBA_ARRAY, Color_Format.HEX_STR): rgba_to_hex,
+    (Color_Format.RGBA_ARRAY, Color_Format.NATURAL_NAME): lambda x: hex_to_natural_name(rgba_to_hex(x))
+}
+
+
+def convert_format(var, output_format, input_format=None):
+    """
+        在各种颜色格式之间进行转换
+
+        参数：
+            var:
+            input_format:       <str> 描述输入的格式。
+                                    支持 HEX_STR、NATURAL_NAME、RGBA_ARRAY 等格式，
+                                    默认为 None，此时将根据输入推断格式
+            output_format:      <str/list of str> 输出的目标格式。
+                                    当输入是一个 tuple/list 时，将输出其中任一格式，具体规则为：
+                                        - 当 input_format 不在可选的输出格式中时，优先按照第一个输出格式进行转换。
+                                            若转换失败，则按照第二个输出格式进行转换。依次类推。
+                                        - 当 input_format 在可选的输出格式中时，不进行转换。
+    """
+    global CONVERT_PROCESS_S
+    if input_format is None:
+        input_format = get_format(var=var)
+    input_format = Color_Format(input_format)
+    if not isinstance(output_format, (list, tuple,)):
+        output_format = [output_format]
+    output_format = [Color_Format(i) for i in output_format]
+
+    if input_format in output_format:
+        return var
+    else:
+        for output_format_i in output_format:
+            try:
+                return CONVERT_PROCESS_S[(input_format, output_format_i)](var)
+            except Exception as e:
+                raise Exception(f'fail to convert {var} from {input_format} to {output_format}, beacause: {e}')
+
+
+if __name__ == '__main__':
+    print(hex_to_rgba('#FF57337F'))
+    print(rgba_to_hex((255, 87, 51, 0.5)))
+    print(natural_name_to_hex('pink'))
+    print(convert_format(var='#FF57337F', input_format='hex_str', output_format='rgba_array'))
+    print(convert_format(var="#0000FF", output_format="rgba_array"))

kevin_toolbox/patches/for_matplotlib/color/generate_color_list.py

@@ -0,0 +1,50 @@
+from kevin_toolbox.patches.for_matplotlib.color import Color_Format, convert_format
+from kevin_toolbox.patches.for_numpy import random
+
+PREDEFINED = ['blue', 'red', 'green', 'orange', 'purple', 'yellow', "brown", "pink", "gray", "olive", "cyan"]
+PREDEFINED = [convert_format(var=i, output_format=Color_Format.HEX_STR) for i in PREDEFINED]
+
+population = tuple('0123456789ABCDEF')
+
+
+def generate_color_list(nums, seed=None, rng=None, exclude_ls=None, output_format=Color_Format.HEX_STR):
+    """
+        生成颜色列表
+
+        参数:
+            nums:           <int> 生成颜色的数量
+            seed,rng:       随机种子或随机生成器，二选一
+            exclude:        <list of str> 需要排除的颜色
+            output_format:  <Color_Format/str> 输出格式
+                            支持 HEX_STR、RGBA_ARRAY 两种格式
+        返回：
+            不包含 alpha 透明度值的颜色列表
+    """
+    global PREDEFINED, population
+    assert output_format in [Color_Format.HEX_STR, Color_Format.RGBA_ARRAY]
+    output_format = Color_Format(output_format)
+    if exclude_ls is None:
+        exclude_ls = []
+    assert isinstance(exclude_ls, (list, tuple))
+    exclude_ls = set(convert_format(var=i, output_format=Color_Format.HEX_STR) for i in exclude_ls)
+    rng = random.get_rng(seed=seed, rng=rng)
+
+    colors = [i for i in PREDEFINED if i not in exclude_ls][:nums]  # 优先输出预定义的颜色
+
+    # 随机生成剩余数量的颜色
+    while len(colors) < nums:
+        c = "#" + ''.join(
+            rng.choice(population, size=6, replace=True))
+        if c not in colors and c not in exclude_ls:
+            colors.append(c)
+    colors = [convert_format(c, output_format=output_format) for c in colors]
+
+    return colors
+
+
+if __name__ == '__main__':
+    color_list = generate_color_list(1, exclude_ls=['blue'])
+    print(color_list)
+
+    color_list = generate_color_list(nums=1, seed=114, exclude_ls=['#0000FF'])
+    print(color_list)

kevin_toolbox/patches/for_matplotlib/color/get_format.py

@@ -0,0 +1,12 @@
+from kevin_toolbox.patches.for_matplotlib.color import Color_Format
+
+
+def get_format(var):
+    if isinstance(var, str):
+        if var.startswith("#"):
+            res = Color_Format.HEX_STR
+        else:
+            res = Color_Format.NATURAL_NAME
+    else:
+        res = Color_Format.RGBA_ARRAY
+    return res

kevin_toolbox/patches/for_matplotlib/common_charts/plot_lines.py

@@ -1,7 +1,7 @@
 import os
 import matplotlib.pyplot as plt
 from kevin_toolbox.patches.for_os.path import replace_illegal_chars
-from kevin_toolbox.patches.for_matplotlib import generate_color_list
+from kevin_toolbox.patches.for_matplotlib.color import generate_color_list
 
 
 def plot_lines(data_s, title, x_name, output_dir=None, **kwargs):

kevin_toolbox/patches/for_matplotlib/common_charts/plot_scatters.py

@@ -1,6 +1,6 @@
 import os
 import matplotlib.pyplot as plt
-from kevin_toolbox.patches.for_matplotlib import generate_color_list
+from kevin_toolbox.patches.for_matplotlib.color import generate_color_list
 from kevin_toolbox.patches.for_os.path import replace_illegal_chars
 
 

kevin_toolbox/patches/for_matplotlib/common_charts/plot_scatters_matrix.py

@@ -2,7 +2,7 @@ import os
 import pandas as pd
 import seaborn as sns
 import matplotlib.pyplot as plt
-from kevin_toolbox.patches.for_matplotlib import generate_color_list
+from kevin_toolbox.patches.for_matplotlib.color import generate_color_list
 from kevin_toolbox.patches.for_os.path import replace_illegal_chars
 
 

kevin_toolbox/patches/for_optuna/build_study.py

@@ -24,7 +24,7 @@ def build_study(output_dir=None, feasible_domain_path=None, **kwargs):
     if "storage" in kwargs:
         if isinstance(kwargs["storage"], (str,)) and kwargs["storage"].startswith("mysql:"):
             temp_ls = list(kwargs["storage"].split(":", 1))
-            temp[0] = "mysql+pymysql"
+            temp_ls[0] = "mysql+pymysql"
             kwargs["storage"] = ":".join(temp_ls)
         elif isinstance(kwargs["storage"], (dict,)):
             kwargs["storage"] = build_storage(output_dir=output_dir, **kwargs["storage"]).url

kevin_toolbox_dev-1.3.8.dist-info/METADATA

@@ -0,0 +1,58 @@
+Metadata-Version: 2.1
+Name: kevin-toolbox-dev
+Version: 1.3.8
+Summary: 一个常用的工具代码包集合
+Home-page: https://github.com/cantbeblank96/kevin_toolbox
+Download-URL: https://github.com/username/your-package/archive/refs/tags/v1.0.0.tar.gz
+Author: kevin hsu
+Author-email: xukaiming1996@163.com
+License: MIT
+Keywords: mathematics,pytorch,numpy,machine-learning,algorithm
+Platform: UNKNOWN
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: torch (>=1.2.0)
+Requires-Dist: numpy (>=1.19.0)
+Provides-Extra: plot
+Requires-Dist: matplotlib (>=3.0) ; extra == 'plot'
+Provides-Extra: rest
+Requires-Dist: pytest (>=6.2.5) ; extra == 'rest'
+Requires-Dist: line-profiler (>=3.5) ; extra == 'rest'
+
+# kevin_toolbox
+
+一个通用的工具代码包集合
+
+
+
+环境要求
+
+```shell
+numpy>=1.19
+pytorch>=1.2
+```
+
+安装方法：
+
+```shell
+pip install kevin-toolbox  --no-dependencies
+```
+
+
+
+[项目地址 Repo](https://github.com/cantbeblank96/kevin_toolbox)
+
+[使用指南 User_Guide](./notes/User_Guide.md)
+
+[免责声明 Disclaimer](./notes/Disclaimer.md)
+
+[版本更新记录](./notes/Release_Record.md)：
+
+- v 1.3.8 （2024-08-13）【bug fix】【temporary version】
+  - computer_science.algorithm.registration
+    - modify Registry.collect_from_paths() for python>=3.12，在更高版本的python的importlib中 find_module() 方法已被废弃和移除，因此需要替换为 find_spec() 方法。
+
+

{kevin_toolbox_dev-1.3.6.dist-info → kevin_toolbox_dev-1.3.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-kevin_toolbox/__init__.py,sha256=GlBohqsdsyQwDemVwoyESNeDlLwAoCVkFPWXyasVc5U,410
+kevin_toolbox/__init__.py,sha256=JvwRDuUZBeSChmbw5mWQZfrgV96Q990PrPXKOsPg9nk,410
 kevin_toolbox/computer_science/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 kevin_toolbox/computer_science/algorithm/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 kevin_toolbox/computer_science/algorithm/cache_manager/__init__.py,sha256=p2hddkZ1HfYF9-m2Hx-o9IotwQHd4QwDCePy2ADpTDA,41
@@ -42,7 +42,7 @@ kevin_toolbox/computer_science/algorithm/pareto_front/__init__.py,sha256=F1uD0ZT
 kevin_toolbox/computer_science/algorithm/pareto_front/get_pareto_points_idx.py,sha256=WR-_9BruqAWH0QECa40b1Iz1_k6uesBrUYrn2s9ALBM,3008
 kevin_toolbox/computer_science/algorithm/pareto_front/optimum_picker.py,sha256=wnYN2s9r2g1z5wF0FvFLawRYITUJbMXbBs4TPsdvhlE,9923
 kevin_toolbox/computer_science/algorithm/registration/__init__.py,sha256=teEd9HkrB6baLpwNwae5c4wn0QRwV3KtBv-2V9-Z7cc,49
-kevin_toolbox/computer_science/algorithm/registration/registry.py,sha256=vTply8VnVuI3zaRxCJewKICpVwVcUF_Vl7Yu_LG7O4w,17385
+kevin_toolbox/computer_science/algorithm/registration/registry.py,sha256=YNYKSPV2AIUVTup-YheJcT1Pu21llgDtyCWxpsSCaZo,17666
 kevin_toolbox/computer_science/algorithm/scheduler/__init__.py,sha256=ENzZsNaMu6ISilTxeE3_EP_L0dNi8SI7IYdTdxic2nw,76
 kevin_toolbox/computer_science/algorithm/scheduler/strategy_manager.py,sha256=yLh2GBEsedJhqvB90zEmAOdZ8IF7nn1r9lSE95BbnEQ,12194
 kevin_toolbox/computer_science/algorithm/scheduler/trigger.py,sha256=YlqTX2TE44BwcQI0jfvcBCJhouhdAYuhwu2QJhuBWP0,4470
@@ -239,7 +239,7 @@ kevin_toolbox/nested_dict_list/serializer/enum_variable.py,sha256=RWPydtXI4adOJY
 kevin_toolbox/nested_dict_list/serializer/read.py,sha256=BjsEWYoyvEHgRKKVKw0suf1ukug2tAFLMCAmEnndqgg,2945
 kevin_toolbox/nested_dict_list/serializer/saved_node_name_builder.py,sha256=qsD-rmDmVaKZP4owN3Wm3QY2Ksi71XlYETqw4VmIsSU,1011
 kevin_toolbox/nested_dict_list/serializer/variable.py,sha256=ZywG6obipRBCGY1cY42gdvsuWk8GLZXr6eCYcW7ZJ9c,392
-kevin_toolbox/nested_dict_list/serializer/write.py,sha256=HCT_vAUqJPQgMrEZKzLzlu1mA2aSZnmGQ1SqNe5X1fI,21845
+kevin_toolbox/nested_dict_list/serializer/write.py,sha256=HDmwEQHTnhFYITItFxM5Zw7sl7F4a50_MN59mR-pU3g,21898
 kevin_toolbox/nested_dict_list/serializer/backends/__init__.py,sha256=8g7y-L3cmctxao616dVkGiot00FJzKNmNl_69V2bSmE,39
 kevin_toolbox/nested_dict_list/serializer/backends/_json_.py,sha256=oJXIc28yjxsD9ZJuw120pVHTVsTzCdaXEhVUSQeydq4,2145
 kevin_toolbox/nested_dict_list/serializer/backends/_ndl.py,sha256=3YkAq_Bqzehnw0kGxqxwtF6uUz0EV37tLI-1ROHjixY,1794
@@ -260,18 +260,23 @@ kevin_toolbox/nested_dict_list/value_parser/replace_identical_with_reference.py,
 kevin_toolbox/patches/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 kevin_toolbox/patches/for_logging/__init__.py,sha256=xymF6mjwY4Cin7CoEwanFY5ZVk8oY0pDLqjZAGa7_Rg,39
 kevin_toolbox/patches/for_logging/build_logger.py,sha256=0UoRMKaERd8wlHGTiNR3dbLQRAtXcb0QZuGkX2oFgGo,3071
-kevin_toolbox/patches/for_matplotlib/__init__.py,sha256=iFN3eCUhKN_QbnAiYSc7dPNLmjhjo7i9D2OdLprEdOw,180
+kevin_toolbox/patches/for_matplotlib/__init__.py,sha256=Pr9jXGomD3wBvtKE8p9V7rKDY4YBLAP5ayWEuBbDdk4,182
 kevin_toolbox/patches/for_matplotlib/add_trajectory_2d.py,sha256=mKXRUNJiEZBcff3pAkwL_gcKGn55CLRhYCTSd3fj1Go,1837
 kevin_toolbox/patches/for_matplotlib/add_trajectory_3d.py,sha256=VGlZfVY0xhUBOUzWJVPxZZNHHRvWLR0HZzhADA_cbsU,1696
 kevin_toolbox/patches/for_matplotlib/arrow3d.py,sha256=JSnNMr1hU2N4FUX526I4MDr04mksDgu4VuegYFDxk1Q,1361
-kevin_toolbox/patches/for_matplotlib/generate_color_list.py,sha256=byGZiehbPMUz4DnMtAUbjLL6UADahWEA4vBbaneDPH8,984
+kevin_toolbox/patches/for_matplotlib/clear_border_of_axes.py,sha256=aQtzrw4W-DUffvwTqsA9Ez7b_vj-C58ROE_UcCKIawQ,725
+kevin_toolbox/patches/for_matplotlib/color/__init__.py,sha256=5VGALqLCFsGqBWrOnFouVxkpp_DfqMIcKDLzYPdOTy8,170
+kevin_toolbox/patches/for_matplotlib/color/color_format.py,sha256=ADwKfPmryxOuN691ol_2djOIkGQGJcnUAcqE3pbxGJs,205
+kevin_toolbox/patches/for_matplotlib/color/convert_format.py,sha256=fmFwirEqF2OXuH3qiQD_vCTUBqsqDIDR6F62mIX5XmU,4040
+kevin_toolbox/patches/for_matplotlib/color/generate_color_list.py,sha256=TZm-TkOuJbFzJ0_RklliQ9SHjMUhJvjbu7DUJGtgvw0,1993
+kevin_toolbox/patches/for_matplotlib/color/get_format.py,sha256=l_vX8DUsWHNzLwveuF60TLcbQ_P7PvVt1yH_7FjElDs,312
 kevin_toolbox/patches/for_matplotlib/common_charts/__init__.py,sha256=etey2r0LO4PTLnH3VzcRKFe7IHP9I5TMW3DEz3sQx2c,270
 kevin_toolbox/patches/for_matplotlib/common_charts/plot_bars.py,sha256=crS1h79Dz6gGOnqhjuuN2o5pl8CekhCenx9lRz5KPiI,1887
 kevin_toolbox/patches/for_matplotlib/common_charts/plot_confusion_matrix.py,sha256=dxkgiXeoIdtXzcg_HoUnRGqhJk91iNoB5VbLuoG7o_M,2191
 kevin_toolbox/patches/for_matplotlib/common_charts/plot_distribution.py,sha256=stuyaULWM_vVW3r9WrpzGqA8rohQrdNKT3Agsbobqck,2396
-kevin_toolbox/patches/for_matplotlib/common_charts/plot_lines.py,sha256=qhkshWw9kKF2_acv1h59CwZgJIpJ3eiPTmcEcNyhlQE,1985
-kevin_toolbox/patches/for_matplotlib/common_charts/plot_scatters.py,sha256=JCCBV9gLJ07b8y57rBb6SawZVhLPqwUXI-UBPyT18h8,1652
-kevin_toolbox/patches/for_matplotlib/common_charts/plot_scatters_matrix.py,sha256=-ki6h4j-4OHJNCyb2a04l_2uQxUqD2QOMgYfRLmHmVU,1983
+kevin_toolbox/patches/for_matplotlib/common_charts/plot_lines.py,sha256=rb95pupvaiEiGi3o0CP2v-qcOkl1nYF_kgxCTSLGPjI,1991
+kevin_toolbox/patches/for_matplotlib/common_charts/plot_scatters.py,sha256=whO36bmixjwtsjCS6Ah6zEGJAlJyGcD-wmV3dA6u7mk,1658
+kevin_toolbox/patches/for_matplotlib/common_charts/plot_scatters_matrix.py,sha256=bf2EfGlPW9dtDfRse1gk8RVxvC8CJ0NeMdrpSw43wFg,1989
 kevin_toolbox/patches/for_numpy/__init__.py,sha256=SNjZGxTRBn-uzkyZi6Jcz-9juhhZKT8TI70qH-fhGGc,21
 kevin_toolbox/patches/for_numpy/linalg/__init__.py,sha256=TH-M0Orrakyf9S9A8FiDf3zLHY24gP2SGGTuNmLhDP4,128
 kevin_toolbox/patches/for_numpy/linalg/cos_similar.py,sha256=bFkfDwrW3maXq5i9ZABidKfg8ZdEdXfFgNzW_uygrM4,423
@@ -286,7 +291,7 @@ kevin_toolbox/patches/for_numpy/random/variable.py,sha256=Sam-QZgkx9_IvHzZhpUrXl
 kevin_toolbox/patches/for_optuna/__init__.py,sha256=5ZVEXbL6zp6a0rqH2LPsiErZrgpcILWUEtTyK31gzSY,249
 kevin_toolbox/patches/for_optuna/build_sampler.py,sha256=0gRv2vPLyr71mlnTi2cJ4_SxO8WAyQOGL8DXiY7o2Es,1705
 kevin_toolbox/patches/for_optuna/build_storage.py,sha256=kGY7fsWroFJ4TQUGy5j_qG5xDuapdB0H5dy2IKSJoYw,3327
-kevin_toolbox/patches/for_optuna/build_study.py,sha256=8N0ERvVJxSMRemTzJCeVA6ngkAkXqw8AIFFcvOo27V8,2253
+kevin_toolbox/patches/for_optuna/build_study.py,sha256=nDyG8ifHVmMVc0KylD1lU-iO_BlJ49UZwIRdWVUGp-s,2256
 kevin_toolbox/patches/for_optuna/copy_study.py,sha256=neBGpGuNhVQB5R5wtHem48A2hqBYOXFU1LxxQDUQQw0,2743
 kevin_toolbox/patches/for_optuna/sample_from_feasible_domain.py,sha256=-Ckwo2N4vhWr08F7ROLfwLWIx4ERwdwn4Q5Ft2JRm7g,7071
 kevin_toolbox/patches/for_optuna/serialize/__init__.py,sha256=7WTrwFsW1xnW85zECUQtPTRqVUdPU9V1L8UWrFZyyms,35
@@ -323,7 +328,7 @@ kevin_toolbox/patches/for_torch/math/get_y_at_x.py,sha256=bfoVcasZ_tMdhR_1Me0Jli
 kevin_toolbox/patches/for_torch/math/my_around.py,sha256=ptpU3ids50gwf663EpHbw7raj9tNrDGBFZ5t_uMNH14,1378
 kevin_toolbox/patches/for_torch/nn/__init__.py,sha256=aJs3RMqRzQmd8KKDmQW9FxwCqS5yfPqEdg-m0PwlQro,39
 kevin_toolbox/patches/for_torch/nn/lambda_layer.py,sha256=KUuLiX_Dr4bvRmpAaCW5QTDWDcnMPRnw0jg4NNXTFhM,223
-kevin_toolbox_dev-1.3.6.dist-info/METADATA,sha256=c8MZR_BQteWmD6dhfIvq056-O0Ve0Gv4cyPwNn_86t4,4178
-kevin_toolbox_dev-1.3.6.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
-kevin_toolbox_dev-1.3.6.dist-info/top_level.txt,sha256=S5TeRGF-PwlhsaUEPTI-f2vWrpLmh3axpyI6v-Fi75o,14
-kevin_toolbox_dev-1.3.6.dist-info/RECORD,,
+kevin_toolbox_dev-1.3.8.dist-info/METADATA,sha256=_-T8ozrnXN_PHq8oDPy6Eo4PFojwebPLCnGUsaBsFtI,1576
+kevin_toolbox_dev-1.3.8.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
+kevin_toolbox_dev-1.3.8.dist-info/top_level.txt,sha256=S5TeRGF-PwlhsaUEPTI-f2vWrpLmh3axpyI6v-Fi75o,14
+kevin_toolbox_dev-1.3.8.dist-info/RECORD,,

kevin_toolbox/patches/for_matplotlib/generate_color_list.py

@@ -1,33 +0,0 @@
-import random
-
-PREDEFINED = ['blue', 'red', 'green', 'orange', 'purple', 'yellow', "brown", "pink", "gray", "olive", "cyan"]
-
-
-def generate_color_list(nums, seed=None, exclude_ls=None):
-    """
-        参数:
-            nums:           <int> 生成颜色的数量
-            seed:           随机种子
-            exclude:        <list of str> 需要排除的颜色
-    """
-    global PREDEFINED
-    if exclude_ls is None:
-        exclude_ls = []
-    assert isinstance(exclude_ls, (list, tuple))
-
-    colors = [i for i in PREDEFINED if i not in exclude_ls][:nums]  # 优先输出预定义的颜色
-
-    # 随机生成剩余数量的颜色
-    if seed is not None:
-        random.seed(seed)
-    while len(colors) < nums:
-        c = "#" + ''.join(random.choices('0123456789ABCDEF', k=6))
-        if c not in colors and c not in exclude_ls:
-            colors.append(c)
-
-    return colors
-
-
-if __name__ == '__main__':
-    color_list = generate_color_list(20)
-    print(color_list)

kevin_toolbox_dev-1.3.6.dist-info/METADATA

@@ -1,95 +0,0 @@
-Metadata-Version: 2.1
-Name: kevin-toolbox-dev
-Version: 1.3.6
-Summary: 一个常用的工具代码包集合
-Home-page: https://github.com/cantbeblank96/kevin_toolbox
-Download-URL: https://github.com/username/your-package/archive/refs/tags/v1.0.0.tar.gz
-Author: kevin hsu
-Author-email: xukaiming1996@163.com
-License: MIT
-Keywords: mathematics,pytorch,numpy,machine-learning,algorithm
-Platform: UNKNOWN
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Requires-Dist: torch (>=1.2.0)
-Requires-Dist: numpy (>=1.19.0)
-Provides-Extra: plot
-Requires-Dist: matplotlib (>=3.0) ; extra == 'plot'
-Provides-Extra: rest
-Requires-Dist: pytest (>=6.2.5) ; extra == 'rest'
-Requires-Dist: line-profiler (>=3.5) ; extra == 'rest'
-
-# kevin_toolbox
-
-一个通用的工具代码包集合
-
-
-
-环境要求
-
-```shell
-numpy>=1.19
-pytorch>=1.2
-```
-
-安装方法：
-
-```shell
-pip install kevin-toolbox  --no-dependencies
-```
-
-
-
-[项目地址 Repo](https://github.com/cantbeblank96/kevin_toolbox)
-
-[使用指南 User_Guide](./notes/User_Guide.md)
-
-[免责声明 Disclaimer](./notes/Disclaimer.md)
-
-[版本更新记录](./notes/Release_Record.md)：
-
-- v 1.3.6 （2024-07-03）【new feature】
-  - patches
-    - for_os
-      - 【new feature】add find_files_in_dir()，找出目录下带有给定后缀的所有文件的生成器。
-    - for_os.path
-      - 【new feature】add find_illegal_chars()，找出给定的文件名/路径中出现了哪些非法符号。
-      - 【new feature】add replace_illegal_chars()，将给定的文件名/路径中的非法符号替换为合法形式。
-    - for_matplotlib
-      - 【new feature】add module common_charts，新增模块——常用图表，该模块下包含以下函数：
-        - plot_bars()，绘制柱状图
-        - plot_scatters()，绘制散点图
-        - plot_lines()，绘制折线图
-        - plot_distribution()，绘制分布图
-        - plot_scatters_matrix()，绘制散点图矩阵（常用于多变量关系分析）
-        - plot_confusion_matrix()，绘制混淆矩阵（常用于混淆矩阵、相关性矩阵、特征图可视化）
-    - 添加了测试用例。
-  - data_flow.file
-    - markdown
-      - 【new feature】add save_images_in_ndl()，将ndl结构叶节点下的图片对象保存到 plot_dir 中，并替换为该图片的markdown链接。
-        - 便于对表格中的图片或者列表中的图片进行保存和替换。
-      - 【new feature】add find_tables()，用于从文本中找出markdown格式的表格，并以二维数组的列表形式返回。
-      - 【new feature】add parse_table()，将二维数组形式的表格（比如find_tables()的返回列表的元素），解析成指定的格式。
-    - kevin_notation
-      - 【bug fix】fix bug in Kevin_Notation_Writer，增加检验写入的列的元素数量是否一致，不一致时进行报错。
-      - 【bug fix】fix bug in write()，避免对输入参数 metadata 中的内容进行意料之外的改动。
-  - nested_dict_list
-    - add para b_allow_override to serializer.write to allow overwriting，增加参数用于允许强制覆盖已有文件。
-  - computer_science.algorithm
-    - pareto_front
-      - 【new feature】add Optimum_Picker，帕累托最优值选取器。
-        - 记录并更新帕累托最优值
-        - 同时支持监控以下行为，并触发设定的执行器，详见参数 trigger_for_new 和 trigger_for_out。
-                              - 新加值是一个新的帕累托最优值
-                              - 抛弃一个不再是最优的旧的最优值
-    - statistician
-      - 【new feature】add Accumulator_for_Ndl，适用于 ndl 结构的统计器。
-      - 【bug fix】fix bug in Accumulator_Base._init_var()
-      - 【new feature】modify Average_Accumulator，在 add() 中新增了 weight 参数用于计算带权重的平均值
-      - modify Exponential_Moving_Average，add_sequence() 不再支持 weight_ls 参数，让该接口与其他类更加一致。
-    - 添加了测试用例。
-
-