语法指南 | 发明者量化

gauge

仪表盘：用半圆刻度显示数值在区间中的位置，可按阈值变色，适合RSI、仓位、风险度。

示例

显示最新价在最近24小时高低区间中的位置，靠近两端时变色。


    javascript
    
    
function main() {
    var r = exchange.GetRecords(PERIOD_H1)
    if (!r || r.length < 24) return
    var bars = r.slice(-24)
    var hi = Math.max.apply(null, bars.map(function (b) { return b.High }))
    var lo = Math.min.apply(null, bars.map(function (b) { return b.Low }))
    var pos = hi > lo ? (bars[23].Close - lo) / (hi - lo) : 0.5
    var levels = [{value: 0, color: "down"}, {value: 0.2, color: "primary"},
        {value: 0.8, color: "up"}]
    LogStatus({type: "gauge", title: "24小时区间位置", value: pos,
        format: {percent: true}, thresholds: levels})
}


    python
    
    
def main():
    r = exchange.GetRecords(PERIOD_H1)
    if not r or len(r) < 24:
        return
    bars = r[-24:]
    hi = max(b["High"] for b in bars)
    lo = min(b["Low"] for b in bars)
    pos = (bars[-1]["Close"] - lo) / (hi - lo) if hi > lo else 0.5
    levels = [{"value": 0, "color": "down"}, {"value": 0.2, "color": "primary"},
              {"value": 0.8, "color": "up"}]
    LogStatus({"type": "gauge", "title": "24小时区间位置", "value": pos,
               "format": {"percent": True}, "thresholds": levels})


    rust
    
    
fn main() {
    let Ok(r) = exchange.GetRecords(None, PERIOD_H1, None) else { return };
    if r.len() < 24 { return; }
    let bars = &r[r.len() - 24..];
    let hi = bars.iter().map(|b| b.High).fold(f64::MIN, f64::max);
    let lo = bars.iter().map(|b| b.Low).fold(f64::MAX, f64::min);
    let pos = if hi > lo { (bars[23].Close - lo) / (hi - lo) } else { 0.5 };
    LogStatus!(format!(
        r#"{{"type": "gauge", "title": "24小时区间位置", "value": {},
            "format": {{"percent": true}},
            "thresholds": [{{"value": 0, "color": "down"}}, {{"value": 0.2, "color": "primary"}},
                           {{"value": 0.8, "color": "up"}}]}}"#,
        pos
    ));
}

属性

名称	类型	描述
type	string	必填，固定为 `gauge`。
value	number	必填。当前值。
min	number	区间下限。默认 `0`。
max	number	区间上限，必须大于 `min`。默认 `1`。
unit	string	单位。
format	object	数值格式 `{precision, compact, percent}`，见`状态栏组件`。
color	string	没有命中阈值时的颜色，默认 `primary`。取值见`状态栏组件`。
thresholds	object数组	阈值：取 `value` 已达到的最大阈值的颜色。
thresholds[].value	number	达到这个值起使用 `color`。
thresholds[].color	string	颜色：`up`、`down`、`primary`、`warning`、`muted`，见`状态栏组件`。
title	string	标题，显示在组件左上角。
id	string	稳定标识。组件的个数或顺序会变化时设置，状态栏刷新时组件不重建。
span	number	在所在`grid`中占几列。默认 `1`。

参考

LogStatus 状态栏组件 progress kpi

备注

max 不大于 min 时显示错误卡片。