py2ls 0.2.7.4__tar.gz

py2ls-0.2.7.4/PKG-INFO

@@ -0,0 +1,576 @@
+Metadata-Version: 2.1
+Name: py2ls
+Version: 0.2.7.4
+Summary: py(thon)2(too)ls
+Author: Jianfeng
+Author-email: Jianfeng.Liu0413@gmail.com
+Requires-Python: >=3.5,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Provides-Extra: full
+Provides-Extra: light
+Provides-Extra: ml
+Provides-Extra: neuroscience
+Provides-Extra: superlight
+Requires-Dist: GEOparse (>=2.0.4) ; extra == "full"
+Requires-Dist: Pillow (>=11.2.1) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: PyYAML (>=6.0.1) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: SQLAlchemy (>=2.0.37) ; extra == "full"
+Requires-Dist: adjustText (>=1.3.0) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: autogluon (>=1.2) ; extra == "full" or extra == "ml"
+Requires-Dist: beautifulsoup4 (>=4.12.3) ; extra == "full" or extra == "light"
+Requires-Dist: catboost (>=1.2.8) ; extra == "full" or extra == "ml"
+Requires-Dist: category_encoders (>=2.8.1) ; extra == "full"
+Requires-Dist: chardet (>=3.0.4) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: cryptography (>=45.0.3) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: cycler (>=0.12.1) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: docx2pdf (>=0.1.8) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: fake-useragent (>=1.5.1) ; extra == "full" or extra == "light"
+Requires-Dist: folium (>=0.19.6) ; extra == "full"
+Requires-Dist: fpdf (>=1.7.2) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: fuzzywuzzy (>=0.18.0) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: geopy (>=2.4.1) ; extra == "full"
+Requires-Dist: gseapy (>=1.1.8) ; extra == "full"
+Requires-Dist: gtts (>=2.5.4) ; extra == "full"
+Requires-Dist: hdbscan (>=0.8.40) ; extra == "full"
+Requires-Dist: imagecodecs (>=2025.3.30) ; extra == "ml"
+Requires-Dist: img2pdf (>=0.5.1) ; extra == "full"
+Requires-Dist: ipykernel (>=6.29.4) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: ipython (>=8.26.0) ; extra == "full" or extra == "light"
+Requires-Dist: langdetect (>=1.0.9) ; extra == "full"
+Requires-Dist: lightgbm (>=4.6.0) ; extra == "full" or extra == "ml"
+Requires-Dist: lxml (>=5.3.0) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: matplotlib (>=3.9.1) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: matplotlib-venn (>=1.1.2) ; extra == "full"
+Requires-Dist: mne (>=1.6.1) ; extra == "neuroscience"
+Requires-Dist: msoffcrypto-tool (>=5.4.2) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: neo (>=0.13.1) ; extra == "neuroscience"
+Requires-Dist: networkx (>=3.3) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: nltk (>=3.8.1) ; extra == "full" or extra == "light"
+Requires-Dist: numerizer (>=0.2.3) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: numpy (>=1.26.4,<2.0.0) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: opencv-python-headless (>=4.10.0.84) ; extra == "full"
+Requires-Dist: openlocationcode (>=1.0.1) ; extra == "full"
+Requires-Dist: openpyxl (>=3.1.5) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: paddleocr (>=2.9.1,<3.0.0) ; extra == "full" or extra == "light"
+Requires-Dist: pandas (>=2.2.2) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: pdf2image (>=1.17.0) ; extra == "full"
+Requires-Dist: phonenumbers (>=8.13.51) ; extra == "full"
+Requires-Dist: pingouin (>=0.5.4) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: pixels2svg (>=0.2.2) ; extra == "full"
+Requires-Dist: premailer (>=3.10.0) ; extra == "full" or extra == "light"
+Requires-Dist: psutil (>=5.9.8) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: py-cpuinfo (>=9.0.0) ; extra == "superlight" or extra == "light"
+Requires-Dist: py7zr (>=0.22.0) ; extra == "full"
+Requires-Dist: pyautogui (>=0.9.54) ; extra == "full"
+Requires-Dist: pycryptodome (>=3.23.0) ; extra == "full"
+Requires-Dist: pydeck (>=0.9.1) ; extra == "full"
+Requires-Dist: pymupdf (>=1.26.1) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: pypdf (>=5.6.1) ; extra == "light"
+Requires-Dist: pyperclip (>=1.9.0) ; extra == "full"
+Requires-Dist: pypinyin (>=0.54.0) ; extra == "full"
+Requires-Dist: pytest (>=8.3.3) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: python-box (>=7.2.0) ; extra == "full" or extra == "light"
+Requires-Dist: python-dateutil (>=2.9.0.post0) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: python-docx (>=1.1.2) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: pytz (>=2024.1) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: pyvis (>=0.3.2) ; extra == "full"
+Requires-Dist: qrcode (>=8.2) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: rarfile (>=4.2) ; extra == "full"
+Requires-Dist: realesrgan (>=0.3.0) ; extra == "full"
+Requires-Dist: regex (>=2024.5.15) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: rembg (>=2.0.57) ; extra == "full"
+Requires-Dist: requests (>=2.32.3) ; extra == "full" or extra == "light"
+Requires-Dist: schedule (>=1.2.2) ; extra == "full"
+Requires-Dist: scikit-image (>=0.23.2) ; extra == "full"
+Requires-Dist: scikit-learn (>=1.5.1) ; extra == "full" or extra == "ml"
+Requires-Dist: scipy (>=1.14.0) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: seaborn (>=0.13.2) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: selenium (>=4.23.1) ; extra == "full" or extra == "light"
+Requires-Dist: setuptools (>=72.1.0) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: skimpy (>=0.0.15) ; extra == "full"
+Requires-Dist: skorch (>=1.0.0) ; extra == "full" or extra == "ml"
+Requires-Dist: statsmodels (>=0.14.2) ; extra == "full"
+Requires-Dist: streamlit (>=1.41.0) ; extra == "full"
+Requires-Dist: streamlit-folium (>=0.25.0) ; extra == "full"
+Requires-Dist: striprtf (>=0.0.29) ; extra == "full"
+Requires-Dist: symspellpy (>=6.9.0) ; extra == "full"
+Requires-Dist: tensorflow (>=2.19.0) ; extra == "full" or extra == "ml"
+Requires-Dist: textblob (>=0.18.0.post0) ; extra == "full" or extra == "superlight" or extra == "light"
+Requires-Dist: tifffile (>=2024.12.12) ; extra == "ml"
+Requires-Dist: torch (>=2.4.0) ; extra == "full" or extra == "ml"
+Requires-Dist: tqdm (>=4.66.4) ; extra == "full" or extra == "light"
+Requires-Dist: umap (>=0.1.1) ; extra == "full"
+Requires-Dist: validators (>=0.35.0) ; extra == "full"
+Requires-Dist: venn (>=0.1.3) ; extra == "full"
+Requires-Dist: webdriver-manager (>=4.0.1) ; extra == "full" or extra == "light"
+Requires-Dist: xgboost (>=3.0.2) ; extra == "full" or extra == "ml"
+Description-Content-Type: text/markdown
+
+# Install
+
+```python
+pip install py2ls
+
+
+- Minimal version: pip install py2ls
+- Light version: pip install py2ls[light]
+- Full version: pip install py2ls[full]
+- Or any combination like pip install py2ls[full,ml]
+```
+
+
+# ips
+
+### listdir, basename, dirname, newfolder, finfo
+
+e.g., 
+
+```python
+fpath = "....../"
+ips.listdir(fpath, kind='pdf', sort_by="size", ascending=0, output = 'df')
+```
+
+it filters the ‘.pdf’ files, and sort by the (file-size/name, length of name, create_time, mod_time, last_open_time …) it returns a DataFrame or BoxList (setting by ‘output’)
+
+```python
+dir_data, dir_fig = newfolder(fpath, {'data', 'fig'}) # create folder
+```
+
+```python
+finfo(fpath) # get info: size, creation time, mod time, parent_path, fname, kind...
+```
+
+```python
+dir_lib(lib_of_interest) # get the fpath
+```
+
+
+
+### list_func/func_list (same)
+
+list functions in a package
+
+### fload, fsave, figsave
+
+e.g., 
+
+```python
+fload(fpath, kind=None, **kwargs)
+```
+
+load file (docx, pdf, image, md, json,csv,txt, html, yaml, xml, xlsx…) or save file.
+
+```python
+# figsave, as used in matlab. 
+figsave(dir_save, "fname.pdf", dpi=300)
+```
+
+
+
+### pdf2img, img2pdf, docx2pdf
+
+extract images from a PDF, or merge images into a pdf file
+
+```python
+pdf2img(dir_pdf, dir_save=None, page=None, kind="png",verbose=True, **kws)
+pdf2img(fpath, page=[None, None])  # means extract all pages
+# processing page: 1
+# processing page: 2
+# processing page: 3
+# processing page: 4
+# processing page: 5
+
+```
+
+```python
+img2pdf(dir_img, kind="jpeg",page=None, dir_save=None, page_size="a4", dpi=300)
+```
+
+```python
+docx2pdf(dir_docx, dir_save) # convert docx to pdf
+```
+
+### paper_size
+
+quickly get the size info
+
+```python
+paper_size('a4') # [210, 297]
+paper_size('card') # [85.6, 53.98]
+```
+
+
+
+### str2num, num2str, str2list
+
+```python
+str2num(“123.345 dollers”,2)# => 123.35 (float) 
+```
+
+```python
+str2list("abcd") # ['a','b','c','d']
+```
+
+```python
+list2str(['a','b','c','d']) # 'abcd'
+```
+
+### ssplit, sreplace
+
+```python
+sreplace(text, dict_replace=None, robust=True)
+```
+
+```python
+ssplit(text, by="space", verbose=False, **kws) # by = "word", "sentence", ", ","num_strings","digital".....,"length", "upper followed lower", "lower followed upper"
+```
+
+```python
+text = "The most pronounced physiological changes in sleep occur in the brain.[10] The brain uses significantly less energy during sleep than it does when awake, especially during non-REM sleep. In areas with reduced activity, the brain restores its supply of adenosine triphosphate (ATP), the molecule used for short-term storage and transport of energy.[11] In quiet waking, the brain is responsible for 20% of the body's energy use, thus this reduction has a noticeable effect on overall energy consumption.[12]"
+ssplit(text, by=["[10]", "[11]", "[12]"])
+# ['The most pronounced physiological changes in sleep occur in the brain.',
+# ' The brain uses significantly less energy during sleep than it does when awake, especially during non-REM sleep. In areas with reduced activity, the brain restores its supply of adenosine triphosphate (ATP), the molecule used for short-term storage and transport of energy.',
+# " In quiet waking, the brain is responsible for 20% of the body's energy use, thus this reduction has a noticeable effect on overall energy consumption.",
+ # '']
+```
+
+```python
+ssplit(text[:30], by="len", length=5)
+# ['The m', 'ost p', 'ronou', 'nced ', 'physi', 'ologi']
+```
+
+```python
+ssplit(text, by="non_alphanumeric")
+# ['The most pronounced physiological changes in sleep occur in the brain.[',
+#  '10',
+#  '] The brain uses significantly less energy during sleep than it does when awake, especially during non-REM sleep. In areas with reduced activity, the brain restores its supply of adenosine triphosphate (ATP), the molecule used for short-term storage and transport of energy.[',
+#  '11',
+#  '] In quiet waking, the brain is responsible for ',
+#  '20',
+#  "% of the body's energy use, thus this reduction has a noticeable effect on overall energy consumption.[",
+#  '12',
+#  ']']
+```
+
+```python
+ssplit(text, by="sent")
+#['The most pronounced physiological changes in sleep occur in the brain.',
+ #'[10] The brain uses significantly less energy during sleep than it does when awake, especially during non-REM sleep.',
+ #'In areas with reduced activity, the brain restores its supply of adenosine triphosphate (ATP), the molecule used for short-term storage and transport of energy.',
+ #"[11] In quiet waking, the brain is responsible for 20% of the body's energy use, thus this reduction has a noticeable effect on overall energy consumption.",
+ #'[12]']
+```
+
+```python
+ssplit(text, by="lowup")
+# ["The most pronounced physiological changes in sleep occur in the brain.[10] The brain uses significantly less energy during sleep than it does when awake, especially during non-REM sleep. In areas with reduced activity, the brain restores its supply of adenosine triphosphate (ATP), the molecule used for short-term storage and transport of energy.[11] In quiet waking, the brain is responsible for 20% of the body's energy use, thus this reduction has a noticeable effect on overall energy consumption.[12]"]
+
+```
+
+```python
+sreplace(text, dict_replace=None, robust=True)
+```
+
+```python
+text= 'The most pronounced physiological changes in sleep occur in the brain.[10] '
+ 'The brain uses significantly less energy during sleep than it does when '
+ 'awake, especially during non-REM sleep. In areas with reduced activity, the '
+ 'brain restores its supply of adenosine triphosphate (ATP), the molecule used '
+ 'for short-term storage and transport of energy.[11] In quiet waking, the '
+ "brain is responsible for 20% of the body's energy use, thus this reduction "
+ 'has a noticeable effect on overall energy consumption.[12]'
+sreplace(text)
+"The most pronounced physiological changes in sleep occur in the brain"
+sreplace(text,{"sleep":"wakewake"}) # sreplace(text,dict(sleep="wakewake"))
+"The most pronounced physiological changes in wakewake occur in the brain."
+```
+
+### stats
+
+#### **FuncCmpt** ( two groups cmp)
+
+```python
+FuncCmpt(X1, X2, pmc='auto', pair='unpaired')
+e.g., 
+X1 = [19, 22, 16, 29, 24]
+X2 = [20, 11, 17, 12, 22]
+p, res = FumcCmpt(X1,X2, pmc='pmc', pair = 'unpair')
+# normally distributed
+# normally distributed
+# unpaired t text
+# t(8) = 1.81117, p=0.1077
+p,res = FuncCmpt(x1,x2, pmc='pmc',pair='pair')
+# paired t test
+# t(4)=1.55556,p=0.19479
+```
+
+#### FuncMultiCmpt ( multiple groups cmp)
+
+```python
+FuncMultiCmpt(pmc='pmc', pair='unpair', data=None, dv=None, factor=None,
+                  ss_type=2, detailed=True, effsize='np2',
+                  correction='auto', between=None, within=None,
+                  subject=None, group=None
+                  )
+```
+
+```python
+df = pd.DataFrame({'score': [64, 66, 68, 75, 78, 94, 98, 79, 71, 80,
+                             91, 92, 93, 90, 97, 94, 82, 88, 95, 96,
+                             79, 78, 88, 94, 92, 85, 83, 85, 82, 81],
+                   'group': np.repeat(['strat1', 'strat2', 'strat3'],repeats=10)})
+res = FuncMultiCmpt(pmc='auto',pair='unpaired',data=df, dv='score', factor='group', group='group')
+res["APA"] 
+# ['group:F(2, 17)=9.71719,p=0.0016']
+```
+
+#### FuncStars
+
+```python
+FuncStars(ax,
+              pval=None,
+              Ylim=None,
+              Xlim=None,
+              symbol='*',
+              yscale=0.95,
+              x1=0,
+              x2=1,
+              alpha=0.05,
+              fontsize=14,
+              fontsize_note=6,
+              rotation=0,
+              fontname='Arial',
+              values_below=None,
+              linego=True,
+              linestyle='-',
+              linecolor='k',
+              linewidth=.8,
+              nsshow='off',
+              symbolcolor='k',
+              tailindicator=[0.06, 0.06],
+              report=None,
+              report_scale=-0.1,
+              report_loc=None)
+
+
+
+```
+
+### plots
+
+#### stdshade
+
+```python
+stdshade(ax=None,*args, **kwargs)
+```
+
+#### add_colorbar
+
+```python
+add_colorbar(im, width=None, pad=None, **kwargs)
+```
+
+#### get_color
+
+```python
+get_color(n=1, cmap='auto')
+```
+
+```python
+get_color(12)
+# ['#474747',
+#  '#FF2C00',
+#  '#0C5DA5',
+#  '#845B97',
+#  '#58BBCC',
+#  '#FF9500',
+#  '#D57DBE',
+#  '#474747',
+#  '#FF2C00',
+#  '#0C5DA5',
+#  '#845B97',
+#  '#58BBCC']
+```
+
+```python
+get_color(5, cmap="jet") # ['#000080', '#000084', '#000089', '#00008d', '#000092']
+get_color(5,cmap="rainbow") #['#8000ff', '#7e03ff', '#7c06ff', '#7a09ff', '#780dff']
+```
+
+#### img appearance
+
+#### imgsets
+
+```python
+imgsets(
+    img,
+    sets=None,
+    show=True,
+    show_axis=False,
+    size=None,
+    dpi=100,
+    figsize=None,
+    auto=False,
+    filter_kws=None,
+)
+```
+
+```python
+img = imgsets(
+    fpath,
+    sets={"rota": -5, "sharp": 10},
+    dpi=200,
+    # show_axis=True,
+)
+figsave(dir_save, "test1_sharp.pdf")
+
+
+img2 = imgsets(
+    fpath,
+    sets={"rota": -5, "crop": [100, 100, 300, 400], "sharp": 10},
+    dpi=200,
+    filter_kws={
+        "sharpen": 10,
+    },
+    # show_axis=True,
+)
+figsave(dir_save, "test2_crop.pdf")
+```
+
+```python
+fload(dir_img)
+```
+
+![image-20240613233304196](./README.assets/image-20240613233304196.png)
+
+```python
+imgsets(img, sets={"color": 1.5}, show=0)
+```
+
+![image-20240613233356996](./README.assets/image-20240613233356996.png)
+
+```python
+imgsets(img, sets={"pad": (300, 300), "bgcolor": (73, 162, 127)}, show=0)
+```
+
+![image-20240613233423144](./README.assets/image-20240613233423144.png)
+
+```python
+imgsets(
+    img,
+    sets={"contrast": 1.3, "color": 1.5, "pad": (300, 300)},
+    show=0,
+    filter_kws=dict(sh=1050, EDG=10, gaus=5),
+)
+```
+
+![image-20240613233503718](./README.assets/image-20240613233503718.png)
+
+```python
+imgsets(
+    img,
+    sets={"color": 10.5},
+    show=0,
+    filter_kws=dict(EDGE_ENHANCE=50, EDGE_NHANCEmore=50),
+)
+```
+
+![image-20240613233525291](./README.assets/image-20240613233525291.png)
+
+```python
+imgsets(
+    img,
+    sets=dict(contr=1.5, rm="default"),
+    show=0,
+    # filter_kws=dict(sharp=1),
+)
+```
+
+![image-20240613233554225](./README.assets/image-20240613233554225.png)
+
+```python
+imgsets(
+    img,
+    sets=dict(contr=0, rm="default"),
+    show=0,
+    filter_kws=dict(sharp=1),
+)
+```
+
+![image-20240613233611627](./README.assets/image-20240613233611627.png)
+
+#### figsets
+
+```python
+figsets(*args)
+```
+
+```python
+cm = 1 / 2.54
+# plt.style.use("paper")
+plt.figure(figsize=[8 * cm, 5 * cm])
+for i in range(2, 4):
+    plt.plot(x, y * i, ls="-")
+figsets(
+    plt.gca(),
+    {
+        "xlabel": f"time([{x[0]}:{x[-1]}])",
+        "ylabel": "Amplitude (signals)",
+        # "titel": "paper",
+        "xlim": [0, 600],
+        "xtick": np.arange(0, 620, 150),
+        "xlabel": "test xticklabel",
+        # "ylim": [-2.5, 2.5],
+        "sp": "go",
+        # "style": "paper",
+        "box": ":",
+        "grid": "on",
+        "minorticks": "on",
+        "ticks": {"c": "k"},
+    },
+)
+figsets('style','paper')
+```
+
+```python
+cm = 1/2.54  # centimeters in inches
+fig, ax = plt.subplots(1, 1, figsize=(7*cm, 5*cm))
+x = np.linspace(0, 2 * np.pi, 50) * 100
+y = np.sin(x)
+c=get_color(7)
+
+for i in range(2,7):
+    plt.plot(x, y*i,c=c[i])
+figsets(
+    ax,
+    {
+        "xlim": [0, 450],
+        # "ylim": [-1.5, 1.5],
+        "xlabel": "2222",
+        # "style":"paper",
+        "yticks": np.arange(-5,5, 2),
+        "ylabel": "ylabelsssss",
+        "xtkbel": range(0, 800, 100),
+        # "spine": 5,
+        "suptitle": "supertitle",
+        # "minorticks": "y",
+        # "ticksloc":"lt",
+        # "ticks": {"direction": "out",'c':'b'},
+        "rotation":45,
+        # 'box':"lt",
+        # "labellocation":'r',
+        # "ax_color":'b',
+        # 'grid':{"which":'minor','lw':1,"ls":'-.','c':'b','al':0.3},
+    },
+)
+```
+
+