hcn 0.0.1__tar.gz

hcn-0.0.1/.github/workflows/python-publish.yml

@@ -0,0 +1,53 @@
+name: Upload Python Package
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Build release distributions
+        run: |
+          python -m pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      id-token: write
+
+    environment:
+      name: pypi
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

hcn-0.0.1/.gitignore

@@ -0,0 +1,142 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+
+# Manually Added
+.DS_Store

hcn-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Chao-Ning Hu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hcn-0.0.1/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: hcn
+Version: 0.0.1
+Summary: HCN's Collections of Nonpareils (or Nonsense)
+License: MIT License
+        
+        Copyright (c) 2023 Chao-Ning Hu
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: scipy
+Requires-Dist: matplotlib
+Requires-Dist: gitpython
+Requires-Dist: imageio[ffmpeg,tifffile]
+Dynamic: license-file
+
+Refactoring...

hcn-0.0.1/README.md

@@ -0,0 +1 @@
+Refactoring...

hcn-0.0.1/bak/__init__.py

@@ -0,0 +1,30 @@
+from math import *
+import numpy as np
+import scipy as sp
+import matplotlib.pyplot as plt
+
+from PIL import Image as image
+
+import os, shutil, timeit
+from glob import glob
+from time import sleep
+
+try:
+    from tqdm import tqdm
+except ImportError:
+    pass
+
+from .futils import *
+from .macro import *
+from .laser import *
+from .decorators import *
+
+from .ezmail import *
+from .cryptutils import *
+
+from .plotter import *
+# inline_format()
+
+from .cache import *
+clean_expired_cache()
+

hcn-0.0.1/bak/assets/mplstyle/draft.mplstyle

@@ -0,0 +1,22 @@
+figure.figsize: 3.3, 2.5
+figure.dpi: 150
+
+font.size: 8
+font.family: Latin Modern Roman, Source Han Sans SC
+mathtext.fontset: cm
+
+lines.linewidth: 1.5
+lines.markersize: 4
+
+axes.grid: True
+axes.labelsize: large
+axes.prop_cycle: cycler('color', 'bgmbgm') + cycler('linestyle', ['--', '-.', '--', '-.', '--', '-.'])
+
+legend.fancybox: False
+legend.frameon: True
+legend.framealpha: None
+legend.facecolor: inherit
+legend.edgecolor: inherit
+
+savefig.format: pdf
+savefig.bbox: tight

hcn-0.0.1/bak/assets/mplstyle/group_wiki_style.mplstyle

@@ -0,0 +1,16 @@
+figure.figsize: 3.3, 2.5
+figure.dpi: 150
+
+# text.usetex: true
+
+font.size: 8
+font.family: Source Han Sans SC
+
+# font.sans-serif: Helvetica    
+# font.family: sans-serif
+
+lines.linewidth: 1.5
+lines.markersize: 4
+
+savefig.format: pdf
+savefig.bbox: tight

hcn-0.0.1/bak/assets/mplstyle/matlab_style.py

@@ -0,0 +1,130 @@
+import numpy as np
+import matplotlib.pyplot as plt
+
+from matplotlib_inline import backend_inline
+backend_inline.set_matplotlib_formats('retina')
+del backend_inline
+
+import os
+from matplotlib.font_manager import fontManager
+assets_dir = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), '..')
+)
+fontManager.addfont(os.path.join(assets_dir, 'fonts/SourceHanSans.otf'))
+del fontManager
+
+
+plt.rcParams['font.size'] = 7
+plt.rcParams['font.sans-serif'].append('Source Han Sans SC')
+
+plt.rcParams['axes.linewidth'] = 0.334
+plt.rcParams['xtick.major.width'] = 0.334
+plt.rcParams['ytick.major.width'] = 0.334
+plt.rcParams['figure.dpi'] = 150
+plt.rcParams['figure.figsize'] = (3.3, 2.5)
+plt.rcParams['lines.linewidth'] = 1
+plt.rcParams['lines.markersize'] = 4
+
+plt.rcParams['xtick.top'] = True
+plt.rcParams['ytick.right'] = True
+plt.rcParams['xtick.direction'] = 'in'
+plt.rcParams['ytick.direction'] = 'in'
+plt.rcParams['xtick.major.size'] = 2.3
+plt.rcParams['ytick.major.size'] = 2.3
+
+
+plt.rcParams['savefig.bbox'] = 'tight'
+plt.rcParams['axes.prop_cycle'] = \
+    plt.cycler('color', ['#0072bd', '#d95319', '#edb120', '#7e2f8e', '#77ac30', '#4dbeee', '#a2142f'])
+    # plt.cycler('linestyle', ['-', '--', '-.', ':', '-', '--', '-.'])
+
+plt.rcParams['legend.fancybox'] = False
+plt.rcParams['legend.frameon'] = True
+plt.rcParams['legend.framealpha'] = 1
+plt.rcParams['legend.edgecolor'] = 'k'
+plt.rcParams['legend.handlelength'] = 2.5
+plt.rcParams['legend.borderpad'] = 0.3
+plt.rcParams['legend.handletextpad'] = 0.3
+plt.rcParams['patch.linewidth'] = 0.334
+
+plt.rcParams['axes.unicode_minus'] = False
+
+
+import matplotlib as mpl
+
+
+cm_data = [
+    [0.2081, 0.1663, 0.5292],
+    [0.2116238095, 0.1897809524, 0.5776761905],
+    [0.212252381, 0.2137714286, 0.6269714286],
+    [0.2081, 0.2386, 0.6770857143],
+    [0.1959047619, 0.2644571429, 0.7279],
+    [0.1707285714, 0.2919380952, 0.779247619],
+    [0.1252714286, 0.3242428571, 0.8302714286],
+    [0.0591333333, 0.3598333333, 0.8683333333],
+    [0.0116952381, 0.3875095238, 0.8819571429],
+    [0.0059571429, 0.4086142857, 0.8828428571],
+    [0.0165142857, 0.4266, 0.8786333333],
+    [0.032852381, 0.4430428571, 0.8719571429],
+    [0.0498142857, 0.4585714286, 0.8640571429],
+    [0.0629333333, 0.4736904762, 0.8554380952],
+    [0.0722666667, 0.4886666667, 0.8467],
+    [0.0779428571, 0.5039857143, 0.8383714286],
+    [0.079347619, 0.5200238095, 0.8311809524],
+    [0.0749428571, 0.5375428571, 0.8262714286],
+    [0.0640571429, 0.5569857143, 0.8239571429],
+    [0.0487714286, 0.5772238095, 0.8228285714],
+    [0.0343428571, 0.5965809524, 0.819852381],
+    [0.0265, 0.6137, 0.8135],
+    [0.0238904762, 0.6286619048, 0.8037619048],
+    [0.0230904762, 0.6417857143, 0.7912666667],
+    [0.0227714286, 0.6534857143, 0.7767571429],
+    [0.0266619048, 0.6641952381, 0.7607190476],
+    [0.0383714286, 0.6742714286, 0.743552381],
+    [0.0589714286, 0.6837571429, 0.7253857143],
+    [0.0843, 0.6928333333, 0.7061666667],
+    [0.1132952381, 0.7015, 0.6858571429],
+    [0.1452714286, 0.7097571429, 0.6646285714],
+    [0.1801333333, 0.7176571429, 0.6424333333],
+    [0.2178285714, 0.7250428571, 0.6192619048],
+    [0.2586428571, 0.7317142857, 0.5954285714],
+    [0.3021714286, 0.7376047619, 0.5711857143],
+    [0.3481666667, 0.7424333333, 0.5472666667],
+    [0.3952571429, 0.7459, 0.5244428571],
+    [0.4420095238, 0.7480809524, 0.5033142857],
+    [0.4871238095, 0.7490619048, 0.4839761905],
+    [0.5300285714, 0.7491142857, 0.4661142857],
+    [0.5708571429, 0.7485190476, 0.4493904762],
+    [0.609852381, 0.7473142857, 0.4336857143],
+    [0.6473, 0.7456, 0.4188],
+    [0.6834190476, 0.7434761905, 0.4044333333],
+    [0.7184095238, 0.7411333333, 0.3904761905],
+    [0.7524857143, 0.7384, 0.3768142857],
+    [0.7858428571, 0.7355666667, 0.3632714286],
+    [0.8185047619, 0.7327333333, 0.3497904762],
+    [0.8506571429, 0.7299, 0.3360285714],
+    [0.8824333333, 0.7274333333, 0.3217],
+    [0.9139333333, 0.7257857143, 0.3062761905],
+    [0.9449571429, 0.7261142857, 0.2886428571],
+    [0.9738952381, 0.7313952381, 0.266647619],
+    [0.9937714286, 0.7454571429, 0.240347619],
+    [0.9990428571, 0.7653142857, 0.2164142857],
+    [0.9955333333, 0.7860571429, 0.196652381],
+    [0.988, 0.8066, 0.1793666667],
+    [0.9788571429, 0.8271428571, 0.1633142857],
+    [0.9697, 0.8481380952, 0.147452381],
+    [0.9625857143, 0.8705142857, 0.1309],
+    [0.9588714286, 0.8949, 0.1132428571],
+    [0.9598238095, 0.9218333333, 0.0948380952],
+    [0.9661, 0.9514428571, 0.0755333333],
+    [0.9763, 0.9831, 0.0538],
+]
+
+
+parula = mpl.colors.LinearSegmentedColormap.from_list('parula', cm_data)
+mpl.colormaps.register(parula)
+plt.rcParams['image.cmap'] = 'parula'
+del mpl, parula, cm_data
+
+
+__all__ = []

hcn-0.0.1/bak/assets/mplstyle/paper_matlablike.mplstyle

@@ -0,0 +1,36 @@
+# Imitating 陆老师's PRX, cannot use Chinese fonts due to font
+
+# Line thickness, image size, and font size
+lines.linewidth: 2.5
+figure.figsize: 6.4, 4.8    # Same as matplotlib default
+font.size: 13
+
+# Font settings
+mathtext.fontset: cm
+font.family: Times New Roman
+
+# Axis ticks directed inward, with top and right ticks displayed
+xtick.direction: in
+ytick.direction: in
+xtick.top: True
+ytick.right: True
+
+# Remove default whitespace
+axes.xmargin: 0.0
+axes.ymargin: 0.0
+axes.zmargin: 0.0
+
+# Display labels in larger font size and set color and linestyle cycle 
+# Colors are slightly modified from 'bmh' style
+axes.labelsize: large
+axes.prop_cycle: cycler('color', ['348ABD', 'A60628', '7A68A6', '467821', 'CC79A7', '56B4E9', '00C800', 'F0E442']) + cycler('linestyle', ['-', '--', '-.', ':', '-', '--', '-.', ':'])
+
+# Set the style of the legend box; rectangular black border, opaque
+legend.fancybox: False
+legend.frameon: True
+legend.framealpha: None
+legend.facecolor: inherit
+legend.edgecolor: inherit
+
+# Display fonts in path format for better compatibility
+svg.fonttype: path

hcn-0.0.1/bak/decorators.py

@@ -0,0 +1,129 @@
+import numpy as np
+from matplotlib import pyplot as plt
+import matplotlib.ticker as ticker
+
+import os
+from functools import wraps
+
+from .macro import hashsum, format_time
+
+
+__all__ = [
+    'stopwatch',
+    'parallelize'
+]
+
+
+def plotter_decorator(**kwargs):
+    default_params = {
+          'figsize': None, 
+             'axis': True, 
+             'grid': None, 
+           'xlabel': None, 
+           'ylabel': None, 
+            'title': None,
+             'xlim': None, 
+             'ylim': None, 
+           'legend': True, 
+            'label': None, 
+             'save': None, 
+         'override': False, 
+             'show': False,
+    }
+    default_params = {**default_params, **kwargs}
+    def decorator(plotter_function):
+        from functools import wraps
+        @wraps(plotter_function)
+        def wrapper(*args, **kwargs): 
+            params = {**default_params, **kwargs}
+            if params['figsize'] is not None:
+                old_figsize = plt.rcParams['figure.figsize']
+                plt.rcParams['figure.figsize'] = params['figsize']
+            if not params['axis']:
+                plt.xticks([])
+                plt.yticks([])
+            if params['grid'] is not None:    
+                plt.grid(params['grid'])
+            if params['xlabel'] is not None:
+                plt.xlabel(params['xlabel'])
+            if params['ylabel'] is not None:
+                plt.ylabel(params['ylabel'])
+            if params['title'] is not None:
+                plt.title(params['title'])
+
+            plotter_function(*args, **kwargs)
+
+            # plt.gca().xaxis.set_major_formatter(ticker.ScalarFormatter(useMathText=True))
+            # plt.gca().yaxis.set_major_formatter(ticker.ScalarFormatter(useMathText=True))
+            # plt.ticklabel_format(style='sci', axis='both')
+            
+            if params['xlim'] is not None:
+                plt.xlim(params['xlim'])
+            if params['ylim'] is not None:
+                plt.ylim(params['ylim'])
+            if params['legend'] and params['label'] is not None:
+                plt.legend()
+            save = params['save']
+            if save is not None:
+                if type(save) is bool or type(save) is str:
+                    if save == True:
+                        while True:
+                            temp_name = f'{np.random.randint(0, 1e8)}.svg'
+                            if not os.path.exists(temp_name):
+                                break
+                        plt.savefig(temp_name)
+                        save = hashsum(temp_name, algorithm='sha1')
+                        os.rename(src=temp_name, dst=f'{save}.svg')
+                    elif type(save) is str:
+                        if os.path.exists(save) or os.path.exists(f'{save}.svg'):
+                            if params['override']:
+                                plt.savefig(save)
+                            else:
+                                raise FileExistsError('file already exists')
+                        else:
+                            plt.savefig(save)
+                else:
+                    raise TypeError('type(save) must be bool or str')
+            if params['show']:
+                plt.show()
+            if params['figsize'] is not None:
+                plt.rcParams['figure.figsize'] = old_figsize
+        return wrapper
+    return decorator
+
+
+def stopwatch(func):
+    from time import time
+    @wraps(func)
+    def wrapper(*args, **kargs):
+        start = time()
+        result = func(*args, **kargs)
+        print(f'Function {func.__name__} took: {format_time(time() - start)}')
+        return result
+    return wrapper
+
+
+
+def parallelize(cores: int = 0):
+    from dask import delayed, compute
+    from dask.distributed import Client
+
+    if cores <= 0:
+        import psutil
+        cores = psutil.cpu_count(logical=False)
+
+    def decorator(func):
+        @wraps(func)
+        def wrapper(tasks, *args, **kwargs):
+
+            @delayed
+            def _delayed_func(*args, **kwargs):
+                return func(*args, **kwargs)
+            
+            all_tasks = [_delayed_func(task, *args, **kwargs) for task in tasks]
+            with Client(n_workers=cores, threads_per_worker=1):
+                results = compute(*all_tasks)
+
+            return results
+        return wrapper
+    return decorator