mbapy 0.7.2__tar.gz → 0.7.4__tar.gz

{mbapy-0.7.2/mbapy.egg-info → mbapy-0.7.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mbapy
-Version: 0.7.2
+Version: 0.7.4
 Summary: MyBA in Python
 Home-page: https://github.com/BHM-Bob/BA_PY
 Author: BHM-Bob G
@@ -10,24 +10,49 @@ Description: <!--
          * @Author: BHM-Bob 2262029386@qq.com
          * @Date: 2022-10-19 22:16:22
          * @LastEditors: BHM-Bob 2262029386@qq.com
-         * @LastEditTime: 2024-04-04 19:36:44
+         * @LastEditTime: 2024-04-30 10:19:58
          * @Description: 
         -->
-        # BA_PY: Optimize Your Workflow with Python!
-        [![Downloads](https://static.pepy.tech/badge/mbapy)](https://pepy.tech/project/mbapy) ![PyPI - Downloads](https://img.shields.io/pypi/dm/mbapy) ![GitHub all releases](https://img.shields.io/github/downloads/BHM-Bob/BA_PY/total?label=GitHub%20all%20releases%20downloads)
         
-        ![GitHub repo size](https://img.shields.io/github/repo-size/BHM-Bob/BA_PY) ![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/BHM-Bob/BA_PY) [![GitHub Commit Activity](https://img.shields.io/github/commit-activity/m/BHM-Bob/BA_PY)](https://github.com/BHM-Bob/BA_PY/pulse)
+        <h1 style="text-align:center;">BA_PY: Optimize Your Workflow with Python!</h1>
+        
+        <p style="text-align:center;">
+        <img src="https://static.pepy.tech/badge/mbapy" alt="Downloads" style="display:inline-block; margin-left:auto; margin-right:auto;" />
+        <img src="https://img.shields.io/pypi/dm/mbapy" alt="Downloads" style="display:inline-block; margin-left:auto; margin-right:auto;" />
+        <img src="https://img.shields.io/github/downloads/BHM-Bob/BA_PY/total?label=GitHub%20all%20releases%20downloads" alt="Downloads" style="display:inline-block; margin-left:auto; margin-right:auto;" />
+        </p>
+        
+        <p style="text-align:center;">
+        <a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://img.shields.io/github/repo-size/BHM-Bob/BA_PY" alt="repo size" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        <a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://img.shields.io/github/languages/code-size/BHM-Bob/BA_PY" alt="code size" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        <a href="https://github.com/BHM-Bob/BA_PY/releases"><img src="https://img.shields.io/github/v/release/BHM-Bob/BA_PY?label=GitHub%20Release" alt="GitHub release (latest by date)" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        <a href="https://github.com/BHM-Bob/BA_PY/releases"><img src="https://img.shields.io/github/commit-activity/m/BHM-Bob/BA_PY" alt="GitHub Commit Activity" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        <a><img src="https://img.shields.io/github/last-commit/BHM-Bob/BA_PY?label=GitHub%20Last%20Commit" alt="GitHub last commit" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        </p>
+        
+        <p style="text-align:center;">
+        <a href="https://pypi.org/project/mbapy/"><img src="https://img.shields.io/pypi/status/mbapy?label=PyPI%20Status" alt="PyPI Status" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        <a href="https://pypi.org/project/mbapy/"><img src="https://img.shields.io/pypi/v/mbapy?label=PyPI%20Release" alt="PyPI" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        <a href="https://pypi.org/project/mbapy/"><img src="https://img.shields.io/pypi/pyversions/mbapy" alt="python versions" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        </p>
+        
+        <p style="text-align:center;">
+        <img alt="GitHub language count" src="https://img.shields.io/github/languages/count/BHM-Bob/BA_PY">
+        <a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://img.shields.io/readthedocs/ba-py" alt="docs" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        <a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://img.shields.io/github/license/BHM-Bob/BA_PY" alt="license" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        <a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://codeium.com/badges/main" alt="codeium" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        </p>
+        
+        <p style="text-align:center;">
+        <a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://camo.githubusercontent.com/c292429e232884db22e86c2ea2ea7695bc49dc4ae13344003a95879eeb7425d8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f57696e646f77732d3030373844363f7374796c653d666f722d7468652d6261646765266c6f676f3d77696e646f7773266c6f676f436f6c6f723d7768697465" alt="windows" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        <a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://camo.githubusercontent.com/7eefb2ba052806d8a9ce69863c2eeb3b03cd5935ead7bd2e9245ae2e705a1adf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c696e75782d4643433632343f7374796c653d666f722d7468652d6261646765266c6f676f3d6c696e7578266c6f676f436f6c6f723d626c61636b" alt="linux" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+        </p>
         
-        ![PyPI - Status](https://img.shields.io/pypi/status/mbapy?label=PyPI%20Status) ![PyPI](https://img.shields.io/pypi/v/mbapy) ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mbapy)
-        
-        ![Read the Docs](https://img.shields.io/readthedocs/ba-py) ![GitHub](https://img.shields.io/github/license/BHM-Bob/BA_PY) [![built with Codeium](https://codeium.com/badges/main)](https://codeium.com)
-        
-        ![platform - WINDOWS](https://camo.githubusercontent.com/c292429e232884db22e86c2ea2ea7695bc49dc4ae13344003a95879eeb7425d8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f57696e646f77732d3030373844363f7374796c653d666f722d7468652d6261646765266c6f676f3d77696e646f7773266c6f676f436f6c6f723d7768697465) ![platform - LINUX](https://camo.githubusercontent.com/7eefb2ba052806d8a9ce69863c2eeb3b03cd5935ead7bd2e9245ae2e705a1adf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c696e75782d4643433632343f7374796c653d666f722d7468652d6261646765266c6f676f3d6c696e7578266c6f676f436f6c6f723d626c61636b)
         
         mbapy is a Python package that includes a collection of useful Python scripts as sub-modules, and it's goal is *Basic for All in Python*.  
         mbapy primarily focus on data works, including data-retrieval, data-management, data-visualization, data-analysis and data-computation. It is built for both python-users and command-line-users.
         
-        ## get start
+        <h2 style="text-align:center;">Get start</h2>
         
         #### install 
         Now, mbapy only support pypi install:  
@@ -58,10 +83,12 @@ Description: <!--
         - open source at:  
             1. [github： https://github.com/BHM-Bob/BA_PY](https://github.com/BHM-Bob/BA_PY)  
             2. [gitee： https://gitee.com/BHM-Bob/BA_PY](https://gitee.com/BHM-Bob/BA_PY)  
+            3. [SourceForge： https://sourceforge.net/projects/ba-py/](https://sourceforge.net/projects/ba-py/)
         - docs at: [read the docs: https://ba-py.rtfd.io](https://ba-py.readthedocs.io/en/latest/)  
         - PyPI: [https://pypi.org/project/mbapy/](https://pypi.org/project/mbapy/)  
         
-        # contain  
+        <h2 style="text-align:center;">Contents</h2>
+        
         ## mbapy python package  
         #### \_\_version\_\_  
         *some version info*  

mbapy-0.7.4/README.md

@@ -0,0 +1,155 @@
+<!--
+ * @Author: BHM-Bob 2262029386@qq.com
+ * @Date: 2022-10-19 22:16:22
+ * @LastEditors: BHM-Bob 2262029386@qq.com
+ * @LastEditTime: 2024-04-30 10:19:58
+ * @Description: 
+-->
+
+<h1 style="text-align:center;">BA_PY: Optimize Your Workflow with Python!</h1>
+
+<p style="text-align:center;">
+<img src="https://static.pepy.tech/badge/mbapy" alt="Downloads" style="display:inline-block; margin-left:auto; margin-right:auto;" />
+<img src="https://img.shields.io/pypi/dm/mbapy" alt="Downloads" style="display:inline-block; margin-left:auto; margin-right:auto;" />
+<img src="https://img.shields.io/github/downloads/BHM-Bob/BA_PY/total?label=GitHub%20all%20releases%20downloads" alt="Downloads" style="display:inline-block; margin-left:auto; margin-right:auto;" />
+</p>
+
+<p style="text-align:center;">
+<a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://img.shields.io/github/repo-size/BHM-Bob/BA_PY" alt="repo size" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+<a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://img.shields.io/github/languages/code-size/BHM-Bob/BA_PY" alt="code size" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+<a href="https://github.com/BHM-Bob/BA_PY/releases"><img src="https://img.shields.io/github/v/release/BHM-Bob/BA_PY?label=GitHub%20Release" alt="GitHub release (latest by date)" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+<a href="https://github.com/BHM-Bob/BA_PY/releases"><img src="https://img.shields.io/github/commit-activity/m/BHM-Bob/BA_PY" alt="GitHub Commit Activity" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+<a><img src="https://img.shields.io/github/last-commit/BHM-Bob/BA_PY?label=GitHub%20Last%20Commit" alt="GitHub last commit" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+</p>
+
+<p style="text-align:center;">
+<a href="https://pypi.org/project/mbapy/"><img src="https://img.shields.io/pypi/status/mbapy?label=PyPI%20Status" alt="PyPI Status" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+<a href="https://pypi.org/project/mbapy/"><img src="https://img.shields.io/pypi/v/mbapy?label=PyPI%20Release" alt="PyPI" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+<a href="https://pypi.org/project/mbapy/"><img src="https://img.shields.io/pypi/pyversions/mbapy" alt="python versions" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+</p>
+
+<p style="text-align:center;">
+<img alt="GitHub language count" src="https://img.shields.io/github/languages/count/BHM-Bob/BA_PY">
+<a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://img.shields.io/readthedocs/ba-py" alt="docs" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+<a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://img.shields.io/github/license/BHM-Bob/BA_PY" alt="license" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+<a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://codeium.com/badges/main" alt="codeium" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+</p>
+
+<p style="text-align:center;">
+<a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://camo.githubusercontent.com/c292429e232884db22e86c2ea2ea7695bc49dc4ae13344003a95879eeb7425d8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f57696e646f77732d3030373844363f7374796c653d666f722d7468652d6261646765266c6f676f3d77696e646f7773266c6f676f436f6c6f723d7768697465" alt="windows" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+<a href="https://github.com/BHM-Bob/BA_PY/"><img src="https://camo.githubusercontent.com/7eefb2ba052806d8a9ce69863c2eeb3b03cd5935ead7bd2e9245ae2e705a1adf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c696e75782d4643433632343f7374796c653d666f722d7468652d6261646765266c6f676f3d6c696e7578266c6f676f436f6c6f723d626c61636b" alt="linux" style="display:inline-block; margin-left:auto; margin-right:auto;" /></a>
+</p>
+
+
+mbapy is a Python package that includes a collection of useful Python scripts as sub-modules, and it's goal is *Basic for All in Python*.  
+mbapy primarily focus on data works, including data-retrieval, data-management, data-visualization, data-analysis and data-computation. It is built for both python-users and command-line-users.
+
+<h2 style="text-align:center;">Get start</h2>
+
+#### install 
+Now, mbapy only support pypi install:  
+```
+pip install mbapy
+```
+
+mbapy is a multi-funtional package, and it does not require every third-party packages to make every sub-module work. However, it provides some requriements option to install more specified requirements to make some sub-modules work:  
+1. bio: some packages for biology(sci).  
+    install as `pip install mbapy[bio]`  
+2. game: some packages for game(pygame).  
+    install as `pip install mbapy[game]`  
+3. full: full requirements to make almost every sub-module in mbapy work(except dl_torch).  
+     install as `pip install mbapy[full]`  
+
+If you find the latest release version has some problems, you can try install the up-to-date version on github or gitee:  
+```
+pip install git+https://github.com/BHM-Bob/BA_PY.git
+```
+```
+pip install git+https://gitee.com/BHM-Bob/BA_PY.git
+```
+
+#### docs
+The documentation for mbapy can be found on [read the docs](https://ba-py.readthedocs.io/en/latest/) or just in the `docs` folder.
+
+#### web sites
+- open source at:  
+    1. [github： https://github.com/BHM-Bob/BA_PY](https://github.com/BHM-Bob/BA_PY)  
+    2. [gitee： https://gitee.com/BHM-Bob/BA_PY](https://gitee.com/BHM-Bob/BA_PY)  
+    3. [SourceForge： https://sourceforge.net/projects/ba-py/](https://sourceforge.net/projects/ba-py/)
+- docs at: [read the docs: https://ba-py.rtfd.io](https://ba-py.readthedocs.io/en/latest/)  
+- PyPI: [https://pypi.org/project/mbapy/](https://pypi.org/project/mbapy/)  
+
+<h2 style="text-align:center;">Contents</h2>
+
+## mbapy python package  
+#### \_\_version\_\_  
+*some version info*  
+
+#### base  
+*some utils for easier coding*
+
+#### file
+##### image
+*imgae utils*, including reading, saving and process a image into a feature tensor via pytorch.  
+##### video
+*video utils*, including extract frames or unique frames from a video.  
+
+#### plot
+*pandas.dataFrame utils for plot and some simple plot based on plt*  
+
+#### web
+*utils for web-crawler*  
+##### request
+*get a web hyml page or a selenium browser warpper for easier usage*.  
+##### parse
+*utils for parsing html*  
+##### task
+*small task manager*  
+##### spider
+*a light-weight web spider architecture*  
+
+#### stats
+##### cluster
+*BAKmeans, KOptim, KBayesian from KMeans, and a func for many cluster*  
+##### df
+*pandas.dataFrame utils for stats*  
+##### reg
+*regression*  
+##### test
+*some test func(using scipy and mostly give a support for mbapy-style data input)*  
+
+#### dl-torch
+*pytorch utils for deeplearning*  
+##### bb
+*basic blocks : tiny network structures*  
+##### data
+*utils for dataset loading*  
+##### loss
+*some loss function*  
+##### m
+*model : deeplearning model constructed with basic blocks*  
+##### utils
+*deeplearning training utils*  
+##### optim
+*learning rate scheduler*
+
+#### paper
+*sci-paper utils, contains paper searching, downloading and parsing*  
+##### paper_search
+*search papers via pubmed, baidu xueshu, wos*  
+##### paper_download
+*download papers via scihub*  
+##### paper_parse
+*parse paper from a pdf file into a dict of each sections* 
+
+#### scripts
+*some useful scripts for command user*  
+launch by `python -m mbapy.scripts.XXX` or `mbapy-cli XXX`.  
+
+## examples
+#### web/crawler
+1. chaoxin ppt multi threads downloader (jpg->pdf)
+2. wujin search http://www.basechem.org
+3. chemSub search http://chemsub.online.fr
+4. cnipa https://pss-system.cponline.cnipa.gov.cn/seniorSearch
+

{mbapy-0.7.2 → mbapy-0.7.4}/mbapy/__version__.py

@@ -2,15 +2,15 @@
 Author: BHM-Bob 2262029386@qq.com
 Date: 2022-11-01 22:16:49
 LastEditors: BHM-Bob 2262029386@qq.com
-LastEditTime: 2024-04-21 21:06:53
+LastEditTime: 2024-05-10 21:06:00
 Description: 
 '''
 
 __title__ = "mbapy"
 __description__ = "MyBA in Python"
 __url__ = "https://github.com/BHM-Bob/BA_PY"
-__version__ = "0.7.2"
-__build__ = "20240421_0"
+__version__ = "0.7.4"
+__build__ = "20240510_0"
 __author__ = "BHM-Bob G"
 __author_email__ = "bhmfly@foxmail.com"
 __license__ = "MIT"

{mbapy-0.7.2 → mbapy-0.7.4}/mbapy/base.py

@@ -2,7 +2,7 @@
 Author: BHM-Bob 2262029386@qq.com
 Date: 2022-10-19 22:46:30
 LastEditors: BHM-Bob 2262029386@qq.com
-LastEditTime: 2024-03-01 10:09:58
+LastEditTime: 2024-04-25 22:58:26
 Description: 
 '''
 import ctypes
@@ -356,6 +356,10 @@ def parameter_checker(*arg_checkers, raise_err = True, **kwarg_checkers):
 
     Returns:
         A decorated function that performs argument validity checks before executing the original function.
+        
+    Notes:
+        - If all checkers get passed, the original function is executed.
+        - If any checker fails, the function returns None or raises a ValueError, depending on the value of `raise_err`.
 
     Example usage:
     >>> @check_arguments(path = check_parameters_path, head = check_parameters_len)
@@ -366,32 +370,39 @@ def parameter_checker(*arg_checkers, raise_err = True, **kwarg_checkers):
     def decorator(func):
         @wraps(func)
         def wrapper(*args, **kwargs):
-            # info string
             info_string = f"Parameter checker for {func.__code__.co_name} : Invalid value for argument "
+            def check_arg(checker, arg_name: str, arg_value):
+                if not checker(arg_value):
+                    if raise_err:
+                        raise ValueError(info_string+arg_name)
+                    else:
+                        return put_err(info_string+arg_name, False)
+                return True
+            # args_name will exclude *args and **kwargs with name of args and kwargs
+            args_name = list(func.__code__.co_varnames)[:func.__code__.co_argcount+
+                                                 func.__code__.co_kwonlyargcount]
             # check positional arguments
-            for i, arg_check in enumerate(arg_checkers):
+            for i, arg_checker in enumerate(arg_checkers):
                 if i < len(args):
-                    arg = args[i]
-                    if not arg_check(arg):
-                        arg_name = func.__code__.co_varnames[i]
-                        if raise_err:
-                            raise ValueError(info_string+arg_name)
-                        else:
-                            # directly return a none value, skip the err pop
-                            return put_err(info_string+arg_name, None)
+                    if not check_arg(arg_checker, args_name[i], args[i]):
+                        return None
             # check keyword arguments
             for arg_name, kwarg_checker in kwarg_checkers.items():
-                # pass the rigth arg name
-                if arg_name in func.__code__.co_varnames:
+                # if passed the rigth arg name
+                if arg_name in args_name:
                     # get the index of the argument
-                    idx = func.__code__.co_varnames.index(arg_name)
-                    # get the argument through the index if passed positionally
-                    arg = args[idx] if idx < len(args) else kwargs[arg_name]
-                    if not kwarg_checker(arg):
-                        if raise_err:
-                            raise ValueError(info_string+arg_name)
-                        else:
-                            return put_err(info_string+arg_name, None)
+                    idx = args_name.index(arg_name)
+                    # get arg value
+                    if idx < len(args):
+                        arg_value = args[idx]
+                    elif arg_name in kwargs:
+                        arg_value = kwargs[arg_name]
+                    elif func.__defaults__ and idx-len(args) < len(func.__defaults__):
+                        arg_value = func.__defaults__[idx-len(args)]
+                    else:
+                        raise TypeError(f'{func.__code__.co_name}() minssing required argument')
+                    if not check_arg(kwarg_checker, arg_name, arg_value):
+                        return None
             return func(*args, **kwargs)
         return wrapper
     return decorator
@@ -681,5 +692,11 @@ __all__ = [
 
 if __name__ == '__main__':
     # dev code
-    # set_default_kwargs
-    d = set_default_kwargs({'a':1}, discard_extra=True, eps = 0.5, min_samples = 3)
+    class Test:
+        @parameter_checker(b = lambda b: b in ['b', 'B'], raise_err=False)
+        def __init__(self, a, b: str = 'b', *args, **kwargs) -> None:
+            print(a, b)
+            
+    Test('A')
+    Test('A', 'A', e = 'E')
+    Test('A', 'B', 10)

{mbapy-0.7.2 → mbapy-0.7.4}/mbapy/bio/peptide.py

@@ -309,6 +309,8 @@ class Peptide:
                 parts[-1] = parts[-1] + C_pg
             # generate AAs
             self.AAs = [AnimoAcid(part, aa_repr_w) for part in parts]
+        else:
+            self.AAs = []
         
     def flatten(self, inplace: bool = False):
         """
@@ -323,9 +325,7 @@ class Peptide:
                 seq.append(aa)
         if inplace:
             self.AAs = seq
-            return self
-        else:
-            return seq
+        return seq
         
     def repr(self, repr_w: int = 3, include_pg: bool = True,
              include_dash: bool = True):

mbapy-0.7.4/mbapy/plot.py

@@ -0,0 +1,264 @@
+from itertools import chain, combinations
+from typing import Callable, Dict, List, Tuple, Union, Optional
+
+import matplotlib.patches as patches
+import matplotlib.pyplot as plt
+import matplotlib.ticker as ticker
+import numpy as np
+import pandas as pd
+import seaborn as sns
+import statsmodels.api as sm
+
+if __name__ == '__main__':
+    # dev mode
+    import mbapy.stats.test as mst
+    from mbapy.stats.df import (get_df_data, pro_bar_data, pro_bar_data_R,
+                                sort_df_factors)
+    from mbapy.stats.test import p_value_to_stars
+    # Assembly of functions
+    from mbapy.plot_utils.bar_utils import AxisLable, pro_bar_data, plot_bar, plot_positional_hue
+    from mbapy.plot_utils.line_utils import *
+    from mbapy.plot_utils.scatter_utils import plot_reg, plot_scatter, add_scatter_legend
+else:
+    # release mode
+    from .stats import test as mst
+    from .stats.df import (get_df_data, pro_bar_data, pro_bar_data_R,
+                           sort_df_factors)
+    from .stats.test import p_value_to_stars
+    # Assembly of functions
+    from .plot_utils.bar_utils import AxisLable, pro_bar_data, plot_bar, plot_positional_hue
+    from .plot_utils.line_utils import *
+    from .plot_utils.scatter_utils import plot_reg, plot_scatter, add_scatter_legend
+
+# plt.rcParams['font.sans-serif'] = ['SimHei'] #用来正常显示中文
+plt.rcParams["font.family"] = 'Times New Roman'
+plt.rcParams['axes.unicode_minus'] = False #用来正常显示负号
+colors = plt.rcParams['axes.prop_cycle'].by_key()['color']
+
+def rgb2hex(r, g, b):
+  return '#'+('{:02X}' * 3).format(r, g, b)
+def hex2rgb(hex:str):
+  return [int(hex[i:i+2], 16) for i in (1, 3, 5)]
+def rgbs2hexs(rgbs:List[Tuple[float]]):
+    """
+    Takes a list of RGB tuples and converts them to a list of hexadecimal color codes. 
+    Each RGB tuple must contain three floats between 0 and 1 representing the red, green, and blue 
+    components of the color. Returns a list of hexadecimal color codes as strings.
+    """
+    return list(map(lambda x : rgb2hex(*[int(x[i]*255) for i in range(3)]),
+                    rgbs))
+    
+def get_palette(n:int = 10, mode:Union[None, str] = None, return_n = True) -> List[str]:
+    """get a seq of hex colors    
+    Parameters
+    ----------
+    n: how many colors required
+    mode: kind of colors
+        - hls : [default] sns.color_palette('hls', n)
+        - green : sum 5 grenns
+        - pair : plt.get_cmap('tab20')
+        - others : plt.get_cmap(mode)
+    """
+    assert n >= 1, 'n < 1'
+    ret = None
+    if mode == 'hls':
+        ret = rgbs2hexs(sns.color_palette('hls', n))
+    elif n <= 5 and mode == 'green':
+        ret = ['#80ab1c', '#405535', '#99b69b', '#92e4ce', '#72cb87'][0:n]
+    elif n <= 9:
+        ret = rgbs2hexs(plt.get_cmap('Set1').colors)
+    elif n <= 12:
+        ret = rgbs2hexs(plt.get_cmap('Set3').colors)
+    elif n <= 20 and mode == 'pair':
+        ret = rgbs2hexs(plt.get_cmap('tab20').colors)
+    else:
+        ret = rgbs2hexs(plt.get_cmap(mode).colors)
+    if return_n and ret is not None:
+        ret = ret[:n]
+    return ret
+    
+
+def calcu_swarm_pos(x: float, y: np.ndarray, width: float, d: Optional[float] = None):
+    """
+   This function calculates the x-coordinates for the data points in a swarm plot.
+   The x-coordinates are calculated based on the given x-coordinate, y-coordinates,
+   and width of the swarm. If d is not None, it will be used as the distance between
+   the data points. Otherwise, it will be calculated based on the number of data points.
+   
+    Parameters:
+        - x: the x-coordinate of the center of the swarm.
+        - y: the y-coordinates of the data points.
+        - width: the width of the swarm.
+        - d: the distance between the data points. If None, it will be calculated based on the number of data points.
+        
+    Returns:
+        - A numpy array of x-coordinates for the data points.
+    """
+    def _calcu_arithmetic(x, n, w, d):
+        if isinstance(d, float) or isinstance(d, int):
+            a0 = x - (n-1)*d/2
+            return np.linspace(a0, a0+d*(n-1), n)
+        if n == 1:
+            return x
+        else:
+            a0, d = x-w/2, w/(n-1)
+            return np.linspace(a0, a0+d*(n-1), n)
+    ret = np.zeros(len(y))
+    for y_u in np.unique(y):
+        y_idx = np.where(y == y_u)[0]
+        ret[y_idx] = _calcu_arithmetic(x, len(y_idx), width, d)
+    return ret
+
+def qqplot(tags:List[str], df:pd.DataFrame, figsize = (12, 6), nrows = 1, ncols = 1, **kwargs):
+    """
+    Generate a QQ-plot for each column in the given DataFrame.
+
+    Parameters:
+        tags (List[str]): A list of column names to generate QQ-plots for.
+        df (pd.DataFrame): The DataFrame containing the data.
+        figsize (tuple, optional): The size of the figure. Defaults to (12, 6).
+        nrows (int, optional): The number of rows in the figure grid. Defaults to 1.
+        ncols (int, optional): The number of columns in the figure grid. Defaults to 1.
+        **kwargs: Additional keyword arguments including xlim, ylim, title, tick_size, and label_size.
+
+    Returns:
+        None
+    """
+    axs = []
+    fig = plt.figure(figsize = (12, 6))
+    for fig_idx in range(1, ncols*nrows+1):
+        axs.append(fig.add_subplot(nrows, ncols, fig_idx))
+        if 'xlim' in kwargs:
+            axs[-1].set_xlim(kwargs['xlim'])
+        if 'ylim' in kwargs:
+            axs[-1].set_ylim(kwargs['ylim'])            
+        sm.qqplot(np.array(df[tags[fig_idx-1]]), fit=True, line="45", ax=axs[-1])
+        axs[-1].set_title(tags[fig_idx-1]+' - QQPlot', fontdict={'fontsize':15})
+        if 'title' in kwargs:
+            axs[-1].set_ylim(kwargs['title'][fig_idx-1])
+        if 'tick_size' in kwargs:
+            axs[-1].tick_params(labelsize = kwargs['tick_size'])
+        if 'label_size' in kwargs:
+            axs[-1].set_xlabel('Theoretical Quantiles', fontsize = kwargs['label_size'])
+            axs[-1].set_ylabel('Sample Quantiles', fontsize = kwargs['label_size'])
+    return axs
+            
+def save_show(path:str, dpi = 300, bbox_inches = 'tight', show: bool = True):
+    """
+    Saves the current matplotlib figure to a file at the specified path and displays the figure.
+
+    Parameters:
+        - path (str): The path where the figure will be saved.
+        - dpi (int, optional): The resolution of the saved figure in dots per inch. Default is 300.
+        - bbox_inches (str or Bbox, optional): The portion of the figure to save. Default is 'tight'.
+        - show (bool, optional): Whether to show the figure after saving. Default is True.
+    """
+    plt.tight_layout()
+    plt.gcf().savefig(path, dpi=dpi, bbox_inches = bbox_inches)
+    if show:
+        plt.show()
+    
+def plot_stats_star(x1: float, x2: float, h: float, endpoint: float, p_value: float,
+                    ax = plt, p2star: Callable[[float], str] = p_value_to_stars):
+    """
+    Params
+        - x1: The x-coordinate of the left endpoint.
+        - x2: The x-coordinate of the right endpoint.
+        - h: The y-coordinate of the horizontal line.
+        - endpoint: The height of the endpoint.
+        - p_value: The p-value of the difference.
+        - ax: The `Axes` instance to plot on. Default is `plt`.
+        - p2star: A function that converts a p-value to a string of stars. Default is `p_value_to_stars`.
+
+    Returns:
+        None
+    """
+    ax.plot([x1, x2], [h, h], color='black')
+    ax.plot([x1, x1], [h, h-endpoint], color='black')
+    ax.plot([x2, x2], [h, h-endpoint], color='black')
+    ax.text((x1+x2)/2, h, p2star(p_value), ha='center')    
+    
+def plot_turkey(means, std_errs, tukey_results, min_star = 1):
+    """
+    Plot a bar chart showing the means of different groups along with the standard errors.
+
+    Parameters:
+        - means: A list of mean values for each group.
+        - std_errs: A list of standard errors for each group.
+        - tukey_results: The Tukey's test results object.
+
+    Returns:
+        The current `Axes` instance.
+
+    This function plots a bar chart using the given mean values and standard errors. It also marks the groups with significant differences based on the Tukey's test results.
+    For each combination of groups, the function checks if the corresponding Tukey's test result indicates a significant difference. If so, it plots a horizontal line at the maximum height, vertical lines at the endpoints, and places a text label with stars indicating the p-value of the difference.
+    """
+    x = np.arange(len(means))
+    plt.bar(x, means, yerr=std_errs, capsize=5)
+
+    combins = np.array(list(combinations(range(len(means)), 2)))
+    height = max(means) + max(std_errs)
+    min_height = 0.05 * height
+    endpoint_height = [height - 0.05 * min_height, height + 0.05 * min_height]
+    for i, combination in enumerate(combins):
+        if tukey_results.reject[i] \
+                and len(p_value_to_stars(tukey_results.pvalues[i])) >= min_star:
+            plt.plot(combination, [height, height], color='black')
+            plt.plot([combination[0], combination[0]], endpoint_height, color='black')
+            plt.plot([combination[1], combination[1]], endpoint_height, color='black')
+            plt.text(np.mean(combination), height,
+                     p_value_to_stars(tukey_results.pvalues[i]), ha='center')
+            height += min_height
+
+    plt.xticks(x, tukey_results.groupsunique)
+    return plt.gca()
+
+
+__all__ = [
+    'AxisLable',
+    'pro_bar_data',
+    'plot_bar',
+    'plot_positional_hue',
+    
+    'plot_reg',
+    'plot_scatter',
+    'add_scatter_legend',
+    
+    'rgb2hex',
+    'hex2rgb',
+    'rgbs2hexs',
+    'get_palette',
+    'calcu_swarm_pos',
+    'qqplot',
+    'save_show',
+    'plot_stats_star',
+    'plot_turkey'
+]
+
+
+if __name__ == '__main__':
+    # dev code
+    df = pd.read_excel('./data/plot.xlsx', sheet_name='MWM')
+    df['Animal Type'] = df['Animal Type'].astype('str')
+    model = mst.multicomp_turkeyHSD({'Animal Type':[]}, 'Duration', df)
+    result = mst.turkey_to_table(model)
+    print(result)
+    # sub_df = get_df_data({'Animal Type':[]}, ['Duration'], df)
+    sub_df = pro_bar_data(['Animal Type'], ['Duration'], df)
+    # test err
+    cols = get_palette(n = 4, mode = 'hls')
+    plot_bar(['Animal Type'], ['Duration'], df, err = sub_df['Duration_SE'], jitter = True,
+             edgecolor = [cols], linewidth = 5, colors = ['white'], jitter_kwargs = {'size': 10, 'alpha': 1, 'color': [cols]})
+    plt.show()
+    plot_turkey(sub_df['Duration'], sub_df['Duration_SE'], model)
+    plt.show()
+    
+    df = pd.DataFrame({'Month': [5, 5, 6, 6, 7, 7, 8, 8, 9, 9],
+                       'Ozone': [23.61538, 22.22445, 29.44444, 18.20790, 59.11538, 31.63584, 59.96154, 39.68121, 31.44828, 24.14182]})
+    model = mst.multicomp_turkeyHSD({'Month':[]}, 'Ozone', df)
+    result = mst.turkey_to_table(model)
+    print(result)
+    sub_df = pro_bar_data(['Month'], ['Ozone'], df)
+    plot_turkey(sub_df['Ozone'], sub_df['Ozone_SE'], model)
+    plt.show()
+