Skip to content

Files

Latest commit

Snoopy1866Snoopy1866
feat(qualify_xxx): 新增参数 missing_output，可指定当 missing = true 时是否输出缺…
Jul 30, 2025
7a18f21 · Jul 30, 2025

History

History
278 lines (178 loc) · 7.37 KB

readme.md

File metadata and controls

278 lines (178 loc) · 7.37 KB

简介

多组单个定性指标的分析，输出频数、构成比（率）指标。

语法

必选参数

可选参数

调试参数

参数说明

indata

用法同 indata。

var

用法同 var。

group

Syntax :

  • variable
  • variable("category-1"<, "category-2", ...>)

指定分组变量，category 表示需要统计的分组水平名称。

Warning

  • 参数 group 不允许指定不存在于参数 indata 指定的数据集中的变量；
  • 参数 group 不允许指定数值型变量；

Usage :

group = arm
group = arm("试验组", "对照组")

Example

groupby

Syntax :

  • variable<(asc<ending> | desc<ending>)>
  • format<(asc<ending> | desc<ending>)>

指定各分组在输出数据集中的排列顺序依据。

Default : #auto

默认情况下，各个分组的输出结果根据分组水平名称在当前语言环境下的默认排列顺序排序（例如：gbk 环境下，按照水平名称的汉语拼音顺序）

Important

  • 若参数 groupby 指定了基于某个输出格式进行排序，则该格式必须是 catalog-based，即在 dictionary.formats 表中，变量 source 的值应当是 C。

  • 当指定一个输出格式作为排序依据时，该输出格式应当使用 value 语句生成，例如：

    proc format;
    value armn
        1 = "试验组"
        2 = "对照组";
run;

    宏程序将根据格式化之前的数值对各分类进行排序。

Usage :

groupby = armn(desc)
groupby = armn.

Example

by

用法同 by。

uid

用法同 uid。

pattern

用法同 pattern。

missing

用法同 missing。

missing_output

用法同 missing_output。

missing_note

用法同 missing_note。

missing_position

用法同 missing_position。

outdata

Syntax : <libname.>dataset(dataset-options)

指定统计结果输出的数据集，可包含数据集选项，用法同参数 indata。

输出数据集含有以下变量：

变量名 含义
idt 缩进标识（indent identifier）
seq 行号
item_origin 分类名称（原始名称）
item 分类名称（展示名称）
value_i group 的第 i 个水平的统计量在 pattern 指定的模式下的格式化值
freq_i group 的第 i 个水平的频数
freq_i_fmt group 的第 i 个水平的频数格式化值
times_i group 的第 i 个水平的频次
times_i_fmt group 的第 i 个水平的频次格式化值
rate_i group 的第 i 个水平的频率
rate_i_fmt group 的第 i 个水平的频率格式化值
value_sum group 的所有水平合计的统计量在 pattern 指定的模式下的格式化值
freq_sum group 的所有水平合计的频数
freq_sum_fmt group 的所有水平合计的频数格式化值
times_sum group 的所有水平合计的频次
times_sum_fmt group 的所有水平合计的频次格式化值
rate_sum group 的所有水平合计的频率
rate_sum_fmt group 的所有水平合计的频率格式化值

其中，变量 item、value_i、value_sum 默认输出到 outdata 指定的数据集中，其余变量默认隐藏。

Note

  • 当 group 的水平数量为 0 时，输出数据集仅包含变量 idt、seq、item，此时 dataset-options 无效。
  • 当 group 的水平数量为 1 时，变量 value_sum 默认隐藏。

Default : res_var

默认情况下，输出数据集的名称为 res_var，其中 var 为参数 var 指定的变量名。

Tip

  • 如需显示隐藏的变量，可使用数据集选项实现，例如：outdata = t1(keep = seq item value_1 value_2 value_sum times_1 times_2 times_sum)

Usage :

outdata = t1
outdata = t1(keep = seq item value_1 value_2 value_sum times_1 times_2 times_sum)

stat_format

用法同 stat_format。

label

用法同 label。

indent

用法同 indent。

suffix

用法同 suffix。

debug

Syntax : true | false

指定是否删除宏程序运行过程生成的中间数据集。

Default : false

默认情况下，宏程序会自动删除运行过程生成的中间数据集。

Note

  • 此参数用于开发者调试，一般无需关注。
  • 本宏程序内部调用的依赖宏程序 %qualify 运行过程中生成的中间数据集无法通过此参数控制，在退出 %qualify 时，这些中间数据集默认被删除，如需单独调试宏程序 %qualify，请单独调用 %qualify 并指定 debug = true。

例子

打开帮助文档

%qualify_multi();
%qualify_multi(help);

一般用法

%qualify_multi(indata = adam.adsl(where = (FASFL = "Y")), var = ecgcsig, by = clsig., group = arm);

指定分组变量的水平名称

%qualify_multi(indata = adam.adsl(where = (FASFL = "Y")), var = ecgcsig, by = clsig., group = arm("试验组"));

指定分组变量的排序变量

%qualify_multi(indata = adam.adsl(where = (FASFL = "Y")), var = ecgcsig, by = clsig., group = arm, groupby = armn);