Skip to main content
Glama

SooTool

Precision Calc MCP for LLM tool use.

CI PyPI version Python 3.12+ License: MIT

LLM 대신 계산을 맡는 MCP 서버. 세금, 급여, 금융, 통계, 공학 계산을 Decimal로 정확하게 수행하고 계산 근거를 함께 돌려준다. 18개 계산 도메인 276개 기본 도구 + 10개 admin 정책 도구, 한 번에 최대 500건 병렬 계산(core.batch), 단계 연결 계산(core.pipeline), 4종 전송(stdio/Streamable HTTP/Unix, 폐기 예정 SSE)을 제공한다. Python 3.12 이상.

왜 필요한가

LLM은 숫자를 계산하지 않고 그럴듯한 숫자를 생성한다. 그래서 누진세 구간 경계, 반올림 방향, 연도별 세율에서 자주 틀린다. 아래는 같은 20문제를 풀린 결과다(2026-04-24 측정).

풀이 주체

정답(exact)

근사(오차 0.01% 이내)

오답

SooTool

20

0

0

gemini-3-pro-preview

12

4

4

claude-opus-4-7

9

3

8

gpt-5.4

5

3

12

틀리는 지점은 모델이 달라도 비슷하다. 소득세 구간 경계, 양도소득세 장기보유특별공제, 부가세 반올림, 교류 임피던스 정밀도다. 문제 구성과 원자료는 bench/에 있다.

SooTool은 이 계산을 세 가지 장치로 고정한다.

  • Decimal 전용 계산. 입력 숫자는 문자열이나 Decimal로 받는다. 부동소수점 오차가 계산에 끼지 않는다.

  • 법령 값의 외부화. 세율, 공제액, 보험료율은 정책 파일(YAML)에 근거 조문과 시행일을 붙여 둔다. 시점(as_of)을 주면 그날 시행 중이던 값으로 계산한다.

  • 계산 근거 반환. 모든 응답에 공식, 입력, 중간값, 결과가 담긴 trace와 재실행 검증용 영수증(_meta.integrity)이 붙는다.

Related MCP server: Polymath MegaBlaster MCP

구조

 LLM 에이전트 / CLI / 파이썬 코드
        │
        │  MCP(stdio, HTTP, Unix)        sootool call ...        from sootool.sdk import tax
        ▼                                      ▼                          ▼
 ┌──────────────────────────────────────────────────────────────────────────────┐
 │ 경계 검사   인자 이름·타입·크기 검증, 숫자 문자열 → Decimal, 인증 범위 확인     │
 ├──────────────────────────────────────────────────────────────────────────────┤
 │ 레지스트리   도구 286개를 이름으로 찾아 실행 (core.batch / core.pipeline 포함)   │
 ├───────────────────────────────┬──────────────────────────────────────────────┤
 │ 도메인 도구                     │ 정책 로더                                      │
 │ tax · payroll · finance ·      │ policies/<도메인>/<이름>_<연도>.yaml           │
 │ realestate · stats · ...       │ 해시 검증 → as_of 시점의 시행 버전 선택         │
 └───────────────────────────────┴──────────────────────────────────────────────┘
        │
        ▼
 { 결과 필드, trace(공식·입력·단계·출력), 정책 출처와 근거 조문, _meta.integrity(영수증) }

세 진입점(MCP, CLI, SDK)은 같은 레지스트리를 거친다. 같은 입력이면 어느 경로로 불러도 결과와 영수증이 같다.

빠른 시작

설치

pip install sootool                 # 기호 계산(symbolic.*)까지 쓰려면 pip install "sootool[symbolic]"

Claude Code에 등록

claude mcp add --scope user sootool -- uvx sootool

저장소를 받아 개발 중인 코드로 띄우려면 다음처럼 등록한다.

git clone https://github.com/JinHo-von-Choi/SooTool.git
cd SooTool && uv sync
claude mcp add --scope user sootool -- uv run --directory "$PWD" python -m sootool

첫 계산

MCP 클라이언트에서 "과세표준 5천만 원의 2026년 소득세는?"이라고 물으면 에이전트가 tax.kr_income을 호출한다. 터미널에서 같은 도구를 직접 실행할 수도 있다.

sootool call tax.kr_income --arg taxable_income=50000000 --arg year=2026 --format raw
{
  "tax": "6240000",
  "effective_rate": "0.12480000",
  "marginal_rate": "0.15",
  "breakdown": [ ... 구간별 과세표준과 세액 ... ],
  "policy_effective_date": "2026-01-01",
  "policy_citations": [{"law": "소득세법", "article": "제55조제1항", "url": "https://www.law.go.kr/법령/소득세법/제55조"}]
}

응답 읽는 법

finance.npv(rate="0.08", cashflows=["-1000","300","400","500","200"], rounding="HALF_EVEN", decimals=2)의 실제 응답이다.

{
  "npv": "164.64",
  "trace": {
    "tool": "finance.npv",
    "formula": "NPV = sum(CF_t / (1+r)^t, t=0..n)",
    "inputs": {"rate": "0.08", "cashflows": ["-1000", "300", "400", "500", "200"], "rounding": "HALF_EVEN", "decimals": 2},
    "steps": [{"label": "npv_raw", "value": "164.63539696786661172171511042618089308126395968697"}],
    "output": "164.64"
  },
  "_meta": {
    "integrity": {
      "tool": "finance.npv",
      "input_hash": "00da5199...",
      "result_hash": "d7a0ecfe...",
      "tool_version": "1.0.0",
      "sootool_version": "0.3.1"
    },
    "engine": "decimal"
  }
}

필드

뜻

npv 등 결과 필드

계산 결과. 숫자는 모두 문자열이다.

trace.steps

반올림 전 값을 포함한 중간 계산. 결과를 사람이 검산할 때 본다.

policy_*

정책 도구만 붙는다. 적용한 정책 파일의 시행일, 상태, 근거 조문, 해시.

_meta.integrity

영수증. 입력과 결과의 해시라서 sootool receipt verify로 같은 계산을 다시 돌려 대조할 수 있다.

_meta.engine

계산 엔진. decimal(정확), mpmath(지정 자릿수), float64(근사), composite, none.

_meta.hints

다음에 부를 만한 도구 제안. 결과 값에는 영향이 없다.

주요 기능

반올림은 호출자가 고른다

반올림 관행이 상황마다 갈리는 금융·회계 도구(부가세, 현금흐름, 감가상각, 환전 등)는 rounding(HALF_EVEN, HALF_UP, DOWN, UP, FLOOR, CEIL)과 decimals를 받는다. 부가세 역산은 원 단위 절사(DOWN), 회계 일반은 HALF_EVEN처럼 쓰임새마다 규칙이 다르기 때문이다. 법령이 끝수 처리를 정한 세목(건강보험료·장기요양보험료, 월급 원천징수 지방소득세, 자동차세·등록면허세는 10원 단위 절사)은 그 규칙을 그대로 따르고 도구 설명에 적어 둔다.소득세 산출세액과 개인지방소득세 산출세액은 원 미만 절사다.

시점을 지정한 정책 계산

세법과 보험료율은 연중에도 바뀐다. 정책 도구는 year 외에 as_of(YYYY-MM-DD)와 include_proposed를 받는다.

policies/payroll/kr_4insurance_2026.yaml             2026-01-01 ~ 2026-06-30
policies/payroll/kr_4insurance_2026@2026-07-01.yaml  2026-07-01 ~ 2026-10-31  ◀── as_of="2026-08-15"
policies/payroll/kr_4insurance_2026@2026-11-01.yaml  2026-11-01 ~ 2026-12-31

as_of가 속한 버전으로 계산하고, 응답에 그 버전의 시행일과 근거 조문을 싣는다.

as_of를 주지 않으면 그 해 확정 버전 중 시행일이 가장 늦은 것을 쓴다. 국회 확정 전 개정안(status: proposed)은 include_proposed=true일 때만 쓴다. 정책 파일을 서버 재배포 없이 고치는 절차는 docs/policy_management.md에 있다.

여러 건을 한 번에: batch와 pipeline

core.batch     독립 계산 N건을 병렬로             core.pipeline   앞 단계 결과를 다음 단계 입력으로
                                                 
 ┌ s1: finance.npv(rate=0.05) ┐                  annual = core.mul(3000000, 12)
 ├ s2: finance.npv(rate=0.08) ┼─▶ id 순서로 결과       │  ${annual.result.result}
 └ s3: finance.npv(rate=0.10) ┘                       ▼
                                                  tax = tax.kr_income(annual, 2026)
 최대 500건, 항목당 10초, 전체 60초              최대 50단계, 깊이 10, 단계당 2초, 전체 30초

core.batch는 항목마다 성공, 오류, 시간 초과를 따로 기록하고 결과를 입력 순서대로 돌려준다. core.pipeline은 앞 단계가 실패하면 뒤 단계를 skipped로 표시하며, 실패한 지점부터 다시 돌리는 core.pipeline_resume(10분 보관)이 있다.

{
  "name": "core.pipeline",
  "arguments": {
    "steps": [
      {"id": "annual", "tool": "core.mul",      "args": {"operands": ["3000000", "12"]}},
      {"id": "tax",    "tool": "tax.kr_income", "args": {"taxable_income": "${annual.result.result}", "year": 2026}}
    ]
  }
}

실무에서는 다음처럼 쓴다.

작업

규모

조합

급여 마감

직원 500명

core.batch + payroll.kr_salary

투자 민감도

할인율 9개 × 현금흐름 5안

core.batch + finance.npv, finance.irr

거래명세서 부가세 분리

수백 건

core.batch + accounting.vat_extract

월급에서 실수령액까지

4단계

core.pipeline

역산, 비교, 설명

  • core.solve_for: 목표 결과를 만드는 입력값을 찾는다. 예) 실수령액 300만 원이 되는 세전 월급.

  • core.compare: 기준안 대비 시나리오별 값과 차이를 표로 낸다.

  • core.explain: 계산 과정과 적용 정책을 한국어나 영어 문장으로 풀어 쓴다. 수치는 바꾸지 않는다.

영수증 재실행 검증

sootool receipt verify --tool finance.fv \
  --arguments '{"present_value":"1000","rate":"0.05","periods":10}' \
  --receipt receipt.json

같은 도구를 다시 실행해 도구 이름, 입력 해시, 결과 해시, 도구 버전, 정책 해시를 대조한다. SOOTOOL_RECEIPT_KEY_FILE에 ed25519 개인 키 파일을 지정하면 영수증에 서명이 붙는다.

도구 카탈로그 (276개 기본 + 10개 admin, 18 계산 도메인 + 운영 도구)

Namespace

Count

대표 도구

core

11

add, sub, mul, div, calc(수식), batch, pipeline, pipeline_resume, solve_for, compare, explain

accounting

12

vat_extract, vat_add, balance, 감가상각 3종, dupont 2종, ratios, income_statement, cashflow_operating, break_even

finance

18

pv, fv, npv, irr, roi, cagr, payback_period, loan_schedule, bond_ytm, bond_duration, black_scholes, var 2종, sharpe, sortino

tax

17

kr_income, kr_comprehensive_income_tax, kr_withholding_simple, capital_gains_kr, kr_gift, kr_inheritance, kr_corporate, kr_eitc, 지방세 부가 3종

tax_us

4

federal_income, capital_gains, state_tax, fica

payroll

15

kr_salary, kr_gross_from_net, kr_severance_pay, kr_year_end_tax_settlement, kr_overtime_pay, kr_minimum_wage_check, 공제 4종

realestate

10

kr_acquisition_tax, kr_transfer_tax, kr_property_tax, kr_comprehensive, kr_ltv, kr_dti, kr_dsr, kr_subscription_score

stats

14

descriptive, t-검정 3종, anova_oneway, regression_linear, ci_mean, bootstrap_ci, 비모수 검정

probability

30

정규, 이항, 포아송, 감마, 베타, 지수, 로그정규, 카이제곱, F 분포의 pdf·cdf·ppf, bayes, nCr, nPr

datetime

14

영업일 계산, day_count, age, diff, tz_convert, 음양력 변환, 24절기, 회계연도, 소득세 과세기간

math

10

수치 적분 2종, 수치 미분 2종, 보간 2종, polynomial_roots, polynomial_horner, fft, ifft

geometry

15

넓이·부피 7종, 벡터 3종, 행렬 4종, haversine

engineering

56

전기·교류 회로, 유체, 열전달, 재료역학, 제어, 신뢰성, SI 접두어 변환

units

8

convert, fx_convert, fx_triangulate, temperature, 에너지·압력·데이터 크기·시간 변환

medical

12

bmi, bsa, egfr, dose_weight_based, pregnancy_weeks, cha2ds2_vasc, has_bled, framingham_cvd_10y, QTc 4종

science

11

half_life, ideal_gas, molar_mass, stoichiometry, nernst, snell_law, thin_lens, bragg 외

crypto

10

gcd, lcm, egcd, modinv, modpow, crt, is_prime, euler_totient, carmichael_lambda, hash

pm

5

critical_path, pert, evm, earned_schedule, monte_carlo_schedule

symbolic

2

solve, diff (sootool[symbolic] 설치 시)

sootool

2+10

skill_guide, verify_receipt, 정책 관리 10종(쓰기 4종은 관리자 모드)

도구별 버전, 정확도 등급, 설명은 docs/tool_catalog.md에 있다. 이 파일은 레지스트리에서 자동 생성한다.

서버 실행

sootool                                                    # stdio (MCP 클라이언트 기본)
sootool --transport http --http-port 10535                 # Streamable HTTP
sootool --transport unix --socket /tmp/sootool.sock        # Unix 소켓
sootool --transport stdio,http --socket /tmp/sootool.sock  # 여러 전송 동시 기동

전송

용도

비고

stdio

Claude Code, Claude Desktop 등 로컬 클라이언트

기본값

http

원격 접속(Streamable HTTP)

무상태라 로드 밸런서 뒤에 둘 수 있다. 기본 포트 10535

unix

같은 호스트의 다른 프로세스

소켓 파일 권한(기본 0600)으로 접근을 통제한다

sse-legacy

MCP 2024-11 클라이언트 호환

폐기 예정. --enable-sse-legacy로만 켜진다. 기본 포트 10536

네트워크 전송의 보안 규칙은 다음과 같다.

  • 기본 바인딩은 127.0.0.1이다. --host 0.0.0.0으로 외부에 열려면 --auth-token(또는 SOOTOOL_AUTH_TOKEN)이 있어야 기동한다.

  • 정책을 바꾸는 쓰기 도구 4종은 stdio와 Unix 소켓에서만 노출한다. 네트워크에서 쓰려면 --admin --remote-admin --admin-token <토큰>이 모두 필요하고, 관리자 토큰으로 인증한 요청만 쓰기를 수행한다.

노출 프로파일

sootool --profile full   # 기본값. 도구 286개를 모두 노출
sootool --profile lean   # sootool.search, describe, call, skill_guide 4개만 노출

lean은 도구 정의 전체를 컨텍스트에 올리지 않는다. 에이전트는 sootool.search로 도구를 찾고, sootool.describe로 인자를 확인한 뒤, sootool.call로 실행한다. 결과와 영수증은 직접 호출과 같다. sootool.call은 읽기 전용 도구만 실행한다.

명령줄

서브커맨드를 주면 서버를 띄우지 않고 도구를 바로 실행한다.

sootool call core.add --arg 'operands=["1.5","2.5"]'
sootool call finance.npv --arg-json '{"rate":"0.1","cashflows":["-100","50","60","70"]}'
sootool call payroll.kr_gross_from_net --arg net_monthly=3000000 --arg year=2026 --format raw
sootool tools list --search 양도세        # 줄임말과 일상 표현으로 검색
sootool tools describe tax.kr_income     # 인자와 정책 인자 확인
sootool batch -f items.json              # -f - 는 표준입력
sootool policy show --arg domain=tax --arg name=kr_income --arg year=2026
sootool skill-guide --section triggers
sootool version

항목

내용

인자

--arg 이름=값을 반복하거나 --arg-json으로 한 번에 넘긴다. 문자열 인자는 값을 그대로 쓰고, 정수·불리언·목록·객체는 JSON으로 읽는다.

출력 형식

--format pretty(기본), json(전체), raw(trace와 _meta 제외), trace

출력 위치

결과는 표준출력, 오류는 표준에러에 JSON으로 낸다.

종료 코드

0 성공, 1 도구 오류, 2 입력 오류, 3 관리자 모드 필요(SOOTOOL_ADMIN_MODE=1), 70 내부 오류

파이썬 라이브러리로 쓰기

MCP 서버 없이 같은 도구를 함수로 부른다. 결과, 영수증, as_of 처리가 MCP와 같고 결과 타입이 선언되어 있어 타입 검사기가 필드를 확인한다.

from sootool.sdk import tax

out = tax.kr_income(taxable_income=50_000_000, year=2026)
out["tax"]                                # "6240000"
out["_meta"]["integrity"]["input_hash"]   # 재실행 검증용 영수증

샌드박스에서 에이전트가 파이썬을 실행하는 구성은 docs/sdk.md를 본다.

에이전트에 사용 규칙 알려 주기

도구를 등록해도 에이전트가 직접 암산하는 경우가 있다. 아래 중 하나로 "숫자 계산은 SooTool로" 규칙을 넣는다.

  • 세션 시작 시 sootool.skill_guide를 호출하게 한다. 언제 어떤 도구를 부를지 정리한 트리거 표, 예시, 금지 패턴, 플레이북을 돌려준다(section: triggers, examples, anti_patterns, playbooks, all / lang: ko, en).

  • 클라이언트 설정 파일에 붙여 넣을 규칙: Claude Code, Cursor, AGENTS.md

문서

문서

내용

사용자 가이드

도메인별 도구 개요, 공통 인자, 응답 규칙

도구 카탈로그

도구 286개의 버전, 정확도 등급, 설명

정책 관리

정책 파일 구조, 시점 선택, 갱신·롤백 절차, 감사 로그

SDK

파이썬 라이브러리 사용법과 샌드박스 구성

외부 정책 팩

서명된 정책 묶음의 생성, 검증, 설치

안정성 계약

호환을 약속하는 범위와 폐기 절차

쿡북

세무, 금융, 전기 공학 시나리오별 호출 예시

아키텍처 결정 기록

설계 결정과 근거(ADR)

릴리스 절차

버전 올리기부터 PyPI 게시까지

개발

uv sync --extra symbolic
make test        # pytest와 커버리지
make lint        # ruff
make typecheck   # mypy
uv run python scripts/mcp_smoke_test.py   # stdio 연결 점검 (http, sse, unix 스크립트도 있다)

새 도구는 src/sootool/modules/<도메인>/에 함수를 만들고 @REGISTRY.tool(namespace, name, description, version)을 붙인 뒤 도메인 __init__.py에서 불러오면 등록된다. 도구 설명이나 타입을 바꾸면 scripts/gen_tool_catalog.py와 scripts/gen_sdk_stubs.py로 생성 문서를 다시 만든다. 정책 파일을 고치면 scripts/policy_stamp.py로 해시를 갱신한다.

라이선스

MIT. LICENSE 참조.

Available Tools

286 tools
accounting.balanceA
Read-onlyIdempotent

분개 목록의 차변 합계와 대변 합계가 같은지 검증한다. entries 는 {account, debit, credit} 항목의 목록이며 금액은 Decimal 문자열, 비어 있으면 0 으로 본다. 반환값은 balanced 여부, 두 합계, 차이의 절댓값(diff). account 는 합계에 쓰이지 않으므로 계정별 잔액 검증에는 쓸 수 없다.

Inputs: entries (required). Returns: diff, _meta, trace, balanced, +2 more

accounting.break_evenA
Read-onlyIdempotent

손익분기 판매량 = fixed_costs / (unit_price - unit_variable_cost). 금액은 유한한 Decimal 문자열이며 고정비와 단위 변동비는 0 이상, 판매 단가는 단위 변동비보다 커야 한다. 50자리 Decimal 정밀도로 계산하고 decimals(기본 4)자리 HALF_EVEN 반올림한다. 결과는 소수 판매량이며 정수 판매 개수로 올림하지 않는다.

Inputs: unit_price (required), fixed_costs (required), unit_variable_cost (required), decimals. Returns: _meta, trace, break_even_units

accounting.cashflow_operatingA
Read-onlyIdempotent

간접법 영업활동현금흐름(CFO)을 계산한다. 당기순이익에 감가상각비, 무형자산상각비, 기타 비현금 항목을 더하고 매출채권 증가와 재고자산 증가는 빼며 매입채무 증가는 더한다. 금액은 Decimal 문자열이며 반올림하지 않는다. 증가는 양수로 넣어야 하며 증가분을 음수로 넣으면 부호가 뒤집힌다.

Inputs: net_income (required), amortization, depreciation, other_noncash, +4 more. Returns: cfo, _meta, trace, breakdown

accounting.depreciation_declining_balanceA
Read-onlyIdempotent

정률법 감가상각 스케줄을 계산한다. 연도별 감가비 = 기초 장부가 x 감가율(rate, 0 초과 1 미만 Decimal 문자열)이며 장부가는 잔존가치 아래로 내려가지 않고 도달하면 이후 연도 감가비는 0 이다. decimals(기본 0)자리로 rounding(기본 HALF_EVEN) 처리한다. 감가율은 입력값 그대로 쓰며 내용연수로 역산하지 않는다.

Inputs: cost (required), rate (required), salvage (required), life_years (required), +2 more. Returns: _meta, trace, schedule

accounting.depreciation_straight_lineA
Read-onlyIdempotent

정액법 감가상각 스케줄을 계산한다. 연 감가비 = (취득원가 - 잔존가치) / 내용연수(life_years, 1 이상 정수), 취득원가와 잔존가치는 유한한 0 이상 Decimal 문자열이며 취득원가는 잔존가치 이상이어야 한다. decimals(기본 0)자리로 rounding(기본 HALF_EVEN) 처리하되 감가비는 남은 상각액을 넘지 않는다. 마지막 해는 소수 자릿수와 관계없이 잔액을 정확히 상각한다. 월할이나 기중 취득 안분은 지원하지 않는다.

Inputs: cost (required), salvage (required), life_years (required), decimals, +1 more. Returns: _meta, trace, schedule, annual_expense

accounting.depreciation_units_of_productionA
Read-onlyIdempotent

생산량비례법 감가상각 스케줄을 계산한다. 기간 감가비 = (취득원가 - 잔존가치) / 총생산량 x 기간 생산량. total_units 는 1 이상 정수, period_units 는 기간별 생산량 정수 목록이며 금액은 Decimal 문자열. decimals(기본 0)자리로 rounding(기본 HALF_EVEN) 처리한다. 누적 생산량이 총생산량을 넘어도 오류 없이 장부가가 잔존가치에서 멈춘다.

Inputs: cost (required), salvage (required), total_units (required), period_units (required), +2 more. Returns: _meta, trace, schedule

accounting.dupont_3A
Read-onlyIdempotent

DuPont 3단계 분해로 ROE = 순이익률 x 총자산회전율 x 자기자본승수(재무레버리지)를 계산한다. 금액은 Decimal 문자열이며 매출, 총자산, 자기자본은 0 이 아니어야 한다. 각 값은 decimals(기본 6)자리 HALF_EVEN 반올림이고 음수 자기자본은 막지 않으므로 부호를 확인해야 한다.

Inputs: revenue (required), net_income (required), total_assets (required), total_equity (required), +1 more. Returns: roe, _meta, trace, net_margin, +2 more

accounting.dupont_5A
Read-onlyIdempotent

DuPont 5단계 분해로 ROE = 세부담비율(순이익/세전이익) x 이자부담비율(세전이익/EBIT) x 영업이익률 x 총자산회전율 x 재무레버리지를 계산한다. 금액은 Decimal 문자열이며 세전이익, EBIT, 매출, 총자산, 자기자본은 0 이 아니어야 한다. 각 값은 decimals(기본 6)자리 HALF_EVEN 반올림이다.

Inputs: ebit (required), revenue (required), net_income (required), total_assets (required), +3 more. Returns: roe, _meta, trace, tax_burden, +4 more

accounting.income_statementA
Read-onlyIdempotent

다단계 손익계산서: 매출에서 매출총이익, 영업이익, 세전이익, 당기순이익까지 단계별 이익과 이익률을 계산한다. 금액은 유한한 Decimal 문자열이며 매출과 매출원가는 0 이상이어야 한다. 50자리 Decimal 정밀도로 계산하며 이익에 별도 반올림을 적용하지 않는다. 이익률은 소수 6자리 HALF_EVEN(0.25 = 25%)이며 매출이 0 이면 0 이다. 계산 범위 초과는 입력 오류다. 비용 항목은 양수로 입력한다.

Inputs: revenue (required), cost_of_sales (required), tax_expense, other_income, +3 more. Returns: _meta, trace, net_income, net_margin, +6 more

accounting.ratiosA
Read-onlyIdempotent

재무상태표와 손익 항목으로 유동비율, 당좌비율, 부채/자기자본, 부채/총자산, 자기자본비율, ROE, ROA, 순이익률 8개를 한 번에 계산한다. 금액은 유한한 Decimal 문자열이며 호출자 설정과 독립적인 50자리 정밀도로 계산한다. 비율은 배수(0.5 = 50%)로 decimals(기본 4)자리 HALF_EVEN 반올림한다. decimals는 0 이상 정수이고 계산 범위 초과는 입력 오류다. 분모(유동부채, 자기자본, 총자산, 매출)가 0 이면 오류이며 백분율로 쓰려면 직접 100 을 곱한다.

Inputs: revenue (required), inventory (required), net_income (required), total_assets (required), +5 more. Returns: roa, roe, _meta, trace, +6 more

accounting.vat_addA
Read-onlyIdempotent

공급가액에 부가세를 더해 공급대가를 계산한다. 부가세 = 공급가액 x rate(기본 0.1)를 정수 자리로 rounding 처리하며 기본은 HALF_EVEN 으로 vat_extract 의 기본(DOWN)과 다르다. 금액은 Decimal 문자열. 공급대가에서 공급가액을 구하려면 vat_extract 를 쓴다.

Inputs: net (required), rate, rounding. Returns: vat, _meta, gross, trace

accounting.vat_extractA
Read-onlyIdempotent

공급대가(부가세 포함 금액)에서 공급가액과 부가세를 역산한다. 공급가액 = gross / (1 + rate)를 정수 자리로 rounding(기본 DOWN, 절사) 처리하고 부가세 = gross - 공급가액. rate 기본 0.1, 금액은 Decimal 문자열. 공급가액에서 공급대가를 구하는 순방향 계산에는 vat_add 를 쓴다.

Inputs: gross (required), rate, rounding. Returns: net, vat, _meta, trace

core.addA
Read-onlyIdempotent

Decimal 정밀 덧셈. operands(쉼표, 단위, 공백 없는 숫자 문자열 목록)의 합을 result 문자열로 반환한다. 유효숫자 50자리 안에서 계산하고 별도 반올림은 없다. trace_level 은 summary(기본), full, none. 합계를 직접 암산하지 말고 이 도구로 구한다.

Inputs: operands (required), trace_level. Returns: core.add, sub, mul, div 의 결과. trace_level=none 이거나 응답 크기 한도로 잘리면 trace 가 없다.

core.batchA
Read-onlyIdempotent

서로 독립인 도구 호출 N개를 병렬 실행한다. items 는 id, tool, args 를 가진 객체 목록(최대 500개, id 중복 불가)이고 읽기 전용 도구만 실행된다. 결과는 입력 id 순서이며 항목별 status(ok, error, timeout)와 item_timeout_s, batch_timeout_s 가 적용된다. item_timeout_s 는 항목의 실행 시간을, batch_timeout_s 는 배치 전체 시간을 구속한다(워커 대기 시간은 item_timeout_s 에 포함되지 않는다). 앞 결과를 뒤 입력에 쓰려면 core.pipeline 을 쓴다.

Inputs: items (required), max_workers, deterministic, item_timeout_s, +1 more. Returns: _meta, status, results, count_ok, +5 more

core.calcA
Read-onlyIdempotent

AST 기반 안전 수식 평가기. expression 은 사칙, %, //, **, 괄호, 함수(sqrt, abs, floor, ceil, round, log, ln, exp, 삼각함수 등), 상수(pi, e, tau)를 쓸 수 있고 variables 는 Decimal 문자열 전용이다. 결과는 precision(기본 50)자리 십진 문자열이다. 비교, 조건식, 속성 접근은 거부한다. 세금, 금융 공식은 전용 도구를 쓴다.

Inputs: expression (required), precision, variables, trace_level. Returns: core.calc 결과. trace_level=none 이거나 응답 크기 한도로 잘리면 trace 가 없다.

core.compareA
Read-onlyIdempotent

시나리오 비교: 읽기 전용 도구 tool 을 base_arguments 로 실행한 기준안과, 각 시나리오의 arguments 로 덮어쓴 실행을 비교한다. fields 는 결과에서 비교할 필드 경로 목록(예: tax, breakdown.0.rate). 숫자 필드는 기준안 대비 차이(delta_vs_baseline)를, 숫자가 아닌 필드는 null 을 반환한다. 시나리오는 이름이 겹치지 않게 최대 50개까지 받는다.

Inputs: tool (required), fields (required), scenarios (required), base_arguments (required). Returns: tool, _meta, trace, baseline, +1 more

core.divA
Read-onlyIdempotent

Decimal 정밀 나눗셈 a / b. a 와 b 는 쉼표, 단위, 공백 없는 숫자 문자열이며 b 가 0 이면 오류를 반환한다. 몫은 유효숫자 50자리로 계산되어 나누어떨어지지 않으면 50자리에서 끊긴다. 정수 몫이나 원 단위 절사가 필요하면 결과를 별도로 반올림한다.

Inputs: a (required), b (required), trace_level. Returns: core.add, sub, mul, div 의 결과. trace_level=none 이거나 응답 크기 한도로 잘리면 trace 가 없다.

core.explainA
Read-onlyIdempotent

설명 모드: 읽기 전용 도구 tool 을 arguments 로 실행하고, 수식, 입력, 계산 단계, 결과, 적용 정책(상태, 시행 기간)과 근거 조문을 평문(lang: ko 또는 en)으로 풀어 반환한다. 수치는 도구 결과 그대로이며 설명은 trace 를 서술할 뿐이다. 긴 값은 300자에서 줄여 보이고 원본은 result 에 있다.

Inputs: tool (required), arguments (required), lang. Returns: lang, _meta, lines, trace, +3 more

core.mulA
Read-onlyIdempotent

Decimal 정밀 곱셈. operands(쉼표, 단위, 공백 없는 숫자 문자열 목록)의 곱을 result 문자열로 반환한다. 유효숫자 50자리를 넘는 곱은 그 자릿수로 반올림되며 그 밖의 반올림은 없다. 세금이나 이자 계산에는 전용 도구를 쓴다.

Inputs: operands (required), trace_level. Returns: core.add, sub, mul, div 의 결과. trace_level=none 이거나 응답 크기 한도로 잘리면 trace 가 없다.

core.pipelineA
Read-onlyIdempotent

의존 관계(DAG)를 가진 도구 호출을 순서대로 실행하고 앞 단계 결과를 뒤 단계 입력으로 전달한다. steps 는 id, tool, args 목록(최대 50단계, 깊이 10)이며 args 에서 ${단계id.result.필드} 로 앞 결과를 참조한다. 실패한 단계의 하류는 skipped 가 되고 pipeline_id 로 재개할 수 있다. 서로 독립인 호출은 core.batch 를 쓴다.

Inputs: steps (required), step_timeout_s, pipeline_timeout_s. Returns: _meta, order, steps, status, +2 more

core.pipeline_resumeA
Read-onlyIdempotent

이전 core.pipeline 실행을 pipeline_id 로 지정하고 from_step 단계부터 다시 실행한다. from_step 앞쪽의 성공 단계는 결과를 재사용(reused)한다. 실행 기록은 약 10분 동안만 보관되어 만료되면 오류가 난다. 입력을 바꿔 다시 계산하려면 새로 core.pipeline 을 호출한다.

Inputs: from_step (required), pipeline_id (required). Returns: _meta, order, steps, status, +2 more

core.solve_forA
Read-onlyIdempotent

역산: 읽기 전용 도구 tool 의 결과 필드 target_field 가 target 이 되도록 숫자 문자열 입력 variable 을 [lower, upper] 에서 이분법(Decimal)으로 찾는다. 예: 세후 월급에서 세전 월급 구하기. 구간 양 끝의 함수값 부호가 달라야 하며 단계별 함수는 가장 가까운 해와 residual 을 반환한다. 잔차가 tolerance(기본 0.5) 이내면 converged 가 true 이고 max_iter(기본 100)는 최대 200이다.

Inputs: tool (required), lower (required), upper (required), target (required), +6 more. Returns: _meta, trace, bracket, achieved, +6 more

core.subA
Read-onlyIdempotent

Decimal 정밀 뺄셈 a - b. a 와 b 는 쉼표, 단위, 공백 없는 숫자 문자열이며 결과는 result 문자열이다. 유효숫자 50자리 안에서 계산하고 별도 반올림은 없다. 순서에 주의한다(a 에서 b 를 뺀다).

Inputs: a (required), b (required), trace_level. Returns: core.add, sub, mul, div 의 결과. trace_level=none 이거나 응답 크기 한도로 잘리면 trace 가 없다.

crypto.carmichael_lambdaA
Read-onlyIdempotent

카마이클 함수 λ(n) = lcm(λ(p^k)) 를 구한다. n 은 1 이상 10^14 이하의 정수 문자열이며 시행 나눗셈으로 소인수분해하므로 한도를 넘으면 오류다. 결과 키는 lambda(정수 문자열)와 factorization 이다. λ(n) 은 φ(n) 의 약수이므로 둘을 혼동해 쓰지 않는다.

Inputs: n (required). Returns: _meta, trace, lambda, factorization

crypto.crtA
Read-onlyIdempotent

중국인의 나머지 정리로 연립합동식 x ≡ r_i (mod m_i) 의 해 x 를 구한다. residues, moduli 는 길이가 같은 정수 문자열 리스트이고 moduli 는 모두 양수이며 쌍별 서로소여야 한다. x 는 0 이상 modulus(법의 곱) 미만이다. 서로소가 아닌 법은 해가 있어도 거부한다.

Inputs: moduli (required), residues (required). Returns: x, _meta, trace, modulus

crypto.egcdA
Read-onlyIdempotent

확장 유클리드 알고리즘으로 gcd(a, b) = ax + by 를 만족하는 gcd 와 Bezout 계수 x, y 를 구한다. a, b 는 정수 문자열(자릿수 한도 2048)이고 gcd 는 0 이상이다. 계수 쌍은 유일하지 않으며 이 알고리즘이 내는 한 쌍이다. 모듈러 역원이 목적이면 modinv 가 직접적이다.

Inputs: a (required), b (required). Returns: x, y, gcd, _meta, +1 more

crypto.euler_totientA
Read-onlyIdempotent

오일러 토션트 φ(n) = n * Π(1 - 1/p) 를 구한다. n 은 1 이상 10^14 이하의 정수 문자열이며 시행 나눗셈으로 소인수분해하므로 한도를 넘으면 오류다. phi 는 정수 문자열, factorization 은 소수 문자열을 지수에 대응시킨 맵이다. RSA 크기의 수에는 쓸 수 없다.

Inputs: n (required). Returns: phi, _meta, trace, factorization

crypto.gcdA
Read-onlyIdempotent

두 정수의 최대공약수(GCD)를 구한다. a, b 는 정수 문자열(부호는 무시, 자릿수 한도 2048)이고 결과 result 는 정수 문자열이다. 둘 다 0 이면 0. 소수점이나 쉼표가 든 값은 거부하며, 세 수 이상은 결과를 다시 넣어 이어서 호출한다.

Inputs: a (required), b (required). Returns: _meta, trace, result

crypto.hashA
Read-onlyIdempotent

문자열을 UTF-8 로 인코딩해 해시를 소문자 16진수 hex 로 반환한다. algorithm 은 sha256(기본) | sha512 | blake2b(64바이트 출력)이며 대소문자를 구분하지 않는다. 무결성 지문 확인용이고, 솔트와 반복이 없어 비밀번호 저장에는 쓰지 않는다.

Inputs: data (required), algorithm. Returns: hex, _meta, trace

crypto.is_primeA
Read-onlyIdempotent

Miller-Rabin 으로 소수 여부 is_prime(bool)을 판정한다. n 은 정수 문자열(자릿수 한도 2048)이며 2 미만과 음수는 False. 약 3.8e18 미만은 고정 증인이라 결정적이고, 그 이상은 무작위 증인 k 회(기본 20, 1~256)라 확률적이어서 True 가 소수 증명은 아니다. 소인수분해는 하지 않는다.

Inputs: n (required), k. Returns: _meta, trace, is_prime

crypto.lcmA
Read-onlyIdempotent

두 정수의 최소공배수(LCM)를 구한다. a, b 는 정수 문자열(부호는 무시, 자릿수 한도 2048)이고 큰 정수도 정확히 계산해 result 를 정수 문자열로 돌려준다. 둘 중 하나가 0 이면 0 이다. 분수의 통분에는 분모들의 LCM 을 쓰되, 소수 입력은 받지 않는다.

Inputs: a (required), b (required). Returns: _meta, trace, result

crypto.modinvA
Read-onlyIdempotent

모듈러 역원 a^-1 mod m 을 구한다. a, m 은 정수 문자열(자릿수 한도 2048)이고 m 은 2 이상이어야 한다. result 는 0 이상 m 미만이며, gcd(a, m) 이 1 이 아니면 역원이 없어 오류가 난다. a 가 0 이거나 m 과 약수를 공유하면 역원이 없다.

Inputs: a (required), m (required). Returns: _meta, trace, result

crypto.modpowA
Read-onlyIdempotent

모듈러 거듭제곱 base^exponent mod modulus 를 구한다. 세 인자는 정수 문자열(자릿수 한도 2048)이며 modulus 는 1 이상, exponent 는 0 이상이어야 한다. result 는 0 이상 modulus 미만의 정수 문자열이다. 음수 지수로 역원을 구하려면 modinv 를 쓴다.

Inputs: base (required), modulus (required), exponent (required). Returns: _meta, trace, result

datetime.add_business_daysA
Read-onlyIdempotent

start_date 에 영업일 기준으로 days 를 더한(음수면 뺀) 날짜 end_date 를 YYYY-MM-DD 로 반환한다. 토·일, holidays 패키지의 country(기본 KR) 공휴일, extra_holidays 를 건너뛰고 시작일은 세지 않는다. days 는 절대값 100000 이하이며, 0 이면 시작일이 휴일이어도 그대로 반환한다.

Inputs: days (required), start_date (required), country, extra_holidays. Returns: _meta, trace, end_date

datetime.ageA
Read-onlyIdempotent

만 나이(한국 법정 연령)를 years, months, days 정수로 계산한다. 날짜는 YYYY-MM-DD 이고 생일 당일에 한 살이 오른다. reference_date 를 생략하면 서버의 오늘 날짜를 쓰므로 실행일마다 결과가 달라진다. 기준일이 생일보다 앞서면 오류이며 세는나이는 계산하지 않는다.

Inputs: birth_date (required), reference_date. Returns: days, _meta, trace, years, +1 more

datetime.count_business_daysA
Read-onlyIdempotent

start 와 end 사이의 영업일 수 count 를 정수로 센다. 날짜는 YYYY-MM-DD 이고 양 끝 날짜를 포함하며 토·일과 holidays 패키지의 country(기본 KR) 공휴일은 제외한다. end 가 start 보다 앞서거나 구간이 100000일을 넘으면 오류이고, 임시 휴일을 더하는 입력은 없다.

Inputs: end (required), start (required), country. Returns: _meta, count, trace

datetime.day_countA
Read-onlyIdempotent

이자 계산용 일수 days(정수)와 연 환산 비율 year_fraction(Decimal 문자열)을 구한다. convention 은 30/360(말일 31일 보정만 적용, 2월 말일 규칙 없음) | ACT/365 | ACT/ACT(연 경계별 윤년 분모) | ACT/360 이며 날짜는 YYYY-MM-DD, end 는 start 이후여야 한다. 비율은 반올림 없이 유효 50자리까지 나온다.

Inputs: end (required), start (required), convention (required). Returns: days, _meta, trace, year_fraction

datetime.diffA
Read-onlyIdempotent

두 날짜의 차이를 unit(days | weeks | months | years) 단위의 정수 문자열 value 로 돌려준다. 날짜는 YYYY-MM-DD 이다. weeks 는 일수를 7 로 나눈 몫(내림), months 와 years 는 가득 찬 달과 해만 세며 end 가 start 보다 앞서면 음수이다. 소수 단위나 남는 일수는 주지 않는다.

Inputs: end (required), unit (required), start (required). Returns: _meta, trace, value

datetime.fiscal_quarterA
Read-onlyIdempotent

기준일 as_of(YYYY-MM-DD)가 속한 회계분기 번호 quarter(1~4)와 시작·종료일을 구한다. country(KR | US | JP | UK, 기본 KR)의 회계연도 시작일에서 3개월씩 끊으며 시작일의 일자를 유지한다(UK 는 분기마다 6일 시작). 부가세 신고 등 법정 신고기한은 계산하지 않는다.

Inputs: as_of (required), country. Returns: _meta, trace, country, quarter, +3 more

datetime.fiscal_yearA
Read-onlyIdempotent

기준일 as_of(YYYY-MM-DD)가 속한 회계연도의 라벨 fiscal_year 와 시작·종료일을 구한다. country 는 KR | US(1/112/31), JP(4/1다음 해 3/31), UK(4/6~다음 해 4/5)이며 라벨은 시작일이 속한 해이다. 기업별 결산기는 반영하지 않으므로 고정 국가 기준 연도 판정에만 쓴다.

Inputs: as_of (required), country. Returns: _meta, trace, country, end_date, +2 more

datetime.lunar_holidayA
Read-onlyIdempotent

음력 명절을 양력 solar_date 로 환산한다. name 은 seollal(설날), jeongwol_daeboreum(정월대보름), buddhas_birthday(부처님오신날), dano(단오), chilseok(칠석), chuseok(추석), seotdal_geumum(섣달그믐)이고 year 는 음력년(20202030)이라 섣달그믐은 이듬해 양력 12월에 나온다. 윤달은 쓰지 않으며 연휴와 대체공휴일은 계산하지 않는다.

Inputs: name (required), year (required). Returns: name, year, _meta, trace, +3 more

datetime.lunar_to_solarA
Read-onlyIdempotent

음력 날짜를 양력 solar_date(YYYY-MM-DD)로 바꾼다. lunar_year 는 20202030, lunar_month 는 112, lunar_day 는 1~30 정수이고 윤달이면 is_leap=True 를 준다. 그 해에 없는 윤달이나 달 길이를 넘는 일자는 오류이며 범위 밖 연도는 지원하지 않는다.

Inputs: lunar_day (required), lunar_year (required), lunar_month (required), is_leap. Returns: _meta, trace, solar_date

datetime.payroll_periodA
Read-onlyIdempotent

as_of(YYYY-MM-DD)가 속한 월 단위 급여 정산 기간의 period_start, period_end 를 구한다. start_day(128, 기본 1)일에 시작해 다음 달 start_day 전날에 끝난다. 지급일이 아닌 산정 기간이며 2931일 시작은 지원하지 않는다.

Inputs: as_of (required), start_day. Returns: _meta, trace, period_end, period_start

datetime.solar_termsA
Read-onlyIdempotent

양력 year 의 24절기 이름과 양력 날짜 24개를 입춘부터의 순서로 반환한다. 연도별 계산이 아닌 고정 일자표이므로 모든 연도에 같은 월일이 나오고 실제 절기일과 하루 어긋날 수 있다. 소한·대한은 같은 해 1월 날짜이며 절기 시각이 필요한 용도에는 쓰지 않는다.

Inputs: year (required). Returns: year, _meta, terms, trace

datetime.solar_to_lunarA
Read-onlyIdempotent

양력 날짜를 음력 년·월·일(lunar_year, lunar_month, lunar_day)과 윤달 여부 is_leap 으로 바꾼다. 입력은 YYYY-MM-DD 이고 내장 조견표의 음력 20202030년에 해당하는 2020-01-252031-01-22 만 지원하며 범위 밖은 오류이다. 그 밖의 연도 음력 계산에는 쓸 수 없다.

Inputs: solar_date (required). Returns: _meta, trace, is_leap, lunar_day, +2 more

datetime.tax_period_krA
Read-onlyIdempotent

as_of(YYYY-MM-DD)가 속한 한국 소득세 과세기간(소득세법 제5조, 1/1~12/31)의 연도 tax_year 와 경계일을 반환한다. 사업 개시·폐업, 사망, 출국으로 달라지는 중도 종료 기간은 다루지 않으며 법인의 사업연도에는 쓰지 않는다.

Inputs: as_of (required). Returns: _meta, trace, country, end_date, +2 more

datetime.tz_convertA
Read-onlyIdempotent

IANA 타임존 사이에서 시각을 변환해 UTC 오프셋이 붙은 ISO 8601 문자열 iso_datetime 으로 돌려준다. 입력은 초 단위(YYYY-MM-DDTHH:MM:SS, 공백 구분 허용, 소수 초 불가)이며 오프셋이 없으면 from_tz 로 해석하고 있으면 from_tz 를 쓰지 않는다. 서머타임 겹침 시각은 앞선 쪽으로 해석한다.

Inputs: to_tz (required), from_tz (required), iso_datetime (required). Returns: _meta, trace, iso_datetime

engineering.ac_impedanceA
Read-onlyIdempotent

R, L, C 조합의 AC 합성 임피던스 크기와 위상각을 구한다. frequency(Hz, 0 초과), resistance(Ω), inductance(H), capacitance(F)는 0 이상 Decimal 문자열이고 topology='series' 또는 'parallel'. 반환: magnitude(Ω), phase_deg(도), real, imag. 값 0은 그 소자가 없다는 뜻이며 단락이나 0 용량이 아니다. 병렬에서 소자를 모두 생략하면 오류.

Inputs: frequency (required), topology, inductance, resistance, +1 more. Returns: 합성 임피던스. 값은 Decimal 문자열이며 위상은 도 단위.

engineering.beam_deflectionA
Read-onlyIdempotent

표준 하중 조건의 보 최대 처짐 δ_max 를 계산한다. case: cantilever_point_end(PL³/3EI), cantilever_uniform(wL⁴/8EI), simply_supported_point_center(PL³/48EI), simply_supported_uniform(5wL⁴/384EI). length m, young Pa, inertia m⁴, load 는 점하중 N 또는 등분포하중 N/m(모두 0 초과)이며 처짐은 m. 하중 종류와 case 가 어긋나면 값이 틀리고 전단 변형은 무시한다. 반올림 없이 50자리 유효숫자.

Inputs: case (required), load (required), young (required), length (required), +1 more. Returns: _meta, trace, deflection

engineering.bearing_equivalent_loadA
Read-onlyIdempotent

베어링 동등가하중 P = X·Fr + Y·Fa 를 계산한다. 반경하중, 축하중, 계수 X 와 Y 는 모두 0 이상이고 두 하중이 동시에 0 이면 오류다. X, Y 는 카탈로그 값을 직접 넣어야 하며 Fa/Fr 과 e 의 비교로 계수를 고르는 과정은 하지 않는다. 순수 반경하중이면 axial_load 와 y_factor 를 0 으로 둔다. 결과는 bearing_life_l10 의 equivalent_load 로 쓴다.

Inputs: x_factor (required), y_factor (required), axial_load (required), radial_load (required). Returns: _meta, trace, equivalent_load

engineering.bearing_life_l10A
Read-onlyIdempotent

구름 베어링 기본정격수명 L10 = (C/P)^p 를 백만 회전(10⁶ rev) 단위로 계산한다. bearing_type 'ball' 은 p=3(정확 계산), 'roller' 는 p=10/3(30자리 유효숫자). dynamic_capacity 와 equivalent_load 는 같은 힘 단위이고 0 초과여야 한다. 신뢰도나 윤활 보정계수는 적용하지 않으며 등가하중은 bearing_equivalent_load 로 먼저 구한다.

Inputs: bearing_type (required), equivalent_load (required), dynamic_capacity (required). Returns: _meta, trace, exponent, l10_million_revolutions

engineering.bending_stressA
Read-onlyIdempotent

휨응력 σ = M·c/I 를 계산한다. moment 는 굽힘모멘트(N·m, 부호 유지), distance_neutral 은 중립축에서 응력을 구할 섬유까지 거리 c(m, 0 초과), inertia 는 단면 이차모멘트 I(m⁴, 0 초과)이며 결과는 Pa. 최외곽 응력이 필요하면 c 에 전체 높이가 아니라 중립축에서 바깥 면까지의 거리를 넣어야 한다. 반올림 없이 50자리 유효숫자.

Inputs: moment (required), inertia (required), distance_neutral (required). Returns: _meta, trace, stress

engineering.bernoulliA
Read-onlyIdempotent

베르누이 방정식 P + ½ρv² + ρgz = 일정 을 풀어 상태 2의 미지수 하나를 구한다. pressure_2, velocity_2, elevation_2 중 정확히 하나만 생략(None)하며 압력 Pa, 속도 m/s, 높이 m, 밀도 kg/m³, 중력가속도 기본 9.80665 m/s². 비압축성 비점성 정상류 가정이라 펌프나 마찰 손실이 있는 관로에는 쓰지 않는다. 속도 해는 30자리, 나머지는 반올림 없음.

Inputs: density (required), pressure_1 (required), velocity_1 (required), elevation_1 (required), +4 more. Returns: _meta, trace, pressure_2, velocity_2, +1 more

engineering.bode_magnitude_phaseA
Read-onlyIdempotent

단일 극점 또는 영점 1차 전달함수의 Bode 크기(dB)와 위상(도)을 구한다. mode='pole'이면 G(jω)=1/(1+jω/ωc), 'zero'이면 G(jω)=1+jω/ωc. corner_freq ωc와 frequency ω는 같은 단위(rad/s 또는 Hz)의 0 초과 Decimal 문자열이며 비율만 쓴다. 유효숫자 30자리. 오용 주의: 극점과 영점이 여러 개인 전달함수는 직접 합산해야 한다.

Inputs: mode (required), frequency (required), corner_freq (required). Returns: Bode 크기(dB)와 위상(도). 값은 Decimal 문자열.

engineering.capacitor_combineA
Read-onlyIdempotent

커패시터 여러 개의 합성 정전용량을 구한다. topology='series'면 1/C=Σ(1/Cᵢ), 'parallel'이면 C=ΣCᵢ. capacitors 는 0 초과 정전용량(F)의 Decimal 문자열 목록이며 최소 1개, total 은 입력과 같은 단위. 계산은 유효숫자 50자리 Decimal. 오용 주의: 저항과 인덕터는 직렬 병렬 공식이 반대다.

Inputs: topology (required), capacitors (required). Returns: 합성 결과. total 은 Decimal 문자열.

engineering.convective_heat_transferA
Read-onlyIdempotent

뉴턴 냉각 법칙에 따른 대류 열전달 Q = h·A·(T_s − T_∞) (W)를 계산한다. heat_transfer_coefficient W/(m²·K), area m², 온도는 K 또는 °C(차이만 사용). 표면이 유체보다 뜨거우면 양수, 차가우면 음수이다. h 는 입력값이며 유동 조건에서 구해 주지 않는다. 반올림 없이 50자리 유효숫자.

Inputs: area (required), temperature_fluid (required), temperature_surface (required), heat_transfer_coefficient (required). Returns: _meta, trace, heat_rate_w

engineering.darcy_weisbachA
Read-onlyIdempotent

다르시-바이스바흐 식으로 관 마찰 손실 수두 h_f = f·(L/D)·v²/(2g) (m)와 압력강하 ρ·g·h_f (Pa)를 계산한다. friction_factor 무차원, length 와 diameter m, velocity m/s, density 기본 1000 kg/m³, gravity 기본 9.80665. 마찰계수를 모르면 moody_friction_factor 로 먼저 구하며 밸브나 곡관의 국부 손실은 포함하지 않는다. 반올림 없이 50자리 유효숫자.

Inputs: length (required), diameter (required), velocity (required), friction_factor (required), +2 more. Returns: _meta, trace, head_loss_m, pressure_drop_pa

engineering.db_convertA
Read-onlyIdempotent

dB, Np, dBm과 선형 값을 서로 변환한다. mode: v_to_db(20·log10(value/reference)), p_to_db(10·log10(value/reference)), db_to_v, db_to_p, np_to_db, db_to_np, w_to_dbm(1 mW 기준), dbm_to_w. value 는 Decimal 문자열, reference(기본 1)는 v_to_db와 p_to_db에서만 쓴다. 로그 입력은 0 초과여야 하며 유효숫자 30자리. 오용 주의: 전압비에 p_to_db를 쓰면 값이 절반이 된다.

Inputs: mode (required), value (required), reference. Returns: 변환 결과. result 는 Decimal 문자열.

engineering.elastic_modulus_relateA
Read-onlyIdempotent

등방성 선형 탄성체에서 영률 E, 전단탄성계수 G, 푸아송비 ν, 체적탄성계수 K 중 정확히 2개를 받아 나머지 2개를 계산한다(E = 2G(1+ν) = 3K(1−2ν)). 탄성계수는 같은 응력 단위로 0 초과, 푸아송비는 -1 초과 0.5 미만이며 입력이 2개가 아니면 오류. 이방성 재료에는 쓸 수 없다. 반올림 없이 50자리 유효숫자.

Inputs: bulk, shear, young, poisson. Returns: bulk, _meta, shear, trace, +2 more

engineering.electrical_ohmA
Read-onlyIdempotent

옴의 법칙 V=IR에서 빠진 한 값을 구한다. voltage(V), current(A), resistance(Ω) 중 정확히 2개를 Decimal 문자열로 넣으면 나머지를 계산해 세 값을 모두 돌려준다. current와 resistance는 0 초과, voltage는 입력일 때 0 이상이어야 한다. 오용 주의: 3개 이상이나 1개만 넣으면 오류이고, 교류 임피던스에는 쓸 수 없다(ac_impedance 사용).

Inputs: current, voltage, resistance. Returns: 옴의 법칙 결과. 값은 Decimal 문자열.

engineering.electrical_powerA
Read-onlyIdempotent

직류 전력 방정식 P=VI=I²R=V²/R에서 나머지 값을 구한다. power(W), voltage(V), current(A), resistance(Ω) 중 정확히 2개를 Decimal 문자열로 넣으면 네 값을 모두 돌려준다. (P,R) 조합은 제곱근을 쓰며 양의 근만 반환한다. 오용 주의: 교류의 유효전력은 역률을 곱해야 하므로 three_phase_power 등을 쓴다.

Inputs: power, current, voltage, resistance. Returns: 전력 방정식 결과. 값은 Decimal 문자열.

engineering.euler_bucklingA
Read-onlyIdempotent

오일러 좌굴 임계하중 P_cr = π²EI/(KL)² (N)를 계산한다. end_condition 으로 K 를 자동 설정(fixed_free 2, pinned_pinned 1, fixed_pinned 0.699, fixed_fixed 0.5)하거나 effective_length_factor 를 직접 주되 둘 중 정확히 하나만 지정한다. young Pa, inertia m⁴, length m. 세장한 기둥의 탄성 좌굴 식이라 짧은 기둥에는 항복 하중보다 크게 나올 수 있다. π 는 30자리.

Inputs: young (required), length (required), inertia (required), end_condition, +1 more. Returns: _meta, trace, critical_load

engineering.exponential_reliabilityA
Read-onlyIdempotent

지수분포 고장 모델의 신뢰도 R(t) = exp(−λt), 불신뢰도 1−R, 평균 고장간격 MTBF = 1/λ 를 계산한다. failure_rate λ 는 단위시간당 고장률(0 초과), time 은 같은 시간 단위의 t(0 이상)이며 시간 단위가 다르면 틀린다. 고장률이 일정한 우발 고장 구간 가정이라 마모 고장에는 weibull_reliability 를 쓴다. exp 는 30자리 유효숫자.

Inputs: time (required), failure_rate (required). Returns: mtbf, _meta, trace, reliability, +1 more

engineering.first_order_responseA
Read-onlyIdempotent

1차 시스템 G(s)=K/(τs+1)의 스텝 응답 y(t)=K·u·(1−exp(−t/τ))를 구한다. gain K, time_constant τ(초, 0 초과), input_step u, time t(초, 0 이상)는 Decimal 문자열. 지수항은 유효숫자 30자리. 반환: response, steady_state(K·u), time_constant. 오용 주의: 2차 이상 시스템이나 임펄스 응답에는 쓸 수 없다.

Inputs: gain (required), time (required), input_step (required), time_constant (required). Returns: 1차 시스템 스텝 응답. 값은 모두 Decimal 문자열.

engineering.fluid_reynoldsA
Read-onlyIdempotent

레이놀즈 수 Re = ρvL/μ 를 계산하고 층류(Re < 2300), 천이(2300 이상 4000 이하), 난류(4000 초과)로 분류한다. 밀도 kg/m³, 속도 m/s, 특성길이 m, 점성계수 Pa·s 를 숫자 문자열로 받고 모두 0 초과여야 한다. 경계값은 관 유동 기준이라 평판 등 다른 형상에는 맞지 않는다. 반올림 없이 50자리 유효숫자로 계산한다.

Inputs: length (required), density (required), velocity (required), viscosity (required). Returns: _meta, trace, regime, reynolds

engineering.fourier_heat_conductionA
Read-onlyIdempotent

1차원 정상상태 평판 열전도 Q = k·A·(T_hot − T_cold)/L (W)를 계산한다. thermal_conductivity W/(m·K), area m², thickness m, 온도는 K 또는 °C(차이만 사용). temperature_hot 이 temperature_cold 보다 낮으면 오류이며 역방향은 인자를 바꿔 호출한다. 다층벽은 층별 L/(kA)를 구해 thermal_resistance 로 합성한다. 반올림 없이 50자리 유효숫자.

Inputs: area (required), thickness (required), temperature_hot (required), temperature_cold (required), +1 more. Returns: _meta, trace, heat_rate_w

engineering.gear_ratioA
Read-onlyIdempotent

단순 기어쌍의 기어비 i = 피동 잇수 / 구동 잇수 를 계산하고 방향을 함께 반환한다. i > 1 이면 reduction(감속), i < 1 이면 overdrive(증속), 1 이면 direct. 잇수는 0 초과 숫자 문자열이며 구동과 피동 인수를 바꾸면 역수가 나온다. 다단 기어열은 단별로 구해 곱해야 한다. 반올림 없이 50자리 유효숫자.

Inputs: teeth_driven (required), teeth_driver (required). Returns: _meta, ratio, trace, direction

engineering.gear_torque_transmissionA
Read-onlyIdempotent

기어쌍을 통과한 출력 토크 τ_out = τ_in·(피동 잇수/구동 잇수)·η 를 계산하고 기어비도 반환한다. 출력 토크는 input_torque 와 같은 단위(예: N·m)이고 efficiency 는 기본 1, [0, 1] 범위의 소수여야 한다(95 가 아니라 0.95). 속도는 기어비에 반비례해 변하므로 출력 속도는 별도로 구해야 한다. 반올림 없이 50자리 유효숫자.

Inputs: input_torque (required), teeth_driven (required), teeth_driver (required), efficiency. Returns: _meta, ratio, trace, output_torque

engineering.hardness_convertA
Read-onlyIdempotent

강재의 경도를 HV, HB, HRC 사이에서 근사식(HV ≈ 0.95·HB, HRC ≈ 88.887 − 0.058·HV)으로 환산한다. value 는 0 초과이고 HRC 입력은 88.887 미만이어야 한다. 선형 근사라 적용 범위는 HV 240~800 정도이며 그 밖이나 비철금속은 오차가 크므로 정밀 환산에는 ASTM E140 표를 쓴다. 반올림 없는 Decimal 문자열.

Inputs: value (required), to_scale (required), from_scale (required). Returns: _meta, scale, trace, value

engineering.hazen_williams_flowA
Read-onlyIdempotent

하젠-윌리엄스 식(SI)으로 관 유량 Q = 0.278·C·D^2.63·S^0.54 (m³/s)를 계산한다. S = head_loss/length 는 동수경사, coefficient 는 관 조도계수 C(무차원), diameter 와 head_loss, length 는 m. 물 관로용 경험식이라 다른 유체에는 쓰지 않는다. 손실수두가 0 이면 유량 0, 지수 계산은 30자리 유효숫자.

Inputs: length (required), diameter (required), head_loss (required), coefficient (required). Returns: _meta, trace, flow_rate_m3s

engineering.inductor_combineA
Read-onlyIdempotent

인덕터 여러 개의 합성 인덕턴스를 구한다. topology='series'면 L=ΣLᵢ, 'parallel'이면 1/L=Σ(1/Lᵢ). inductors 는 0 초과 인덕턴스(H)의 Decimal 문자열 목록이며 최소 1개, total 은 입력과 같은 단위. 상호 인덕턴스는 고려하지 않는다. 오용 주의: 커패시터는 직렬 병렬 공식이 반대다.

Inputs: topology (required), inductors (required). Returns: 합성 결과. total 은 Decimal 문자열.

engineering.lc_resonant_frequencyA
Read-onlyIdempotent

LC 공진 주파수 f0=1/(2π√(LC))를 구한다. inductance(H)와 capacitance(F)는 0 초과 Decimal 문자열이고 결과는 Hz(각주파수 rad/s가 아님). 이상적인 L, C만 가정하며 저항 손실에 의한 주파수 이동은 반영하지 않는다.

Inputs: inductance (required), capacitance (required). Returns: LC 공진 주파수(Hz). Decimal 문자열.

engineering.lmtdA
Read-onlyIdempotent

열교환기 대수평균온도차 LMTD = (ΔT₁ − ΔT₂)/ln(ΔT₁/ΔT₂)를 계산한다. 양 끝단의 온도차 두 값(K 또는 °C 차, 모두 0 초과)을 받고 같으면 극한값 ΔT₁ 을 반환한다. 병류와 향류에 맞게 각 끝단의 온도차를 직접 정해 넣어야 하며 다관식 열교환기의 보정계수 F 는 포함하지 않는다. ln 은 30자리 유효숫자.

Inputs: delta_t_hot_inlet (required), delta_t_cold_outlet (required). Returns: lmtd, _meta, trace

engineering.max_power_transferA
Read-onlyIdempotent

최대 전력 전달 정리로 최적 부하와 최대 전력을 구한다. R_L=R_th일 때 P_max=V_th²/(4R_th). v_th(V)와 r_th(Ω, 0 초과)는 Decimal 문자열. 반환: optimal_load(Ω), max_power(W). 오용 주의: 이때 효율은 50%이므로 전력 효율이 중요한 전원 설계의 부하 선정 기준은 아니다.

Inputs: r_th (required), v_th (required). Returns: 최대 전력 전달 조건. 값은 Decimal 문자열.

engineering.mech_strainA
Read-onlyIdempotent

선형 변형률 ε = ΔL / L (무차원)을 계산한다. delta_length 와 original_length 는 같은 길이 단위여야 하며(mm 와 m 을 섞으면 틀림) original_length 는 0 초과, delta_length 는 음수(수축)도 가능하다. 반올림 없이 50자리 유효숫자.

Inputs: delta_length (required), original_length (required). Returns: _meta, trace, strain

engineering.mech_stressA
Read-onlyIdempotent

수직응력 σ = F / A 를 계산한다. force 는 힘(N), area 는 단면적(m², 0 초과)이며 결과는 Pa(N/m²). 단위 변환은 하지 않고 입력 단위 그대로 나누므로 N 과 mm² 를 넣으면 MPa 가 나온다. force 부호는 유지되며 인장과 압축의 부호 약속은 호출자가 정한다. 반올림 없이 50자리 유효숫자.

Inputs: area (required), force (required). Returns: _meta, trace, stress

engineering.moment_of_inertiaA
Read-onlyIdempotent

표준 형상의 질량 관성모멘트 I (kg·m²)를 계산한다. solid_disk(½mr²), thin_ring(mr²), solid_sphere(2/5 mr²)는 radius 가, thin_rod_center(mL²/12)와 thin_rod_end(mL²/3)는 length 가 필요하다. mass 와 치수는 0 초과이며 mass 는 kg, 치수는 m. 막대는 중심 또는 끝점을 지나는 축 기준이라 다른 축은 평행축 정리를 따로 적용해야 한다. 반올림 없음.

Inputs: mass (required), shape (required), length, radius. Returns: _meta, trace, moment_of_inertia

engineering.moody_friction_factorA
Read-onlyIdempotent

콜브룩 방정식 1/√f = -2·log10(ε/(3.7D) + 2.51/(Re·√f)) 를 스위미-제인 초기값에서 시작해 최대 100회, 허용오차 1e-10 으로 반복 풀어 다르시 마찰계수 f 를 구한다. Re 2300 미만은 f = 64/Re 로 즉시 반환(iterations 0). reynolds 무차원, roughness 와 diameter 는 같은 길이 단위, 수렴 실패 시 오류. 난류 결과는 30자리 유효숫자.

Inputs: diameter (required), reynolds (required), roughness (required). Returns: _meta, trace, regime, iterations, +1 more

engineering.norton_equivalentA
Read-onlyIdempotent

테브난 등가(V_th, R_th)를 노턴 등가로 변환한다. I_N=V_th/R_th, R_N=R_th. v_th(V)와 r_th(Ω, 0 초과)는 Decimal 문자열. 반환: i_n(A), r_n(Ω). 오용 주의: 개방 전압과 단락 전류에서 바로 구하려면 먼저 thevenin_equivalent 를 쓴다.

Inputs: r_th (required), v_th (required). Returns: 노턴 등가 전류원과 병렬 저항. 값은 Decimal 문자열.

engineering.opamp_gainA
Read-onlyIdempotent

이상적 연산증폭기의 폐루프 전압 이득을 구한다. configuration='inverting'이면 -Rf/Rin, 'non_inverting'이면 1+Rf/Rin. feedback_resistance와 input_resistance는 0 초과 Decimal 문자열(Ω)이고 gain 은 배율이다(dB 아님, db_convert로 변환). 오용 주의: 유한 개방 이득, 대역폭, 포화 전압은 반영하지 않는다.

Inputs: input_resistance (required), feedback_resistance (required), configuration. Returns: 전압 이득(배율). Decimal 문자열이며 반전 구성은 음수.

engineering.parallel_reliabilityA
Read-onlyIdempotent

병렬(중복) 시스템 신뢰도 R_sys = 1 − Π(1 − R_i)를 계산한다. component_reliabilities 는 구성요소 신뢰도의 숫자 문자열 목록(1개 이상, 각 0 이상 1 이하)이며 소수로 넣는다(0.99). 하나라도 작동하면 시스템이 작동하는 구조이며 구성요소가 독립이라고 가정한다. 구성요소 k개 이상이 필요한 k-of-n 구조에는 쓸 수 없다. 반올림 없이 50자리 유효숫자.

Inputs: component_reliabilities (required). Returns: _meta, trace, reliability

engineering.pid_discrete_outputA
Read-onlyIdempotent

속도형(velocity form) 이산 PID의 새 출력 u_k=u_{k-1}+Δu를 구한다. Δu=Kp·Δe+Ki·e·Ts+Kd·(Δe−Δe_prev)/Ts. kp, ki, kd, sample_time Ts(0 초과), error_curr, error_prev, error_prev2, output_prev 는 Decimal 문자열. 반환: output, delta_u, p_term, i_term, d_term. 적분항은 현재 오차 e에 Ts를 곱하는 방식이며 출력 포화와 anti-windup은 없다.

Inputs: kd (required), ki (required), kp (required), error_curr (required), +4 more. Returns: 이산 PID 출력과 항별 기여도. 값은 Decimal 문자열.

engineering.power_factor_correctionA
Read-onlyIdempotent

지상(유도성) 부하의 역률을 목표 역률로 올리는 병렬 커패시턴스를 구한다. Q_c=P·(tanφ₁−tanφ₂), C=Q_c/(2π·f·V²). real_power(W), voltage(V), frequency(Hz)는 0 초과, current_pf와 target_pf는 (0,1] 범위이며 target_pf가 더 커야 한다. 반환: capacitance(F), reactive_power_canceled(VAR). 오용 주의: 3상은 상별 전력과 커패시터 양단 전압으로 환산해 넣는다.

Inputs: voltage (required), frequency (required), target_pf (required), current_pf (required), +1 more. Returns: 역률 보정 결과. capacitance(F)와 reactive_power_canceled(VAR)는 Decimal 문자열.

engineering.pump_hydraulic_powerA
Read-onlyIdempotent

펌프 수력 동력 P = ρ·g·Q·H (W)를 계산하고, efficiency(0 초과 1 이하)를 주면 축동력 P/η 도 반환한다. density kg/m³, flow_rate m³/s, head m, gravity 기본 9.80665. 효율은 백분율(80)이 아니라 소수(0.8)로 넣어야 한다. 반올림 없이 50자리 유효숫자.

Inputs: head (required), density (required), flow_rate (required), gravity, +1 more. Returns: _meta, trace, shaft_power_w, hydraulic_power_w

engineering.rc_filter_cutoffA
Read-onlyIdempotent

1차 RC 필터의 -3 dB 차단 주파수 fc=1/(2πRC)를 Hz로 구한다. resistance(Ω)와 capacitance(F)는 0 초과 Decimal 문자열. filter_type 은 'low_pass' 또는 'high_pass'이며 수식은 같고 입력 그대로 반환될 뿐이다. 오용 주의: 2차 이상 필터나 부하가 걸린 필터에는 맞지 않는다.

Inputs: resistance (required), capacitance (required), filter_type. Returns: RC 필터 차단 주파수(Hz). cutoff_hz 는 Decimal 문자열이고 filter_type 은 입력 그대로.

engineering.resistor_color_codeA
Read-onlyIdempotent

저항기 4밴드 또는 5밴드 컬러코드를 해독해 저항값(Ω)과 허용오차(%)를 구한다. 4밴드는 [자릿수1, 자릿수2, 승수, 허용오차], 5밴드는 [자릿수1, 자릿수2, 자릿수3, 승수, 허용오차] 순서의 영문 색상명(black, brown, red, orange, yellow, green, blue, violet, gray, white, gold, silver)이며 대소문자와 앞뒤 공백은 무시한다. 오용 주의: 6밴드(온도계수)는 지원하지 않으며 읽는 방향이 반대면 값이 틀린다.

Inputs: bands (required). Returns: 컬러코드 해독 결과. resistance_ohm 은 Ω, tolerance_pct 는 %이며 Decimal 문자열.

engineering.resistor_parallelA
Read-onlyIdempotent

병렬 연결 저항의 합성 저항 1/R_total=Σ(1/Rᵢ)를 구한다. resistors 는 0 초과 저항값(Ω)의 Decimal 문자열 목록이며 최소 1개. 계산은 유효숫자 50자리 Decimal 이다. 오용 주의: 직렬 연결에는 resistor_series 를 쓴다.

Inputs: resistors (required). Returns: 저항 직렬 또는 병렬 합성 저항. total 은 Decimal 문자열.

engineering.resistor_seriesA
Read-onlyIdempotent

직렬 연결 저항의 합성 저항 R_total=ΣRᵢ를 구한다. resistors 는 0 초과 저항값(Ω)의 Decimal 문자열 목록이며 최소 1개. 계산은 유효숫자 50자리 Decimal 이다. 오용 주의: 병렬 연결에는 resistor_parallel 을 쓴다.

Inputs: resistors (required). Returns: 저항 직렬 또는 병렬 합성 저항. total 은 Decimal 문자열.

engineering.rlc_time_constantA
Read-onlyIdempotent

RC, RL, 직렬 RLC 회로의 시정수 또는 감쇠 특성을 구한다. mode='rc'면 τ=RC, 'rl'이면 τ=L/R, 'rlc'면 α=R/(2L), ω₀=1/√(LC), ζ=α/ω₀와 regime(underdamped, critically_damped, overdamped)을 반환한다. 필요한 R(Ω), L(H), C(F)는 모드별로 0 초과 Decimal 문자열이며 빠뜨리면 오류. 오용 주의: ζ는 직렬 RLC 기준이라 병렬 RLC에는 맞지 않는다.

Inputs: mode (required), inductance, resistance, capacitance. Returns: 모드별 결과. rc 와 rl 은 tau, rlc 는 alpha, omega0, zeta, regime 을 돌려준다.

engineering.safety_factorA
Read-onlyIdempotent

안전율 SF = 허용응력 / |작용응력| 을 계산하고 SF 1 이상이면 'safe', 미만이면 'unsafe' 를 반환한다. 두 응력은 같은 단위(Pa 또는 MPa)이며 allowable_stress 는 0 초과, applied_stress 는 0 이 아니어야 하고 부호는 무시된다. 요구 안전율(예: 1.5)과 비교하지 않으므로 safe 만으로 설계 적합을 판단하면 안 된다. 반올림 없이 50자리 유효숫자.

Inputs: applied_stress (required), allowable_stress (required). Returns: _meta, trace, verdict, safety_factor

engineering.second_order_responseA
Read-onlyIdempotent

2차 시스템 G(s)=ωn²/(s²+2ζωn·s+ωn²)의 감쇠 고유진동수 ωd, 최대 오버슈트, 정착시간을 구한다. damping_ratio ζ(0 이상)와 natural_freq ωn(rad/s, 0 초과)은 Decimal 문자열. overshoot 는 비율(0~1, 백분율 아님)이고 ζ≥1 이면 0, ζ=0 이면 1. settling_time=4/(ζωn)은 2% 기준 근사이며 ζ=0 이면 "Infinity". regime: underdamped, critically_damped, overdamped. 초월함수는 유효숫자 30자리.

Inputs: natural_freq (required), damping_ratio (required). Returns: 2차 시스템 특성. 값은 Decimal 문자열이며 settling_time 은 ζ=0 이면 "Infinity".

engineering.section_moment_inertiaA
Read-onlyIdempotent

도심 중립축에 대한 단면 이차모멘트 I 를 계산한다. rectangle(width, height: bh³/12), circle(diameter: πd⁴/64), i_beam(flange_width, flange_thickness, web_height, web_thickness: BH³/12 − (B−t_w)·web_height³/12, H = web_height + 2·flange_thickness). 치수는 모두 0 초과이고 m 로 넣으면 m⁴. rectangle 의 height 는 굽힘 방향 치수이며 중공 단면은 지원하지 않는다. π 는 30자리.

Inputs: shape (required), width, height, diameter, +4 more. Returns: _meta, trace, inertia

engineering.series_reliabilityA
Read-onlyIdempotent

직렬 시스템 신뢰도 R_sys = ΠR_i 를 계산한다. component_reliabilities 는 구성요소 신뢰도의 숫자 문자열 목록(1개 이상, 각 0 이상 1 이하)이며 백분율(99)이 아니라 소수(0.99)로 넣는다. 구성요소가 서로 독립이라고 가정하므로 고장이 연관된 경우에는 맞지 않다. 입력은 유한한 값이어야 하며 호출자의 Decimal 설정과 독립적인 50자리 유효숫자 HALF_EVEN으로 계산한다.

Inputs: component_reliabilities (required). Returns: _meta, trace, reliability

engineering.shear_stressA
Read-onlyIdempotent

횡전단응력 τ 를 모드별로 계산한다. average 는 V/A, rectangular_max 는 1.5V/A(직사각형 단면 중립축의 최대값, area 필요), general 은 V·Q/(I·b)(first_moment_q, inertia, width 필요). shear_force 는 N, area 는 m²(0 초과)이고 결과는 Pa. 원형이나 I형 단면에 rectangular_max 를 쓰면 틀리며 필수 인자가 빠지면 오류. 반올림 없음.

Inputs: mode (required), shear_force (required), area, width, +2 more. Returns: _meta, trace, shear_stress

engineering.si_prefix_convertA
Read-onlyIdempotent

수치를 SI 접두사 사이에서 환산한다. 결과 = value × 10^(from 지수 − to 지수)를 Decimal 로 정확히 계산한다. 접두사는 이름으로 넣고(yocto 부터 yotta 까지, 대소문자 무시, 빈 문자열이나 base 는 접두사 없음) 기호(k, M, µ)는 받지 않는다. 이진 접두사(KiB 등)와 단위 자체는 다루지 않으며 데이터 크기는 units_data_size_convert 를 쓴다.

Inputs: value (required), to_prefix (required), from_prefix (required). Returns: _meta, trace, value

engineering.sn_fatigue_lifeA
Read-onlyIdempotent

바스퀸 식 S_a = S_f'·(2N_f)^b 를 N_f = 0.5·(S_a/S_f')^(1/b) 로 풀어 파손까지의 사이클 수를 구한다(반전 횟수 2N_f 가 아니라 사이클 N_f). stress_amplitude 와 fatigue_strength_coeff 는 같은 응력 단위로 0 초과, basquin_exponent 는 음수(통상 -0.05 ~ -0.12). 평균응력 보정과 피로한도는 반영하지 않는다. 거듭제곱은 30자리 유효숫자.

Inputs: basquin_exponent (required), stress_amplitude (required), fatigue_strength_coeff (required). Returns: _meta, trace, cycles

engineering.stefan_boltzmannA
Read-onlyIdempotent

회색체 표면과 주위 사이의 순복사 열전달 Q = ε·σ·A·(T_s⁴ − T_surr⁴) (W)를 계산한다. σ = 5.670374419e-8 W/(m²·K⁴), emissivity 는 [0, 1], area m². 온도는 절대온도 K(0 초과)이므로 섭씨를 그대로 넣으면 틀린다. 작은 표면이 큰 주위에 둘러싸인 경우의 식이며 표면이 더 차가우면 음수. 반올림 없이 50자리 유효숫자.

Inputs: area (required), emissivity (required), temperature_surface (required), temperature_surround (required). Returns: _meta, trace, heat_rate_w

engineering.thermal_expansion_strainA
Read-onlyIdempotent

선팽창 변형률 ε = α·ΔT 를 계산하고 length(0 초과)를 주면 길이 변화 ΔL = ε·L₀ 도 반환한다. alpha 는 선팽창계수(1/K), delta_t 는 K 또는 °C 의 온도 변화량이며 음수면 수축이다. 온도 자체(예: 20°C)가 아니라 변화량을 넣어야 한다. ΔL 은 length 와 같은 단위. 1차원 자유 팽창만 다루며 구속 열응력은 계산하지 않는다. 반올림 없음.

Inputs: alpha (required), delta_t (required), length. Returns: _meta, trace, strain, delta_length

engineering.thermal_resistanceA
Read-onlyIdempotent

열저항 K/W 를 합성한다. topology 'series' 는 R_total = ΣRᵢ, 'parallel' 은 1/R_total = Σ(1/Rᵢ). resistances 는 열저항의 숫자 문자열 목록(1개 이상, 모두 0 초과, 같은 단위)이다. 0 저항(완전 전도)은 입력할 수 없고 직렬과 병렬이 섞인 회로는 단계별로 나눠 호출해야 한다. 반올림 없이 50자리 유효숫자.

Inputs: topology (required), resistances (required). Returns: _meta, total, trace

engineering.thevenin_equivalentA
Read-onlyIdempotent

개방 전압과 단락 전류로 테브난 등가 회로를 구한다. V_th=V_oc, R_th=V_oc/I_sc. open_circuit_voltage(V)와 short_circuit_current(A, 0 초과)는 Decimal 문자열. 반환: v_th, r_th. 오용 주의: 독립 전원이 없는 회로는 V_oc가 0이라 R_th가 0으로 계산되므로 저항 합성으로 R_th를 구해야 한다.

Inputs: open_circuit_voltage (required), short_circuit_current (required). Returns: 테브난 등가 전압원과 저항. 값은 Decimal 문자열.

engineering.three_phase_powerA
Read-onlyIdempotent

균형 3상 회로의 피상, 유효, 무효 전력을 선간 값으로 구한다. S=√3·V_LL·I_L, P=S·cosφ, Q=√(S²−P²). line_voltage(V)와 line_current(A)는 0 초과, power_factor는 -1 이상 1 이하 Decimal 문자열. connection('wye'/'delta')은 검증만 하고 수식은 같다. Q는 항상 0 이상이라 진상 지상을 구분하지 못한다.

Inputs: line_current (required), line_voltage (required), power_factor (required), connection. Returns: 균형 3상 전력. 값은 Decimal 문자열(VA, W, VAR).

engineering.torque_rotational_powerA
Read-onlyIdempotent

회전 일률 P = τ·ω (W)를 계산한다. torque 는 N·m, angular_velocity 는 rad/s 이다. rpm 을 그대로 넣으면 틀리므로 ω = 2π·rpm/60 으로 먼저 환산해야 한다. 두 값의 부호는 그대로 곱해진다. 유한한 Decimal 문자열만 허용하며 호출자의 Decimal 설정과 독립적으로 50자리 유효숫자 HALF_EVEN으로 계산한다. 계산 범위 초과는 입력 오류다.

Inputs: torque (required), angular_velocity (required). Returns: _meta, power, trace

engineering.weibull_reliabilityA
Read-onlyIdempotent

2모수 와이블 분포의 신뢰도 R(t) = exp(−(t/η)^β)와 불신뢰도를 계산한다. shape β 와 scale η 는 0 초과, time 은 η 와 같은 단위의 0 이상 값이다(0 이면 R = 1). β < 1 은 초기 고장, β = 1 은 우발 고장, β > 1 은 마모 고장에 해당한다. 위치모수 γ 는 지원하지 않는다. 거듭제곱과 exp 는 30자리 유효숫자.

Inputs: time (required), scale (required), shape (required). Returns: _meta, trace, reliability, unreliability

finance.black_scholesA
Read-onlyIdempotent

Black-Scholes 유럽형 옵션의 가격과 델타, 감마, 베가, 세타, 로를 계산한다. option_type 은 call 또는 put, rate, sigma, dividend_yield 는 연율 소수, time_to_expiry 는 연 단위, 모두 Decimal 문자열이며 결과는 유효숫자 12자리. 베가는 변동성 1.0 당 변화량, 세타는 연 단위이고 미국형 옵션이나 조기행사에는 맞지 않는다.

Inputs: rate (required), spot (required), sigma (required), strike (required), +3 more. Returns: rho, vega, _meta, delta, +4 more

finance.bond_durationA
Read-onlyIdempotent

채권의 맥컬리 듀레이션과 수정 듀레이션을 연 단위로 계산한다. face 는 양수, coupon_rate 와 ytm 은 연율 소수 Decimal 문자열, years 는 만기 연수 정수, freq 는 연 이자지급 횟수(기본 2). 가격은 ytm 으로 현금흐름을 할인해 구하며 반올림하지 않는다. 시장 가격만 알면 먼저 bond_ytm 으로 ytm 을 구한다.

Inputs: ytm (required), face (required), years (required), coupon_rate (required), +1 more. Returns: _meta, trace, macaulay, modified

finance.bond_ytmA
Read-onlyIdempotent

채권 만기수익률(YTM)을 뉴턴법으로 구한다. price 와 face 는 양수 Decimal 문자열, coupon_rate 는 연 표면이율 소수 (예 0.05), years 는 만기 연수 정수, freq 는 연 이자지급 횟수(기본 2). ytm 은 기간 수익률 x freq 인 연율이다. 수렴하지 못하면 converged=false 로 마지막 추정값이 나오므로 확인해야 하며 이자 지급일 사이의 경과이자는 지원하지 않는다.

Inputs: face (required), price (required), years (required), coupon_rate (required), +3 more. Returns: ytm, _meta, trace, converged, +1 more

finance.cagrA
Read-onlyIdempotent

복합연평균성장률(CAGR)을 계산한다. CAGR = (ending_value / beginning_value)^(1 / periods) - 1. beginning_value 는 0보다 크고 ending_value 는 0 이상인 Decimal 문자열, periods 는 1 이상 정수다. 결과는 배수(0.1 = 10%)이며 decimals(기본 6)자리로 rounding(기본 HALF_EVEN) 처리한다.

Inputs: periods (required), ending_value (required), beginning_value (required), decimals, +1 more. Returns: cagr, _meta, trace

finance.forward_priceA
Read-onlyIdempotent

무차익 선도가격을 계산한다. F = S x exp((r - y) x T), 연속복리 기준이며 income_yield(배당률이나 쿠폰수익률, 기본 0)를 차감한다. spot 은 양수, time_to_expiry 는 0 초과 연 단위, 모두 Decimal 문자열이고 결과는 소수 8자리. 이산복리 이율은 연속복리로 환산해서 넣어야 한다.

Inputs: spot (required), risk_free_rate (required), time_to_expiry (required), income_yield. Returns: _meta, trace, forward_price

finance.futures_priceA
Read-onlyIdempotent

연속복리 보유비용 모형의 선물 이론가격을 계산한다. F = S x exp((r - q) x T). spot 은 양수, risk_free_rate 와 dividend_yield(q, 기본 0)는 연속복리 연율, time_to_expiry 는 0 초과 연 단위, 모두 Decimal 문자열. 결과는 소수 8자리. 이산복리 이율을 그대로 넣으면 값이 어긋난다.

Inputs: spot (required), risk_free_rate (required), time_to_expiry (required), dividend_yield. Returns: _meta, trace, carry_rate, futures_price

finance.fvA
Read-onlyIdempotent

현재 금액의 미래가치를 계산한다. FV = PV x (1+r)^n, 기간마다 복리. present_value 와 rate(기간당 이율, 0 이상, 예 0.05)는 Decimal 문자열, periods 는 1 이상 정수. decimals(기본 2)자리로 rounding(기본 HALF_EVEN) 처리한다. 금액과 이율은 유한해야 하며 decimals는 0 이상 정수다. 호출자 설정과 독립적인 50자리 정밀도로 계산하고 계산 범위 초과는 입력 오류다. 연이율과 월 단위 기간 수처럼 단위가 다른 값을 섞어 넣지 않는다.

Inputs: rate (required), periods (required), present_value (required), decimals, +1 more. Returns: fv, _meta, trace

finance.irrA
Read-onlyIdempotent

내부수익률(IRR), 즉 NPV 를 0 으로 만드는 기간 수익률을 구한다. cashflows 는 2개 이상이며 index 0 이 t=0, 양수와 음수가 모두 있어야 한다. 뉴턴법이 실패하면 -0.99 이상 10 이하 구간 이분법을 쓰고 max_iter 는 10000 이하. 해를 못 찾으면 irr=null, converged=false 를 돌려준다. 월별 현금흐름의 결과는 연율이 아니라 월 수익률이다.

Inputs: cashflows (required), tol, guess, max_iter. Returns: irr, _meta, trace, converged, +1 more

finance.loan_scheduleA
Read-onlyIdempotent

대출 상환 스케줄을 계산한다. method 는 EQUAL_PAYMENT(원리금균등, 기본) 또는 EQUAL_PRINCIPAL(원금균등). annual_rate 는 연이율 소수(예 0.03)이며 월이율 = 연이율 / 12, months 는 1 이상 1200 이하 정수. decimals(기본 0)자리로 rounding(기본 HALF_EVEN) 처리하고 마지막 회차가 잔액을 정리한다. 원금균등은 monthly_payment 가 null 이다. 거치기간과 중도상환은 지원하지 않는다.

Inputs: months (required), principal (required), annual_rate (required), method, +2 more. Returns: _meta, trace, schedule, monthly_payment

finance.npvA
Read-onlyIdempotent

순현재가치를 계산한다. NPV = sum(CF_t / (1+r)^t). cashflows 의 index 0 은 t=0 시점이라 할인하지 않으며 초기 투자는 음수로 넣는다. rate 는 기간당 할인율(0 이상 Decimal 문자열), decimals(기본 2)자리로 rounding(기본 HALF_EVEN) 처리한다. 첫 현금흐름을 1기 말로 보려면 앞에 0 을 추가한다.

Inputs: rate (required), cashflows (required), decimals, rounding. Returns: npv, _meta, trace

finance.option_payoffA
Read-onlyIdempotent

옵션의 만기 payoff 를 계산한다. option_type 은 vanilla, digital(현금 지급), asian(산술평균), barrier(up_in, up_out, down_in, down_out). spot_path 는 기초자산 가격 문자열 목록이며 vanilla 와 digital 은 마지막 값만 쓴다. barrier 유형은 barrier 와 barrier_type 이 필수이고 결과는 소수 8자리. 만기 가치일 뿐 프리미엄이 아니다.

Inputs: strike (required), spot_path (required), option_type (required), barrier, +3 more. Returns: _meta, trace, payoff, is_call, +3 more

finance.payback_periodA
Read-onlyIdempotent

단순 투자회수기간을 계산한다. cashflows 의 index 0 은 음수인 초기 투자이고 이후 값은 기간별 현금흐름이다. 누적 현금흐름이 처음 0 이상이 되는 기간 안에서 선형 보간하며, 회수되지 않으면 payback_period=null 과 recovered=false 를 반환한다. 화폐의 시간가치는 반영하지 않으며 decimals(기본 6)자리로 rounding(기본 HALF_EVEN) 처리한다.

Inputs: cashflows (required), decimals, rounding. Returns: _meta, trace, recovered, payback_period

finance.pvA
Read-onlyIdempotent

미래 현금흐름의 현재가치를 계산한다. PV = FV / (1+r)^n. future_value 와 rate(기간당 이율, 0 이상, 예 0.05)는 Decimal 문자열, periods 는 1 이상 정수. decimals(기본 2)자리로 rounding(기본 HALF_EVEN) 처리한다. 금액과 이율은 유한해야 하며 decimals는 0 이상 정수다. 호출자 설정과 독립적인 50자리 정밀도로 계산하고 계산 범위 초과는 입력 오류다. 연이율과 월 단위 기간 수처럼 단위가 다른 값을 섞어 넣지 않는다.

Inputs: rate (required), periods (required), future_value (required), decimals, +1 more. Returns: pv, _meta, trace

finance.roiA
Read-onlyIdempotent

투자수익률(ROI)을 계산한다. ROI = net_profit / investment_cost. net_profit 은 손실이면 음수인 Decimal 문자열이고 investment_cost 는 0보다 커야 한다. 결과는 배수(0.25 = 25%)이며 decimals(기본 4)자리로 rounding(기본 HALF_EVEN) 처리한다. 기간을 반영한 연환산 수익률은 아니다.

Inputs: net_profit (required), investment_cost (required), decimals, rounding. Returns: roi, _meta, trace

finance.sharpe_ratioA
Read-onlyIdempotent

샤프지수 = (평균수익률 - 무위험수익률) / 표본표준편차(n-1)를 계산한다. returns 는 기간 수익률 문자열 목록(2개 이상), risk_free_rate 는 같은 기간 단위(기본 0), periods_per_year 가 0 보다 크면 sqrt(periods_per_year)를 곱해 연환산한다. 표준편차가 0 이면 오류, 결과는 소수 8자리. 연 무위험수익률을 일간 수익률에서 그대로 빼지 않는다.

Inputs: returns (required), risk_free_rate, periods_per_year. Returns: n, _meta, stdev, trace, +3 more

finance.sortino_ratioA
Read-onlyIdempotent

소르티노 비율 = (평균수익률 - 무위험수익률) / 하방편차를 계산한다. 하방편차 = sqrt(mean(min(r - rf, 0)^2)), 평균은 전체 표본 수로 나눈다. returns 는 기간 수익률 문자열 목록(2개 이상), risk_free_rate 는 같은 기간 단위(기본 0), periods_per_year 가 0 보다 크면 연환산. 하방편차가 0 이면 오류, 결과는 소수 8자리.

Inputs: returns (required), risk_free_rate, periods_per_year. Returns: n, _meta, trace, sortino, +3 more

finance.var_historicalA
Read-onlyIdempotent

과거 수익률의 경험적 분위수로 VaR 와 CVaR(기대부족액)을 계산한다. returns 는 기간 수익률 문자열 목록(2개 이상), confidence 는 0 초과 1 미만(기본 0.95)이며 분위수는 선형보간한다. 손실을 양수로 나타낸 소수 8자리 값이고 분포 가정은 없다. 표본이 적으면 꼬리 추정이 불안정하다.

Inputs: returns (required), confidence. Returns: n, var, cvar, _meta, +2 more

finance.var_parametricA
Read-onlyIdempotent

정규분포를 가정한 모수적 VaR 와 CVaR 를 계산한다. 표본 평균과 표본표준편차(n-1)로 VaR = -(mu + z x sigma). returns 는 기간 수익률 문자열 목록(2개 이상), confidence 는 0 초과 1 미만(기본 0.95). 손실을 양수로 나타낸 소수 8자리 값. 꼬리가 두꺼운 분포에서는 손실을 작게 추정하므로 var_historical 과 비교한다.

Inputs: returns (required), confidence. Returns: n, z, mu, var, +5 more

geometry.area_circleA
Read-onlyIdempotent

원의 넓이 π * r² 를 계산한다. radius 는 0 이상 Decimal 문자열이며 단위는 자유(결과는 그 단위의 제곱). π 는 mpmath 50자리로 계산하고 유효숫자 30자리 문자열로 반환한다. 지름을 radius 로 넣으면 4배 큰 값이 나오므로 반지름을 넣는다.

Inputs: radius (required). Returns: area, _meta, trace

geometry.area_polygonA
Read-onlyIdempotent

다각형 넓이를 신발끈 공식(Shoelace)으로 계산한다. vertices 는 [[x, y], ...] 형태 Decimal 문자열 좌표이고 꼭짓점 3개 이상을 변을 따라 순서대로 준다. 마지막 점은 첫 점과 자동으로 이어지며 결과는 항상 0 이상이다. 변이 서로 교차하거나 점 순서가 뒤섞이면 실제 면적과 다르다.

Inputs: vertices (required). Returns: area, _meta, trace

geometry.area_rectangleA
Read-onlyIdempotent

직사각형 넓이 width * height 를 Decimal 로 계산한다. 두 값은 유한한 0 이상 Decimal 문자열이며 단위는 같아야 한다. 입력 자릿수에 맞춰 정확히 곱하며 호출자의 Decimal 정밀도에 영향을 받지 않는다. 대각선 길이나 둘레를 넣으면 의미 없는 값이 나온다. 정사각형은 두 값에 같은 변 길이를 넣는다.

Inputs: width (required), height (required). Returns: area, _meta, trace

geometry.area_triangleA
Read-onlyIdempotent

삼각형 넓이 (base * height) / 2 를 Decimal 로 계산한다. base 는 밑변, height 는 그 밑변에 수직인 높이이며 둘 다 유한한 0 이상 Decimal 문자열, 단위는 같아야 한다. 입력 자릿수에 맞춰 정확히 계산하며 호출자의 Decimal 정밀도에 영향을 받지 않는다. 비스듬한 변의 길이를 height 로 넣으면 틀리므로 수직 높이를 넣는다.

Inputs: base (required), height (required). Returns: area, _meta, trace

geometry.haversineA
Read-onlyIdempotent

하버사인 공식으로 두 지점의 지구 표면 대원 거리(km)를 계산한다. 위도(-9090)와 경도(-180180)는 도 단위 Decimal 문자열이고 지구 반지름 기본값은 6371km 다. mpmath 50자리 계산 후 유효숫자 30자리로 반환한다. 구면 근사이므로 실제 도로 거리나 타원체 거리와 다르며 라디안을 넣으면 안 된다.

Inputs: lat1 (required), lat2 (required), lon1 (required), lon2 (required), +1 more. Returns: _meta, trace, distance_km

geometry.matrix_determinantA
Read-onlyIdempotent

정방행렬 M 의 행렬식을 계산한다. M 은 n×n Decimal 문자열 2차원 리스트(n 은 200 이하). n 이 3 이하면 Decimal 로 정확히 전개하고 n 이 4 이상이면 numpy float64 로 계산해 약 15자리 정밀도만 보장한다. 정방행렬이 아니면 오류이며 n≥4 결과는 근사값임에 유의한다.

Inputs: M (required). Returns: _meta, trace, result

geometry.matrix_inverseA
Read-onlyIdempotent

정방행렬의 역행렬을 numpy.linalg.inv(float64)로 계산한다. M 은 n×n Decimal 문자열 2차원 리스트(n 은 200 이하). 결과 원소는 float64 repr 문자열이라 '1e-05' 같은 지수 표기가 나올 수 있고 정밀도는 약 15자리다. 특이행렬이면 오류. 연립방정식 해가 목적이면 역행렬을 곱하지 말고 matrix_solve 를 쓴다.

Inputs: M (required). Returns: _meta, trace, result

geometry.matrix_multiplyA
Read-onlyIdempotent

행렬 곱 A @ B 를 Decimal 로 계산한다. A 는 m×k, B 는 k×n 의 Decimal 문자열 2차원 리스트이며 A 의 열 수와 B 의 행 수가 같아야 한다. 행과 열은 각각 200 이하. float 를 거치지 않아 반올림 오차가 없다. 행렬 곱은 교환법칙이 성립하지 않으므로 A @ B 와 B @ A 는 다르다.

Inputs: A (required), B (required). Returns: _meta, trace, result

geometry.matrix_solveA
Read-onlyIdempotent

연립일차방정식 Ax = b 의 해 x 를 numpy.linalg.solve(float64)로 구한다. A 는 n×n Decimal 문자열 2차원 리스트, b 는 길이 n 리스트. 해는 float64 repr 문자열이며 정밀도는 약 15자리다. 특이행렬이거나 b 의 길이가 n 과 다르면 오류. 비정방(과결정, 부족결정) 시스템은 지원하지 않는다.

Inputs: A (required), b (required). Returns: x, _meta, trace

geometry.vector_crossA
Read-onlyIdempotent

3차원 벡터의 외적 a × b 를 Decimal 로 계산한다. a, b 는 정확히 3개 원소의 Decimal 문자열 리스트이고 결과도 3개 원소 리스트다. 외적은 순서를 바꾸면 부호가 반대가 되므로 a × b 와 b × a 를 혼동하지 않는다. 2차원 벡터는 z 성분 0 을 직접 채워 넣는다.

Inputs: a (required), b (required). Returns: _meta, trace, result

geometry.vector_dotA
Read-onlyIdempotent

두 벡터의 내적 Σ a_i * b_i 를 Decimal 로 계산한다. a, b 는 같은 길이의 비어 있지 않은 Decimal 문자열 리스트이며 반올림 없는 정확한 합이다. 길이가 다르면 오류. 3차원 벡터의 직교 방향이 필요하면 vector_cross 를 쓴다.

Inputs: a (required), b (required). Returns: _meta, trace, result

geometry.vector_normA
Read-onlyIdempotent

벡터의 L-p 노름 (Σ |v_i|^p)^(1/p) 을 계산한다. v 는 비어 있지 않은 Decimal 문자열 리스트, p 는 1 이상의 정수(기본 2, 유클리드 길이). mpmath 50자리 계산 후 유효숫자 30자리로 반환한다. 최댓값 노름(p=∞)과 정수가 아닌 p 는 지원하지 않는다.

Inputs: v (required), p. Returns: _meta, trace, result

geometry.volume_cuboidA
Read-onlyIdempotent

직육면체 부피 length * width * height 를 Decimal 로 계산한다. 세 값은 유한한 0 이상 Decimal 문자열이며 같은 길이 단위여야 한다. 입력 자릿수에 맞춰 정확히 곱하며 호출자의 Decimal 정밀도에 영향을 받지 않는다. 정확히 표현할 수 없는 결과는 입력 오류로 거부한다. cm 와 m 처럼 단위를 섞어 넣으면 틀린 값이 나온다.

Inputs: width (required), height (required), length (required). Returns: _meta, trace, volume

geometry.volume_cylinderA
Read-onlyIdempotent

원기둥 부피 π * r² * h 를 계산한다. radius(밑면 반지름)와 height 는 0 이상 Decimal 문자열이며 같은 길이 단위여야 한다. π 는 mpmath 50자리로 계산하고 유효숫자 30자리 문자열로 반환한다. 지름을 radius 로 넣으면 4배 큰 값이 나온다.

Inputs: height (required), radius (required). Returns: _meta, trace, volume

geometry.volume_sphereA
Read-onlyIdempotent

구의 부피 (4/3) * π * r³ 를 계산한다. radius 는 0 이상 Decimal 문자열이며 결과 단위는 길이 단위의 세제곱이다. π 는 mpmath 50자리로 계산하고 유효숫자 30자리 문자열로 반환한다. 지름이 아니라 반지름을 넣는다.

Inputs: radius (required). Returns: _meta, trace, volume

math.diff_centralA
Read-onlyIdempotent

중심 차분 f'(x) ≈ (f(x+h) - f(x-h)) / (2h) 로 x 에서의 1차 도함수를 수치 근사한다. expression 은 core.calc 문법의 수식, variable(기본 x)이 자유 변수, h 는 양수 Decimal 문자열(기본 0.001). float64 계산이며 결과는 유효숫자 12자리다. h 를 지나치게 작게 잡으면 상쇄 오차가 커지고, 도함수 식 자체가 필요하면 symbolic.diff 를 쓴다.

Inputs: x (required), expression (required), h, variable. Returns: _meta, trace, result

math.diff_five_pointA
Read-onlyIdempotent

5점 공식 f'(x) ≈ (-f(x+2h) + 8 f(x+h) - 8 f(x-h) + f(x-2h)) / (12 h) 로 x 에서의 1차 도함수를 수치 근사한다. 중심 차분보다 정확도가 높다(O(h⁴)). expression 은 core.calc 문법, h 는 양수(기본 0.001), float64 계산이며 유효숫자 12자리다. x±2h 구간에서 정의되지 않는 함수에는 쓸 수 없다.

Inputs: x (required), expression (required), h, variable. Returns: _meta, trace, result

math.fftA
Read-onlyIdempotent

실수 샘플의 이산 푸리에 변환(DFT)을 numpy.fft 로 계산한다. samples 는 2개 이상 65536개 이하의 Decimal 문자열 리스트. 각 bin 은 k, magnitude, phase_rad 를 담으며 float64 계산에 유효숫자 12자리이고 1/N 정규화는 하지 않는다. k 는 주파수가 아니라 인덱스이므로 Hz 는 k * 샘플링주파수 / N 으로 직접 계산한다.

Inputs: samples (required). Returns: n, bins, _meta, trace

math.ifftA
Read-onlyIdempotent

fft 결과의 bin 리스트({magnitude, phase_rad})에서 시간 영역 샘플을 복원한다(1/N 정규화 포함). 최대 65536개. real_output 기본 true 는 허수부 절대값이 1e-9 를 넘으면 오류를 내고 문자열 리스트를 반환하며, false 면 {real, imag} 쌍을 반환한다. bin 은 N개 전체를 순서대로 넣어야 하며 일부만 넣으면 다른 신호가 복원된다.

Inputs: bins (required), real_output. Returns: _meta, trace, samples

math.integrate_gauss_legendreA
Read-onlyIdempotent

가우스-르장드르 구적법(mpmath.quadgl)으로 정적분 ∫_a^b f(x) dx 의 근삿값을 구한다. expression 은 core.calc 문법, a 와 b 는 a < b 인 Decimal 문자열, degree 는 2 이상 100 이하(기본 20). 피적분 함수는 float64 로 평가하고 결과는 유효숫자 12자리다. 매끄러운 함수에 적합하며 불연속이 있는 구간은 나누어 적분한다.

Inputs: a (required), b (required), expression (required), degree, +1 more. Returns: _meta, trace, degree, result

math.integrate_simpsonA
Read-onlyIdempotent

합성 심프슨 1/3 법으로 정적분 ∫_a^b f(x) dx 의 근삿값을 구한다. expression 은 core.calc 문법, a 와 b 는 a < b 인 Decimal 문자열, 부구간 수 n 은 2 이상 20000 이하의 짝수(기본 100). float64 계산이며 유효숫자 12자리다. 하한이 상한보다 크면 오류이므로 부호를 직접 뒤집어야 하고, 특이점이 있는 구간은 정확하지 않다.

Inputs: a (required), b (required), expression (required), n, +1 more. Returns: n, _meta, trace, result

math.interpolate_cubic_splineA
Read-onlyIdempotent

3차 스플라인 보간(scipy CubicSpline)으로 x_query 에서의 값을 구한다. xs 는 엄격히 증가하는 4개 이상의 Decimal 문자열 리스트, ys 는 같은 길이. bc_type 은 natural(기본), clamped, not-a-knot 중 하나. x_query 가 표본 구간 밖이면 외삽하지 않고 오류를 낸다. 유효숫자 12자리.

Inputs: xs (required), ys (required), x_query (required), bc_type. Returns: _meta, trace, result

math.interpolate_linearA
Read-onlyIdempotent

표본점 (xs, ys) 를 직선으로 이어 x_query 에서의 값을 구하는 1차원 선형 보간이다. xs 는 엄격히 증가하는 2개 이상의 Decimal 문자열 리스트, ys 는 같은 길이. x_query 가 [min(xs), max(xs)] 밖이면 외삽하지 않고 오류를 낸다. float64 계산, 유효숫자 12자리.

Inputs: xs (required), ys (required), x_query (required). Returns: _meta, trace, result

math.polynomial_hornerA
Read-onlyIdempotent

호너 방법으로 다항식 P(x) 를 Decimal 로 평가한다. coefficients 는 높은 차수부터 내림차순(예 [1, 0, -4] 는 x² - 4), x 는 Decimal 문자열이다. float 를 거치지 않으며 degree 도 함께 반환한다. 계수를 오름차순으로 넣으면 다른 다항식이 평가된다.

Inputs: x (required), coefficients (required). Returns: _meta, trace, degree, result

math.polynomial_rootsA
Read-onlyIdempotent

다항식의 모든 근(복소근 포함)을 numpy.roots 로 구한다. coefficients 는 높은 차수부터 내림차순 Decimal 문자열 리스트(예 [1, 0, -4] 는 x² - 4)이며 1차 이상 256차 이하, 최고차 계수는 0 이 아니어야 한다. 각 근은 {real, imag} 12자리 문자열이고 정렬되어 있지 않다. 오름차순으로 넣으면 다른 다항식이 되며 중근이 많으면 정밀도가 떨어진다.

Inputs: coefficients (required). Returns: _meta, roots, trace, degree

medical.bmiA
Read-onlyIdempotent

체질량지수(BMI)를 계산하고 WHO 기준으로 분류한다. BMI = weight_kg / height_m^2, 입력은 미터와 킬로그램의 Decimal 문자열, 결과는 소수 2자리 HALF_EVEN 반올림. 분류는 underweight(<18.5), normal(<25), overweight(<30), obese_1(<35), obese_2(<40), obese_3(40 이상)이며 반올림한 값으로 판정한다. 신장을 cm 단위로 넣으면 결과가 100배 이상 어긋난다.

Inputs: height_m (required), weight_kg (required). Returns: bmi, _meta, trace, category

medical.bsaA
Read-onlyIdempotent

체표면적(BSA)을 m² 단위로 계산한다. 입력은 신장 cm, 체중 kg의 Decimal 문자열, 결과는 소수 4자리 HALF_EVEN 반올림. method=dubois(기본)는 0.007184 * h^0.725 * w^0.425, method=mosteller는 sqrt(h*w/3600). 항암제 용량 산정 등에 쓰며, 신장을 m 단위로 넣으면 결과가 크게 어긋난다. 비정수 지수는 float64로 계산한다.

Inputs: height_cm (required), weight_kg (required), method. Returns: _meta, trace, bsa_m2

medical.cha2ds2_vascA
Read-onlyIdempotent

심방세동 환자의 뇌졸중 위험 점수 CHA2DS2-VASc를 계산한다. C=울혈성심부전, H=고혈압, A2=75세 이상(2점), D=당뇨, S2=뇌졸중/TIA(2점), V=혈관질환, A=6574세(1점), Sc=여성. 총 09점이며 risk_level은 0점 low, 1점 moderate, 2점 이상 high. age는 0~130 정수, 나머지는 bool이어야 하고 문자열 'true'는 거부한다. 판단 보조용이며 임상 결정을 대신하지 않는다.

Inputs: age (required), female (required), chf, diabetes, +3 more. Returns: _meta, score, trace, risk_level

medical.dose_weight_basedA
Read-onlyIdempotent

체중 기반 약물 용량을 계산한다. dose = weight_kg * dose_per_kg, max_dose를 주면 초과 시 max_dose로 제한하고 capped=true를 돌려준다. 입력은 kg과 kg당 용량의 Decimal 문자열(0 이상), 결과는 소수 4자리 HALF_EVEN 반올림 후 후행 0을 제거한 고정소수점 문자열. unit은 표시용 문자열이며 환산하지 않는다. 단위가 다른 dose_per_kg와 max_dose를 섞으면 안 된다.

Inputs: weight_kg (required), dose_per_kg (required), unit, max_dose. Returns: dose, unit, _meta, trace, +1 more

medical.egfrA
Read-onlyIdempotent

혈청 크레아티닌으로 추정 사구체여과율(eGFR)을 CKD-EPI 2021(인종 계수 없음) 식으로 계산하고 KDIGO 2012 CKD 병기(G1~G5)를 돌려준다. 입력은 mg/dL Decimal 문자열, 정수 나이, sex=male|female. 결과 단위는 mL/min/1.73m², 소수 1자리 HALF_EVEN 반올림이며 병기는 반올림한 값으로 정한다. race 인자는 무시된다. 시스타틴 C 기반 식이나 소아 식에는 쓸 수 없다.

Inputs: age (required), sex (required), creatinine_mg_dl (required), race. Returns: egfr, _meta, stage, trace

medical.framingham_cvd_10yA
Read-onlyIdempotent

Framingham 일반 10년 심혈관질환 발생 확률을 계산한다(D'Agostino 2008 일반 CVD 모델). sex=male|female, age 3074 정수, total_chol과 hdl은 mg/dL, sbp는 mmHg(모두 Decimal 문자열), treated_htn, smoker, diabetes는 bool. risk는 01 확률(유효숫자 10자리), risk_pct는 백분율이다. 범위를 벗어난 나이에는 쓸 수 없다. float64 로그 회귀식이라 Decimal 정확 연산이 아니다.

Inputs: age (required), hdl (required), sbp (required), sex (required), +4 more. Returns: risk, _meta, trace, risk_pct

medical.has_bledA
Read-onlyIdempotent

항응고 치료 환자의 주요 출혈 위험 점수 HAS-BLED를 계산한다. H=고혈압, A=신장 또는 간 기능 이상(각 1점), S=뇌졸중, B=출혈력, L=불안정 INR, E=고령(65세 초과), D=약물 또는 음주(각 1점). 총 0~9점이며 risk_level은 2점 이하 low, 3점 이상 high. 아홉 항목을 모두 bool로 넣어야 하며 기본값이 없다. 판단 보조용이다.

Inputs: drugs (required), stroke (required), alcohol (required), elderly (required), +5 more. Returns: _meta, score, trace, risk_level

medical.pregnancy_weeksA
Read-onlyIdempotent

최종 월경일(LMP)로 임신 주수와 분만예정일(EDD)을 계산한다. 입력은 YYYY-MM-DD 문자열이며 reference_date를 생략하면 서버의 오늘 날짜를 쓴다. EDD = LMP + 280일(Naegele 법칙), 주수와 일수는 042주로 제한하고 삼분기(13)도 함께 반환한다. 초음파 계측으로 조정한 예정일은 반영하지 않는다.

Inputs: lmp_date (required), reference_date. Returns: edd, days, _meta, trace, +2 more

medical.qtc_bazettA
Read-onlyIdempotent

Bazett 공식으로 QT 간격을 심박수에 맞춰 보정한다. QTc = QT / sqrt(RR). qt와 rr은 Decimal 문자열이며 unit='ms'(기본) 또는 's'로 둘 다 같은 단위로 넣고, 결과 단위도 같다. 내부는 mpmath 40자리로 계산해 유효숫자 20자리 문자열로 돌려준다(반올림 소수 자릿수 고정 없음). 빠른 심박(RR 짧음)에서는 과대 보정되므로 그 구간엔 Fridericia를 고려한다.

Inputs: qt (required), rr (required), unit. Returns: qtc, unit, _meta, trace

medical.qtc_framinghamA
Read-onlyIdempotent

Framingham 선형 공식으로 QT 간격을 보정한다. QTc = QT + 0.154 * (1 - RR_초). qt와 rr은 Decimal 문자열이며 unit='ms'(기본) 또는 's'로 둘 다 같은 단위로 넣고, 내부에서 초로 환산해 계산한 뒤 입력 단위로 돌려준다. Decimal 정확 연산이며 반올림하지 않는다. RR을 심박수(bpm)로 넣으면 안 된다.

Inputs: qt (required), rr (required), unit. Returns: qtc, unit, _meta, trace

medical.qtc_fridericiaA
Read-onlyIdempotent

Fridericia 공식으로 QT 간격을 심박수에 맞춰 보정한다. QTc = QT / RR^(1/3). qt와 rr은 Decimal 문자열이며 unit='ms'(기본) 또는 's'로 둘 다 같은 단위로 넣고, 결과 단위도 같다. 내부는 mpmath 40자리로 계산해 유효숫자 20자리 문자열로 돌려준다. RR을 심박수(bpm)로 넣으면 안 된다. RR은 R-R 간격 시간이다.

Inputs: qt (required), rr (required), unit. Returns: qtc, unit, _meta, trace

medical.qtc_hodgesA
Read-onlyIdempotent

Hodges 공식으로 QT 간격을 심박수에 맞춰 보정한다. QTc_ms = QT_ms + 1.75 * (HR - 60), HR = 60 / RR_초. qt와 rr은 Decimal 문자열이며 unit='ms'(기본) 또는 's'로 둘 다 같은 단위로 넣고, 결과는 입력 단위로 돌려주며 계산에 쓴 심박수 hr_bpm도 함께 반환한다. Decimal 연산이며 반올림하지 않는다. RR 대신 심박수를 넣으면 안 된다.

Inputs: qt (required), rr (required), unit. Returns: qtc, unit, _meta, trace, +1 more

payroll.hourly_to_monthly_netA
Read-onlyIdempotent

시급(원, 문자열)을 월 환산시간(기본 209시간, 주 40시간과 주휴 포함)에 곱해 월급으로 바꾸고 원 미만을 버린 뒤 payroll.kr_salary 로 4대보험과 간이세액표 소득세를 공제한 실수령액을 구한다. 식대 비과세 한도, 공제대상가족 수, 8~20세 자녀 수(children_8_20)를 받는다. 주 40시간이 아닌 근로는 monthly_hours 를 직접 줘야 한다.

Inputs: year (required), hourly_wage (required), as_of, children_8_20, +4 more. Returns: net, _meta, taxes, trace, +13 more

payroll.kr_bonus_taxB
Read-onlyIdempotent

상여금 원천징수세액을 근로소득 간이세액표로 구한다. method=averaging(기본, 소득세법 제136조제1항제1호)은 상여를 지급대상기간 월수(1~12, 기본 12)로 안분해 월급여에 더한 간이세액에서 월급여 간이세액을 빼고 월수를 곱하며, simple 은 1개월분으로 본다. 금액은 원 문자열이고 세액은 원 미만 버림이다. 비과세 상여는 빼고 넣어야 한다.

Inputs: year (required), bonus_amount (required), monthly_salary (required), as_of, +5 more. Returns: _meta, bonus, trace, method, +15 more

payroll.kr_donation_deductionA
Read-onlyIdempotent

기부금 세액공제(소득세법 제59조의4제4항, 조세특례제한법 제76조)를 구한다. 근로소득금액(원 문자열) 기준 한도 안에서 특례·일반기부금 합계 1천만원 이하 15%, 초과 30%(특례 먼저), 정치자금 10만원까지 110분의 100과 초과분 15%(3천만원 초과분 25%)를 적용하고 원 미만 버린다. 고향사랑·우리사주 기부금은 한도 순서에만 반영하며 공제액은 계산하지 않는다. 종교단체 기부는 religious_donation 에 따로 넣어야 한다.

Inputs: year (required), earned_income (required), as_of, esop_donation, +7 more. Returns: _meta, trace, legal_limit, legal_credit, +17 more

payroll.kr_education_deductionA
Read-onlyIdempotent

교육비 세액공제(소득세법 제59조의4제3항)를 구한다. expenses 는 self, preschool, elementary, middle_high, university, disabled_special 별 지출액(원 문자열), counts 는 범주별 인원이다. 공제율 15%를 정책의 인당 한도(영유아·초중고 300만원, 대학 900만원, 본인·장애인 특수교육 무한도)에 인원을 곱한 한도까지 적용해 원 미만 버린다. 여러 자녀 지출을 한 범주에 합치고 counts 를 생략하면 1명분 한도만 적용된다.

Inputs: year (required), expenses (required), as_of, counts, +1 more. Returns: _meta, trace, per_category, total_credit, +8 more

payroll.kr_gross_from_netA
Read-onlyIdempotent

역산: 세후 월급(net_monthly, 원 문자열)에서 세전 월급을 구한다. payroll.kr_salary 의 실수령액이 목표 이상이 되는 가장 작은 정수 월급을 공제 합계의 고정점 반복으로 찾고, 달성한 실수령액과 차이(residual)를 함께 반환한다. 정확히 같은 실수령액이 불가능한 목표도 있으니 exact 를 확인하고, 연봉이 아닌 월 단위 실수령액을 넣어야 한다.

Inputs: year (required), net_monthly (required), as_of, children_8_20, +3 more. Returns: _meta, exact, gross, trace, +13 more

payroll.kr_health_income_premiumA
Read-onlyIdempotent

건강보험 직장가입자의 보수 외 소득월액보험료(국민건강보험법 제71조: 연 2천만원 초과분의 1/12, 근로·연금소득 50% 평가, 이자·배당 1천만원 이하 제외, 월 상한 4,591,740원)와 장기요양보험료, 보수총액 기준 보수월액보험료 연간 정산 차액과 분할납부 가능 여부를 계산한다. 소득은 소득 종류별 연간 소득금액(원 문자열), year 는 부과 또는 보수 귀속 연도, 원 미만 버림. 지역가입자 보험료 계산에 쓰면 오용이다.

Inputs: year (required), as_of, end_month, start_month, +10 more. Returns: _meta, trace, settlement, policy_sha256, +8 more

payroll.kr_housing_loan_deductionA
Read-onlyIdempotent

장기주택저당차입금 이자상환액 소득공제(소득세법 제52조제5항·제6항)의 공제 대상액을 구한다. 이자상환액(원 문자열), 상환기간(년), 고정금리와 비거치식 여부로 한도(15년 이상 고정금리+비거치식 2천만원 등)를 정해 그 이하만 인정하며, 10년 미만과 10~15년 변동·거치식은 0이다(limit_key 는 빈 문자열). 소득공제액이지 세액이 아니므로 세율을 곱해야 한다.

Inputs: year (required), term_years (required), is_non_grace (required), interest_paid (required), +3 more. Returns: _meta, limit, trace, limit_key, +10 more

payroll.kr_medical_deductionA
Read-onlyIdempotent

의료비 세액공제(소득세법 제59조의4제2항)를 구한다. 총급여(원 문자열)의 3% 미달분을 일반, 특수, 미숙아, 난임 순으로 차감한 뒤 일반 의료비 15%(연 700만원 한도), 본인·6세 이하·65세 이상·장애인 등 특수 15%(한도 없음), 미숙아 20%, 난임 30%를 적용하고 원 미만 버린다. 본인·65세 이상 의료비를 일반에 넣으면 700만원 한도가 걸린다.

Inputs: year (required), gross_income (required), general_medical (required), as_of, +4 more. Returns: _meta, trace, threshold, gross_income, +15 more

payroll.kr_minimum_wage_checkA
Read-onlyIdempotent

한국 최저임금 충족 여부를 검토한다(최저임금법 제5조·제6조, 시행령 제5조, 연도별 고시). wage_amount 는 wage_unit 단위의 매월 정기 지급 소정근로 임금(원)이고 월급은 주 40시간이면 209시간으로 시급 환산한다. 매월 주는 상여금과 현금 복리후생비는 산입 제외 비율(2024년부터 0%)을 빼고 더하며, 수습 감액 10%는 세 요건을 모두 줄 때만 적용한다. 비교는 정밀 값이고 부족액은 원 미만 올림이다. 연장·휴일·야간 수당, 연차 미사용수당, 현물 복리후생, 1개월 초과 주기 상여는 넣지 않는다. 도급제, 택시 운전, 적용 제외 인가는 다루지 않는다.

Inputs: year (required), wage_amount (required), as_of, wage_unit, +10 more. Returns: _meta, trace, compliant, inclusion, +21 more

payroll.kr_national_pension_benefitA
Read-onlyIdempotent

국민연금 노령연금 예상액을 국민연금법 제51조 기본연금액 산식(A값, 구간별 비례상수 2.4~1.29, 20년 초과 연 5% 가산), 제63조 가입기간별 지급률, 조기수령 월 0.5% 감액(최대 60개월), 연기 월 0.6% 가산(최대 60개월), 부양가족연금으로 계산한다. year 는 지급 개시 연도, 금액은 원 문자열, B는 b_value·monthly_income(현재 소득 유지 가정)·income_history(재평가율 적용) 중 하나. 월 지급액은 10원 미만 버리고 제53조 최고한도(평균 기준소득월액)를 적용한다. 크레딧과 재직자 감액은 빠지므로 공단 확정 연금액 대용으로 쓰면 오용이다.

Inputs: year (required), as_of, b_value, deferral_ratio, +8 more. Returns: _meta, trace, a_value, b_value, +26 more

payroll.kr_overtime_payA
Read-onlyIdempotent

한국 연장·야간·휴일근로수당을 계산한다(근로기준법 제56조, 시행령 제6조). ordinary_wage 는 통상임금(원)이고 wage_unit 으로 시급·일급·주급·월급을 고른다(월급은 주 40시간이면 209시간으로 환산). 시간은 Decimal 문자열이며 휴일근로는 하루별 목록으로 받아 8시간 이내 50%, 초과 100%를, 연장 50%와 야간(22~06시) 50%는 겹치면 더한다. employee_count 4명 이하는 가산 없이 근로시간분만 주고 금액은 원 미만 올림이다. 휴일근로 시간을 overtime_hours 에도 넣으면 이중 가산이다.

Inputs: year (required), ordinary_wage (required), employee_count (required), as_of, +9 more. Returns: _meta, hours, trace, base_pay, +16 more

payroll.kr_salaryA
Read-onlyIdempotent

세전 월급(원, 문자열)에서 한국 실수령액을 구한다. 비과세 식대 한도를 뺀 과세급여로 4대보험 근로자 부담분(국민연금 상·하한, 건강보험, 장기요양, 고용보험)과 근로소득 간이세액표 소득세, 지방소득세(소득세의 10%)를 공제하며 건강보험과 장기요양은 10원 미만 버림, 그 밖의 보험료는 원 미만 버림이고 지방소득세는 징수 끝수 규칙(국고금 관리법 제47조제1항 준용)으로 10원 미만 버림이다. 시행일별 정책을 as_of 로 고른다. 연봉을 월급 자리에 넣으면 안 된다.

Inputs: year (required), monthly_salary (required), as_of, children_8_20, +3 more. Returns: net, _meta, gross, taxes, +13 more

payroll.kr_severance_payA
Read-onlyIdempotent

퇴직소득세(소득세법 제48조·제55조)를 구한다. 퇴직급여총액, 근속연수(년, 소수 가능), 비과세액(원 문자열)에서 근속연수공제, 환산급여(12배 후 근속연수로 나눔)공제, 기본세율 누진을 적용하고 근속연수 비율로 환원해 원 단위 반올림한다. 1년 미만 끝수는 1년으로 올려 쓰며 지방소득세는 포함하지 않는다. 근속연수를 개월 수로 넣으면 안 된다.

Inputs: year (required), service_years (required), severance_amount (required), as_of, +2 more. Returns: tax, _meta, trace, severance, +16 more

payroll.kr_weekly_holiday_payA
Read-onlyIdempotent

한국 주휴수당을 계산한다(근로기준법 제55조제1항·제18조제3항, 시행령 제30조·별표 2). weekly_contract_hours 는 4주 평균 1주 소정근로시간, hourly_ordinary_wage 는 시간급 통상임금(원)이다. 15시간 이상, 소정근로일 개근, 그 주까지 근로관계 존속이면 주휴시간 = min(주 소정근로시간 / 통상 근로자 주 소정근로일 수, 8)에 시급을 곱하고 원 미만은 올린다. 시급제·일급제 근로자용이며 주휴분이 이미 포함된 월급에 더하면 이중 계산이다.

Inputs: year (required), hourly_ordinary_wage (required), weekly_contract_hours (required), as_of, +4 more. Returns: _meta, trace, eligible, holiday_hours, +12 more

payroll.kr_year_end_tax_settlementA
Read-onlyIdempotent

연말정산 환급 또는 추가납부액을 간이 모델로 구한다. 연간 총급여에서 근로소득공제, 인당 기본공제, 추가 소득공제를 뺀 과세표준에 소득세 누진세율을 적용하고 근로소득세액공제, 표준세액공제 13만원, 추가 세액공제를 차감해 결정세액(원 미만 버림)을 낸 뒤 기납부세액과 비교한다. 산출세액도 원 미만 버림이며 tax.kr_comprehensive_income_tax 와 같은 규칙이다. 의료비·교육비·기부금은 각 도구로 따로 구해 extra_* 로 넣어야 한다.

Inputs: year (required), prepaid_tax (required), annual_gross (required), as_of, +4 more. Returns: _meta, trace, refund, status, +17 more

pm.critical_pathA
Read-onlyIdempotent

작업 의존 관계로 주공정법(CPM) 일정을 계산해 각 작업의 ES, EF, LS, LF, 여유(slack)와 총 기간, 여유가 0인 주공정 작업 목록을 돌려준다. tasks는 {id, duration(Decimal 문자열, 0 이상, 단위 통일), predecessors(선행 id 목록)}의 리스트이며 결과는 위상 정렬 순서다. 반올림하지 않는다. 순환 의존이나 없는 선행 id는 오류이고, 작업 간 지연(lag)과 시작 제약은 지원하지 않는다.

Inputs: tasks (required). Returns: _meta, trace, task_details, critical_path, +1 more

pm.earned_scheduleA
Read-onlyIdempotent

획득일정(Earned Schedule) 지표를 계산한다. ES는 획득가치(EV)에 해당하는 계획 시점으로 pv_timeline을 선형 보간해 역산하고, SPI(t)=ES/AT, TSPI(t)=(PD-ES)/(PD-AT), IEAC(t)=PD/SPI(t). pv_timeline은 [{time, cumulative_pv}] 시간 오름차순에 누적 PV 비감소이며 모든 수는 Decimal 문자열, 시간 단위를 통일한다. AT와 PD는 양수여야 하고 PD와 AT가 같으면 TSPI는 0을 돌려준다. 반올림하지 않는다.

Inputs: actual_time (required), pv_timeline (required), earned_value (required), planned_duration (required). Returns: es, _meta, spi_t, trace, +2 more

pm.evmA
Read-onlyIdempotent

획득가치관리(EVM) 지표를 계산한다. SPI=EV/PV, CPI=EV/AC, SV=EV-PV, CV=EV-AC, EAC=BAC/CPI, ETC=EAC-AC, VAC=BAC-EAC. pv, ev, ac, bac는 같은 통화 단위의 Decimal 문자열이며 반올림 없이 Decimal 나눗셈 정밀도로 돌려준다. pv와 ac가 0이면 오류이고 bac는 양수여야 한다. EAC는 현재 비용 효율이 계속된다는 가정의 추정이며 etc_ 키는 예약어 회피용 이름이다.

Inputs: ac (required), ev (required), pv (required), bac (required). Returns: cv, sv, cpi, eac, +5 more

pm.monte_carlo_scheduleA
Read-onlyIdempotent

작업별 낙관, 최빈, 비관 추정으로 프로젝트 총 소요 시간의 분포를 몬테카를로로 시뮬레이션해 P10, P50, P90, 평균, 표본 표준편차를 돌려준다. tasks는 {id, optimistic, most_likely, pessimistic}(Decimal 문자열), n은 100 이상 1,000,000 이하 정수(기본 1000), seed 기본 0이면 결과가 재현된다. float64 계산이며 유효숫자 10자리 문자열이다. 작업 기간을 단순 합산하므로 병렬 경로나 선후 관계는 반영하지 않는다.

Inputs: tasks (required), n, seed. Returns: n, p10, p50, p90, +5 more

pm.pertA
Read-onlyIdempotent

단일 작업의 PERT 삼점 추정으로 기대 기간, 분산, 표준편차를 계산한다. E=(O+4M+P)/6, V=((P-O)/6)², 표준편차는 sqrt(V). 낙관, 최빈, 비관 값은 같은 시간 단위의 Decimal 문자열이며 낙관이 비관을 넘으면 오류다. 반올림하지 않고 표준편차만 유효숫자 30자리까지 구한다. 여러 작업의 합산 일정에는 critical_path 나 monte_carlo_schedule 을 쓴다.

Inputs: optimistic (required), most_likely (required), pessimistic (required). Returns: _meta, stdev, trace, expected, +1 more

probability.bayesA
Read-onlyIdempotent

베이즈 정리로 사후확률 P(A|B) = P(A)P(B|A)/P(B)를 구한다. prior, likelihood, marginal 은 [0, 1] 구간 십진 문자열이고 marginal 은 0 이 될 수 없으며 Decimal 50자리 정밀도로 계산한다. 입력 간 정합성(P(B) ≥ P(A)P(B|A))은 검사하지 않으므로 marginal 은 전체 확률 법칙으로 먼저 구해야 한다.

Inputs: prior (required), marginal (required), likelihood (required). Returns: 사후확률 P(A|B). Decimal 문자열.

probability.beta_cdfA
Read-onlyIdempotent

베타분포의 누적확률 P(X ≤ x) = I_x(α, β)를 구한다. x 는 [0, 1] 구간, alpha 와 beta 는 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. alpha 와 beta 를 서로 바꾸면 결과가 달라진다.

Inputs: x (required), beta (required), alpha (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.beta_pdfA
Read-onlyIdempotent

베타분포의 확률밀도 f(x; α, β)를 구한다. x 는 [0, 1] 구간, alpha 와 beta 는 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. 밀도값은 1 을 넘을 수 있고 확률이 아니다.

Inputs: x (required), beta (required), alpha (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.beta_ppfA
Read-onlyIdempotent

베타분포의 분위수를 구한다. q 는 0 초과 1 미만, alpha 와 beta 는 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. q 가 0 또는 1 이면 오류이며 결과는 [0, 1] 구간의 값이다.

Inputs: q (required), beta (required), alpha (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.binomial_cdfA
Read-onlyIdempotent

이항분포의 누적확률 P(X ≤ k; n, p)를 구한다. k 와 n 은 0 이상 정수(k ≤ n), p 는 [0, 1] 구간 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. 'k 회 이상'은 1 - cdf(k-1)로 구해야 하며 cdf(k)는 'k 회 이하'다.

Inputs: k (required), n (required), p (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.binomial_pmfA
Read-onlyIdempotent

이항분포의 확률질량 P(X=k; n, p)를 구한다. k 와 n 은 0 이상 정수(k ≤ n), p 는 [0, 1] 구간 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. 'k 회 이하' 확률이 필요하면 binomial_cdf 를 쓴다.

Inputs: k (required), n (required), p (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.chi_square_cdfA
Read-onlyIdempotent

카이제곱분포의 누적확률 P(X ≤ x)를 구한다. x 는 0 이상, df(자유도)는 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. 검정의 p 값은 1 에서 이 값을 뺀 오른쪽 꼬리다.

Inputs: x (required), df (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.chi_square_pdfA
Read-onlyIdempotent

카이제곱분포의 확률밀도를 구한다. x 는 0 이상, df(자유도)는 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. 밀도값이지 확률이 아니므로 누적확률은 chi_square_cdf 를 쓴다.

Inputs: x (required), df (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.chi_square_ppfA
Read-onlyIdempotent

카이제곱분포의 분위수를 구한다. q 는 0 초과 1 미만, df(자유도)는 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. 유의수준 α 의 임계값은 q 에 1-α 를 넣는다.

Inputs: q (required), df (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.expected_valueA
Read-onlyIdempotent

이산 확률변수의 기댓값 E[X] = Σ value_i * prob_i 를 구한다. values 와 probabilities 는 같은 길이의 십진 문자열 리스트이며 각 확률은 [0, 1], 합은 1 에서 1e-9 이내여야 한다. Decimal 50자리로 계산하며 연속분포에는 쓸 수 없다.

Inputs: values (required), probabilities (required). Returns: 기댓값 E[X]. Decimal 문자열.

probability.exponential_cdfA
Read-onlyIdempotent

지수분포의 누적확률 P(X ≤ x) = 1 - e^(-λx)를 구한다. x 는 0 이상, rate(λ)는 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. rate 에 평균(1/λ)을 넣으면 틀린다.

Inputs: x (required), rate (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.exponential_pdfA
Read-onlyIdempotent

지수분포의 확률밀도 f(x; λ) = λe^(-λx)를 구한다. x 는 0 이상, rate(λ)는 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. rate 에 평균(1/λ)을 넣으면 틀린다.

Inputs: x (required), rate (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.exponential_ppfA
Read-onlyIdempotent

지수분포의 분위수 x = -ln(1-q)/λ 를 구한다. q 는 0 초과 1 미만, rate(λ)는 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. rate 에 평균(1/λ)을 넣으면 틀린다.

Inputs: q (required), rate (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.factorialA
Read-onlyIdempotent

n!을 정확한 정수 문자열로 반환한다. n 은 0 이상 정수이며 상한은 20000(환경변수 SOOTOOL_LIMIT_COMBINATORICS_N 으로 조정), 1000 미만은 math.factorial, 이상은 mpmath 로 계산하며 반올림은 없다. 결과 자릿수가 매우 커서 float 로 변환하면 정밀도를 잃는다.

Inputs: n (required). Returns: 조합론 결과. 자릿수 제한 없는 정수 문자열.

probability.f_cdfA
Read-onlyIdempotent

F 분포의 누적확률 P(X ≤ x)를 구한다. x 는 0 이상, dfn 은 분자 자유도, dfd 는 분모 자유도(둘 다 양수 십진 문자열)이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. 검정의 p 값은 1 에서 이 값을 뺀 오른쪽 꼬리다.

Inputs: x (required), dfd (required), dfn (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.f_pdfA
Read-onlyIdempotent

F 분포의 확률밀도를 구한다. x 는 0 이상, dfn 은 분자 자유도, dfd 는 분모 자유도(둘 다 양수 십진 문자열)이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. dfn 과 dfd 를 바꾸면 결과가 달라진다.

Inputs: x (required), dfd (required), dfn (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.f_ppfA
Read-onlyIdempotent

F 분포의 분위수를 구한다. q 는 0 초과 1 미만, dfn 은 분자 자유도, dfd 는 분모 자유도(둘 다 양수 십진 문자열)이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. 유의수준 α 의 임계값은 q 에 1-α 를 넣는다.

Inputs: q (required), dfd (required), dfn (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.gamma_cdfA
Read-onlyIdempotent

감마분포의 누적확률 P(X ≤ x)를 구한다. x 는 0 이상, shape(k)는 양수, scale(θ, 기본 1)은 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. scale 은 rate 의 역수이므로 rate 를 그대로 넣으면 틀린다.

Inputs: x (required), shape (required), scale. Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.gamma_pdfA
Read-onlyIdempotent

감마분포의 확률밀도 f(x; k, θ)를 구한다. x 는 0 이상, shape(k)는 양수, scale(θ, 기본 1)은 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. scale 은 rate 의 역수이므로 rate 를 그대로 넣으면 틀린다.

Inputs: x (required), shape (required), scale. Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.gamma_ppfA
Read-onlyIdempotent

감마분포의 분위수를 구한다. q 는 0 초과 1 미만, shape(k)는 양수, scale(θ, 기본 1)은 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. scale 은 rate 의 역수이므로 rate 를 그대로 넣으면 틀린다.

Inputs: q (required), shape (required), scale. Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.lognormal_cdfA
Read-onlyIdempotent

로그정규분포의 누적확률 P(X ≤ x) = Φ((ln x - μ)/σ)를 구한다. x 는 양수, mu 와 sigma 는 ln X 의 평균과 표준편차(sigma 는 양수, 기본 0 과 1)이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. mu 와 sigma 에 X 자체의 통계량을 넣으면 틀린다.

Inputs: x (required), mu, sigma. Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.lognormal_pdfA
Read-onlyIdempotent

로그정규분포의 확률밀도를 구한다. x 는 양수, mu 와 sigma 는 ln X 의 평균과 표준편차(sigma 는 양수, 기본 0 과 1)이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. mu 와 sigma 는 X 자체의 평균과 표준편차가 아니다.

Inputs: x (required), mu, sigma. Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.lognormal_ppfA
Read-onlyIdempotent

로그정규분포의 분위수 exp(μ + σΦ⁻¹(q))를 구한다. q 는 0 초과 1 미만, mu 와 sigma 는 ln X 의 평균과 표준편차(sigma 는 양수, 기본 0 과 1)이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. mu 와 sigma 에 X 자체의 통계량을 넣으면 틀린다.

Inputs: q (required), mu, sigma. Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.nCrA
Read-onlyIdempotent

이항계수 C(n, r) = n!/(r!(n-r)!)을 정확한 정수 문자열로 반환한다. n, r 은 0 이상 정수(r ≤ n, n 상한 20000)이며 반올림은 없다. 순서를 구분하는 선택에 쓰면 r! 배 작게 나오므로 그 경우는 nPr 을 쓴다.

Inputs: n (required), r (required). Returns: 조합론 결과. 자릿수 제한 없는 정수 문자열.

probability.normal_cdfA
Read-onlyIdempotent

정규분포의 누적확률 P(X ≤ x)를 구한다. x, mu(평균, 기본 0), sigma(표준편차, 양수, 기본 1)는 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. sigma 에 분산을 넣으면 틀리므로 표준편차를 넣는다.

Inputs: x (required), mu, sigma. Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.normal_pdfA
Read-onlyIdempotent

정규분포의 확률밀도 f(x; μ, σ)를 구한다. x, mu(평균, 기본 0), sigma(표준편차, 양수, 기본 1)는 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. 밀도값이지 확률이 아니므로 구간 확률은 normal_cdf 의 차로 구한다.

Inputs: x (required), mu, sigma. Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.normal_ppfA
Read-onlyIdempotent

정규분포의 분위수 x = μ + σΦ⁻¹(q)를 구한다. q 는 0 초과 1 미만 확률, mu(기본 0), sigma(표준편차, 양수, 기본 1)이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. q 가 0 또는 1 이면 오류이고, 양측 임계값은 q 에 1-α/2 를 넣는다.

Inputs: q (required), mu, sigma. Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.nPrA
Read-onlyIdempotent

순열 P(n, r) = n!/(n-r)!을 정확한 정수 문자열로 반환한다. n, r 은 0 이상 정수(r ≤ n, n 상한 20000)이며 반올림은 없다. 순서를 구분하지 않는 선택에 쓰면 r! 배 크게 나오므로 그 경우는 nCr 을 쓴다.

Inputs: n (required), r (required). Returns: 조합론 결과. 자릿수 제한 없는 정수 문자열.

probability.poisson_cdfA
Read-onlyIdempotent

포아송분포의 누적확률 P(X ≤ k; λ)를 구한다. k 는 0 이상 정수, lam(λ)은 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. 'k 회 이상'은 1 - cdf(k-1)로 구해야 하며 cdf(k)는 'k 회 이하'다.

Inputs: k (required), lam (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

probability.poisson_pmfA
Read-onlyIdempotent

포아송분포의 확률질량 P(X=k; λ)를 구한다. k 는 0 이상 정수, lam(λ)은 양수 십진 문자열이며 scipy float64 계산 후 유효숫자 10자리로 반올림한 문자열을 반환한다. lam 은 관측 구간 길이에 맞춘 평균 발생 횟수여야 하며 단위 시간당 비율을 그대로 넣으면 틀린다.

Inputs: k (required), lam (required). Returns: 분포 함수(pdf, pmf, cdf, ppf) 값. float64 엔진 결과를 유효숫자 10자리 십진 문자열로 담는다.

realestate.kr_acquisition_taxA
Read-onlyIdempotent

한국 주택 유상취득 취득세와 농어촌특별세·지방교육세를 계산한다. 표준세율은 6억 이하 1%, 6억 초과 9억 이하 산식 세율, 9억 초과 3%이고, 조정 2주택·비조정 3주택 8%, 조정 3주택 이상·비조정 4주택 이상·법인 12% 중과세율이 표준세율을 대체한다. 금액은 원 단위 문자열, 세목별 원 미만 절사. 농어촌특별세는 전용 85㎡ 초과만 과세. 오용 예: house_count 에 취득 전 주택 수 입력.

Inputs: year (required), price (required), area_m2 (required), house_count (required), +5 more. Returns: _meta, trace, base_tax, total_tax, +13 more

realestate.kr_comprehensiveA
Read-onlyIdempotent

주택분 종합부동산세와 농어촌특별세(종부세의 20%)를 계산한다. 공시가격 합계(원)에서 기본공제 후 공정시장가액비율을 곱한 과세표준에 2주택 이하·3주택 이상 누진세율 또는 법인 단일세율을 적용하고, 재산세 상당액 공제, 1세대 1주택 연령·보유 세액공제, 세부담상한(직전 연도 총세액 입력 시)을 반영한다. policy_status 로 확정 전 개정안 여부를 확인. 오용 예: 토지분에 사용.

Inputs: year (required), house_count (required), total_published_price (required), age, +8 more. Returns: _meta, trace, base_tax, breakdown, +19 more

realestate.kr_dsrA
Read-onlyIdempotent

DSR(총부채원리금상환비율 = 연간 원리금 상환액 / 연간 소득, 원 단위 문자열)을 계산하고 한도 이내인지 판정한다. 소수 4자리 HALF_EVEN 반올림, 한도는 은행권 40%, 2금융권(is_nonbank) 50%. mortgage_region 을 주면 스트레스 금리 하한을 반환하지만 상환액에 가산해 주지는 않는다. 오용 예: 월 상환액과 연 소득을 섞어 입력.

Inputs: year (required), annual_income (required), annual_debt_payment (required), as_of, +3 more. Returns: cap, dsr, _meta, trace, +10 more

realestate.kr_dtiA
Read-onlyIdempotent

DTI(총부채상환비율 = 월 원리금 상환액 / 월 소득, 원 단위 문자열)를 계산하고 한도 이내인지 판정한다. 소수 4자리 HALF_EVEN 반올림, 규제지역 40%, 규제지역 외 수도권(아파트 담보) 60%, 수도권 외 비규제지역은 한도 없음(cap 이 null, within_cap 은 true). 오용 예: 연간 금액을 월 금액 자리에 입력.

Inputs: year (required), is_regulated (required), monthly_income (required), monthly_debt_payment (required), +3 more. Returns: cap, dti, _meta, trace, +9 more

realestate.kr_local_propertyA
Read-onlyIdempotent

광역자치단체(seoul, gyeonggi, busan, incheon, daegu, daejeon, gwangju, ulsan, sejong)별 주택 취득세 또는 재산세를 조례 가감 계수로 계산한다. mode 는 acquisition(취득가액) 또는 property(공시가격), 금액은 원 단위 문자열. 취득세와 부가분은 원 미만 절사, 재산세는 구간 세액 반올림 후 계수를 곱해 절사. 재산세 가감과 도시지역분은 자치구·시·군 조례 사항이라 광역 계수는 대표값이다. 오용 예: 구·군 단위 세율 확정에 사용.

Inputs: mode (required), year (required), price (required), region (required), +5 more. Returns: mode 에 따라 키가 다르다. acquisition 은 취득세 부가분, property 는 과세표준과 구간 내역을 더한다.

realestate.kr_ltvA
Read-onlyIdempotent

LTV(대출액 / 주택가액, 원 단위 문자열, 소수 4자리 HALF_EVEN)를 계산하고 한도 이내 여부와 최대 대출액을 구한다. 한도 비율은 규제지역·수도권, 주택 수, 생애최초 여부로 정해지며 규제지역·수도권 다주택은 추가 구입 0%다. 수도권·규제지역은 시가 15억 이하 6억, 25억 이하 4억, 초과 2억 금액 한도도 적용. 오용 예: house_count 에 대출 전 주택 수 입력.

Inputs: year (required), house_count (required), loan_amount (required), is_regulated (required), +5 more. Returns: ltv, _meta, trace, cap_rate, +11 more

realestate.kr_property_taxA
Read-onlyIdempotent

한국 주택 재산세(지방세법 §110~§111의2)와 지방교육세·도시지역분을 계산한다. 공시가격(원)에 공정시장가액비율(일반 60%, 1세대 1주택은 시가표준액 구간별)을 곱해 과세표준을 구하고, 직전 연도 공시가격을 주면 과세표준상한을 적용한다. 누진세율, 9억 이하 1세대 1주택은 특례세율. 재산세는 원 미만 반올림, 부가분은 절사. 오용 예: 토지·건축물에 사용.

Inputs: year (required), published_price (required), as_of, is_one_house, +3 more. Returns: _meta, trace, breakdown, total_tax, +15 more

realestate.kr_subscription_scoreA
Read-onlyIdempotent

주택공급에 관한 규칙 별표 1의 청약 가점제 점수(무주택기간 32, 부양가족 35, 청약저축 가입기간 17, 합계 84점)를 계산한다. 기간은 입주자모집공고일 현재 개월 수 정수, 부양가족은 인원 정수로 넣는다. 배우자 가입기간은 50%로 환산해 3점 한도로 합산하고 저축 점수는 17점 한도다. 주택 소유 세대나 만 30세 미만 미혼은 homeless_period_applicable=false 로 0점이다. 만 나이 전체를 무주택기간으로 넣는 것은 오용이며 30세 또는 혼인신고일부터 센다.

Inputs: year (required), dependents (required), savings_months (required), homeless_months (required), +4 more. Returns: _meta, trace, total_points, policy_sha256, +13 more

realestate.kr_transfer_taxA
Read-onlyIdempotent

한국 부동산 양도소득세를 tax.capital_gains_kr 에 위임해 계산하고 domain, module 표식을 붙인다. 금액은 원 단위 문자열, 세액은 decimals 자리 HALF_UP 반올림. is_one_house=true 는 주택(1세대 1주택 비과세·고가주택 안분·보유 거주 공제), false 는 주택 외 토지·건물로 처리한다. 오용 예: 다주택 주택 양도에 false 입력(중과·분양권·미등기는 tax.capital_gains_kr 직접 사용).

Inputs: year (required), sale_price (required), is_one_house (required), holding_years (required), +4 more. Returns: tax, gain, _meta, trace, +19 more

realestate.rental_yieldA
Read-onlyIdempotent

임대수익률을 백분율(%) 문자열로 계산한다. gross 는 연간 임대수입 / 매입가격, net 은 (연간 임대수입 - 연간 비용) / 매입가격이며 금액은 원 단위 문자열이다. rounding(기본 HALF_EVEN)으로 decimals(기본 2) 자리까지 반올림하고, 비용이 임대수입보다 크면 net 은 음수다. gross 는 비용을 보지 않는다. 오용 예: 월 임대료를 연 환산하지 않고 annual_rent 에 입력.

Inputs: annual_rent (required), property_price (required), decimals, rounding, +2 more. Returns: _meta, trace, yield_pct

science.battery_capacityA
Read-onlyIdempotent

배터리 용량을 Ah와 Wh 사이에서 변환한다. Wh = Ah * V, Ah = Wh / V. mode='ah_to_wh'(기본) 또는 'wh_to_ah', value는 0 이상, voltage는 양수(V)이며 Decimal 문자열이다. 나눗셈은 반올림하지 않는다. 직렬이나 병렬 구성 용량은 계산하지 않으므로 팩 전체 전압과 용량을 쌍으로 넣어야 한다.

Inputs: value (required), voltage (required), mode. Returns: unit, _meta, trace, result

science.braggA
Read-onlyIdempotent

브래그 회절 조건 n*lambda = 2 d sin(theta)에서 파장, 면간격, 회절각 중 하나를 구한다. order는 양의 정수이고 wavelength, spacing, angle 중 정확히 하나를 생략하며 나머지는 Decimal 문자열이다. 파장과 면간격은 같은 길이 단위로 넣고, angle은 unit='deg'(기본) 또는 'rad'이며 브래그각 theta 기준이다(2theta 아님). mpmath 40자리 계산 후 유효숫자 20자리로 돌려주며 sin theta가 1을 넘는 조합은 오류다.

Inputs: order (required), unit, angle, spacing, +1 more. Returns: unit, _meta, angle, trace, +2 more

science.faraday_electrolysisA
Read-onlyIdempotent

패러데이 법칙으로 전기분해 시 석출되는 질량(g)을 계산한다. m = (I * t * M) / (n * F). current_a는 암페어, time_s는 초, molar_mass_g는 g/mol(모두 양수 Decimal 문자열), n_electrons는 양의 정수. F=96485.33212 C/mol이며 반올림하지 않는다. 시간을 분이나 시간 단위로 넣으면 안 되고 전류 효율은 100%로 가정한다.

Inputs: time_s (required), current_a (required), n_electrons (required), molar_mass_g (required). Returns: _meta, trace, mass_g

science.half_lifeA
Read-onlyIdempotent

방사성 붕괴로 남은 양을 계산한다. N(t) = N0 x 0.5^(t/T). initial_amount는 양수, half_life는 양수, elapsed_time은 0 이상의 Decimal 문자열이며 half_life와 elapsed_time은 같은 시간 단위여야 한다. mpmath 50자리로 계산해 유효숫자 30자리 문자열로 돌려주며 남은 비율(fraction)도 함께 반환한다. 단위가 다른 반감기와 경과 시간을 섞으면 안 된다.

Inputs: half_life (required), elapsed_time (required), initial_amount (required). Returns: _meta, trace, fraction, remaining

science.ideal_gasA
Read-onlyIdempotent

이상 기체 법칙 PV = nRT에서 빠진 변수 하나를 계산한다. 압력 Pa, 부피 m³, 물질량 mol, 온도 K 중 정확히 3개를 Decimal 문자열로 주고 나머지는 생략한다. R = 8.314462618 J/(mol K)(CODATA 2018), Decimal 정확 연산이며 반올림하지 않는다. 계산값이 음수이거나 0으로 나누면 오류다. atm, L, 섭씨를 그대로 넣으면 안 되고 SI 단위로 환산해야 한다.

Inputs: moles, volume, pressure, temperature. Returns: _meta, moles, trace, volume, +2 more

science.intensityA
Read-onlyIdempotent

빛이나 복사의 세기(단위 면적당 전력)를 계산한다. I = P / A. power_w는 0 이상 와트, area_m2는 양수 제곱미터의 Decimal 문자열이며 결과 단위는 W/m^2, 반올림하지 않는다. 입사각에 따른 유효 면적 보정이나 파장별 분광 세기는 다루지 않는다. 면적을 cm² 단위로 넣으면 안 된다.

Inputs: area_m2 (required), power_w (required). Returns: unit, _meta, trace, intensity

science.molar_massA
Read-onlyIdempotent

화학식으로 몰질량(g/mol)을 계산하고 원소별 원자 수(composition)를 돌려준다. 원소 기호는 대소문자를 구분하며 괄호 Ca(OH)2, 수화물 CuSO4.5H2O 표기를 지원한다. IUPAC 2021 관례값 원자량을 Decimal로 합산하며 반올림하지 않는다. H~Pb 사이 일반 원소 27종만 지원하고 그 밖의 원소와 이온 전하 표기는 오류다.

Inputs: formula (required). Returns: _meta, trace, molar_mass, composition

science.nernstA
Read-onlyIdempotent

Nernst 방정식으로 비표준 조건의 전극 전위를 V 단위로 계산한다. E = E0 - (RT / nF) * ln(Q). e0(V)와 reaction_q(양수)는 Decimal 문자열, n은 양의 정수 전자수, temperature는 켈빈(기본 298.15). R=8.314462618, F=96485.33212를 쓰고 결과는 소수 20자리로 맞춘다. 섭씨 온도를 그대로 넣거나 Q 대신 ln(Q)를 넣으면 안 된다.

Inputs: n (required), e0 (required), reaction_q (required), temperature. Returns: e, unit, _meta, trace, +1 more

science.snell_lawA
Read-onlyIdempotent

스넬의 법칙으로 굴절각을 계산한다. n1 sin(theta1) = n2 sin(theta2), theta2 = asin(n1/n2 * sin(theta1)). n1, n2는 양수 굴절률, theta1은 입사각이며 모두 Decimal 문자열이다. unit='deg'(기본) 또는 'rad'이고 결과도 같은 단위다. mpmath 40자리 계산 후 유효숫자 20자리로 돌려준다. 전반사가 일어나는 입사각이면 오류이며 각도는 법선 기준이다(표면 기준 각을 넣으면 안 된다).

Inputs: n1 (required), n2 (required), theta1 (required), unit. Returns: unit, _meta, trace, theta2

science.stoichiometryA
Read-onlyIdempotent

균형 맞춘 반응식 계수로 한계 반응물을 찾고 각 물질의 몰수(mol)와 질량(g)을 계산한다. reactants는 {formula, mass(g) 또는 moles} 목록, products는 {formula} 목록, coefficients는 {화학식: 정수 계수}이며 수치는 Decimal 문자열이다. 몰질량은 molar_mass 와 같은 원자량을 쓰고 반올림하지 않는다. 계수가 균형 상태가 아니면 결과가 틀리며 수율이나 불순물은 반영하지 않는다.

Inputs: products (required), reactants (required), coefficients (required). Returns: _meta, moles, trace, masses, +1 more

science.thin_lensA
Read-onlyIdempotent

얇은 렌즈 방정식 1/f = 1/p + 1/q에서 빠진 값 하나(초점거리, 물체거리, 상거리)를 구하고 배율 m = -q/p도 돌려준다. 세 인자 중 정확히 2개를 Decimal 문자열로 주며 길이 단위는 통일한다. 반올림하지 않으며 0 거리나 평행광선(무한대) 조합은 오류다. 실상은 양, 허상은 음의 거리 부호 규약을 따르므로 부호를 맞춰 넣어야 한다.

Inputs: image_dist, object_dist, focal_length. Returns: _meta, trace, image_dist, object_dist, +2 more

sootool.policy_activateA
Destructive

[관리자] 검증을 통과한 초안을 덮어쓰기 저장소에 반영하고 캐시를 비우며 감사 기록을 남긴다. 검증 오류가 있는 초안은 validation_failed 로 거부하고, 관리자 모드가 아니면 admin_required 를 반환한다. 반영된 초안은 삭제된다.

Inputs: draft_id (required). Returns: name, year, _meta, error, +7 more

sootool.policy_diffA
Read-onlyIdempotent

정책 두 버전의 구간별 세율과 주요 값 변경을 비교한다. year_from 과 year_to 로 연도 간 비교하거나 draft_id 로 초안과 현재 시행본을 비교한다. 인자가 모자라거나 비교할 시행본이 없으면 error 필드로 알린다. 변경 이력은 sootool.policy_history 를 쓴다.

Inputs: name (required), domain (required), year_to, draft_id, +1 more. Returns: 비교할 수 없으면 ``error`` 만 있고, 비교했으면 나머지 필드가 있다.

sootool.policy_exportA
Read-onlyIdempotent

정책 하나를 이식 가능한 묶음(원본 YAML과 메타데이터)으로 내보낸다. domain, name, year 로 지정하고 as_of, include_proposed 로 버전을 고른다. include_signature 가 참이면 환경변수 SOOTOOL_POLICY_KEY_FILE 이 가리키는 키 파일(권한 0600)로 ed25519 서명을 붙인다. 묶음은 sootool.policy_import 가 받는다.

Inputs: name (required), year (required), domain (required), as_of, +2 more. Returns: _meta, bundle

sootool.policy_getA
Read-onlyIdempotent

정책 파일 하나의 내용(data)과 출처(package 또는 override), 버전 정보를 반환한다. domain, name, year 로 지정하고 as_of(YYYY-MM-DD)로 그날 시행 중인 버전을, include_proposed 로 확정 전 개정안까지 고를 수 있다. 존재하지 않는 연도를 지정하면 오류가 난다.

Inputs: name (required), year (required), domain (required), as_of, +1 more. Returns: data, name, year, _meta, +3 more

sootool.policy_historyA
Read-onlyIdempotent

정책 하나(domain, name)의 변경 감사 기록을 기록된 순서대로 반환한다. 항목마다 action(activate, rollback, import), 시각, audit_id, 변경 전후 sha256 이 있고 기록이 없으면 빈 목록이다. 정책 내용 자체는 sootool.policy_get 으로 본다.

Inputs: name (required), domain (required). Returns: name, _meta, count, domain, +1 more

sootool.policy_importA
Destructive

[관리자] sootool.policy_export 가 만든 묶음을 검증한 뒤 덮어쓰기 저장소에 반영한다. require_signature 와 public_key_b64 로 ed25519 서명을 검증하며 환경변수 SOOTOOL_POLICY_REQUIRE_SIGNATURE 가 켜져 있으면 서명이 필수다. 검증 오류는 validation_failed 로 거부하고, 관리자 모드가 필요하다.

Inputs: bundle (required), public_key_b64, require_signature. Returns: name, year, _meta, error, +6 more

sootool.policy_listA
Read-onlyIdempotent

패키지와 덮어쓰기 저장소의 모든 정책 파일 목록을 반환한다. 항목마다 영역, 이름, 연도, 출처(package 또는 override), 시행일, 종료일, 상태, sha256 이 있다. 인자가 없고 읽기 전용이며, 정책 내용이 필요하면 sootool.policy_get 을 쓴다.

Inputs: no named parameters. Returns: _meta, count, policies

sootool.policy_proposeA

[관리자] 정책 초안을 만든다. 6단계 검증 보고서와 전년도 대비 변경점을 반환하며 아직 시행되지 않는다. 관리자 모드(SOOTOOL_ADMIN_MODE=1)가 아니면 error=admin_required 를 반환한다. 초안은 expires_at 에 만료되고 반영은 sootool.policy_activate 로 한다.

Inputs: name (required), year (required), domain (required), yaml_content (required), +6 more. Returns: diff, name, year, _meta, +6 more

sootool.policy_rollbackA
Destructive

[관리자] 덮어쓰기 저장소의 정책 버전 파일을 지워 패키지 기본값으로 되돌린다. 같은 연도에 덮어쓴 버전이 여럿이면 effective_date(YYYY-MM-DD)로 고르며 지정하지 않으면 ambiguous_version 을 반환한다. 지울 파일이 없으면 rolled_back 이 false 다. 관리자 모드가 필요하다.

Inputs: name (required), year (required), domain (required), effective_date. Returns: name, year, _meta, error, +5 more

sootool.policy_validateA
Read-onlyIdempotent

정책 YAML 문자열을 검증해 보고서(status, findings, sha256)를 반환한다. name 을 주면 도메인 스키마까지 검사하고 파일은 저장하지 않는다. auto_fix_sha256 이 참이면 계산한 해시를 fixed_sha256 으로 알려 준다. 실제 반영은 sootool.policy_propose 와 sootool.policy_activate 를 쓴다.

Inputs: domain (required), yaml_content (required), name, auto_fix_sha256, +1 more. Returns: _meta, sha256, status, findings, +1 more

sootool.skill_guideA
Read-onlyIdempotent

에이전트용 능동 활용 가이드를 반환한다. section 은 triggers(호출 신호표), examples, anti_patterns, playbooks, all(기본) 중 하나이고 lang 은 ko 또는 en 이다. lang 을 생략하면 요청 언어와 SOOTOOL_LOCALE 환경변수를 거쳐 ko 로 정해진다. 세션을 시작할 때 한 번 읽는다.

Inputs: lang, section. Returns: _meta, locale, version, examples, +3 more

sootool.verify_receiptA
Read-onlyIdempotent

계산 영수증(_meta.integrity)을 재실행으로 검증한다. tool 과 arguments 로 같은 계산을 다시 실행해 입력 해시, 결과 해시, 도구 버전, 정책 해시를 대조하고, 서명이 있으면 public_key_b64 로 서명을 검증한다. valid 와 mismatches 를 반환한다. core.batch, core.pipeline 도 재실행 검증 대상이지만, 저장된 스냅샷에서 이어 실행하는 core.pipeline_resume 은 재현되지 않아 대상이 아니다.

Inputs: tool (required), receipt (required), arguments (required), public_key_b64, +1 more. Returns: _meta, trace, valid, warnings, +2 more

stats.anova_onewayA
Read-onlyIdempotent

둘 이상 집단의 평균 차이를 일원분산분석(one-way ANOVA)으로 검정하고 Tukey HSD 쌍별 비교를 덧붙인다. groups는 집단별 Decimal 문자열 목록(집단 2개 이상, 각 2개 이상), alpha는 유의수준 실수(기본 0.05), include_tukey 기본 True. 집단 크기가 다르면 Tukey-Kramer 방식이다. F는 유효숫자 6자리, 나머지는 10자리 문자열이다. 정규성과 등분산을 가정하므로 어긋나면 kruskal_wallis 를 쓴다.

Inputs: groups (required), alpha, include_tukey. Returns: _meta, alpha, trace, f_stat, +5 more

stats.bootstrap_ciA
Read-onlyIdempotent

표본 평균 또는 중앙값의 부트스트랩 신뢰구간을 백분위수법으로 구한다. values는 Decimal 문자열 2개 이상, statistic은 mean 또는 median, confidence는 0과 1 사이 실수(기본 0.95), n_resamples는 100 이상 100,000 이하(기본 1000), seed 기본 42로 같은 입력이면 결과가 재현된다. float64 계산 결과를 유효숫자 10자리 문자열로 돌려준다. 표본이 매우 작으면 구간이 불안정하다.

Inputs: values (required), seed, statistic, confidence, +1 more. Returns: n, seed, _meta, trace, +6 more

stats.chi_square_independenceA
Read-onlyIdempotent

분할표의 두 범주형 변수가 독립인지 카이제곱 검정으로 판정해 chi2, df, p_value, 기대빈도 표를 돌려준다. observed는 관측 빈도의 2x2 이상 Decimal 문자열 행렬이다. scipy 기본값에 따라 2x2 표에는 Yates 연속성 보정이 적용된다. 결과는 유효숫자 10자리 문자열이다. 비율 자료나 기대빈도가 5 미만인 칸이 많은 표에는 부적합하다.

Inputs: observed (required). Returns: df, chi2, _meta, trace, +2 more

stats.ci_meanA
Read-onlyIdempotent

표본 평균의 양측 신뢰구간을 t-분포로 계산해 mean, lower, upper를 돌려준다. values는 Decimal 문자열 2개 이상, confidence는 0과 1 사이 Decimal 문자열(기본 "0.95")이다. 표준오차는 표본 표준편차(ddof=1) 기반이며 float64 계산 결과를 유효숫자 10자리 문자열로 돌려준다. confidence에 95처럼 백분율을 넣으면 오류이고, 모집단 비율의 구간에는 쓸 수 없다.

Inputs: values (required), confidence. Returns: mean, _meta, lower, trace, +1 more

stats.cohens_dA
Read-onlyIdempotent

두 독립 표본의 효과크기 Cohen's d와 소표본 보정값 Hedges's g를 계산한다. d = (a 평균 - b 평균) / 풀드 표준편차이며 a 평균이 크면 양수다. a, b는 Decimal 문자열 각 2개 이상이고 풀드 표준편차가 0이면 오류다. 결과는 유효숫자 6자리 문자열이다. 대응표본(전후 비교)에는 쓰지 않는다.

Inputs: a (required), b (required). Returns: d, n_a, n_b, _meta, +2 more

stats.descriptiveA
Read-onlyIdempotent

숫자 목록의 기술통계량(n, mean, median, variance, stdev, min, max, q1, q3)을 계산한다. values는 Decimal 문자열 2개 이상, ddof 기본 1은 표본 분산과 표준편차, 0이면 모집단 값이다. q1과 q3는 numpy 선형 보간 백분위수이고 float64 계산 결과를 유효숫자 10자리 문자열로 돌려준다. 모집단 전체 자료에는 ddof=0을 지정해야 한다.

Inputs: values (required), ddof. Returns: n, q1, q3, max, +7 more

stats.eta_squaredA
Read-onlyIdempotent

일원분산분석의 효과크기 eta^2(편향 있음)와 omega^2(편향 보정)를 계산하고 F, p값, 자유도도 함께 돌려준다. groups는 집단별 Decimal 문자열 목록이며 집단 2개 이상, 각 집단 2개 이상이다. eta^2 = SS_between / SS_total, 효과크기와 F는 유효숫자 6자리, p값은 10자리 문자열이다. 표본이 작으면 eta^2가 과대 추정되므로 omega^2를 함께 본다.

Inputs: groups (required). Returns: _meta, trace, f_stat, p_value, +4 more

stats.kruskal_wallisA
Read-onlyIdempotent

독립 여러 집단의 분포 위치 차이를 순위 기반 Kruskal-Wallis H 검정으로 판정해 h_stat, p_value, df(집단 수-1)를 돌려준다. groups는 집단별 Decimal 문자열 목록이며 집단 2개 이상, 각 집단 1개 이상이다. 정규성 가정이 필요 없고 H는 유효숫자 6자리, p값은 10자리 문자열이다. 사후 쌍별 비교는 제공하지 않는다.

Inputs: groups (required). Returns: df, _meta, trace, h_stat, +1 more

stats.mann_whitney_uA
Read-onlyIdempotent

독립 두 표본의 분포 위치 차이를 순위 기반 Mann-Whitney U 검정으로 판정해 u_stat, p_value, n_a, n_b를 돌려준다. a, b는 Decimal 문자열 각 1개 이상, tail은 two(기본), less, greater이며 u_stat은 a 표본 기준이다. 정규성 가정이 필요 없고 u는 유효숫자 6자리, p값은 10자리 문자열이다. 같은 대상의 전후 측정에는 wilcoxon 을 쓴다.

Inputs: a (required), b (required), tail. Returns: n_a, n_b, _meta, trace, +2 more

stats.regression_linearA
Read-onlyIdempotent

최소제곱(OLS) 선형회귀로 계수, 절편, R², 계수별 p값, 잔차를 구한다. X는 표본 수 x 특징 수의 Decimal 문자열 행렬, y는 표본 수 길이의 목록이며 표본 수는 특징 수 + 절편 수보다 커야 한다. add_intercept 기본 True이고 False면 절편은 "0"이다. p_values는 절편을 제외한 계수 순서이며 float64 계산 결과를 유효숫자 10자리 문자열로 돌려준다. 범주형 변수는 수치로 부호화해 넣어야 한다.

Inputs: X (required), y (required), add_intercept. Returns: _meta, trace, p_values, intercept, +3 more

stats.ttest_one_sampleA
Read-onlyIdempotent

표본 평균이 기준값 popmean과 다른지 일표본 t-검정으로 판정해 t, df(n-1), p_value, ci_95를 돌려준다. values는 Decimal 문자열 2개 이상, popmean은 Decimal 문자열, tail은 two(기본), less, greater이며 p값은 방향에 맞게 scipy가 계산한다. ci_95는 방향과 무관한 표본 평균의 95% t-구간이다. t는 유효숫자 6자리, p값은 10자리 문자열이다. 두 집단 비교에는 ttest_two_sample 을 쓴다.

Inputs: values (required), popmean (required), tail. Returns: t, df, _meta, ci_95, +2 more

stats.ttest_pairedA
Read-onlyIdempotent

같은 대상의 전후 측정 등 대응표본의 평균 차이를 t-검정으로 판정해 t, df(n-1), p_value, ci_95(a 평균 - b 평균의 95% 구간)를 돌려준다. a, b는 같은 길이의 Decimal 문자열 목록(2개 이상)이고 같은 위치끼리 짝이다. tail은 two(기본), less, greater. t는 유효숫자 6자리, p값은 10자리다. 서로 다른 대상의 두 집단에는 ttest_two_sample 을 쓴다.

Inputs: a (required), b (required), tail. Returns: t, df, _meta, ci_95, +2 more

stats.ttest_two_sampleA
Read-onlyIdempotent

독립 두 표본의 평균 차이를 t-검정으로 판정해 t, df, p_value, ci_95(a 평균 - b 평균의 95% 구간)를 돌려준다. a, b는 Decimal 문자열 각 2개 이상, equal_var 기본 False는 Welch 검정(df는 소수 가능)이고 True면 Student 검정이다. tail은 two(기본), less, greater이며 df는 문자열이다. 같은 대상의 전후 측정에는 ttest_paired 를 쓴다.

Inputs: a (required), b (required), tail, equal_var. Returns: t, df, _meta, ci_95, +2 more

stats.wilcoxonA
Read-onlyIdempotent

Wilcoxon 부호순위 검정으로 대응표본의 차이 또는 단일 표본의 0 기준 위치 이동을 판정해 w_stat, p_value, n을 돌려준다. b를 주면 a와 b는 같은 길이(1개 이상)의 짝지은 Decimal 문자열 목록이고, b를 생략하면 a 자체를 차이값으로 보고 0과 비교한다. tail은 two(기본), less, greater. w는 유효숫자 6자리, p값은 10자리 문자열이다. 독립 두 집단에는 mann_whitney_u 를 쓴다.

Inputs: a (required), b, tail. Returns: n, _meta, trace, w_stat, +1 more

symbolic.diffA
Read-onlyIdempotent

sympy 로 n차 기호 도함수를 구하고, variables 로 값을 치환하면 그 지점의 수치를 Decimal 문자열(50자리)로 함께 반환한다. var 는 미분 변수, order 는 1~20(기본 1). variables 가 없거나 치환 후에도 기호가 남거나 numeric_eval=false 이면 numeric 은 null 이다. 연산은 5초로 제한되며 sympy extra 가 필요하다.

Inputs: var (required), expression (required), order, variables, +1 more. Returns: _meta, trace, numeric, derivative

symbolic.solveA
Read-onlyIdempotent

sympy 로 방정식을 기호 풀이한다. equation 은 'lhs = rhs' 또는 단일식(=0 가정), var 는 풀 변수이며 variables 값은 풀기 전에 치환한다. solutions 에는 실수해만 50자리 Decimal 문자열로 담기고(소수 리터럴과 variables 값은 정확한 유리수로 해석), 복소해와 기호해는 symbolic 에만 담기며 numeric_eval=false 면 solutions 는 빈 리스트다. 연산은 5초로 제한되며 sympy extra 가 필요하다.

Inputs: var (required), equation (required), variables, numeric_eval. Returns: _meta, trace, symbolic, solutions

tax.capital_gains_krA
Read-onlyIdempotent

한국 양도소득세를 계산한다(소득세법 제89조·제95조·제103조·제104조). 금액은 원 단위 Decimal 문자열, 보유·거주 기간은 만 년 정수다. 1세대1주택 비과세와 12억 초과 고가주택 안분, 장기보유특별공제(표 1, 보유·거주 표 2), 기본공제 250만원, 단기보유·분양권·비사업용 토지·미등기·조정대상지역 다주택 중과 세율 중 해당 경로의 큰 세액을 적용한다. 세액은 decimals(기본 0)자리 HALF_UP 이고 지방소득세는 포함하지 않는다. 보유 2년 이상 다주택 중과 제외 판정에는 transfer_date 가 필요하다.

Inputs: year (required), sale_price (required), is_one_house (required), holding_years (required), +12 more. Returns: tax, gain, _meta, trace, +17 more

tax.kr_comprehensive_income_taxA
Read-onlyIdempotent

종합소득세 신고 흐름(소득금액 합산, 종합소득공제, 과세표준, 산출세액, 세액공제, 결정세액, 지방소득세 10%)을 계산한다. 금액은 원 단위 Decimal 문자열, year 필수, 원 미만 버림. 근로(총급여), 사업, 이자·배당(2천만원 초과 시 배당가산 10%, 제62조 비교과세, 배당세액공제), 연금(총연금액), 기타소득(60% 의제경비, 300만원 이하 분리과세)을 받는다. 결손금 통산, 중간예납·기납부세액, 외국납부세액공제는 계산하지 않고 특별공제는 합계로 넣는다. 근로소득만 있는 연말정산에는 payroll.kr_year_end_tax_settlement 를 쓴다.

Inputs: year (required), as_of, dependents, total_salary, +22 more. Returns: _meta, notes, trace, total_tax, +38 more

tax.kr_corporateA
Read-onlyIdempotent

한국 법인세를 계산한다(법인세법 제55조, 조세특례제한법 제132조). taxable_income 은 과세표준(원, Decimal 문자열)이고 누진 구간 산출세액(base_tax)에서 reductions 를 빼되 최저한세에 미달하는 감면은 배제해 tax 를 정한다. is_small_rental_corp 는 제55조제1항제2호 세율, is_small 과 sme_graduation_period 는 최저한세율을 바꾼다. 감면 전 과세표준이 다르면 pre_deduction_income 을 따로 넣어야 최저한세가 맞는다.

Inputs: year (required), taxable_income (required), as_of, decimals, +7 more. Returns: tax, _meta, trace, base_tax, +14 more

tax.kr_education_tax_addA
Read-onlyIdempotent

한국 지방교육세를 본세 x 부가세율로 계산한다(지방세법 제151조). base_tax 는 재산세·취득세·등록면허세 등 본세액(원, 0 이상 Decimal 문자열), rate 기본 0.20(0 이상 1 이하), rounding 기본 DOWN, decimals 기본 0이라 원 미만을 버린다. 본세마다 세율이 다르므로 rate 를 확인하지 않고 기본값을 쓰면 틀릴 수 있다.

Inputs: base_tax (required), rate, decimals, rounding. Returns: rate, _meta, trace, base_tax, +1 more

tax.kr_eitcA
Read-onlyIdempotent

한국 근로장려금(조특법 §100의3·§100의5·§100의7) 산정. year 는 소득 귀속연도, 금액은 원 단위 숫자 문자열. 가구유형(single/one_earner/dual_earner)과 부부의 근로 총급여액, 사업 총수입금액(업종별 조정률 적용), 종교인소득, 재산 합계액으로 요건을 판정하고 시행령 별표 11 산정표 금액에 재산 1.7억원 이상 50%, 기한 후 95% 감액과 최소지급액 규칙을 적용한다. 산정표가 천원 단위라 별도 반올림은 없다. 자녀장려금, 반기 신청, 체납 충당, 국적·부양자녀·전문직 요건은 판정하지 않는다. 사업소득에 필요경비를 뺀 소득금액을 넣는 것은 오용이다.

Inputs: year (required), household_type (required), property_total (required), as_of, +9 more. Returns: year, _meta, trace, section, +27 more

tax.kr_giftA
Read-onlyIdempotent

한국 증여세를 계산한다(상속세및증여세법 제53조·제53조의2·제56조·제57조·제69조). 금액은 원 단위 Decimal 문자열이다. 관계별 증여재산공제에서 10년 내 기공제액을 빼고, marriage_birth_gift=true 이면 직계존속 증여에 혼인·출산 공제 1억을 더하며, 10~50% 누진세율에 generation_skip=true 일 때 세대생략 할증(30%, 미성년 20억 초과 40%)과 기한 내 신고세액공제 3%를 반영한다. tax 는 신고세액공제 전 금액이고 공제 후는 tax_after_filing_credit 이다. 10년 내 기공제액은 prior_deduction_used_10y 로 직접 넣는다.

Inputs: year (required), gift_amount (required), relationship (required), as_of, +8 more. Returns: tax, _meta, trace, breakdown, +19 more

tax.kr_incomeA
Read-onlyIdempotent

한국 종합소득세·근로소득세 산출세액을 소득세법 제55조 기본세율(6~45% 누진, 정책 YAML)로 계산한다. taxable_income 은 공제를 모두 뺀 과세표준(원, Decimal 문자열)이고 year 는 필수다. 구간별 세액과 실효·한계세율을 돌려주며 rounding(기본 HALF_UP)으로 decimals(기본 0)자리에 맞춘다. 근로소득공제와 세액공제는 반영하지 않으므로 총급여를 그대로 넣으면 안 된다.

Inputs: year (required), taxable_income (required), as_of, decimals, +2 more. Returns: tax, _meta, trace, breakdown, +10 more

tax.kr_inheritanceA
Read-onlyIdempotent

한국 상속세를 계산한다(상속세및증여세법 제18조제21조·제24조·제26조·제69조). 금액은 원 단위 Decimal 문자열이다. 기초·인적공제와 일괄공제 5억 중 큰 금액, 배우자공제(법정상속분 한도와 30억 중 작은 값, 최소 5억), 공제 종합한도를 적용한 뒤 1050% 누진세율로 산출하고 세대생략 할증(제27조, 산출세액 x 받은 재산 비율 x 30%, 미성년 20억 초과 40%)을 더한 뒤 신고세액공제 3%를 따로 보여 준다. gross_estate 는 사전증여 가산 후 과세가액이며 할증 비율의 분모다. 배우자가 있으나 상속받지 않았으면 has_spouse=true 를 지정한다.

Inputs: year (required), gross_estate (required), spouse_inheritance (required), as_of, +17 more. Returns: tax, _meta, trace, breakdown, +17 more

tax.kr_local_income_taxA
Read-onlyIdempotent

한국 개인 지방소득세를 소득세 본세의 10% 고정 비율로 계산한다(지방세법 제92조). income_tax 는 이미 산출된 소득세액(원, 0 이상 Decimal 문자열)이며 rounding 기본 DOWN, decimals 기본 0이라 원 미만을 버린다. 과세표준이나 소득금액을 넣으면 안 되고 소득세 산출 후 그 세액을 넣어야 한다.

Inputs: income_tax (required), decimals, rounding. Returns: rate, _meta, trace, income_tax, +1 more

tax.kr_pension_incomeA
Read-onlyIdempotent

한국 사적연금(연금계좌) 인출 원천징수, 분리과세 판정, 연금소득공제를 계산한다(소득세법 제129조, 제14조, 제47조의2). 금액은 원 문자열이며 private_pension_amount 는 나이별 5·4·3%(종신 3%), deferred_retirement_amount 는 이연퇴직소득으로 연금외수령 세율의 70·60·50%, non_pension_withdrawal_amount 는 연금외수령 15%. 지방소득세 10% 별도, 원 미만 절사. 사적연금 연 1,500만원 이하 분리과세. 공적연금 간이세액표 원천징수는 계산하지 않으므로 공적연금 월 원천징수액 용도로 쓰면 오용이다.

Inputs: year (required), age, as_of, include_proposed, +8 more. Returns: _meta, notes, trace, policy_sha256, +27 more

tax.kr_registration_license_taxA
Read-onlyIdempotent

부동산 등기의 등록면허세와 지방교육세(20%)를 계산한다(지방세법 제28조제1항제1호, 제151조). 저당권, 전세권, 지상권, 지역권, 임차권, 경매신청, 가압류, 가처분, 가등기는 과세표준(원 문자열) × 2/1000, 6천원 미만이면 6천원이고 other 는 건당 6천원이다. 세액은 10원 미만 버림. 소유권 보존과 이전 등기는 취득세로 과세되므로 다루지 않는다. 임차권 과세표준을 보증금으로 넣는 것은 오용이며 월 임대차금액을 넣는다.

Inputs: year (required), registration_type (required), as_of, tax_base, +1 more. Returns: rate, _meta, trace, tax_base, +15 more

tax.kr_rural_special_taxA
Read-onlyIdempotent

한국 농어촌특별세를 계산한다(농어촌특별세법 제5조). mode=base 는 본세액 x 10%, mode=reduced 는 감면세액 x 20%이고 amount 는 해당 금액(원, 0 이상 Decimal 문자열)이다. rounding 기본 DOWN, decimals 기본 0이라 원 미만을 버린다. 과세표준이 아니라 본세 또는 감면액을 넣어야 하며 mode 를 바꾸면 세율이 달라진다.

Inputs: amount (required), mode, decimals, rounding. Returns: mode, rate, _meta, trace, +2 more

tax.kr_securities_transactionA
Read-onlyIdempotent

한국 주식 양도 시 증권거래세와 농어촌특별세를 계산한다(증권거래세법 제8조, 시행령 제5조 탄력세율, 농특세법 제5조). transfer_amount 는 양도가액(원), market 은 kospi, kosdaq, konex, k_otc(금융투자협회 장외), other(그 밖의 장외·비상장, 기본세율 0.35%). year 는 결제일 연도이며 2023~2026 을 지원한다. 세액은 원 미만 절사. 2026 코스피는 0.05%와 농특세 0.15%로 실효 0.20%. 대체거래소 거래와 비과세 양도는 반영하지 않는다. 체결일 연도로 year 를 넣는 것은 오용이다.

Inputs: year (required), market (required), transfer_amount (required), as_of, +1 more. Returns: _meta, trace, market, total_tax, +15 more

tax.kr_simplified_vatA
Read-onlyIdempotent

한국 간이과세자 부가가치세를 계산한다(부가가치세법 제46조·제61조·제63조·제69조). 금액은 원 단위 Decimal 문자열이다. 공급대가 x 업종별 부가가치율 x 10%에서 세금계산서등 수취분 0.5%와 신용카드 등 매출세액공제를 빼며, 공급대가가 4,800만원 미만이면 납부 면제로 0을 돌려준다. 모든 금액은 원 미만을 버리고 일반과세자 계산에는 쓸 수 없다. 간이과세 기준(1억4백만원) 초과여도 계산은 하며 threshold_exceeded 로만 표시하고, prior_year_supply 를 생략하면 당해 공급대가로 판정한다.

Inputs: year (required), supply_value (required), business_type (required), as_of, +5 more. Returns: _meta, trace, net_payable, vat_payable, +17 more

tax.kr_vehicle_taxA
Read-onlyIdempotent

한국 승용자동차 자동차세 연세액과 지방교육세(비영업용 30%)를 계산한다(지방세법 제127조, 제128조, 제151조). 배기량은 cc 정수, 차령기산일은 YYYY-MM-DD(보통 최초 신규등록일)이다. 비영업용은 차령 3년부터 연 5%, 최대 50% 경감하고 annual_payment 로 1월, 3월, 6월, 9월 연납 공제(이자율 5%)를 적용한다. 세액은 기분마다 10원 미만 버림. 승합, 화물, 특수차, 신규등록 일할계산, 조례 세율 조정은 다루지 않으며, 차령을 연식 차이로 넣으면 기산일 규칙과 어긋난다.

Inputs: year (required), as_of, business_use, vehicle_type, +4 more. Returns: _meta, trace, per_cc_rate, business_use, +22 more

tax.kr_withholding_simpleA
Read-onlyIdempotent

근로소득 월 원천징수세액을 소득세법 시행령 별표 2 간이세액표로 구한다. monthly_salary 는 비과세·학자금을 뺀 월급여액(원, Decimal 문자열)이며 천원 미만을 버려 [이상, 미만) 행을 찾고, 10,000천원 초과 산식, 공제대상가족 11명 초과 규정, 8세 이상 20세 이하 자녀 차감을 적용한다. 세액은 원 단위이며 지방소득세 10%는 포함하지 않는다. dependents 는 본인 포함 인원이고 연간 정산(연말정산)에는 쓰지 않는다.

Inputs: year (required), dependents (required), monthly_salary (required), as_of, +2 more. Returns: _meta, trace, lookup, table_tax, +10 more

tax.progressiveA
Read-onlyIdempotent

임의의 누진세율 구간표로 세액을 계산한다. taxable_income 은 0 이상의 Decimal 문자열, brackets 는 오름차순 {upper, rate} 목록이며 마지막 upper 는 null, rate 는 0.1 처럼 소수다. 구간은 하한 초과 상한 이하이고 구간별 세액 합계를 rounding(기본 HALF_UP)으로 decimals(기본 0)자리에 맞춘다. 법정 세율표를 직접 입력해 쓰면 개정을 반영하지 못하므로 정책을 읽는 kr_income 등을 우선 쓴다.

Inputs: brackets (required), taxable_income (required), decimals, rounding. Returns: tax, _meta, trace, breakdown, +2 more

tax_us.capital_gainsA
Read-onlyIdempotent

미국 연방 자본이득세를 계산한다. 장기(long)는 0%/15%/20% 구간을 신고 유형별로 적용하며 ordinary_taxable_income 위에 양도소득을 쌓아 과세하고, 단기(short)는 그 증가분에 일반 소득세율을 쓴다. apply_niit=true 이면 순투자소득세 3.8%를 더한다. 금액은 USD Decimal 문자열이고 기본은 소수 둘째 자리 HALF_UP이다. ordinary_taxable_income 을 생략하면 0으로 보므로 다른 소득이 있으면 반드시 넣어야 한다.

Inputs: gain (required), year (required), filing_status (required), magi, +7 more. Returns: tax, niit, term, _meta, +18 more

tax_us.federal_incomeA
Read-onlyIdempotent

미국 연방 소득세(일반 세율)를 계산한다. IRS 2025·2026 tax year, 7개 누진 구간, 4개 신고 유형이며 qualifying_surviving_spouse 는 공동 신고 표를 쓴다. 금액은 USD Decimal 문자열이고 기본은 소수 둘째 자리 HALF_UP이다. apply_standard_deduction=true 이면 taxable_income 을 AGI 로 보고 표준공제를 뺀다. 이미 공제를 뺀 과세표준에 true 를 주면 공제가 두 번 빠지고, 장기 양도소득이나 FICA 는 반영하지 않는다.

Inputs: year (required), filing_status (required), taxable_income (required), as_of, +4 more. Returns: tax, _meta, trace, breakdown, +13 more

tax_us.ficaA
Read-onlyIdempotent

미국 FICA 급여세(IRC 3101, 3111) 근로자·고용주 부담분과 자영업세 SECA(IRC 1401, 순이익의 92.35%)를 과세연도 정책으로 계산한다. 금액은 USD 연간 합계 문자열, 세목별로 decimals 자리 반올림(기본 HALF_UP 2자리). 추가 Medicare 0.9%는 고용주 원천징수(20만 달러 초과)와 filing_status 별 신고 정산(25만/12.5만/20만)을 나눠 낸다. 사회보장 기준액은 고용주 한 곳 기준이며 복수 고용주 초과징수 환급, 선택적 계산법, RRTA, 배우자 자영업 소득 합산은 다루지 않는다. 오용 예: 급여 1회분을 연간 임금으로 넣기.

Inputs: year (required), mode, as_of, wages, +6 more. Returns: mode, _meta, trace, employee, +27 more

tax_us.state_taxA
Read-onlyIdempotent

미국 주 소득세를 계산한다(CA, NY, TX). 신고 유형별 누진 구간과 주별 표준공제를 반영하고 TX 는 소득세가 없어 0이다. NY 는 조정총소득(state_agi)이 107,650 을 넘으면 세액 환수(recapture) 워크시트를, CA 는 과세표준 1,000,000 초과분에 1% 가산세를 적용한다. 금액은 USD Decimal 문자열이고 기본은 소수 둘째 자리 HALF_UP이다. 연도별 지원 범위가 다르고(CA 2025), 지방세나 FICA 는 포함하지 않는다.

Inputs: year (required), state (required), filing_status (required), taxable_income (required), +6 more. Returns: tax, _meta, state, trace, +17 more

units.convertA
Read-onlyIdempotent

pint 로 물리 단위를 변환한다. magnitude 는 Decimal 문자열, from_unit 과 to_unit 은 pint 단위 이름(meter, foot, km 등)이고 차원이 다르거나 모르는 단위는 오류이다. 결과 magnitude 는 문자열이며 1E+3 같은 지수 표기가 나올 수 있다. 섭씨·화씨는 끝자리 오차가 생기므로 units.temperature 를 쓴다.

Inputs: to_unit (required), from_unit (required), magnitude (required). Returns: unit, _meta, trace, magnitude

units.data_size_convertA
Read-onlyIdempotent

데이터 크기 단위를 바이트 기준으로 변환한다. mode 'si'(b, B, kB, MB, GB, TB, PB, 1000 배, b 는 비트, 기본)와 'iec'(B, KiB, MiB, GiB, TiB, PiB, 1024 배)는 각 표의 단위만, 'mixed' 는 두 표를 함께 허용한다. magnitude 는 0 이상 Decimal 문자열이고 단위는 대소문자를 구분한다(KB 는 오류, kB 만 유효).

Inputs: to_unit (required), from_unit (required), magnitude (required), mode. Returns: unit, _meta, trace, magnitude

units.energy_convertA
Read-onlyIdempotent

에너지 단위를 J 기준 Decimal 계수로 변환한다. 지원 단위는 J, kJ, cal, kcal, eV, BTU, Wh, kWh 이며 대소문자를 구분하고 magnitude 는 Decimal 문자열이다. cal 은 열화학 칼로리(4.184 J)이고 결과는 magnitude 와 unit 이다. 목록에 없는 단위(MJ, 국제표 칼로리 등)는 오류이다.

Inputs: to_unit (required), from_unit (required), magnitude (required). Returns: unit, _meta, trace, magnitude

units.fx_convertA
Read-onlyIdempotent

amount * rate 를 to_ccy 의 소수 자릿수로 반올림해 amount(문자열)와 currency 를 반환한다. 자릿수는 JPY, KRW 등 0, USD 등 2, KWD 등 3 이고 표에 없는 통화는 2 이다. rounding 은 HALF_EVEN(기본), HALF_UP, DOWN, UP, FLOOR, CEIL. rate 는 from_ccy 에서 to_ccy 방향의 양수이며 환율을 조회하지는 않는다.

Inputs: rate (required), amount (required), to_ccy (required), from_ccy (required), +1 more. Returns: _meta, trace, amount, currency

units.fx_triangulateA
Read-onlyIdempotent

중간 통화를 거치는 삼각 환산 amount * rate1 * rate2 를 to_ccy 의 소수 자릿수로 한 번만 반올림해 amount(문자열)와 currency 를 반환한다. rate1 은 from_ccy 에서 via_ccy, rate2 는 via_ccy 에서 to_ccy 방향의 양수이며 중간 금액은 반올림하지 않는다. rounding 기본값은 HALF_EVEN 이다.

Inputs: rate1 (required), rate2 (required), amount (required), to_ccy (required), +3 more. Returns: _meta, trace, amount, currency

units.pressure_convertA
Read-onlyIdempotent

압력 단위를 Pa 기준 Decimal 계수로 변환한다. 지원 단위는 Pa, kPa, MPa, atm, bar, mbar, psi, mmHg, torr 이며 대소문자를 구분하고 magnitude 는 Decimal 문자열이다. 단순 배율 변환이라 게이지압과 절대압의 차이는 반영하지 않는다. 결과는 magnitude 와 unit 이다.

Inputs: to_unit (required), from_unit (required), magnitude (required). Returns: unit, _meta, trace, magnitude

units.temperatureA
Read-onlyIdempotent

섭씨(C), 화씨(F), 켈빈(K), 랭킨(R) 사이에서 온도를 변환한다. value 는 Decimal 문자열, from_scale 과 to_scale 은 대소문자 구분 없는 한 글자이며 결과는 value 와 대문자 scale 이다. 절대영도 미만 입력은 오류이다. 온도 차이(Δ)가 아닌 절대 온도 값 변환용이고, 5/9 계수는 유효 50자리로 근사한다.

Inputs: value (required), to_scale (required), from_scale (required). Returns: _meta, scale, trace, value

units.time_small_convertA
Read-onlyIdempotent

짧은 시간 단위 s, ms, us, ns, ps, min, hour, day 사이를 pint 로 변환한다. magnitude 는 Decimal 문자열이고 단위는 대소문자를 구분하며 1 day 는 86400 s 이다. 월과 연은 길이가 일정하지 않아 지원하지 않으므로 날짜 간격에는 datetime.diff 를 쓴다.

Inputs: to_unit (required), from_unit (required), magnitude (required). Returns: unit, _meta, trace, magnitude

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 286 tools

    Disambiguation4/5

    Each tool targets a narrowly defined calculation, and detailed descriptions clearly distinguish near-neighbors such as vat_add vs vat_extract or the many probability pdf/cdf/ppf variants. With 286 tools, however, several clusters still invite misselection (e.g., core.calc vs arithmetic helpers, multiple tax sub-calculators, many overlapping formula tools), so boundaries are mostly but not perfectly crisp.

    Naming Consistency4/5

    Almost all names use lower-case domain-prefixed snake_case (accounting.ratios, engineering.beam_deflection, tax.kr_gift), which is predictable and readable. Minor deviations such as probability.nCr and probability.nPr (camelCase) and a few mixed noun/verb styles prevent a perfect score.

    Tool Count1/5

    A 286-tool surface is far beyond what an agent can efficiently discover or select from, even for a broad multi-domain calculator. Many domains could be split into separate servers or exposed through a smaller router/guide surface.

    Completeness4/5

    The set covers an unusually wide range of domains with substantial depth: tax, finance, engineering, statistics, payroll, real estate, units, probability, and policy management. Some domains remain intentionally partial (e.g., only three US states, limited distributions, no FX rate lookup), but they are minor relative to the overall surface.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides exact, deterministic tools for math, dates, units, validation, and more to AI agents, returning precise answers with explicit assumptions and warnings instead of model guesses.
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to perform accurate local computations including arbitrary-precision math, date handling, unit conversion, subnet calculations, encoding, hashing, and text analysis, all without network calls or API keys.
      27
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables LLMs to run arbitrary-precision integer and bitwise operations, endianness swaps, IEEE 754 float decomposition, hashing/checksum/modular math, data codecs, statistics, and trigonometry through 29 specialized tools. Its chained batch execution engine lets multiple dependent steps run in one call, eliminating multi-turn round-trip overhead.
      29
      16 npm
      20
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables language models and users to perform exact arithmetic, symbolic math, unit/date conversions, statistics, and read-only SQL queries over registered files, with every operation logged by a citable ID that humans can re-run.
      11
      MIT