环境信息 - cedarkit-notebook指南

本 Notebook 记录当前文档运行环境的关键信息，包括 cedarkit 工具栈及关键依赖库的版本、Python 运行环境，以及本地示例数据的信息，便于环境追溯与问题排查。

cedarkit 工具栈¶

cedarkit 工具栈各库的版本（未安装的库显示为“未安装”）。

from importlib.metadata import PackageNotFoundError, version

import pandas as pd


def get_version(package: str) -> str:
    try:
        return version(package)
    except PackageNotFoundError:
        return "未安装"


cedarkit_packages = [
    "reki",
    "cedarkit-comp",
    "cedarkit-plots",
    "cedar-graph",
    "cemc-meda-data",
    "nuwe-cmadaas",
    "cedarkit-notebook",
]

pd.DataFrame(
    [(pkg, get_version(pkg)) for pkg in cedarkit_packages],
    columns=["库", "版本"],
)

关键依赖¶

数据处理与绘图的关键依赖库版本。

key_packages = [
    "numpy",
    "pandas",
    "xarray",
    "matplotlib",
    "cartopy",
    "eccodes",
    "cfgrib",
]

pd.DataFrame(
    [(pkg, get_version(pkg)) for pkg in key_packages],
    columns=["库", "版本"],
)

Python 环境¶

import platform
import sys

print(f"Python: {sys.version}")
print(f"Platform: {platform.platform()}")

Python: 3.14.3 (main, Mar 24 2026, 22:50:36) [Clang 22.1.1 ]
Platform: Linux-6.6.87.2-microsoft-standard-WSL2-x86_64-with-glibc2.39

数据信息¶

本地数据目录中已下载的示例数据，信息来自 data/metadata/ 目录下的元信息文件。

from cedarkit_notebook.data import get_data_root, list_datasets

data_root = get_data_root()
datasets = list_datasets()
print(f"数据根目录: {data_root}")

rows = []
for system, metadata in datasets.items():
    query = metadata.get("query", {})
    rows.append({
        "系统": system,
        "数据类型": metadata.get("data_type", ""),
        "起报时次": query.get("start_time", ""),
        "预报时效": query.get("forecast_time", ""),
        "附加时效": ", ".join(query.get("extra_forecast_times", [])),
        "文件数": len(metadata.get("files", [])),
        "下载时间": metadata.get("downloaded_at", ""),
    })

pd.DataFrame(rows)

数据根目录: /home/wangdp/project/cedarkit/notebook-project/notebook-devel/repo/cedarkit-notebook-project/cedarkit-notebook/data