oafuncs 0.0.97.2__tar.gz → 0.0.97.4__tar.gz

oafuncs-0.0.97.4/MANIFEST.in

@@ -0,0 +1,5 @@
+include LICENSE.txt
+include README.md
+recursive-include oafuncs/_data *
+recursive-include oafuncs/oa_down *.txt
+recursive-include oafuncs/_script *.py

{oafuncs-0.0.97.2/oafuncs.egg-info → oafuncs-0.0.97.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: oafuncs
-Version: 0.0.97.2
+Version: 0.0.97.4
 Summary: Oceanic and Atmospheric Functions
 Home-page: https://github.com/Industry-Pays/OAFuncs
 Author: Kun Liu
@@ -86,17 +86,88 @@ oafuncs.oa_help.use('query')
 ```
 
 ```shell
-# 此小板块于2024/12/26更新，仅为示例，不代表最新情况
+# 此小板块于2025/03/16更新，仅为示例，不代表最新情况
 函数数量：
-49
+62
 函数列表：
-['MidpointNormalize', 'add_cartopy', 'add_gridlines', 'add_lonlat_unit', 'check_ncfile', 'choose_cmap', 'clear_folder', 'cmap2colors', 'convert_longitude', 'copy_file', 'create_cmap', 'create_cmap_rgbtxt', 'create_gif', 'download', 'download5doi', 'draw_time_range', 'extract5nc', 'fig_minus', 'file_size', 'find_file', 'get_time_list', 'get_ua', 'get_var', 'how_to_use', 'install_lib', 'interp_2d', 'link_file', 'make_folder', 'merge5nc', 'modify_var_attr', 'modify_var_value', 'nc_isel', 'plot_contourf', 'plot_contourf_cartopy', 'plot_contourf_lonlat', 'plot_quiver', 'query', 'remove', 'remove_empty_folder', 'rename_file', 'rename_var_or_dim', 'send', 'show', 'sign_in_love_ocean', 'sign_in_meteorological_home', 'sign_in_scientific_research', 'upgrade_lib', 'use', 'write2nc']
+[
+    'MidpointNormalize',
+    'ParallelExecutor',
+    'add_cartopy',
+    'add_gridlines',
+    'add_lonlat_unit',
+    'check',
+    'clear_folder',
+    'contour',
+    'contourf',
+    'convert_longitude',
+    'copy_file',
+    'create',
+    'create_rgbtxt',
+    'data_record',
+    'download',
+    'download5doi',
+    'downloader',
+    'draw',
+    'draw_time_range',
+    'ending_record',
+    'ensure_list',
+    'extract',
+    'fig_minus',
+    'file_size',
+    'find_file',
+    'get',
+    'get_days',
+    'get_time_list',
+    'get_ua',
+    'get_var',
+    'gif',
+    'header_record',
+    'how_to_use',
+    'install_lib',
+    'interp_2d',
+    'interp_along_dim',
+    'isel',
+    'link_file',
+    'log',
+    'make_dir',
+    'make_folder',
+    'mask_shapefile',
+    'mean_size',
+    'merge',
+    'modify',
+    'query',
+    'quiver',
+    'remove',
+    'remove_empty_folder',
+    'rename',
+    'rename_file',
+    'save',
+    'send',
+    'show',
+    'sign_in_love_ocean',
+    'sign_in_meteorological_home',
+    'sign_in_scientific_research',
+    'tail_record',
+    'test',
+    'to_color',
+    'upgrade_lib',
+    'use'
+]
+同名函数：
+----------------------------------------
 模块全路径：
 oafuncs.oa_help.query
-函数提示：
 
-    description: 查看oafuncs模块的函数列表
-    example: query()
+Help on function query in module oafuncs.oa_help:
+
+query()
+    Description:
+        Show the number of functions and the list of functions in the module.
+    Example:
+        query()
+
+----------------------------------------
 ```
 
 ## Structure

oafuncs-0.0.97.4/README.md

@@ -0,0 +1,131 @@
+# oafuncs
+
+## Description
+
+**Python Function**
+
+```text
+In the field of geoscience, some commonly used and universal operations!
+
+Just for the convenience of daily use, some complex operations are integrated into general functions.
+
+The code will be optimized and updated from time to time, with additions, deletions, or modifications…
+
+Existing functions will not be completely removed, they might just have a different function name, or the parameter passing might have been optimized…
+
+Note: If there are any requirements, you can email to liukun0312@stu.ouc.edu.cn. Within my capabilities, I can consider implementing them.
+```
+
+## PyPI
+
+```html
+https://pypi.org/project/oafuncs
+```
+
+## Github
+
+```html
+https://github.com/Industry-Pays/OAFuncs
+```
+
+## Example
+
+```python
+import oafuncs
+
+# 查询当前所有可用函数
+oafuncs.oa_help.query()
+# 根据函数名获取使用方法
+oafuncs.oa_help.use('query')
+```
+
+```shell
+# 此小板块于2025/03/16更新，仅为示例，不代表最新情况
+函数数量：
+62
+函数列表：
+[
+    'MidpointNormalize',
+    'ParallelExecutor',
+    'add_cartopy',
+    'add_gridlines',
+    'add_lonlat_unit',
+    'check',
+    'clear_folder',
+    'contour',
+    'contourf',
+    'convert_longitude',
+    'copy_file',
+    'create',
+    'create_rgbtxt',
+    'data_record',
+    'download',
+    'download5doi',
+    'downloader',
+    'draw',
+    'draw_time_range',
+    'ending_record',
+    'ensure_list',
+    'extract',
+    'fig_minus',
+    'file_size',
+    'find_file',
+    'get',
+    'get_days',
+    'get_time_list',
+    'get_ua',
+    'get_var',
+    'gif',
+    'header_record',
+    'how_to_use',
+    'install_lib',
+    'interp_2d',
+    'interp_along_dim',
+    'isel',
+    'link_file',
+    'log',
+    'make_dir',
+    'make_folder',
+    'mask_shapefile',
+    'mean_size',
+    'merge',
+    'modify',
+    'query',
+    'quiver',
+    'remove',
+    'remove_empty_folder',
+    'rename',
+    'rename_file',
+    'save',
+    'send',
+    'show',
+    'sign_in_love_ocean',
+    'sign_in_meteorological_home',
+    'sign_in_scientific_research',
+    'tail_record',
+    'test',
+    'to_color',
+    'upgrade_lib',
+    'use'
+]
+同名函数：
+----------------------------------------
+模块全路径：
+oafuncs.oa_help.query
+
+Help on function query in module oafuncs.oa_help:
+
+query()
+    Description:
+        Show the number of functions and the list of functions in the module.
+    Example:
+        query()
+
+----------------------------------------
+```
+
+## Structure
+
+<img title="" src="./oafuncs/data_store/OAFuncs.png" alt="">
+
+<img title="OAFuncs" src="https://raw.githubusercontent.com/Industry-Pays/OAFuncs/main/oafuncs/data_store/OAFuncs.png" alt="OAFuncs">

oafuncs-0.0.97.4/oafuncs/_script/plot_dataset.py

@@ -0,0 +1,299 @@
+import os
+from typing import Optional, Tuple
+
+import matplotlib as mpl
+
+mpl.use("Agg")  # Use non-interactive backend
+
+import cftime
+import matplotlib.pyplot as plt
+import numpy as np
+from rich import print
+import cartopy.crs as ccrs
+import xarray as xr
+
+import oafuncs
+
+
+def plot_1d(data: xr.DataArray, output_path: str, x_dim: str, y_dim: str, z_dim: str, t_dim: str) -> None:
+    """Plot 1D data."""
+    plt.figure(figsize=(10, 6))
+
+    # Handle time dimension
+    if t_dim in data.dims and isinstance(data[t_dim].values[0], cftime.datetime):
+        try:
+            data[t_dim] = data.indexes[t_dim].to_datetimeindex()
+        except (AttributeError, ValueError, TypeError) as e:
+            print(f"Warning: Could not convert {t_dim} to datetime index: {e}")
+
+    # Determine X axis data
+    x, x_label = determine_x_axis(data, x_dim, y_dim, z_dim, t_dim)
+
+    y = data.values
+    plt.plot(x, y, linewidth=2)
+
+    # Add chart info
+    long_name = getattr(data, "long_name", "No long_name")
+    units = getattr(data, "units", "")
+    plt.title(f"{data.name} | {long_name}", fontsize=12)
+    plt.xlabel(x_label)
+    plt.ylabel(f"{data.name} ({units})" if units else data.name)
+
+    plt.grid(True, linestyle="--", alpha=0.7)
+    plt.tight_layout()
+
+    # Save image
+    os.makedirs(os.path.dirname(output_path), exist_ok=True)
+    plt.savefig(output_path, bbox_inches="tight", dpi=600)
+    plt.clf()
+    plt.close()
+
+
+def determine_x_axis(data: xr.DataArray, x_dim: str, y_dim: str, z_dim: str, t_dim: str) -> Tuple[np.ndarray, str]:
+    """Determine the X axis data and label."""
+    if x_dim in data.dims:
+        return data[x_dim].values, x_dim
+    elif y_dim in data.dims:
+        return data[y_dim].values, y_dim
+    elif z_dim in data.dims:
+        return data[z_dim].values, z_dim
+    elif t_dim in data.dims:
+        return data[t_dim].values, t_dim
+    else:
+        return np.arange(len(data)), "Index"
+
+
+def plot_2d(data: xr.DataArray, output_path: str, data_range: Optional[Tuple[float, float]], x_dim: str, y_dim: str, t_dim: str, plot_type: str) -> bool:
+    """Plot 2D data."""
+    if x_dim in data.dims and y_dim in data.dims and x_dim.lower() in ["lon", "longitude"] and y_dim.lower() in ["lat", "latitude"]:
+        lon_range = data[x_dim].values
+        lat_range = data[y_dim].values
+        lon_lat_ratio = np.abs(np.max(lon_range) - np.min(lon_range)) / (np.max(lat_range) - np.min(lat_range))
+        figsize = (10, 10 / lon_lat_ratio)
+        fig, ax = plt.subplots(figsize=figsize, subplot_kw={"projection": ccrs.PlateCarree()})
+        oafuncs.oa_draw.add_cartopy(ax, lon_range, lat_range)
+    else:
+        fig, ax = plt.subplots(figsize=(10, 8))
+
+    # Handle time dimension
+    if t_dim in data.dims and isinstance(data[t_dim].values[0], cftime.datetime):
+        try:
+            data[t_dim] = data.indexes[t_dim].to_datetimeindex()
+        except (AttributeError, ValueError, TypeError) as e:
+            print(f"Warning: Could not convert {t_dim} to datetime index: {e}")
+
+    # Check for valid data
+    if np.all(np.isnan(data.values)) or data.size == 0:
+        print(f"Skipping {data.name}: All values are NaN or empty")
+        plt.close()
+        return False
+
+    data_range = calculate_data_range(data, data_range)
+
+    if data_range is None:
+        print(f"Skipping {data.name} due to all NaN values")
+        plt.close()
+        return False
+
+    # Select appropriate colormap and levels
+    cmap, norm, levels = select_colormap_and_levels(data_range, plot_type)
+
+    mappable = None
+    try:
+        if plot_type == "contourf":
+            if np.ptp(data.values) < 1e-10 and not np.all(np.isnan(data.values)):
+                print(f"Warning: {data.name} has very little variation. Using imshow instead.")
+                mappable = ax.imshow(data.values, cmap=cmap, aspect="auto", interpolation="none")
+                colorbar = plt.colorbar(mappable, ax=ax)
+            else:
+                mappable = ax.contourf(data[x_dim], data[y_dim], data.values, levels=levels, cmap=cmap, norm=norm)
+                colorbar = plt.colorbar(mappable, ax=ax)
+        elif plot_type == "contour":
+            if np.ptp(data.values) < 1e-10 and not np.all(np.isnan(data.values)):
+                print(f"Warning: {data.name} has very little variation. Using imshow instead.")
+                mappable = ax.imshow(data.values, cmap=cmap, aspect="auto", interpolation="none")
+                colorbar = plt.colorbar(mappable, ax=ax)
+            else:
+                mappable = ax.contour(data[x_dim], data[y_dim], data.values, levels=levels, cmap=cmap, norm=norm)
+                ax.clabel(mappable, inline=True, fontsize=8, fmt="%1.1f")
+                colorbar = plt.colorbar(mappable, ax=ax)
+    except (ValueError, TypeError) as e:
+        print(f"Warning: Could not plot with specified parameters: {e}. Trying simplified parameters.")
+        try:
+            mappable = data.plot(ax=ax, cmap=cmap, add_colorbar=False)
+            colorbar = plt.colorbar(mappable, ax=ax)
+        except Exception as e2:
+            print(f"Error plotting {data.name}: {e2}")
+            plt.figure(figsize=(10, 8))
+            mappable = ax.imshow(data.values, cmap="viridis", aspect="auto")
+            colorbar = plt.colorbar(mappable, ax=ax, label=getattr(data, "units", ""))
+            plt.title(f"{data.name} | {getattr(data, 'long_name', 'No long_name')} (basic plot)", fontsize=12)
+            plt.tight_layout()
+            os.makedirs(os.path.dirname(output_path), exist_ok=True)
+            plt.savefig(output_path, bbox_inches="tight", dpi=600)
+            plt.close()
+            return True
+
+    plt.title(f"{data.name} | {getattr(data, 'long_name', 'No long_name')}", fontsize=12)
+    units = getattr(data, "units", "")
+    if units and colorbar:
+        colorbar.set_label(units)
+
+    plt.tight_layout()
+    os.makedirs(os.path.dirname(output_path), exist_ok=True)
+    plt.savefig(output_path, bbox_inches="tight", dpi=600)
+    plt.close()
+    return True
+
+
+def calculate_data_range(data: xr.DataArray, data_range: Optional[Tuple[float, float]]) -> Optional[Tuple[float, float]]:
+    """Calculate the data range, ignoring extreme outliers."""
+    if data_range is None:
+        flat_data = data.values.flatten()
+        if flat_data.size == 0:
+            return None
+        valid_data = flat_data[~np.isnan(flat_data)]
+        if len(valid_data) == 0:
+            return None
+        low, high = np.percentile(valid_data, [0.5, 99.5])
+        filtered_data = valid_data[(valid_data >= low) & (valid_data <= high)]
+        if len(filtered_data) > 0:
+            data_range = (np.min(filtered_data), np.max(filtered_data))
+        else:
+            data_range = (np.nanmin(valid_data), np.nanmax(valid_data))
+        if abs(data_range[1] - data_range[0]) < 1e-10:
+            mean = (data_range[0] + data_range[1]) / 2
+            data_range = (mean - 1e-10 if mean != 0 else -1e-10, mean + 1e-10 if mean != 0 else 1e-10)
+    return data_range
+
+
+def select_colormap_and_levels(data_range: Tuple[float, float], plot_type: str) -> Tuple[mpl.colors.Colormap, mpl.colors.Normalize, np.ndarray]:
+    """Select colormap and levels based on data range."""
+    if plot_type == "contour":
+        # For contour plots, use fewer levels
+        num_levels = 10
+    else:
+        # For filled contour plots, use more levels
+        num_levels = 128
+
+    if data_range[0] * data_range[1] < 0:
+        cmap = oafuncs.oa_cmap.get("diverging_1")
+        bdy = max(abs(data_range[0]), abs(data_range[1]))
+        norm = mpl.colors.TwoSlopeNorm(vmin=-bdy, vcenter=0, vmax=bdy)
+        levels = np.linspace(-bdy, bdy, num_levels)
+    else:
+        cmap = oafuncs.oa_cmap.get("cool_1") if data_range[0] < 0 else oafuncs.oa_cmap.get("warm_1")
+        norm = mpl.colors.Normalize(vmin=data_range[0], vmax=data_range[1])
+        levels = np.linspace(data_range[0], data_range[1], num_levels)
+
+    if np.any(np.diff(levels) <= 0):
+        levels = np.linspace(data_range[0], data_range[1], 10)
+    return cmap, norm, levels
+
+
+def process_variable(var: str, data: xr.DataArray, dims: int, dims_name: Tuple[str, ...], output_dir: str, x_dim: str, y_dim: str, z_dim: str, t_dim: str, fixed_colorscale: bool, plot_type: str) -> None:
+    """Process a single variable."""
+    valid_dims = {x_dim, y_dim, z_dim, t_dim}
+    if not set(dims_name).issubset(valid_dims):
+        print(f"Skipping {var} due to unsupported dimensions: {dims_name}")
+        return
+
+    # Process 1D data
+    if dims == 1:
+        if np.issubdtype(data.dtype, np.character):
+            print(f"Skipping {var} due to character data type")
+            return
+        plot_1d(data, os.path.join(output_dir, f"{var}.png"), x_dim, y_dim, z_dim, t_dim)
+        print(f"{var}.png")
+        return
+
+    # Compute global data range for fixed colorscale
+    global_data_range = None
+    if dims >= 2 and fixed_colorscale:
+        global_data_range = calculate_data_range(data, None)
+        if global_data_range is None:
+            print(f"Skipping {var} due to no valid data")
+            return
+        print(f"Fixed colorscale range: {global_data_range}")
+
+    # Process 2D data
+    if dims == 2:
+        success = plot_2d(data, os.path.join(output_dir, f"{var}.png"), global_data_range, x_dim, y_dim, t_dim, plot_type)
+        if success:
+            print(f"{var}.png")
+
+    # Process 3D data
+    if dims == 3:
+        for i in range(data.shape[0]):
+            for attempt in range(10):
+                try:
+                    if data[i].values.size == 0:
+                        print(f"Skipped {var}_{dims_name[0]}-{i} (empty data)")
+                        break
+                    success = plot_2d(data[i], os.path.join(output_dir, f"{var}_{dims_name[0]}-{i}.png"), global_data_range, x_dim, y_dim, t_dim, plot_type)
+                    if success:
+                        print(f"{var}_{dims_name[0]}-{i}.png")
+                    else:
+                        print(f"Skipped {var}_{dims_name[0]}-{i} (invalid data)")
+                    break
+                except Exception as e:
+                    if attempt < 9:
+                        print(f"Retrying {var}_{dims_name[0]}-{i} (attempt {attempt + 1})")
+                    else:
+                        print(f"Error processing {var}_{dims_name[0]}-{i}: {e}")
+
+    # Process 4D data
+    if dims == 4:
+        for i in range(data.shape[0]):
+            for j in range(data.shape[1]):
+                for attempt in range(3):
+                    try:
+                        if data[i, j].values.size == 0:
+                            print(f"Skipped {var}_{dims_name[0]}-{i}_{dims_name[1]}-{j} (empty data)")
+                            break
+                        success = plot_2d(data[i, j], os.path.join(output_dir, f"{var}_{dims_name[0]}-{i}_{dims_name[1]}-{j}.png"), global_data_range, x_dim, y_dim, t_dim, plot_type)
+                        if success:
+                            print(f"{var}_{dims_name[0]}-{i}_{dims_name[1]}-{j}.png")
+                        else:
+                            print(f"Skipped {var}_{dims_name[0]}-{i}_{dims_name[1]}-{j} (invalid data)")
+                        break
+                    except Exception as e:
+                        if attempt < 2:
+                            print(f"Retrying {var}_{dims_name[0]}-{i}_{dims_name[1]}-{j} (attempt {attempt + 1})")
+                        else:
+                            print(f"Error processing {var}_{dims_name[0]}-{i}_{dims_name[1]}-{j}: {e}")
+
+
+def func_plot_dataset(ds_in: xr.Dataset, output_dir: str, xyzt_dims: Tuple[str, str, str, str] = ("longitude", "latitude", "level", "time"), plot_type: str = "contourf", fixed_colorscale: bool = False) -> None:
+    """Plot variables from a NetCDF file and save the plots to the specified directory."""
+    os.makedirs(output_dir, exist_ok=True)
+    x_dim, y_dim, z_dim, t_dim = xyzt_dims
+
+    # Main processing function
+    try:
+        ds = ds_in
+        varlist = list(ds.data_vars)
+        print(f"Found {len(varlist)} variables in dataset")
+
+        for var in varlist:
+            print("=" * 120)
+            print(f"Processing: {var}")
+            data = ds[var]
+            dims = len(data.shape)
+            dims_name = data.dims
+            try:
+                process_variable(var, data, dims, dims_name, output_dir, x_dim, y_dim, z_dim, t_dim, fixed_colorscale, plot_type)
+            except Exception as e:
+                print(f"Error processing variable {var}: {e}")
+
+    except Exception as e:
+        print(f"Error processing dataset: {e}")
+    finally:
+        if "ds" in locals():
+            ds.close()
+            print("Dataset closed")
+
+
+if __name__ == "__main__":
+    pass
+    # func_plot_dataset(ds, output_dir, xyzt_dims=("longitude", "latitude", "level", "time"), plot_type="contourf", fixed_colorscale=False)

{oafuncs-0.0.97.2 → oafuncs-0.0.97.4/oafuncs.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: oafuncs
-Version: 0.0.97.2
+Version: 0.0.97.4
 Summary: Oceanic and Atmospheric Functions
 Home-page: https://github.com/Industry-Pays/OAFuncs
 Author: Kun Liu
@@ -86,17 +86,88 @@ oafuncs.oa_help.use('query')
 ```
 
 ```shell
-# 此小板块于2024/12/26更新，仅为示例，不代表最新情况
+# 此小板块于2025/03/16更新，仅为示例，不代表最新情况
 函数数量：
-49
+62
 函数列表：
-['MidpointNormalize', 'add_cartopy', 'add_gridlines', 'add_lonlat_unit', 'check_ncfile', 'choose_cmap', 'clear_folder', 'cmap2colors', 'convert_longitude', 'copy_file', 'create_cmap', 'create_cmap_rgbtxt', 'create_gif', 'download', 'download5doi', 'draw_time_range', 'extract5nc', 'fig_minus', 'file_size', 'find_file', 'get_time_list', 'get_ua', 'get_var', 'how_to_use', 'install_lib', 'interp_2d', 'link_file', 'make_folder', 'merge5nc', 'modify_var_attr', 'modify_var_value', 'nc_isel', 'plot_contourf', 'plot_contourf_cartopy', 'plot_contourf_lonlat', 'plot_quiver', 'query', 'remove', 'remove_empty_folder', 'rename_file', 'rename_var_or_dim', 'send', 'show', 'sign_in_love_ocean', 'sign_in_meteorological_home', 'sign_in_scientific_research', 'upgrade_lib', 'use', 'write2nc']
+[
+    'MidpointNormalize',
+    'ParallelExecutor',
+    'add_cartopy',
+    'add_gridlines',
+    'add_lonlat_unit',
+    'check',
+    'clear_folder',
+    'contour',
+    'contourf',
+    'convert_longitude',
+    'copy_file',
+    'create',
+    'create_rgbtxt',
+    'data_record',
+    'download',
+    'download5doi',
+    'downloader',
+    'draw',
+    'draw_time_range',
+    'ending_record',
+    'ensure_list',
+    'extract',
+    'fig_minus',
+    'file_size',
+    'find_file',
+    'get',
+    'get_days',
+    'get_time_list',
+    'get_ua',
+    'get_var',
+    'gif',
+    'header_record',
+    'how_to_use',
+    'install_lib',
+    'interp_2d',
+    'interp_along_dim',
+    'isel',
+    'link_file',
+    'log',
+    'make_dir',
+    'make_folder',
+    'mask_shapefile',
+    'mean_size',
+    'merge',
+    'modify',
+    'query',
+    'quiver',
+    'remove',
+    'remove_empty_folder',
+    'rename',
+    'rename_file',
+    'save',
+    'send',
+    'show',
+    'sign_in_love_ocean',
+    'sign_in_meteorological_home',
+    'sign_in_scientific_research',
+    'tail_record',
+    'test',
+    'to_color',
+    'upgrade_lib',
+    'use'
+]
+同名函数：
+----------------------------------------
 模块全路径：
 oafuncs.oa_help.query
-函数提示：
 
-    description: 查看oafuncs模块的函数列表
-    example: query()
+Help on function query in module oafuncs.oa_help:
+
+query()
+    Description:
+        Show the number of functions and the list of functions in the module.
+    Example:
+        query()
+
+----------------------------------------
 ```
 
 ## Structure

{oafuncs-0.0.97.2 → oafuncs-0.0.97.4}/oafuncs.egg-info/SOURCES.txt

@@ -15,8 +15,9 @@ oafuncs.egg-info/SOURCES.txt
 oafuncs.egg-info/dependency_links.txt
 oafuncs.egg-info/requires.txt
 oafuncs.egg-info/top_level.txt
-oafuncs/data_store/OAFuncs.png
-oafuncs/data_store/hycom_3hourly.png
+oafuncs/_data/OAFuncs.png
+oafuncs/_data/hycom_3hourly.png
+oafuncs/_script/plot_dataset.py
 oafuncs/oa_down/User_Agent-list.txt
 oafuncs/oa_down/__init__.py
 oafuncs/oa_down/hycom_3hourly.py

{oafuncs-0.0.97.2 → oafuncs-0.0.97.4}/setup.py

@@ -18,7 +18,7 @@ URL = "https://github.com/Industry-Pays/OAFuncs"
 EMAIL = "liukun0312@stu.ouc.edu.cn"
 AUTHOR = "Kun Liu"
 REQUIRES_PYTHON = ">=3.9.0"  # 2025/03/13
-VERSION = "0.0.97.2" # 下次用98.0，98.1已经被用过了
+VERSION = "0.0.97.4" # 下次用98.0，98.1已经被用过了
 
 # What packages are required for this module to be executed?
 REQUIRED = [
@@ -117,8 +117,14 @@ class UploadCommand(Command):
 # 确保包含所有包
 packages = find_packages(exclude=["tests", "*.tests", "*.tests.*", "tests.*"])
 # 显式添加 data_store 目录
-if "oafuncs.data_store" not in packages:
-    packages.append("oafuncs.data_store")
+# 若添加，还是会被显示为包，但其函数不会被直接显示（应该也可调用）
+# 要完全隐藏，但同时包含其py脚本和函数，试试在MANIFEST.in中添加
+# 同一级不写__init__.py，但是在MANIFEST.in中写入，就不会显示函数
+# if "oafuncs.data_store" not in packages:
+#     packages.append("oafuncs.data_store")
+
+# if "oafuncs._nc_script" not in packages:
+#     packages.append("oafuncs._nc_script")
 
 # Where the magic happens:
 setup(

oafuncs-0.0.97.2/MANIFEST.in

@@ -1,4 +0,0 @@
-include LICENSE.txt
-include README.md
-recursive-include oafuncs/data_store *
-recursive-include oafuncs/oa_down *.txt

oafuncs-0.0.97.2/README.md

@@ -1,60 +0,0 @@
-# oafuncs
-
-## Description
-
-**Python Function**
-
-```text
-In the field of geoscience, some commonly used and universal operations!
-
-Just for the convenience of daily use, some complex operations are integrated into general functions.
-
-The code will be optimized and updated from time to time, with additions, deletions, or modifications…
-
-Existing functions will not be completely removed, they might just have a different function name, or the parameter passing might have been optimized…
-
-Note: If there are any requirements, you can email to liukun0312@stu.ouc.edu.cn. Within my capabilities, I can consider implementing them.
-```
-
-## PyPI
-
-```html
-https://pypi.org/project/oafuncs
-```
-
-## Github
-
-```html
-https://github.com/Industry-Pays/OAFuncs
-```
-
-## Example
-
-```python
-import oafuncs
-
-# 查询当前所有可用函数
-oafuncs.oa_help.query()
-# 根据函数名获取使用方法
-oafuncs.oa_help.use('query')
-```
-
-```shell
-# 此小板块于2024/12/26更新，仅为示例，不代表最新情况
-函数数量：
-49
-函数列表：
-['MidpointNormalize', 'add_cartopy', 'add_gridlines', 'add_lonlat_unit', 'check_ncfile', 'choose_cmap', 'clear_folder', 'cmap2colors', 'convert_longitude', 'copy_file', 'create_cmap', 'create_cmap_rgbtxt', 'create_gif', 'download', 'download5doi', 'draw_time_range', 'extract5nc', 'fig_minus', 'file_size', 'find_file', 'get_time_list', 'get_ua', 'get_var', 'how_to_use', 'install_lib', 'interp_2d', 'link_file', 'make_folder', 'merge5nc', 'modify_var_attr', 'modify_var_value', 'nc_isel', 'plot_contourf', 'plot_contourf_cartopy', 'plot_contourf_lonlat', 'plot_quiver', 'query', 'remove', 'remove_empty_folder', 'rename_file', 'rename_var_or_dim', 'send', 'show', 'sign_in_love_ocean', 'sign_in_meteorological_home', 'sign_in_scientific_research', 'upgrade_lib', 'use', 'write2nc']
-模块全路径：
-oafuncs.oa_help.query
-函数提示：
-
-    description: 查看oafuncs模块的函数列表
-    example: query()
-```
-
-## Structure
-
-<img title="" src="./oafuncs/data_store/OAFuncs.png" alt="">
-
-<img title="OAFuncs" src="https://raw.githubusercontent.com/Industry-Pays/OAFuncs/main/oafuncs/data_store/OAFuncs.png" alt="OAFuncs">