cucumberian.github.io

{
  "name": "shev-list-materials",
  "kind": "answer",
  "impl": "imperative",
  "description": "Список материалов труб калькулятора Шевелева с id, названиями, доступными диаметрами (мм), сериями труб (у plastic, pe100, pex — с их рядами dн) и лимитами скорости по режимам. Вызывай первым, чтобы узнать допустимые значения для shev-configure. Ряд diameters_mm — ряд ВЫБРАННОЙ СЕРИИ (у plastic/pe100/pex по умолчанию ПЭ32+SDR21, SDR 17, SDR 13,6), полный список серий — в series.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/shavelev-web/"
}

{
  "name": "shev-configure",
  "kind": "act",
  "impl": "imperative",
  "description": "Задаёт входные данные расчёта в UI: материал, новые/неновые, диаметр (dн из ряда страницы ИЛИ dv_mm — расчётный внутренний напрямую), толщину стенки, серию труб (pe — марка ПЭ, sdr — SDR), класс ВТ и тип а/ц трубы (vt/tip), галку «по формуле (4) СП» для PEX (sp4), режим водопровода, кинематическую вязкость ν (м²/с), плотность ρ (кг/м³). Параметр не той страницы и неизвестное имя НЕ проглатываются — возвращаются в warnings. Все параметры опциональны — меняется только переданное. На страницах чугуна, ж/б, стеклопластика и стекла режим/ν/ρ/k игнорируются (параметры программы). Возвращает подтверждение: что выбрано, чему равен расчётный dв и откуда он взят (dv_from: row — из сортамента, manual — ручной ввод). ПОРЯДОК: material → pe → sdr → diameter_mm (серия меняет список диаметров, поэтому ставить её надо до диаметра), wall_mm после diameter_mm, dv_mm последним (перекрывает diameter_mm). ПРИМЕР: {material:\"steel-es\", diameter_mm:1120, wall_mm:10, wear:\"old\", mode:\"dhw-supply\"} → dp=1099; без wall_mm программа возьмёт ПЕРВУЮ доступную для этого dн толщину (у dн=1120 это 8 мм → dp=1103). У меди {material:\"copper\", diameter_mm:22, wall_mm:1.0, cu_system:\"circ\", t_c:50}; у ПЭ 100 {material:\"pe100\", sdr:\"17\", diameter_mm:110}; по внутреннему диаметру {material:\"pe100\", dv_mm:76} — расчёт ровно при dв=76 (dv_from=manual, dv_matched=false).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "material": {
        "type": "string",
        "description": "id материала из shev-list-materials (steel, steel-es, ci, asbes, plastic, pe100, conc, grp, glass, copper, pex, metal-pex); если не передан — остаётся текущий"
      },
      "pe": {
        "type": "string",
        "enum": [
          "32",
          "63",
          "80",
          "100"
        ],
        "description": "только plastic: марка ПЭ (frmtablII5 Frame2) — от неё зависит, какие серии SDR допустимы; ставь ДО sdr"
      },
      "sdr": {
        "type": "string",
        "description": "серия труб: plastic/pe100 — номер SDR (например 11, 17; можно передать числом), pex — id серии (sdr11, sdr136). Серия меняет dв, а значит и ΔP: задавай её явно, не полагаясь на дефолт"
      },
      "cu_system": {
        "type": "string",
        "enum": [
          "cold",
          "circ",
          "supply",
          "heat",
          "hot"
        ],
        "description": "только copper/pex/metal-pex. У меди: cold=ХВС (ф-ла 2, v≤4), circ=циркуляционный ГВС (ф-ла 2, v≤3), supply=подающие ГВС (ф-ла 3, v≤3), heat=отопление (ф-лы 5–9, v≤2). У PEX и PEX-AL-PEX выбор меньше: cold=ХВС, hot=ГВС, heat=отопление (одна λ, v≤4/3/2) — на их странице значения circ/supply не действуют"
      },
      "vt": {
        "type": "string",
        "enum": [
          "ВТ6",
          "ВТ9",
          "ВТ12",
          "ВТ15"
        ],
        "description": "только asbes: класс трубы ВТ по ГОСТ 539-80 — от пары (ВТ, тип) зависит dв; ставь вместе с tip"
      },
      "tip": {
        "type": "string",
        "enum": [
          "1",
          "2",
          "3"
        ],
        "description": "только asbes: тип труб по размерам (frmtablII4); ВТ15 при типе 1 скрыта"
      },
      "sp4": {
        "type": "boolean",
        "description": "только pex/metal-pex: считать по формуле (4) СП 41-109-2005 (галка в окне); без неё — вариант программы, λ у него отличается примерно на треть"
      },
      "t_c": {
        "type": "number",
        "enum": [
          50,
          60,
          70,
          80,
          90
        ],
        "description": "только copper/pex/metal-pex: температура воды °С (Combo3) — по ней программа подставляет ν и ρ (50→0,55e-6/990 … 90→0,36e-6/970); при пустой t ν=1,3e-6, ρ=1000"
      },
      "wear": {
        "type": "string",
        "enum": [
          "new",
          "old"
        ],
        "description": "новые/неновые. Блок есть только у стали, электросварных и чугуна (там wear меняет формулу); на остальных страницах параметр не входит в расчёт и в ответе не эхомется"
      },
      "pipe_class": {
        "type": "string",
        "enum": [
          "ЛА",
          "А",
          "Б"
        ],
        "description": "класс чугунной трубы (только ci): единый список dу (14 значений, без 450/700/900) для всех классов, dp из таблицы класса"
      },
      "wall_mm": {
        "type": "number",
        "description": "толщина стенки мм (сталь/э/с/медь). У этих страниц толщина своя у КАЖДОГО диаметра, поэтому задавай её после diameter_mm; в срезе shev-sweep она ставится на каждый dн отдельно и если у этого dн такой толщины нет — строка вернёт {dn, error}"
      },
      "mode": {
        "type": "string",
        "description": "режим: potable|combined|prod-fire|fire|dhw-supply|dhw-tp|dhw-risers (блок режима есть только у стали и электросварных; на остальных страницах игнорируется — факт игнора приходит в warnings)"
      },
      "nu": {
        "type": "number",
        "description": "кинематическая вязкость, м²/с (вода 10°C: 1.3e-6); действительна только на стальных страницах (и как «другой» теплоноситель у меди в отоплении); на остальных игнорируется с предупреждением"
      },
      "rho": {
        "type": "number",
        "description": "плотность, кг/м³; действительна только на стальных страницах (у меди — «другой» теплоноситель в отоплении); на остальных игнорируется с предупреждением"
      },
      "diameter_mm": {
        "type": "number",
        "description": "диаметр ИЗ РЯДА страницы (dу/dн/du, мм). Значения не из ряда здесь ошибка — перечисли доступные в сообщении"
      },
      "dv_mm": {
        "type": "number",
        "description": "расчётный ВНУТРЕННИЙ диаметр напрямую, мм — как формулирует вопрос сантехник. Если значение ровно из сортамента, выбирается та строка (dv_from=»row«); иначе включается ручной ввод галочкой «другой» и расчёт идёт РОВНО по этому dв (dv_from=»manual«, dv_matched=false). На стали, э/с, чугуне, а/ц и ж/б ручного dв нет — там dв из сортамента, задавай diameter_mm (+ wall_mm/pipe_class)"
      }
    }
  },
  "page": "/shavelev-web/"
}

{
  "name": "shev-velocity",
  "kind": "act",
  "impl": "imperative",
  "description": "СКОРОСТЬ ПОТОКА В ТРУБЕ: v = Q/(π·dв²/4). Принимает ровно то, что входит в формулу, — расчётный внутренний диаметр dв (мм) и расход: материал, ν, ρ, режим и длина в скорость не входят (одна формула velocity() на все 12 страниц, js/calc.js). Поэтому вызов НЕ зависит от того, что открыто на странице, и НИЧЕГО на экране не меняет: два одинаковых вызова дают одинаковый ответ. dв берётся из shev-list-materials (ряды диаметров и серии) или из shev-configure (dv_mm). Потери по этой скорости — shev-losses с v_ms.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "dv_mm": {
        "type": "number",
        "description": "расчётный внутренний диаметр dв, мм (у стали и чугуна «неновых» — уже с поправкой −1 мм на отложения; у полиэтилена — dн−2e выбранной серии)"
      },
      "q": {
        "type": "number",
        "description": "расход"
      },
      "qunit": {
        "type": "string",
        "enum": [
          "ls",
          "mh"
        ],
        "description": "единицы расхода: ls=л/с (по умолчанию), mh=м³/ч"
      }
    }
  },
  "page": "/shavelev-web/"
}

{
  "name": "shev-losses",
  "kind": "act",
  "impl": "imperative",
  "description": "ПОТЕРИ НАПОРА И ДАВЛЕНИЯ на участке — считает по ОДНОМУ из двух входов: РАСХОД q (скорость посчитается сама; экран покажет расчёт как кнопка «Расчёт», в ответе будут raw-текст программы и экономическая рекомендация по диаметру) или СКОРОСТЬ v_ms, если она уже известна извне (расход тогда не нужен; результат на экране не пересчитывается, рекомендации по диаметру нет — для неё нужен расход). Отдаёт: i (мм/м и м/м), R (Па/м), при длине L — H (м) и потери давления (Па), law/method — какой формулой фактически посчитано, предупреждения по скорости. Вход материала/сортамента — тот же словарь, что у shev-configure: он нужен, чтобы получить расчётный dв. Если надо и задать входы, и посчитать — это один вызов shev-losses.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "material": {
        "type": "string",
        "description": "id материала из shev-list-materials (steel, steel-es, ci, asbes, plastic, pe100, conc, grp, glass, copper, pex, metal-pex); если не передан — остаётся текущий"
      },
      "pe": {
        "type": "string",
        "enum": [
          "32",
          "63",
          "80",
          "100"
        ],
        "description": "только plastic: марка ПЭ (frmtablII5 Frame2) — от неё зависит, какие серии SDR допустимы; ставь ДО sdr"
      },
      "sdr": {
        "type": "string",
        "description": "серия труб: plastic/pe100 — номер SDR (например 11, 17; можно передать числом), pex — id серии (sdr11, sdr136). Серия меняет dв, а значит и ΔP: задавай её явно, не полагаясь на дефолт"
      },
      "cu_system": {
        "type": "string",
        "enum": [
          "cold",
          "circ",
          "supply",
          "heat",
          "hot"
        ],
        "description": "только copper/pex/metal-pex. У меди: cold=ХВС (ф-ла 2, v≤4), circ=циркуляционный ГВС (ф-ла 2, v≤3), supply=подающие ГВС (ф-ла 3, v≤3), heat=отопление (ф-лы 5–9, v≤2). У PEX и PEX-AL-PEX выбор меньше: cold=ХВС, hot=ГВС, heat=отопление (одна λ, v≤4/3/2) — на их странице значения circ/supply не действуют"
      },
      "vt": {
        "type": "string",
        "enum": [
          "ВТ6",
          "ВТ9",
          "ВТ12",
          "ВТ15"
        ],
        "description": "только asbes: класс трубы ВТ по ГОСТ 539-80 — от пары (ВТ, тип) зависит dв; ставь вместе с tip"
      },
      "tip": {
        "type": "string",
        "enum": [
          "1",
          "2",
          "3"
        ],
        "description": "только asbes: тип труб по размерам (frmtablII4); ВТ15 при типе 1 скрыта"
      },
      "sp4": {
        "type": "boolean",
        "description": "только pex/metal-pex: считать по формуле (4) СП 41-109-2005 (галка в окне); без неё — вариант программы, λ у него отличается примерно на треть"
      },
      "t_c": {
        "type": "number",
        "enum": [
          50,
          60,
          70,
          80,
          90
        ],
        "description": "только copper/pex/metal-pex: температура воды °С (Combo3) — по ней программа подставляет ν и ρ (50→0,55e-6/990 … 90→0,36e-6/970); при пустой t ν=1,3e-6, ρ=1000"
      },
      "wear": {
        "type": "string",
        "enum": [
          "new",
          "old"
        ],
        "description": "новые/неновые. Блок есть только у стали, электросварных и чугуна (там wear меняет формулу); на остальных страницах параметр не входит в расчёт и в ответе не эхомется"
      },
      "pipe_class": {
        "type": "string",
        "enum": [
          "ЛА",
          "А",
          "Б"
        ],
        "description": "класс чугунной трубы (только ci): единый список dу (14 значений, без 450/700/900) для всех классов, dp из таблицы класса"
      },
      "wall_mm": {
        "type": "number",
        "description": "толщина стенки мм (сталь/э/с/медь). У этих страниц толщина своя у КАЖДОГО диаметра, поэтому задавай её после diameter_mm; в срезе shev-sweep она ставится на каждый dн отдельно и если у этого dн такой толщины нет — строка вернёт {dn, error}"
      },
      "mode": {
        "type": "string",
        "description": "режим: potable|combined|prod-fire|fire|dhw-supply|dhw-tp|dhw-risers (блок режима есть только у стали и электросварных; на остальных страницах игнорируется — факт игнора приходит в warnings)"
      },
      "nu": {
        "type": "number",
        "description": "кинематическая вязкость, м²/с (вода 10°C: 1.3e-6); действительна только на стальных страницах (и как «другой» теплоноситель у меди в отоплении); на остальных игнорируется с предупреждением"
      },
      "rho": {
        "type": "number",
        "description": "плотность, кг/м³; действительна только на стальных страницах (у меди — «другой» теплоноситель в отоплении); на остальных игнорируется с предупреждением"
      },
      "diameter_mm": {
        "type": "number",
        "description": "диаметр ИЗ РЯДА страницы (dу/dн/du, мм). Значения не из ряда здесь ошибка — перечисли доступные в сообщении"
      },
      "dv_mm": {
        "type": "number",
        "description": "расчётный ВНУТРЕННИЙ диаметр напрямую, мм — как формулирует вопрос сантехник. Если значение ровно из сортамента, выбирается та строка (dv_from=»row«); иначе включается ручной ввод галочкой «другой» и расчёт идёт РОВНО по этому dв (dv_from=»manual«, dv_matched=false). На стали, э/с, чугуне, а/ц и ж/б ручного dв нет — там dв из сортамента, задавай diameter_mm (+ wall_mm/pipe_class)"
      },
      "q": {
        "type": "number",
        "description": "расход (по умолчанию л/с)"
      },
      "qunit": {
        "type": "string",
        "enum": [
          "ls",
          "mh"
        ],
        "description": "единицы расхода: ls=л/с, mh=м³/ч"
      },
      "length_m": {
        "type": "number",
        "description": "длина участка L, м"
      },
      "k": {
        "type": "number",
        "description": "коэффициент местных сопротивлений k ≥ 0 (только сталь и электросварные: переданный k сам включает галку «учесть потери на местные сопротивления»; на остальных страницах H=i·L и k игнорируется с предупреждением, как и при dу≥80/dн≥88, где блок скрыт)"
      },
      "xi_total": {
        "type": "number",
        "description": "сумма ξ местных сопротивлений для страниц с редактором ξ (медь, PEX, PEX-AL-PEX — Frame6 окна; задаётся «другими ξ», складываются без умножения); входит в H как V²Σξ/2g и в потери давления как Z=0,5ρV²Σξ; на остальных страницах игнорируется с предупреждением"
      },
      "v_ms": {
        "type": "number",
        "description": "СКОРОСТЬ, м/с — если она уже известна, q не нужен: потери считаются прямо по ней (экран не меняется, рекомендации по диаметру нет)"
      }
    }
  },
  "page": "/shavelev-web/"
}

{
  "name": "shev-sweep",
  "kind": "act",
  "impl": "imperative",
  "description": "Срез расчёта по списку диаметров одним вызовом: те же параметры страницы, что у shev-configure, плюс dn — список диаметров, и расход с длиной (k и xi_total тоже принимаются и действуют на весь срез). Материал и серия выставляются ОДИН раз, затем расчёт идёт по каждому dн — один вызов вместо N. Диаметр, которого нет в ряду выбранной серии, не роняет весь срез: в его строке придёт {dn, error}. Экран остаётся на последнем рассчитанном диаметре. Список — по dн: dv_mm здесь не принимается (ручной dв не менялся бы от строки к строке).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "material": {
        "type": "string",
        "description": "id материала из shev-list-materials (steel, steel-es, ci, asbes, plastic, pe100, conc, grp, glass, copper, pex, metal-pex); если не передан — остаётся текущий"
      },
      "pe": {
        "type": "string",
        "enum": [
          "32",
          "63",
          "80",
          "100"
        ],
        "description": "только plastic: марка ПЭ (frmtablII5 Frame2) — от неё зависит, какие серии SDR допустимы; ставь ДО sdr"
      },
      "sdr": {
        "type": "string",
        "description": "серия труб: plastic/pe100 — номер SDR (например 11, 17; можно передать числом), pex — id серии (sdr11, sdr136). Серия меняет dв, а значит и ΔP: задавай её явно, не полагаясь на дефолт"
      },
      "cu_system": {
        "type": "string",
        "enum": [
          "cold",
          "circ",
          "supply",
          "heat",
          "hot"
        ],
        "description": "только copper/pex/metal-pex. У меди: cold=ХВС (ф-ла 2, v≤4), circ=циркуляционный ГВС (ф-ла 2, v≤3), supply=подающие ГВС (ф-ла 3, v≤3), heat=отопление (ф-лы 5–9, v≤2). У PEX и PEX-AL-PEX выбор меньше: cold=ХВС, hot=ГВС, heat=отопление (одна λ, v≤4/3/2) — на их странице значения circ/supply не действуют"
      },
      "vt": {
        "type": "string",
        "enum": [
          "ВТ6",
          "ВТ9",
          "ВТ12",
          "ВТ15"
        ],
        "description": "только asbes: класс трубы ВТ по ГОСТ 539-80 — от пары (ВТ, тип) зависит dв; ставь вместе с tip"
      },
      "tip": {
        "type": "string",
        "enum": [
          "1",
          "2",
          "3"
        ],
        "description": "только asbes: тип труб по размерам (frmtablII4); ВТ15 при типе 1 скрыта"
      },
      "sp4": {
        "type": "boolean",
        "description": "только pex/metal-pex: считать по формуле (4) СП 41-109-2005 (галка в окне); без неё — вариант программы, λ у него отличается примерно на треть"
      },
      "t_c": {
        "type": "number",
        "enum": [
          50,
          60,
          70,
          80,
          90
        ],
        "description": "только copper/pex/metal-pex: температура воды °С (Combo3) — по ней программа подставляет ν и ρ (50→0,55e-6/990 … 90→0,36e-6/970); при пустой t ν=1,3e-6, ρ=1000"
      },
      "wear": {
        "type": "string",
        "enum": [
          "new",
          "old"
        ],
        "description": "новые/неновые. Блок есть только у стали, электросварных и чугуна (там wear меняет формулу); на остальных страницах параметр не входит в расчёт и в ответе не эхомется"
      },
      "pipe_class": {
        "type": "string",
        "enum": [
          "ЛА",
          "А",
          "Б"
        ],
        "description": "класс чугунной трубы (только ci): единый список dу (14 значений, без 450/700/900) для всех классов, dp из таблицы класса"
      },
      "wall_mm": {
        "type": "number",
        "description": "толщина стенки мм (сталь/э/с/медь). У этих страниц толщина своя у КАЖДОГО диаметра, поэтому задавай её после diameter_mm; в срезе shev-sweep она ставится на каждый dн отдельно и если у этого dн такой толщины нет — строка вернёт {dn, error}"
      },
      "mode": {
        "type": "string",
        "description": "режим: potable|combined|prod-fire|fire|dhw-supply|dhw-tp|dhw-risers (блок режима есть только у стали и электросварных; на остальных страницах игнорируется — факт игнора приходит в warnings)"
      },
      "nu": {
        "type": "number",
        "description": "кинематическая вязкость, м²/с (вода 10°C: 1.3e-6); действительна только на стальных страницах (и как «другой» теплоноситель у меди в отоплении); на остальных игнорируется с предупреждением"
      },
      "rho": {
        "type": "number",
        "description": "плотность, кг/м³; действительна только на стальных страницах (у меди — «другой» теплоноситель в отоплении); на остальных игнорируется с предупреждением"
      },
      "q": {
        "type": "number",
        "description": "расход (по умолчанию л/с)"
      },
      "qunit": {
        "type": "string",
        "enum": [
          "ls",
          "mh"
        ],
        "description": "единицы расхода: ls=л/с, mh=м³/ч"
      },
      "length_m": {
        "type": "number",
        "description": "длина участка L, м"
      },
      "k": {
        "type": "number",
        "description": "коэффициент местных сопротивлений k ≥ 0 (только сталь и электросварные: переданный k сам включает галку «учесть потери на местные сопротивления»; на остальных страницах H=i·L и k игнорируется с предупреждением, как и при dу≥80/dн≥88, где блок скрыт)"
      },
      "xi_total": {
        "type": "number",
        "description": "сумма ξ местных сопротивлений для страниц с редактором ξ (медь, PEX, PEX-AL-PEX — Frame6 окна; задаётся «другими ξ», складываются без умножения); входит в H как V²Σξ/2g и в потери давления как Z=0,5ρV²Σξ; на остальных страницах игнорируется с предупреждением"
      },
      "dn": {
        "type": "array",
        "items": {
          "type": "number"
        },
        "description": "список диаметров для среза, мм (dу/dн — как у материала, см. shev-list-materials)"
      }
    }
  },
  "page": "/shavelev-web/"
}

{
  "name": "shev-get-formulas",
  "kind": "act",
  "impl": "imperative",
  "description": "Возвращает расчётные формулы Шевелева, реализованные в программе (λ, A=λ/(2g), i=A·v²/d^e по материалам и состояниям труб), для справки и объяснения результата пользователю.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/shavelev-web/"
}