ocs-calculators 0.1.3 → 0.2.0

package/dist/pole-capacity/index.cjs

@@ -0,0 +1,13 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunk4344WWAFcjs = require('../chunk-4344WWAF.cjs');
+
+
+
+
+
+exports.STEEL_POLE_SERIES_KNM = _chunk4344WWAFcjs.STEEL_POLE_SERIES_KNM; exports.TEST_MOMENT_FACTOR = _chunk4344WWAFcjs.TEST_MOMENT_FACTOR; exports.poleCapacityCheck = _chunk4344WWAFcjs.poleCapacityCheck; exports.poleCapacityMeta = _chunk4344WWAFcjs.poleCapacityMeta;
+//# sourceMappingURL=index.cjs.map

package/dist/pole-capacity/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/ocs-calculators/ocs-calculators/dist/pole-capacity/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACF,2QAAC","file":"/home/runner/work/ocs-calculators/ocs-calculators/dist/pole-capacity/index.cjs"}

package/dist/pole-capacity/index.d.cts

@@ -0,0 +1,47 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.cjs';
+
+declare const poleCapacityMeta: CalculatorMeta;
+
+/** GB/T 25020.1-2025 格构式钢支柱标称容量系列（表 A.2），kN·m */
+declare const STEEL_POLE_SERIES_KNM: readonly [150, 200, 250, 300, 350, 400, 450, 500, 550, 600, 650, 750, 900, 1050, 1200, 1500];
+/** 承载力检验弯矩 = 1.5 × 标称容量（25020.1 表 A.2 表值规律） */
+declare const TEST_MOMENT_FACTOR = 1.5;
+/** 支柱容量校核输入。单位：kN、m、mm、Pa。 */
+interface PoleCapacityInput {
+    /** 区段类型 */
+    readonly section: 'line' | 'curve';
+    /** 接触线张力 T_j，kN */
+    readonly contactWireTensionKN: number;
+    /** 承力索张力 T_c，kN */
+    readonly messengerTensionKN: number;
+    /** 拉出值 a，mm */
+    readonly staggerMM: number;
+    /** 跨距 l，m */
+    readonly spanM: number;
+    /** 曲线半径 R，m（曲线区段） */
+    readonly curveRadiusM?: number;
+    /** 水平力合力作用高度 h_e，m */
+    readonly resultantHeightM: number;
+    /** 设计最大风压 P，Pa */
+    readonly windPressurePa: number;
+    /** 支柱迎风宽度 b，m */
+    readonly poleWidthM: number;
+    /** 支柱高度 h，m */
+    readonly poleHeightM: number;
+    /** 线索风载 F_wl，N */
+    readonly wireWindLoadN?: number;
+}
+interface PoleCapacityResult {
+    /** 悬挂水平力 F_h，N */
+    readonly horizontalForceN: number;
+    /** 工作弯矩 M，kN·m */
+    readonly workMomentKNM: number;
+    /** 折合标称容量（÷1.5），kN·m */
+    readonly nominalNeedKNM: number;
+    /** 选型结果 */
+    readonly selection: string | null;
+}
+/** 支柱容量选型（容量比较法，TB/T 2286 5.9.2 检验弯矩口径；钢柱 25020.1 5.1.1+附录A） */
+declare function poleCapacityCheck(input: PoleCapacityInput): PoleCapacityResult;
+
+export { type PoleCapacityInput, type PoleCapacityResult, STEEL_POLE_SERIES_KNM, TEST_MOMENT_FACTOR, poleCapacityCheck, poleCapacityMeta };

package/dist/pole-capacity/index.d.ts

@@ -0,0 +1,47 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.js';
+
+declare const poleCapacityMeta: CalculatorMeta;
+
+/** GB/T 25020.1-2025 格构式钢支柱标称容量系列（表 A.2），kN·m */
+declare const STEEL_POLE_SERIES_KNM: readonly [150, 200, 250, 300, 350, 400, 450, 500, 550, 600, 650, 750, 900, 1050, 1200, 1500];
+/** 承载力检验弯矩 = 1.5 × 标称容量（25020.1 表 A.2 表值规律） */
+declare const TEST_MOMENT_FACTOR = 1.5;
+/** 支柱容量校核输入。单位：kN、m、mm、Pa。 */
+interface PoleCapacityInput {
+    /** 区段类型 */
+    readonly section: 'line' | 'curve';
+    /** 接触线张力 T_j，kN */
+    readonly contactWireTensionKN: number;
+    /** 承力索张力 T_c，kN */
+    readonly messengerTensionKN: number;
+    /** 拉出值 a，mm */
+    readonly staggerMM: number;
+    /** 跨距 l，m */
+    readonly spanM: number;
+    /** 曲线半径 R，m（曲线区段） */
+    readonly curveRadiusM?: number;
+    /** 水平力合力作用高度 h_e，m */
+    readonly resultantHeightM: number;
+    /** 设计最大风压 P，Pa */
+    readonly windPressurePa: number;
+    /** 支柱迎风宽度 b，m */
+    readonly poleWidthM: number;
+    /** 支柱高度 h，m */
+    readonly poleHeightM: number;
+    /** 线索风载 F_wl，N */
+    readonly wireWindLoadN?: number;
+}
+interface PoleCapacityResult {
+    /** 悬挂水平力 F_h，N */
+    readonly horizontalForceN: number;
+    /** 工作弯矩 M，kN·m */
+    readonly workMomentKNM: number;
+    /** 折合标称容量（÷1.5），kN·m */
+    readonly nominalNeedKNM: number;
+    /** 选型结果 */
+    readonly selection: string | null;
+}
+/** 支柱容量选型（容量比较法，TB/T 2286 5.9.2 检验弯矩口径；钢柱 25020.1 5.1.1+附录A） */
+declare function poleCapacityCheck(input: PoleCapacityInput): PoleCapacityResult;
+
+export { type PoleCapacityInput, type PoleCapacityResult, STEEL_POLE_SERIES_KNM, TEST_MOMENT_FACTOR, poleCapacityCheck, poleCapacityMeta };

package/dist/pole-capacity/index.js

@@ -0,0 +1,13 @@
+import {
+  STEEL_POLE_SERIES_KNM,
+  TEST_MOMENT_FACTOR,
+  poleCapacityCheck,
+  poleCapacityMeta
+} from "../chunk-VXVTT6WS.js";
+export {
+  STEEL_POLE_SERIES_KNM,
+  TEST_MOMENT_FACTOR,
+  poleCapacityCheck,
+  poleCapacityMeta
+};
+//# sourceMappingURL=index.js.map

package/dist/pole-capacity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/sag/index.cjs

@@ -0,0 +1,13 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkPYNVEHGRcjs = require('../chunk-PYNVEHGR.cjs');
+
+
+
+
+
+exports.maxSpanFromSagM = _chunkPYNVEHGRcjs.maxSpanFromSagM; exports.sagMM = _chunkPYNVEHGRcjs.sagMM; exports.sagMeta = _chunkPYNVEHGRcjs.sagMeta; exports.tensionFromSagKN = _chunkPYNVEHGRcjs.tensionFromSagKN;
+//# sourceMappingURL=index.cjs.map

package/dist/sag/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/ocs-calculators/ocs-calculators/dist/sag/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACF,iNAAC","file":"/home/runner/work/ocs-calculators/ocs-calculators/dist/sag/index.cjs"}

package/dist/sag/index.d.cts

@@ -0,0 +1,21 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.cjs';
+
+declare const sagMeta: CalculatorMeta;
+
+/** 弛度计算参数。单位：张力 kN、跨距 m、单位重 N/m。 */
+interface SagInput {
+    /** 接触线/承力索张力 T，kN */
+    readonly tensionKN: number;
+    /** 跨距 l，m */
+    readonly spanM: number;
+    /** 单位长度重量 g，N/m */
+    readonly weightNPerM: number;
+}
+/** 弛度 f = g·l²/(8T)，mm */
+declare function sagMM(input: SagInput): number;
+/** 反算张力：给定弛度求张力 T = g·l²/(8·f)，kN */
+declare function tensionFromSagKN(weightNPerM: number, spanM: number, sagMM: number): number;
+/** 反算最大跨距：给定张力与限值弛度 l_max = √(8·T·f_max/g)，m */
+declare function maxSpanFromSagM(weightNPerM: number, tensionKN: number, sagLimitMM: number): number;
+
+export { type SagInput, maxSpanFromSagM, sagMM, sagMeta, tensionFromSagKN };

package/dist/sag/index.d.ts

@@ -0,0 +1,21 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.js';
+
+declare const sagMeta: CalculatorMeta;
+
+/** 弛度计算参数。单位：张力 kN、跨距 m、单位重 N/m。 */
+interface SagInput {
+    /** 接触线/承力索张力 T，kN */
+    readonly tensionKN: number;
+    /** 跨距 l，m */
+    readonly spanM: number;
+    /** 单位长度重量 g，N/m */
+    readonly weightNPerM: number;
+}
+/** 弛度 f = g·l²/(8T)，mm */
+declare function sagMM(input: SagInput): number;
+/** 反算张力：给定弛度求张力 T = g·l²/(8·f)，kN */
+declare function tensionFromSagKN(weightNPerM: number, spanM: number, sagMM: number): number;
+/** 反算最大跨距：给定张力与限值弛度 l_max = √(8·T·f_max/g)，m */
+declare function maxSpanFromSagM(weightNPerM: number, tensionKN: number, sagLimitMM: number): number;
+
+export { type SagInput, maxSpanFromSagM, sagMM, sagMeta, tensionFromSagKN };

package/dist/sag/index.js

@@ -0,0 +1,13 @@
+import {
+  maxSpanFromSagM,
+  sagMM,
+  sagMeta,
+  tensionFromSagKN
+} from "../chunk-C2XU3XKP.js";
+export {
+  maxSpanFromSagM,
+  sagMM,
+  sagMeta,
+  tensionFromSagKN
+};
+//# sourceMappingURL=index.js.map

package/dist/sag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/steady-arm/index.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunk57J7I6JAcjs = require('../chunk-57J7I6JA.cjs');
+
+
+
+
+exports.steadyArmAngleDeg = _chunk57J7I6JAcjs.steadyArmAngleDeg; exports.steadyArmCheck = _chunk57J7I6JAcjs.steadyArmCheck; exports.steadyArmMeta = _chunk57J7I6JAcjs.steadyArmMeta;
+//# sourceMappingURL=index.cjs.map

package/dist/steady-arm/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/ocs-calculators/ocs-calculators/dist/steady-arm/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACF,oLAAC","file":"/home/runner/work/ocs-calculators/ocs-calculators/dist/steady-arm/index.cjs"}

package/dist/steady-arm/index.d.cts

@@ -0,0 +1,66 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.cjs';
+
+declare const steadyArmMeta: CalculatorMeta;
+
+/** 定位器坡度校核的输入参数 */
+interface SteadyArmInput {
+    /** 接触线张力 T，kN */
+    readonly contactWireTensionKN: number;
+    /** 拉出值 a，mm（内部换算 m） */
+    readonly staggerMM: number;
+    /** 跨距 l，m */
+    readonly spanM: number;
+    /** 曲线半径 R，m。undefined 表示直线区段 */
+    readonly curveRadiusM?: number;
+    /** 第一吊弦距定位点距离 l₁，m */
+    readonly firstDropperOffsetM: number;
+    /** 接触线单位重 g_j，kN/m */
+    readonly wireWeightKNPerM: number;
+    /** 定位器自重 G_d，kN */
+    readonly regulatorSelfWeightKN: number;
+}
+/** 定位器受力与坡度角计算结果 */
+interface SteadyArmAngleResult {
+    /** 直线之字力 Fz，kN */
+    readonly staggerForceKN: number;
+    /** 曲线力 Fq，kN（直线区段为 0） */
+    readonly curveForceKN: number;
+    /** 水平合成力 Fs，kN（直线为 Fz；曲线为 |Fq − Fz|） */
+    readonly horizontalForceKN: number;
+    /** 垂直力 Fc，kN */
+    readonly verticalForceKN: number;
+    /** 坡度角 θ = atan(Fc/Fs)，度 */
+    readonly angleDeg: number;
+    /** 坡度比（垂直∶水平）= 1∶n，n = Fs/Fc */
+    readonly slopeRatio: number;
+    /** 是否为直线区段 */
+    readonly isStraight: boolean;
+}
+/** 定位器坡度校核结果 */
+interface SteadyArmCheckResult extends SteadyArmAngleResult {
+    /** 是否满足限值要求 */
+    readonly passes: boolean;
+    /** 判定理由 */
+    readonly reason: string;
+}
+/**
+ * 定位器坡度计算（纯函数）：
+ *   Fz = 4·T·a/l           （直线之字力，a 由 mm 换算 m）
+ *   Fq = T·l/R             （曲线力）
+ *   Fs = |Fq − Fz|         （曲线合成，直线时 Fs = Fz）
+ *   Fc = g_j·l₁ + G_d      （垂直力）
+ *   θ  = atan(Fc/Fs)       （坡度角，弧度转度）
+ *   n  = Fs/Fc             （坡度比 1∶n）
+ */
+declare function steadyArmAngleDeg(input: SteadyArmInput): SteadyArmAngleResult;
+/**
+ * 定位器坡度限值校核。
+ *
+ * 限值（300 km/h 及以上高铁期刊口径，罗健等《高速铁路接触网定位器坡度问题的深化研究》，
+ * 铁道工程学报 2013,30(1):76-80）：
+ *   - 直线区段：θ ≥ 8°
+ *   - 曲线区段：6° ≤ θ ≤ 16°
+ */
+declare function steadyArmCheck(input: SteadyArmInput): SteadyArmCheckResult;
+
+export { type SteadyArmAngleResult, type SteadyArmCheckResult, type SteadyArmInput, steadyArmAngleDeg, steadyArmCheck, steadyArmMeta };

package/dist/steady-arm/index.d.ts

@@ -0,0 +1,66 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.js';
+
+declare const steadyArmMeta: CalculatorMeta;
+
+/** 定位器坡度校核的输入参数 */
+interface SteadyArmInput {
+    /** 接触线张力 T，kN */
+    readonly contactWireTensionKN: number;
+    /** 拉出值 a，mm（内部换算 m） */
+    readonly staggerMM: number;
+    /** 跨距 l，m */
+    readonly spanM: number;
+    /** 曲线半径 R，m。undefined 表示直线区段 */
+    readonly curveRadiusM?: number;
+    /** 第一吊弦距定位点距离 l₁，m */
+    readonly firstDropperOffsetM: number;
+    /** 接触线单位重 g_j，kN/m */
+    readonly wireWeightKNPerM: number;
+    /** 定位器自重 G_d，kN */
+    readonly regulatorSelfWeightKN: number;
+}
+/** 定位器受力与坡度角计算结果 */
+interface SteadyArmAngleResult {
+    /** 直线之字力 Fz，kN */
+    readonly staggerForceKN: number;
+    /** 曲线力 Fq，kN（直线区段为 0） */
+    readonly curveForceKN: number;
+    /** 水平合成力 Fs，kN（直线为 Fz；曲线为 |Fq − Fz|） */
+    readonly horizontalForceKN: number;
+    /** 垂直力 Fc，kN */
+    readonly verticalForceKN: number;
+    /** 坡度角 θ = atan(Fc/Fs)，度 */
+    readonly angleDeg: number;
+    /** 坡度比（垂直∶水平）= 1∶n，n = Fs/Fc */
+    readonly slopeRatio: number;
+    /** 是否为直线区段 */
+    readonly isStraight: boolean;
+}
+/** 定位器坡度校核结果 */
+interface SteadyArmCheckResult extends SteadyArmAngleResult {
+    /** 是否满足限值要求 */
+    readonly passes: boolean;
+    /** 判定理由 */
+    readonly reason: string;
+}
+/**
+ * 定位器坡度计算（纯函数）：
+ *   Fz = 4·T·a/l           （直线之字力，a 由 mm 换算 m）
+ *   Fq = T·l/R             （曲线力）
+ *   Fs = |Fq − Fz|         （曲线合成，直线时 Fs = Fz）
+ *   Fc = g_j·l₁ + G_d      （垂直力）
+ *   θ  = atan(Fc/Fs)       （坡度角，弧度转度）
+ *   n  = Fs/Fc             （坡度比 1∶n）
+ */
+declare function steadyArmAngleDeg(input: SteadyArmInput): SteadyArmAngleResult;
+/**
+ * 定位器坡度限值校核。
+ *
+ * 限值（300 km/h 及以上高铁期刊口径，罗健等《高速铁路接触网定位器坡度问题的深化研究》，
+ * 铁道工程学报 2013,30(1):76-80）：
+ *   - 直线区段：θ ≥ 8°
+ *   - 曲线区段：6° ≤ θ ≤ 16°
+ */
+declare function steadyArmCheck(input: SteadyArmInput): SteadyArmCheckResult;
+
+export { type SteadyArmAngleResult, type SteadyArmCheckResult, type SteadyArmInput, steadyArmAngleDeg, steadyArmCheck, steadyArmMeta };

package/dist/steady-arm/index.js

@@ -0,0 +1,11 @@
+import {
+  steadyArmAngleDeg,
+  steadyArmCheck,
+  steadyArmMeta
+} from "../chunk-TO46PTS3.js";
+export {
+  steadyArmAngleDeg,
+  steadyArmCheck,
+  steadyArmMeta
+};
+//# sourceMappingURL=index.js.map

package/dist/steady-arm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ocs-calculators",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "铁路接触网（OCS）工程计算工具集 —— 张力、弛度、吊弦、风偏移等计算，零依赖纯函数实现 / Railway overhead contact system (OCS) engineering calculators as zero-dependency pure functions",
   "keywords": [
     "catenary",
@@ -87,7 +87,47 @@
       "import": "./dist/wear/index.js",
       "require": "./dist/wear/index.cjs"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "steady-arm": {
+      "types": "./dist/steady-arm/index.d.ts",
+      "import": "./dist/steady-arm/index.js",
+      "require": "./dist/steady-arm/index.cjs"
+    },
+    "cross-span": {
+      "types": "./dist/cross-span/index.d.ts",
+      "import": "./dist/cross-span/index.js",
+      "require": "./dist/cross-span/index.cjs"
+    },
+    "bvalue": {
+      "types": "./dist/bvalue/index.d.ts",
+      "import": "./dist/bvalue/index.js",
+      "require": "./dist/bvalue/index.cjs"
+    },
+    "sag": {
+      "types": "./dist/sag/index.d.ts",
+      "import": "./dist/sag/index.js",
+      "require": "./dist/sag/index.cjs"
+    },
+    "anchor-length": {
+      "types": "./dist/anchor-length/index.d.ts",
+      "import": "./dist/anchor-length/index.js",
+      "require": "./dist/anchor-length/index.cjs"
+    },
+    "creepage": {
+      "types": "./dist/creepage/index.d.ts",
+      "import": "./dist/creepage/index.js",
+      "require": "./dist/creepage/index.cjs"
+    },
+    "pole-capacity": {
+      "types": "./dist/pole-capacity/index.d.ts",
+      "import": "./dist/pole-capacity/index.js",
+      "require": "./dist/pole-capacity/index.cjs"
+    },
+    "cantilever": {
+      "types": "./dist/cantilever/index.d.ts",
+      "import": "./dist/cantilever/index.js",
+      "require": "./dist/cantilever/index.cjs"
+    }
   },
   "files": [
     "dist",
@@ -121,4 +161,4 @@
     "url": "https://github.com/showhoo/ocs-calculators/issues"
   },
   "author": "思维接触网百科"
-}
+}