basic-measurement

name: basic_measurement type: measurement description: | 基础测量技能模板，用于演示框架功能。 执行简单的参数扫描并返回数据。

capabilities: 排查问题: - 仪器连接测试: 验证仪器响应 提取信息: - 扫描结果: 记录扫描数据

inputs:

• name: param_name type: string description: 扫描参数名 default: x
• name: start type: number description: 扫描起始值 default: 0
• name: stop type: number description: 扫描终止值 default: 10
• name: num_points type: integer description: 扫描点数 default: 101

outputs:

• name: max_value type: number description: 最大值
• name: min_value type: number description: 最小值

metadata: tags: [basic, template, demo] estimated_time: 10

单 Dataset 格式（向后兼容）

import numpy as np

def run(param_name: str = 'x', start: float = 0, stop: float = 10,
        num_points: int = 101, ctx=None):
    """基础测量示例 - 单 dataset 格式"""
    # 生成扫描点
    values = np.linspace(start, stop, num_points)

    # 模拟测量（实际应调用仪器）
    # result = ctx.get_instrument('instrument').measure(values)
    result = np.sin(values) + np.random.randn(num_points) * 0.1

    # 使用单数 'dataset' 格式（向后兼容）
    return {
        'dataset': {
            param_name: values,
            'result': result,
        },
        'max_value': float(np.max(result)),
        'min_value': float(np.min(result)),
    }

多 Datasets 格式

import numpy as np

def run_multi_channel(channels: list, start: float = 0, stop: float = 10,
                      num_points: int = 101, ctx=None):
    """多通道测量示例 - 多 datasets 格式

    Args:
        channels: 通道列表，如 ['ch1', 'ch2', 'ch3']
        start: 扫描起始值
        stop: 扫描终止值
        num_points: 扫描点数
        ctx: 测量上下文

    Returns:
        使用 'datasets'（复数）格式返回多个通道的数据
    """
    values = np.linspace(start, stop, num_points)
    datasets = []
    summary = {}

    for channel in channels:
        # 模拟测量（实际应调用仪器）
        # result = ctx.get_instrument('instrument').measure_channel(channel, values)
        phase = np.random.uniform(0, 2 * np.pi)
        result = np.sin(values + phase) + np.random.randn(num_points) * 0.1

        # 为每个通道创建一个 dataset
        datasets.append({
            'x': values,
            'amplitude': result,
            'channel': channel,
        })

        summary[channel] = {
            'max': float(np.max(result)),
            'min': float(np.min(result)),
            'mean': float(np.mean(result)),
        }

    # 使用 'datasets'（复数）格式返回
    return {
        'datasets': datasets,  # 多个 dataset 的列表
        'summary': summary,
        'channels': channels,
    }