如何为mizani.labels.percent()设置精度，使geom_label显示一位小数？

错误原因 #

mizani的percent()是标签生成器，它接收格式化配置参数（如accuracy）后返回一个用于格式化数值的函数，而非直接处理数值的函数。你直接在aes的label映射中调用ml.percent(rate, accuracy=.1)，相当于把数值rate当成配置参数传给了生成器，因此触发参数不匹配的错误。

解决方案 #

以下两种方法都能实现需求，且保持y轴和标签的格式化一致性：

方案一：提前在DataFrame中生成格式化标签

先通过polars预处理数据，生成带一位小数的百分比标签列，再直接映射到label：

import polars as pl
from plotnine import * 
import mizani.labels as ml

# 创建带一位小数的百分比格式化函数
percent_formatter = ml.percent(accuracy=.1)

df = pl.DataFrame({
  "group": ["A", "B"], 
  "rate": [.511, .634]
}).with_columns(
    # 对rate列应用格式化函数，生成标签列
    pl.col("rate").map_elements(percent_formatter).alias("rate_label")
)

(
    ggplot(df, aes(x="group", y="rate", label="rate_label"))
    + geom_col()
    + geom_label()
    + scale_y_continuous(labels=percent_formatter)  # y轴用相同格式化规则
)

方案二：在aes中使用lambda函数动态格式化

直接在label映射中用lambda调用预先生成的格式化函数，动态处理数值：

import polars as pl
from plotnine import * 
import mizani.labels as ml

df = pl.DataFrame({
  "group": ["A", "B"], 
  "rate": [.511, .634]
})

# 创建带一位小数的百分比格式化函数
percent_formatter = ml.percent(accuracy=.1)

(
    ggplot(df, aes(x="group", y="rate", label=lambda x: percent_formatter(x.rate)))
    + geom_col()
    + geom_label()
    + scale_y_continuous(labels=percent_formatter)
)

关键说明 #

ml.percent(accuracy=.1)的作用是生成一个格式化函数，这个函数接收单个数值参数后，会返回对应的百分比字符串（比如输入0.511返回"51.1%"）。正确用法是先生成这个函数，再用它处理数值，而非直接把数值和配置参数一起传入。

内容的提问来源于stack exchange，提问作者Joe