Skip to content

quick_plot.md

Latest commit

 

History

History
84 lines (67 loc) · 2.3 KB

quick_plot.md

File metadata and controls

84 lines (67 loc) · 2.3 KB
Raw
mystnb
execution_mode
off

快速绘图

{func}cedar_graph.quickplot.quick_plot 是在 CMA-HPC 上 最快速的画图方式。指定图种、业务系统名以及预报时间， 它内部会通过 {class}~cedar_graph.data.LocalDataSource 完成数据查找与读取。

plot_type 直接映射图种定义：先查 YAML 配方 （cedar_graph/recipes/，如 cn.t2m 对应 recipes/cn/t2m.yaml），再查 Python 绘图模块 （cedar_graph/plots/，如 cn.shr.default），两者接口一致、 对调用方透明。完整图种清单见 {doc}../api/recipes 与 {doc}../api/plots。

默认范围下的 2 m 温度

from cedar_graph.quickplot import quick_plot

quick_plot(
    plot_type="cn.t2m",
    system_name="CMA-GFS",
    start_time="2024073000",
    forecast_time="48h",
)

start_time 既支持 pd.Timestamp 对象，也支持 GRIB 中常用的 紧凑形式 "YYYYMMDDHH" / "YYYYMMDDHHMM"。 forecast_time 支持 pd.Timedelta 对象或 "24h" 这样的字符串。

自定义区域的 10 m 风场

需要画到子区域时，配合 area_name 与 {class}cedarkit.plots.types.AreaRange 即可：

from cedar_graph.quickplot import quick_plot
from cedarkit.plots.types import AreaRange

quick_plot(
    plot_type="cn.wind_10m",
    system_name="CMA-MESO",
    start_time="2024073000",
    forecast_time="48h",
    area_name="NorthEast",
    area_range=AreaRange.from_tuple((108, 137, 37, 55)),
)

带参数的图种

配方声明的参数（见 {doc}recipe）作为 quick_plot 的关键字参数 传入，例如 K 指数 + 风场的风场层次、降水图形的降水时段：

quick_plot(
    plot_type="cn.kidx_wind",
    system_name="CMA-GFS",
    start_time="2024073000",
    forecast_time="48h",
    wind_level=850.0,          # 必需参数
)

quick_plot(
    plot_type="cn.rain_wind_10m",
    system_name="CMA-GFS",
    start_time="2024073000",
    forecast_time="48h",
    interval="24h",            # 降水时段
)

不在 CMA-HPC 时

quick_plot 默认假设了 CMA-HPC 上的目录结构与配置。在 CMA-HPC 之外的环境，请改用 {doc}manual_plot 中介绍的方式直接 驱动 load_data 与 plot，并按需挑选数据源——例如本文档使用的 {class}cedar_graph.testing.MockDataSource。