oltc-selector 1.3.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -4
- package/bin/oltc.js +389 -92
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
填工况,给出 2025 目录里**最低满足**的型号。网页和 `oltc` CLI 共用同一份 `selectOltc` 引擎。
|
|
4
4
|
|
|
5
|
-
**CLI:** `npx -y oltc-selector@
|
|
5
|
+
**CLI:** `npx -y oltc-selector@2.0.0`,命令是 `oltc`。Agent 技能包另放,不在这个仓库里。
|
|
6
6
|
**网页:** [oltc-selector.vercel.app](https://oltc-selector.vercel.app/) · [GitHub Pages](https://erict16.github.io/oltc-selector/)
|
|
7
7
|
|
|
8
8
|
私人辅助,不是厂家官网。型号是起点,出 OS 前要工程确认。
|
|
@@ -21,7 +21,13 @@ oltc --iu 350 --um 40.5 --conn D --reg W --pm 8
|
|
|
21
21
|
|
|
22
22
|
oltc --octc --iu 800 --um 72.5 --conn D --series II --contact 6x5
|
|
23
23
|
oltc --iu 600 --um 72.5 --conn Y --reg W --pm 8 --structure combined
|
|
24
|
-
oltc --mva 25 --kv 110 --
|
|
24
|
+
oltc --mva 25 --kv 110 --tap neutral --reg W --pm 8
|
|
25
|
+
oltc --mva 16 --kv 22 --tap line --winding star
|
|
26
|
+
# CV2III-600D/40.5-10193W
|
|
27
|
+
|
|
28
|
+
# Autotransformer tapped at the series/common junction (sized on the HV side)
|
|
29
|
+
oltc --mva 125 --kind auto --hv 225 --mv 115 --tap junction
|
|
30
|
+
# 3xCM2I-500/252D-10193W
|
|
25
31
|
```
|
|
26
32
|
|
|
27
33
|
| Flag | Meaning | Default |
|
|
@@ -29,9 +35,14 @@ oltc --mva 25 --kv 110 --conn Y --reg W --pm 8
|
|
|
29
35
|
| `--iu` / `--imax` | Max through-current Imax (A). **No** safety factor. | required unless `--mva` |
|
|
30
36
|
| `--mva` `--kv` | Transformer MVA + tap-side kV → Imax (min tap + `--k`) | |
|
|
31
37
|
| `--k` | Safety factor ≥ 1, **capacity path only** | 1.0 |
|
|
38
|
+
| `--kind two\|auto` | Transformer kind (`--auto` = `--kind auto`) | two-winding |
|
|
39
|
+
| `--tap` | Where the OLTC sits: `neutral` / `line` (two-winding), `junction` / `mv-line` (autotransformer). Sets current, Ust and Um. | neutral |
|
|
40
|
+
| `--winding star\|delta` | Tapped winding connection (two-winding) | star |
|
|
41
|
+
| `--hv` `--mv` | Autotransformer HV / MV rated kV | |
|
|
42
|
+
| `--earth-um` | OLTC insulation to earth from the OS; overrides the rule | |
|
|
32
43
|
| `--um` | Equipment Um (kV) | derived from `--kv` on MVA path |
|
|
33
44
|
| `--ust` | Step voltage (V) | 0, or derived on MVA path |
|
|
34
|
-
| `--conn Y\|D` | Switch star / delta (
|
|
45
|
+
| `--conn Y\|D` | Switch star / delta on the `--iu` path (with `--mva`, use `--tap`) | Y |
|
|
35
46
|
| `--reg W\|G\|0` | Reversing / coarse-fine / linear | W |
|
|
36
47
|
| `--pm` | ± steps | 8 |
|
|
37
48
|
| `--octc` | Off-circuit 无载 (WSL/WSG) | on-load |
|
|
@@ -54,6 +65,7 @@ oltc --mva 25 --kv 110 --conn Y --reg W --pm 8
|
|
|
54
65
|
6. **WSL / WDL existence is 2025-list row keys without prices** (`lib/listIndex.data.json`). Missing rows (no `WSLIV-2000D/126`, no `7x6E` @ 72.5) are not emitted.
|
|
55
66
|
7. **WSG** is catalogue axes only (no 2025 list sheet in the index).
|
|
56
67
|
8. **Typing Imax (`--iu`) does not apply a safety factor.** `--k` only applies on the transformer-capacity (`--mva`) path.
|
|
68
|
+
9. **Um is set where the tap changer sits** (`lib/transformer.ts`). Line end: the winding system's class (132 kV → 145, 220 kV → 252). Neutral: the full class up to 72.5; above that 72.5 is assumed and flagged. Autotransformer: the HV system's class, combined types only (no CV / CV2 / SV).
|
|
57
69
|
|
|
58
70
|
## Web app
|
|
59
71
|
|
|
@@ -68,7 +80,7 @@ npm run pack:cli
|
|
|
68
80
|
|
|
69
81
|
GitHub Pages:`npm run build:gh`(`GH_PAGES=true`)。Vercel 根路径,不要设 `GH_PAGES`。
|
|
70
82
|
|
|
71
|
-
语言:中文、English、Tiếng Việt、Español、Türkçe
|
|
83
|
+
语言:中文、English、Tiếng Việt、Español、Türkçe、Bahasa Indonesia。
|
|
72
84
|
|
|
73
85
|
## OS regression
|
|
74
86
|
|
package/bin/oltc.js
CHANGED
|
@@ -14,71 +14,6 @@ function parseDecimal(raw) {
|
|
|
14
14
|
return { ok: true, value: n };
|
|
15
15
|
}
|
|
16
16
|
|
|
17
|
-
// lib/deriveUm.ts
|
|
18
|
-
var RATED_TO_WINDING_UM = {
|
|
19
|
-
33: 40.5,
|
|
20
|
-
35: 40.5,
|
|
21
|
-
66: 72.5,
|
|
22
|
-
69: 72.5,
|
|
23
|
-
110: 126,
|
|
24
|
-
115: 126,
|
|
25
|
-
132: 145,
|
|
26
|
-
138: 145,
|
|
27
|
-
150: 170,
|
|
28
|
-
220: 252,
|
|
29
|
-
230: 252,
|
|
30
|
-
330: 363
|
|
31
|
-
};
|
|
32
|
-
var SNAP_UN = Object.keys(RATED_TO_WINDING_UM).map(Number).sort(
|
|
33
|
-
(a, b) => a - b
|
|
34
|
-
);
|
|
35
|
-
function snapRatedKv(ratedKv) {
|
|
36
|
-
if (!Number.isFinite(ratedKv) || ratedKv <= 0) return ratedKv;
|
|
37
|
-
if (RATED_TO_WINDING_UM[ratedKv] != null) return ratedKv;
|
|
38
|
-
let best = SNAP_UN[0];
|
|
39
|
-
let bestDist = Math.abs(ratedKv - best);
|
|
40
|
-
for (const u of SNAP_UN) {
|
|
41
|
-
const d = Math.abs(ratedKv - u);
|
|
42
|
-
if (d < bestDist) {
|
|
43
|
-
best = u;
|
|
44
|
-
bestDist = d;
|
|
45
|
-
}
|
|
46
|
-
}
|
|
47
|
-
const rel = bestDist / Math.max(ratedKv, 1);
|
|
48
|
-
if (rel <= 0.12 || bestDist <= 8) return best;
|
|
49
|
-
return ratedKv;
|
|
50
|
-
}
|
|
51
|
-
function windingUmFromRatedKv(ratedKv) {
|
|
52
|
-
const snapped = snapRatedKv(ratedKv);
|
|
53
|
-
return RATED_TO_WINDING_UM[snapped] ?? snapped;
|
|
54
|
-
}
|
|
55
|
-
function deriveOltcUm(windingUmKv, connection) {
|
|
56
|
-
if (connection !== "Y") return windingUmKv;
|
|
57
|
-
if (windingUmKv >= 125.9 && windingUmKv <= 170.1) return 72.5;
|
|
58
|
-
return windingUmKv;
|
|
59
|
-
}
|
|
60
|
-
function oltcUmFromRatedKv(ratedKv, connection) {
|
|
61
|
-
return deriveOltcUm(windingUmFromRatedKv(ratedKv), connection);
|
|
62
|
-
}
|
|
63
|
-
function throughCurrentFromRated(mva, ratedKv, connection) {
|
|
64
|
-
if (!(mva > 0) || !(ratedKv > 0)) return NaN;
|
|
65
|
-
if (connection === "D") return mva * 1e3 / (3 * ratedKv);
|
|
66
|
-
return mva * 1e3 / (Math.sqrt(3) * ratedKv);
|
|
67
|
-
}
|
|
68
|
-
function stepVoltageFromPercent(ratedKv, stepPercent, connection) {
|
|
69
|
-
if (!(ratedKv > 0) || !(stepPercent > 0)) return NaN;
|
|
70
|
-
const windingV = connection === "D" ? ratedKv * 1e3 : ratedKv * 1e3 / Math.sqrt(3);
|
|
71
|
-
return windingV * stepPercent;
|
|
72
|
-
}
|
|
73
|
-
function maxThroughCurrent(ratedA, minusSteps, stepPercent) {
|
|
74
|
-
if (!(ratedA > 0)) return NaN;
|
|
75
|
-
if (!(minusSteps > 0) || !(stepPercent > 0)) return ratedA;
|
|
76
|
-
const drop = minusSteps * stepPercent;
|
|
77
|
-
if (drop <= 0) return ratedA;
|
|
78
|
-
const denom = 1 - Math.min(drop, 0.45);
|
|
79
|
-
return ratedA / denom;
|
|
80
|
-
}
|
|
81
|
-
|
|
82
17
|
// lib/tapCode.ts
|
|
83
18
|
var PITCHES = [10, 12, 14, 16, 18];
|
|
84
19
|
var W_DIAGRAMS = [
|
|
@@ -1503,6 +1438,21 @@ function selectOltc(input) {
|
|
|
1503
1438
|
return s.connections.includes(input.connection) || s.connections.includes("any");
|
|
1504
1439
|
});
|
|
1505
1440
|
const wantStruct = input.preferStructure;
|
|
1441
|
+
if (input.transformerKind === "auto" && !wantOctc) {
|
|
1442
|
+
if (wantStruct === "compound") {
|
|
1443
|
+
return {
|
|
1444
|
+
ok: false,
|
|
1445
|
+
results: [],
|
|
1446
|
+
errorsEn: [
|
|
1447
|
+
"Autotransformers take combined types only: compound types (CV/CV2/SV) stop at 200 kV across the tap winding."
|
|
1448
|
+
],
|
|
1449
|
+
errorsZh: [
|
|
1450
|
+
"\u81EA\u8026\u53D8\u53EA\u7528\u7EC4\u5408\u5F0F\uFF1A\u590D\u5408\u5F0F\uFF08CV/CV2/SV\uFF09\u8DE8\u8C03\u538B\u7ED5\u7EC4\u51B2\u51FB\u4E0A\u9650 200 kV\u3002"
|
|
1451
|
+
]
|
|
1452
|
+
};
|
|
1453
|
+
}
|
|
1454
|
+
candidates = candidates.filter((s) => s.structure !== "compound");
|
|
1455
|
+
}
|
|
1506
1456
|
if (wantStruct && wantStruct !== "auto") {
|
|
1507
1457
|
candidates = candidates.filter((s) => s.structure === wantStruct);
|
|
1508
1458
|
}
|
|
@@ -1976,6 +1926,222 @@ function optionsWithInsurance(results, dutyA, stepVoltageV, n = 3, need) {
|
|
|
1976
1926
|
return step ? [step].slice(0, n) : [];
|
|
1977
1927
|
}
|
|
1978
1928
|
|
|
1929
|
+
// lib/deriveUm.ts
|
|
1930
|
+
var RATED_TO_WINDING_UM = {
|
|
1931
|
+
33: 40.5,
|
|
1932
|
+
35: 40.5,
|
|
1933
|
+
66: 72.5,
|
|
1934
|
+
69: 72.5,
|
|
1935
|
+
110: 126,
|
|
1936
|
+
115: 126,
|
|
1937
|
+
132: 145,
|
|
1938
|
+
138: 145,
|
|
1939
|
+
150: 170,
|
|
1940
|
+
220: 252,
|
|
1941
|
+
230: 252,
|
|
1942
|
+
330: 363
|
|
1943
|
+
};
|
|
1944
|
+
var SNAP_UN = Object.keys(RATED_TO_WINDING_UM).map(Number).sort(
|
|
1945
|
+
(a, b) => a - b
|
|
1946
|
+
);
|
|
1947
|
+
var IEC_UM = [
|
|
1948
|
+
3.6,
|
|
1949
|
+
7.2,
|
|
1950
|
+
12,
|
|
1951
|
+
17.5,
|
|
1952
|
+
24,
|
|
1953
|
+
36,
|
|
1954
|
+
40.5,
|
|
1955
|
+
52,
|
|
1956
|
+
72.5,
|
|
1957
|
+
100,
|
|
1958
|
+
123,
|
|
1959
|
+
145,
|
|
1960
|
+
170,
|
|
1961
|
+
245,
|
|
1962
|
+
300,
|
|
1963
|
+
362,
|
|
1964
|
+
420,
|
|
1965
|
+
550,
|
|
1966
|
+
800
|
|
1967
|
+
];
|
|
1968
|
+
var CATALOGUE_UM = [12, 17.5, 40.5, 72.5, 126, 145, 170, 252, 300, 363];
|
|
1969
|
+
function nominalSystemKv(ratedKv) {
|
|
1970
|
+
let best = ratedKv;
|
|
1971
|
+
for (const u of SNAP_UN) {
|
|
1972
|
+
if (u <= ratedKv && (ratedKv - u) / ratedKv <= 0.12) best = u;
|
|
1973
|
+
}
|
|
1974
|
+
return best;
|
|
1975
|
+
}
|
|
1976
|
+
function iecUmFromRatedKv(ratedKv) {
|
|
1977
|
+
if (!(ratedKv > 0)) return NaN;
|
|
1978
|
+
const un = nominalSystemKv(ratedKv);
|
|
1979
|
+
return IEC_UM.find((u) => u >= un * 1.04) ?? NaN;
|
|
1980
|
+
}
|
|
1981
|
+
function catalogueUmFromRatedKv(ratedKv) {
|
|
1982
|
+
const um = iecUmFromRatedKv(ratedKv);
|
|
1983
|
+
if (!Number.isFinite(um)) return NaN;
|
|
1984
|
+
return CATALOGUE_UM.find((c) => c >= um - 1e-9) ?? um;
|
|
1985
|
+
}
|
|
1986
|
+
function maxThroughCurrent(ratedA, minusSteps, stepPercent) {
|
|
1987
|
+
if (!(ratedA > 0)) return NaN;
|
|
1988
|
+
if (!(minusSteps > 0) || !(stepPercent > 0)) return ratedA;
|
|
1989
|
+
const drop = minusSteps * stepPercent;
|
|
1990
|
+
if (drop <= 0) return ratedA;
|
|
1991
|
+
const denom = 1 - Math.min(drop, 0.45);
|
|
1992
|
+
return ratedA / denom;
|
|
1993
|
+
}
|
|
1994
|
+
|
|
1995
|
+
// lib/transformer.ts
|
|
1996
|
+
var TAP_POINTS_FOR = {
|
|
1997
|
+
two_winding: ["neutral", "line_end"],
|
|
1998
|
+
auto: ["auto_junction", "auto_mv_line"]
|
|
1999
|
+
};
|
|
2000
|
+
var SQRT3 = Math.sqrt(3);
|
|
2001
|
+
var fail = (zh, en) => ({
|
|
2002
|
+
ok: false,
|
|
2003
|
+
errorZh: zh,
|
|
2004
|
+
errorEn: en,
|
|
2005
|
+
connection: "Y",
|
|
2006
|
+
umSystemKv: NaN,
|
|
2007
|
+
actualUmKv: NaN,
|
|
2008
|
+
umKv: NaN,
|
|
2009
|
+
umRule: "line",
|
|
2010
|
+
umAssumed: false,
|
|
2011
|
+
ratedA: NaN,
|
|
2012
|
+
maxA: NaN,
|
|
2013
|
+
dutyA: NaN,
|
|
2014
|
+
currentKv: NaN,
|
|
2015
|
+
currentDivisor: "sqrt3",
|
|
2016
|
+
stepV: null,
|
|
2017
|
+
combinedOnly: false,
|
|
2018
|
+
cautionsZh: [],
|
|
2019
|
+
cautionsEn: []
|
|
2020
|
+
});
|
|
2021
|
+
var NEUTRAL_DEFAULT_UM = 72.5;
|
|
2022
|
+
function deriveDuty(spec) {
|
|
2023
|
+
const cautionsZh = [];
|
|
2024
|
+
const cautionsEn = [];
|
|
2025
|
+
const auto = spec.kind === "auto";
|
|
2026
|
+
if (!TAP_POINTS_FOR[spec.kind].includes(spec.tapPoint)) {
|
|
2027
|
+
return fail(
|
|
2028
|
+
"\u5F00\u5173\u4F4D\u7F6E\u548C\u53D8\u538B\u5668\u79CD\u7C7B\u4E0D\u5339\u914D\u3002",
|
|
2029
|
+
"Tap position does not fit the transformer kind."
|
|
2030
|
+
);
|
|
2031
|
+
}
|
|
2032
|
+
if (auto) {
|
|
2033
|
+
if (!(spec.hvKv > 0) || !(spec.mvKv > 0)) {
|
|
2034
|
+
return fail("\u81EA\u8026\u53D8\u8981\u586B\u9AD8\u538B\u548C\u4E2D\u538B\u989D\u5B9A\u7535\u538B\u3002", "Enter the autotransformer's HV and MV rated voltage.");
|
|
2035
|
+
}
|
|
2036
|
+
if (!(spec.hvKv > spec.mvKv)) {
|
|
2037
|
+
return fail("\u81EA\u8026\u53D8\u9AD8\u538B\u8981\u9AD8\u4E8E\u4E2D\u538B\u3002", "Autotransformer HV must be above MV.");
|
|
2038
|
+
}
|
|
2039
|
+
} else {
|
|
2040
|
+
if (!(spec.tapKv > 0)) {
|
|
2041
|
+
return fail("\u8BF7\u586B\u5199\u8C03\u538B\u7ED5\u7EC4\u989D\u5B9A\u7535\u538B\u3002", "Enter the tapped winding's rated voltage.");
|
|
2042
|
+
}
|
|
2043
|
+
if (spec.tapPoint === "neutral" && spec.winding === "delta") {
|
|
2044
|
+
return fail(
|
|
2045
|
+
"\u89D2\u5F62\u7ED5\u7EC4\u6CA1\u6709\u4E2D\u6027\u70B9\uFF0C\u5F00\u5173\u53EA\u80FD\u5728\u7EBF\u7AEF\u3002",
|
|
2046
|
+
"A delta winding has no neutral; the tap changer sits at the line end."
|
|
2047
|
+
);
|
|
2048
|
+
}
|
|
2049
|
+
}
|
|
2050
|
+
let currentKv;
|
|
2051
|
+
let currentDivisor;
|
|
2052
|
+
let stepBaseV;
|
|
2053
|
+
if (auto) {
|
|
2054
|
+
currentKv = spec.tapPoint === "auto_junction" ? spec.hvKv : spec.mvKv;
|
|
2055
|
+
currentDivisor = "sqrt3";
|
|
2056
|
+
stepBaseV = currentKv * 1e3 / SQRT3;
|
|
2057
|
+
} else if (spec.winding === "delta") {
|
|
2058
|
+
currentKv = spec.tapKv;
|
|
2059
|
+
currentDivisor = "three";
|
|
2060
|
+
stepBaseV = spec.tapKv * 1e3;
|
|
2061
|
+
} else {
|
|
2062
|
+
currentKv = spec.tapKv;
|
|
2063
|
+
currentDivisor = "sqrt3";
|
|
2064
|
+
stepBaseV = spec.tapKv * 1e3 / SQRT3;
|
|
2065
|
+
}
|
|
2066
|
+
const ratedA = spec.mva > 0 ? spec.mva * 1e3 / ((currentDivisor === "three" ? 3 : SQRT3) * currentKv) : NaN;
|
|
2067
|
+
const maxA = spec.stepFraction != null && spec.stepFraction > 0 ? maxThroughCurrent(ratedA, spec.minusSteps, spec.stepFraction) : ratedA;
|
|
2068
|
+
const k = spec.safetyK > 0 ? spec.safetyK : 1;
|
|
2069
|
+
const stepV = spec.stepFraction != null && spec.stepFraction > 0 ? stepBaseV * spec.stepFraction : null;
|
|
2070
|
+
let umSystemKv;
|
|
2071
|
+
let umKv;
|
|
2072
|
+
let umRule;
|
|
2073
|
+
let umAssumed = false;
|
|
2074
|
+
if (auto) {
|
|
2075
|
+
umSystemKv = spec.hvKv;
|
|
2076
|
+
umKv = catalogueUmFromRatedKv(spec.hvKv);
|
|
2077
|
+
umRule = "auto_hv";
|
|
2078
|
+
} else if (spec.tapPoint === "neutral") {
|
|
2079
|
+
umSystemKv = spec.tapKv;
|
|
2080
|
+
const lineClass = catalogueUmFromRatedKv(spec.tapKv);
|
|
2081
|
+
if (lineClass <= NEUTRAL_DEFAULT_UM) {
|
|
2082
|
+
umKv = lineClass;
|
|
2083
|
+
umRule = "neutral_full";
|
|
2084
|
+
if (lineClass === 40.5) umAssumed = true;
|
|
2085
|
+
} else {
|
|
2086
|
+
umKv = NEUTRAL_DEFAULT_UM;
|
|
2087
|
+
umRule = "neutral_assumed";
|
|
2088
|
+
umAssumed = true;
|
|
2089
|
+
}
|
|
2090
|
+
} else {
|
|
2091
|
+
umSystemKv = spec.tapKv;
|
|
2092
|
+
umKv = catalogueUmFromRatedKv(spec.tapKv);
|
|
2093
|
+
umRule = "line";
|
|
2094
|
+
}
|
|
2095
|
+
if (!Number.isFinite(umKv) || umKv > 363) {
|
|
2096
|
+
return fail(
|
|
2097
|
+
"\u7535\u538B\u8D85\u51FA\u76EE\u5F55\uFF1A\u5F00\u5173\u6700\u9AD8 Um 363 kV\u3002",
|
|
2098
|
+
"Voltage above the catalogue: the highest switch class is Um 363 kV."
|
|
2099
|
+
);
|
|
2100
|
+
}
|
|
2101
|
+
if (spec.earthUmKv != null && spec.earthUmKv > 0) {
|
|
2102
|
+
umKv = spec.earthUmKv;
|
|
2103
|
+
umRule = "explicit";
|
|
2104
|
+
umAssumed = false;
|
|
2105
|
+
}
|
|
2106
|
+
if (umRule === "neutral_full" && umAssumed) {
|
|
2107
|
+
cautionsZh.push("35 kV \u7EA7\u4E2D\u6027\u70B9\u5148\u6309 Um 40.5 \u9009\uFF1B\u4E0D\u5C11\u8BA2\u5355\uFF08\u4FC4\u7F57\u65AF\u3001\u571F\u8033\u5176\uFF09\u6309 72.5 \u4E70\uFF0C\u4EE5 OS \u4E3A\u51C6\u3002");
|
|
2108
|
+
cautionsEn.push("35 kV-class neutral sized at Um 40.5; many orders (Russia, Turkey) bought 72.5. The OS decides.");
|
|
2109
|
+
}
|
|
2110
|
+
if (umRule === "neutral_assumed") {
|
|
2111
|
+
cautionsZh.push(`\u4E2D\u6027\u70B9\u7EDD\u7F18\u672A\u7ED9\uFF0C\u5148\u6309 Um ${NEUTRAL_DEFAULT_UM} \u9009\uFF0C\u4EE5 OS \u4E3A\u51C6\u3002`);
|
|
2112
|
+
cautionsEn.push(`Neutral insulation not given: sized at Um ${NEUTRAL_DEFAULT_UM}; the OS decides.`);
|
|
2113
|
+
}
|
|
2114
|
+
if (auto) {
|
|
2115
|
+
if (spec.tapPoint === "auto_mv_line" && umRule === "auto_hv") {
|
|
2116
|
+
cautionsZh.push("HMR 230/121 kV \u5148\u4F8B\u6309\u5382\u5BB6\u6570\u636E\u7528 Um 170\u3002");
|
|
2117
|
+
cautionsEn.push("HMR 230/121 kV orders used Um 170 on the maker's data.");
|
|
2118
|
+
} else if (spec.tapPoint === "auto_junction" && umKv === 252 && umRule === "auto_hv") {
|
|
2119
|
+
cautionsZh.push("\u5148\u4F8B\uFF1A125 MVA 225/115/35 kV \xB18\xD71.25% \u2192 3\xD7SHZVI-600/252D-10193W\uFF082026-10-27\uFF09\u3002");
|
|
2120
|
+
cautionsEn.push("Precedent: 125 MVA 225/115/35 kV \xB18\xD71.25% \u2192 3\xD7SHZVI-600/252D-10193W (27 Oct 2026).");
|
|
2121
|
+
}
|
|
2122
|
+
cautionsZh.push("\u672A\u6838\uFF1A\u8DE8\u8C03\u538B\u7ED5\u7EC4\u51B2\u51FB\uFF08a \u503C\uFF09\u3001\u675F\u7F1A\u7535\u963B\u3002");
|
|
2123
|
+
cautionsEn.push("Not checked: impulse across the tap winding (a), tie-in resistor.");
|
|
2124
|
+
}
|
|
2125
|
+
return {
|
|
2126
|
+
ok: true,
|
|
2127
|
+
connection: spec.tapPoint === "neutral" ? "Y" : "D",
|
|
2128
|
+
umSystemKv,
|
|
2129
|
+
actualUmKv: iecUmFromRatedKv(umSystemKv),
|
|
2130
|
+
umKv,
|
|
2131
|
+
umRule,
|
|
2132
|
+
umAssumed,
|
|
2133
|
+
ratedA,
|
|
2134
|
+
maxA,
|
|
2135
|
+
dutyA: maxA * k,
|
|
2136
|
+
currentKv,
|
|
2137
|
+
currentDivisor,
|
|
2138
|
+
stepV,
|
|
2139
|
+
combinedOnly: auto,
|
|
2140
|
+
cautionsZh,
|
|
2141
|
+
cautionsEn
|
|
2142
|
+
};
|
|
2143
|
+
}
|
|
2144
|
+
|
|
1979
2145
|
// lib/cli.ts
|
|
1980
2146
|
var CliError = class extends Error {
|
|
1981
2147
|
constructor(message) {
|
|
@@ -1996,6 +2162,7 @@ function num(raw, flag) {
|
|
|
1996
2162
|
function parseCliArgs(argv) {
|
|
1997
2163
|
const out = {
|
|
1998
2164
|
conn: "Y",
|
|
2165
|
+
kind: "two_winding",
|
|
1999
2166
|
reg: "reversing",
|
|
2000
2167
|
octc: false,
|
|
2001
2168
|
structure: "auto",
|
|
@@ -2100,6 +2267,56 @@ function parseCliArgs(argv) {
|
|
|
2100
2267
|
i = n;
|
|
2101
2268
|
continue;
|
|
2102
2269
|
}
|
|
2270
|
+
if (a === "--kind") {
|
|
2271
|
+
out.given.add("kind");
|
|
2272
|
+
const [v, n] = take(i, a);
|
|
2273
|
+
const k = v.toLowerCase();
|
|
2274
|
+
if (k === "auto" || k === "autotransformer" || k === "\u81EA\u8026") out.kind = "auto";
|
|
2275
|
+
else if (k === "two" || k === "two-winding" || k === "\u53CC\u7ED5\u7EC4") {
|
|
2276
|
+
out.kind = "two_winding";
|
|
2277
|
+
} else throw new CliError(`--kind must be two or auto`);
|
|
2278
|
+
i = n;
|
|
2279
|
+
continue;
|
|
2280
|
+
}
|
|
2281
|
+
if (a === "--auto") {
|
|
2282
|
+
out.given.add("kind");
|
|
2283
|
+
out.kind = "auto";
|
|
2284
|
+
continue;
|
|
2285
|
+
}
|
|
2286
|
+
if (a === "--tap") {
|
|
2287
|
+
out.given.add("tap");
|
|
2288
|
+
const [v, n] = take(i, a);
|
|
2289
|
+
const map = {
|
|
2290
|
+
neutral: "neutral",
|
|
2291
|
+
line: "line_end",
|
|
2292
|
+
"line-end": "line_end",
|
|
2293
|
+
junction: "auto_junction",
|
|
2294
|
+
"mv-line": "auto_mv_line"
|
|
2295
|
+
};
|
|
2296
|
+
const t = map[v.toLowerCase()];
|
|
2297
|
+
if (!t) throw new CliError(`--tap must be neutral|line|junction|mv-line`);
|
|
2298
|
+
out.tap = t;
|
|
2299
|
+
i = n;
|
|
2300
|
+
continue;
|
|
2301
|
+
}
|
|
2302
|
+
if (a === "--winding") {
|
|
2303
|
+
out.given.add("winding");
|
|
2304
|
+
const [v, n] = take(i, a);
|
|
2305
|
+
const w = v.toLowerCase();
|
|
2306
|
+
if (w === "star" || w === "y") out.winding = "star";
|
|
2307
|
+
else if (w === "delta" || w === "d") out.winding = "delta";
|
|
2308
|
+
else throw new CliError(`--winding must be star or delta`);
|
|
2309
|
+
i = n;
|
|
2310
|
+
continue;
|
|
2311
|
+
}
|
|
2312
|
+
if (a === "--hv" || a === "--mv" || a === "--earth-um") {
|
|
2313
|
+
const key = a === "--hv" ? "hv" : a === "--mv" ? "mv" : "earthUm";
|
|
2314
|
+
out.given.add(key);
|
|
2315
|
+
const [v, n] = take(i, a);
|
|
2316
|
+
out[key] = num(v, a);
|
|
2317
|
+
i = n;
|
|
2318
|
+
continue;
|
|
2319
|
+
}
|
|
2103
2320
|
if (a === "--reg") {
|
|
2104
2321
|
out.given.add("reg");
|
|
2105
2322
|
const [v, n] = take(i, a);
|
|
@@ -2209,18 +2426,31 @@ var CLI_HELP = `oltc \u2014 OLTC/OCTC type selection (package: oltc-selector, no
|
|
|
2209
2426
|
|
|
2210
2427
|
Usage:
|
|
2211
2428
|
oltc --iu 400 --um 72.5 --conn Y --reg W --pm 8
|
|
2212
|
-
oltc --mva 25 --kv 110 --
|
|
2429
|
+
oltc --mva 25 --kv 110 --tap neutral --reg W --pm 8
|
|
2430
|
+
oltc --mva 16 --kv 22 --tap line --winding star
|
|
2431
|
+
oltc --mva 125 --kind auto --hv 225 --mv 115 --tap junction
|
|
2213
2432
|
oltc --octc --iu 800 --um 72.5 --conn D --series II --contact 6x5
|
|
2214
2433
|
oltc --iu 600 --um 72.5 --conn Y --reg W --pm 8 --structure combined
|
|
2215
2434
|
|
|
2216
2435
|
Flags:
|
|
2217
2436
|
--iu, --imax A Max through-current (Imax). No safety factor.
|
|
2218
2437
|
--mva MVA --kv kV Capacity path: Imax from rated I, minus steps, --step-pct, --k
|
|
2438
|
+
--kind two|auto Transformer kind (--auto = --kind auto). Default two-winding.
|
|
2439
|
+
--tap P Where the OLTC sits: neutral|line (two-winding),
|
|
2440
|
+
junction|mv-line (autotransformer, series/common junction
|
|
2441
|
+
or MV line lead). Capacity path; replaces --conn there.
|
|
2442
|
+
--winding star|delta Tapped winding connection (two-winding). Sets the current
|
|
2443
|
+
formula: star I = S/(\u221A3U), delta I = S/(3U).
|
|
2444
|
+
--hv kV --mv kV Autotransformer HV / MV rated voltage (with --kind auto).
|
|
2445
|
+
--earth-um kV OLTC insulation to earth from the OS or maker (catalogue
|
|
2446
|
+
class). Overrides the rule: line end = winding system,
|
|
2447
|
+
neutral \u226472.5 full else 72.5 assumed, autotransformer = HV.
|
|
2219
2448
|
--um kV Equipment Um (OLTC). With --mva/--kv, derived if omitted.
|
|
2220
2449
|
--ust V Step voltage. With --mva/--kv/--step-pct, derived if omitted.
|
|
2221
2450
|
--step-pct % Step as percent (1.25 means 1.25%). Capacity path only.
|
|
2222
2451
|
--k n Safety factor on capacity path only (default 1.0, same as the web app).
|
|
2223
|
-
--conn Y|D Switch connection (star /
|
|
2452
|
+
--conn Y|D Switch connection (star point / line end). Default Y.
|
|
2453
|
+
On the capacity path, legacy: Y = star neutral, D = delta line end.
|
|
2224
2454
|
--reg W|G|0 Reversing / coarse-fine / linear. Default W.
|
|
2225
2455
|
--pm N \xB1 steps. Default 8.
|
|
2226
2456
|
--pos, --positions Linear / OCTC positions.
|
|
@@ -2237,6 +2467,35 @@ Flags:
|
|
|
2237
2467
|
Defaults match the web first paint: on-load, in-tank vacuum, structure auto,
|
|
2238
2468
|
\xB18 mid-3 reversing. Omitting --octc and --structure auto is minimum-adequate.
|
|
2239
2469
|
`;
|
|
2470
|
+
function cliDuty(args) {
|
|
2471
|
+
if (args.mva == null) return null;
|
|
2472
|
+
const auto = args.kind === "auto";
|
|
2473
|
+
if (auto) {
|
|
2474
|
+
if (!(args.hv != null && args.hv > 0 && args.mv != null && args.mv > 0)) {
|
|
2475
|
+
throw new CliError("--kind auto with --mva needs --hv and --mv");
|
|
2476
|
+
}
|
|
2477
|
+
} else if (!(args.kv != null && args.kv > 0)) {
|
|
2478
|
+
throw new CliError("--mva requires --kv (tap-side rated voltage)");
|
|
2479
|
+
}
|
|
2480
|
+
const tap = args.tap ?? (auto ? "auto_junction" : args.conn === "D" ? "line_end" : "neutral");
|
|
2481
|
+
const winding = args.winding ?? (tap === "neutral" || args.conn === "Y" ? "star" : "delta");
|
|
2482
|
+
const pct = args.stepPct != null && args.stepPct > 0 ? args.stepPct / 100 : 0.0125;
|
|
2483
|
+
const earth = args.earthUm != null && args.earthUm > 0 ? args.earthUm : args.um != null && args.um > 0 ? args.um : void 0;
|
|
2484
|
+
return deriveDuty({
|
|
2485
|
+
kind: args.kind,
|
|
2486
|
+
tapPoint: tap,
|
|
2487
|
+
winding,
|
|
2488
|
+
mva: args.mva,
|
|
2489
|
+
tapKv: args.kv ?? 0,
|
|
2490
|
+
hvKv: args.hv ?? 0,
|
|
2491
|
+
mvKv: args.mv ?? 0,
|
|
2492
|
+
minusSteps: args.pm != null && args.pm > 0 ? args.pm : 8,
|
|
2493
|
+
stepFraction: pct,
|
|
2494
|
+
// 与网页版首屏一致:容量路径默认不额外加安全系数
|
|
2495
|
+
safetyK: args.k != null && args.k > 0 ? args.k : 1,
|
|
2496
|
+
...earth != null ? { earthUmKv: earth } : {}
|
|
2497
|
+
});
|
|
2498
|
+
}
|
|
2240
2499
|
function cliToSelectInput(args) {
|
|
2241
2500
|
const dutyKind = args.octc ? "octc" : "oltc";
|
|
2242
2501
|
const oil = args.octc || args.oil || !args.vacuum;
|
|
@@ -2256,26 +2515,16 @@ function cliToSelectInput(args) {
|
|
|
2256
2515
|
if (args.stepPct != null && args.mva == null) {
|
|
2257
2516
|
throw new CliError("--step-pct needs --mva/--kv; give --ust on the --iu path");
|
|
2258
2517
|
}
|
|
2259
|
-
|
|
2260
|
-
|
|
2261
|
-
|
|
2262
|
-
|
|
2263
|
-
|
|
2264
|
-
if (
|
|
2265
|
-
|
|
2266
|
-
|
|
2267
|
-
|
|
2268
|
-
|
|
2269
|
-
const iMax = maxThroughCurrent(rated, minus, pct);
|
|
2270
|
-
const k = args.k != null && args.k > 0 ? args.k : 1;
|
|
2271
|
-
iu = iMax * k;
|
|
2272
|
-
if (um == null || !(um > 0)) {
|
|
2273
|
-
um = oltcUmFromRatedKv(args.kv, args.conn);
|
|
2274
|
-
}
|
|
2275
|
-
if (!(ust > 0)) {
|
|
2276
|
-
const v = stepVoltageFromPercent(args.kv, pct, args.conn);
|
|
2277
|
-
if (Number.isFinite(v) && v > 0) ust = v;
|
|
2278
|
-
}
|
|
2518
|
+
const duty = cliDuty(args);
|
|
2519
|
+
let conn = args.conn;
|
|
2520
|
+
if (duty) {
|
|
2521
|
+
if (!duty.ok) throw new CliError(duty.errorZh ?? duty.errorEn ?? "Bad transformer data");
|
|
2522
|
+
iu = duty.dutyA;
|
|
2523
|
+
if (um == null || !(um > 0)) um = duty.umKv;
|
|
2524
|
+
if (!(ust > 0) && duty.stepV != null) ust = duty.stepV;
|
|
2525
|
+
conn = duty.connection;
|
|
2526
|
+
} else if (args.tap) {
|
|
2527
|
+
conn = args.tap === "neutral" ? "Y" : "D";
|
|
2279
2528
|
}
|
|
2280
2529
|
if (iu == null || !(iu > 0)) {
|
|
2281
2530
|
throw new CliError("Need --iu (Imax) or --mva plus --kv");
|
|
@@ -2289,7 +2538,8 @@ function cliToSelectInput(args) {
|
|
|
2289
2538
|
preferVacuum: !oil && dutyKind === "oltc",
|
|
2290
2539
|
dutyKind,
|
|
2291
2540
|
phases: args.phases,
|
|
2292
|
-
connection:
|
|
2541
|
+
connection: conn,
|
|
2542
|
+
...args.kind === "auto" ? { transformerKind: "auto" } : {},
|
|
2293
2543
|
throughCurrentA: iu,
|
|
2294
2544
|
umKv: um,
|
|
2295
2545
|
stepVoltageV: ust,
|
|
@@ -2326,9 +2576,29 @@ var MOUNT_ZH = {
|
|
|
2326
2576
|
};
|
|
2327
2577
|
function assumptionsFromArgs(args, family) {
|
|
2328
2578
|
const mark = (key) => args.given.has(key) ? "" : "\uFF08\u9ED8\u8BA4\uFF09";
|
|
2329
|
-
const items = [
|
|
2330
|
-
|
|
2331
|
-
|
|
2579
|
+
const items = [];
|
|
2580
|
+
const tapZh = {
|
|
2581
|
+
neutral: "\u4E2D\u6027\u70B9",
|
|
2582
|
+
line_end: "\u7EBF\u7AEF",
|
|
2583
|
+
auto_junction: "\u4E32\u8054/\u516C\u5171\u7ED5\u7EC4\u8FDE\u63A5\u70B9",
|
|
2584
|
+
auto_mv_line: "\u4E2D\u538B\u51FA\u7EBF"
|
|
2585
|
+
};
|
|
2586
|
+
if (args.mva != null) {
|
|
2587
|
+
const duty = cliDuty(args);
|
|
2588
|
+
const tap = args.tap ?? (args.kind === "auto" ? "auto_junction" : args.conn === "D" ? "line_end" : "neutral");
|
|
2589
|
+
items.push(`${args.kind === "auto" ? "\u81EA\u8026\u53D8" : "\u53CC\u7ED5\u7EC4"}${mark("kind")}`);
|
|
2590
|
+
items.push(`\u5F00\u5173\u5728${tapZh[tap]}${args.given.has("tap") || args.given.has("conn") ? "" : "\uFF08\u9ED8\u8BA4\uFF09"}`);
|
|
2591
|
+
if (args.kind !== "auto") {
|
|
2592
|
+
const w = args.winding ?? (tap === "neutral" || args.conn === "Y" ? "star" : "delta");
|
|
2593
|
+
items.push(`${w === "star" ? "\u661F\u5F62" : "\u89D2\u5F62"}\u7ED5\u7EC4${args.given.has("winding") ? "" : "\uFF08\u9ED8\u8BA4\uFF09"}`);
|
|
2594
|
+
}
|
|
2595
|
+
if (duty?.umAssumed) items.push(`\u5BF9\u5730 Um ${duty.umKv}\uFF08\u672A\u6307\u5B9A\uFF09`);
|
|
2596
|
+
} else {
|
|
2597
|
+
items.push(
|
|
2598
|
+
`conn=${args.conn} ${args.conn === "Y" ? "\u661F\u70B9" : "\u7EBF\u7AEF"}${mark("conn")}`
|
|
2599
|
+
);
|
|
2600
|
+
if (args.kind === "auto") items.push("\u81EA\u8026\u53D8");
|
|
2601
|
+
}
|
|
2332
2602
|
if (args.mva != null) {
|
|
2333
2603
|
items.push(args.given.has("k") ? `k=${args.k}` : "k=1.0\uFF08\u9ED8\u8BA4\uFF09");
|
|
2334
2604
|
items.push(
|
|
@@ -2377,6 +2647,13 @@ function assumptionsLine(args, family) {
|
|
|
2377
2647
|
}
|
|
2378
2648
|
return `\u5047\u5B9A\uFF1A${items.join(" \xB7 ")}`;
|
|
2379
2649
|
}
|
|
2650
|
+
var round1 = (n) => Math.round(n * 10) / 10;
|
|
2651
|
+
function basisLineZh(d) {
|
|
2652
|
+
const div = d.currentDivisor === "three" ? "3" : "\u221A3";
|
|
2653
|
+
const um = d.umRule === "explicit" ? `\u5BF9\u5730 Um ${d.umKv}\uFF08\u6307\u5B9A\uFF09` : d.umRule === "neutral_assumed" || d.umRule === "neutral_full" ? `\u4E2D\u6027\u70B9 Um ${d.umKv}${d.umAssumed ? "\uFF08\u5F85 OS \u6838\u5BF9\uFF09" : ""}` : `${d.umSystemKv} kV \u7CFB\u7EDF Um ${d.actualUmKv} \u2192 ${d.umKv} \u7EA7`;
|
|
2654
|
+
const ust = d.stepV == null ? "" : ` \xB7 Ust ${round1(d.stepV)} V`;
|
|
2655
|
+
return `I = S/(${div}\xD7${d.currentKv} kV) = ${round1(d.ratedA)} A\uFF0C\u6700\u4F4E\u6863 ${round1(d.maxA)} A${ust} \xB7 ${um}`;
|
|
2656
|
+
}
|
|
2380
2657
|
function formatCliText(input, args) {
|
|
2381
2658
|
const out = selectOltc(input);
|
|
2382
2659
|
if (!out.ok || !out.results.length) {
|
|
@@ -2401,7 +2678,10 @@ function formatCliText(input, args) {
|
|
|
2401
2678
|
primary.model,
|
|
2402
2679
|
primary.reasonsZh[0] || primary.reasonsEn[0] || "\u6700\u4F4E\u6EE1\u8DB3"
|
|
2403
2680
|
];
|
|
2681
|
+
const duty = args ? cliDuty(args) : null;
|
|
2682
|
+
if (duty?.ok) lines.push(`\u4F9D\u636E\uFF1A${basisLineZh(duty)}`);
|
|
2404
2683
|
for (const c of primary.cautionsZh) lines.push(`\u6CE8\u610F\uFF1A${c}`);
|
|
2684
|
+
for (const c of duty?.cautionsZh ?? []) lines.push(`\u6CE8\u610F\uFF1A${c}`);
|
|
2405
2685
|
if (alts.length) {
|
|
2406
2686
|
lines.push("");
|
|
2407
2687
|
lines.push("\u5176\u4ED6");
|
|
@@ -2437,7 +2717,24 @@ function formatCliJson(input, args) {
|
|
|
2437
2717
|
model: primary?.model ?? null,
|
|
2438
2718
|
why: primary?.reasonsZh[0] ?? primary?.reasonsEn[0] ?? null,
|
|
2439
2719
|
alts,
|
|
2440
|
-
cautions:
|
|
2720
|
+
cautions: [
|
|
2721
|
+
...primary?.cautionsZh ?? [],
|
|
2722
|
+
...(args ? cliDuty(args) : null)?.cautionsZh ?? []
|
|
2723
|
+
],
|
|
2724
|
+
basis: (() => {
|
|
2725
|
+
const d = args ? cliDuty(args) : null;
|
|
2726
|
+
return d?.ok ? {
|
|
2727
|
+
connection: d.connection,
|
|
2728
|
+
ratedA: round1(d.ratedA),
|
|
2729
|
+
maxA: round1(d.maxA),
|
|
2730
|
+
stepV: d.stepV == null ? null : round1(d.stepV),
|
|
2731
|
+
umSystemKv: d.umSystemKv,
|
|
2732
|
+
actualUmKv: d.actualUmKv,
|
|
2733
|
+
umKv: d.umKv,
|
|
2734
|
+
umRule: d.umRule,
|
|
2735
|
+
umAssumed: d.umAssumed
|
|
2736
|
+
} : null;
|
|
2737
|
+
})(),
|
|
2441
2738
|
assumptions: args ? assumptionsFromArgs(args, primary?.seriesCode) : [],
|
|
2442
2739
|
errors: out.errorsZh.length ? out.errorsZh : out.errorsEn
|
|
2443
2740
|
};
|