# One-RC Thevenin Battery Piecewise-Current Polarization SOC & Voltage Simulator

> One-RC Thevenin Battery Piecewise-Current Polarization SOC & Voltage Simulator is a paid API for AI agents from detect.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-17).

Simulates a one-RC Thevenin battery model using zero-order hold current steps, computing Coulomb-counted SOC, exponential RC polarization, and terminal voltage at each time step given caller-supplied OCV polynomial and circuit parameters.

## Facts

- Endpoint: POST https://detect.halowerk.com/v1/F-TD2000-ENGINEERING-B002/one-rc-battery-piecewise-current-polarization-soc-voltage?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/one-rc-thevenin-battery-piecewise-current-polarization-soc-voltage-014c2a11
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JmMmB8UgfzkuBmeA3kICA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability one-rc-thevenin-battery-piecewise-current-polarization-soc-voltage-014c2a11 -d '<json body>'
```

Example prompt: Simulate a one-RC Thevenin battery with 50 Ah capacity, R0=0.01 Ω, R1=0.005 Ω, C1=5000 F, starting SOC of 1.0, zero initial polarization, OCV polynomial coefficients [3.2, 0.8, -0.5, 0.1], and three current steps: discharge at 10 A for 360 s, rest for 120 s, then charge at 5 A for 300 s — give me the SOC, polarization voltage, and terminal voltage at each step.

## When to prefer this

Use this endpoint when you need an exact, deterministic simulation of a one-RC Thevenin battery model with piecewise-constant current steps, where you already have identified circuit parameters (R0, R1, C1) and an OCV polynomial. It is ideal for BMS validation, charge/discharge profile analysis, or verification tasks requiring reproducible numeric results. It does not perform parameter identification, temperature correction, aging/fade modeling, or multi-RC simulation — choose other tools for those tasks.

## Known failure modes

- SOC exits [0,1] range during simulation — step returns 'unknown'
- OCV polynomial evaluation is singular or ill-conditioned — returns 'unknown'
- Input artifact exceeds 16000 bytes — rejected
- Steps array empty or missing required fields — validation error
- R0/R1/C1/capacity outside allowed min/max bounds — validation error
- OCV coefficients array length outside 1–8 — validation error
- More than 100 steps supplied — validation error

## How this service works

Exact zero-order hold current steps for explicit one-RC Thevenin battery; Coulomb SOC, exponential RC polarization, caller-supplied OCV polynomial, terminal voltage at each step. Constant coefficients, no temperature/fade/lifetime fitting; SOC exit returns unknown.

## Output

Returns the terminal voltage, Coulomb-counted SOC, and exponential RC polarization voltage at the end of each supplied current step, computed via exact zero-order hold integration of the one-RC Thevenin model using the caller-supplied OCV polynomial. Results are rounded to six decimal places. If SOC leaves the valid [0,1] domain or the system is ill-conditioned, returns 'unknown' for the affected step.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "artifact": {
   "type": "object",
   "required": [
    "battery"
   ],
   "properties": {
    "battery": {
     "type": "object",
     "required": [
      "data",
      "claim"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "capacity_Ah",
        "R0",
        "R1",
        "C1",
        "ocv_coefficients",
        "initial_soc",
        "initial_polarization",
        "steps"
       ],
       "properties": {
        "C1": {
         "type": "number",
         "maximum": 1000000,
         "minimum": 0.01
        },
        "R0": {
         "type": "number",
         "maximum": 10,
         "minimum": 0
        },
        "R1": {
         "type": "number",
         "maximum": 10,
         "minimum": 0.00001
        },
        "steps": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "duration",
           "current"
          ],
          "properties": {
           "current": {
            "type": "number",
            "maximum": 10000,
            "minimum": -10000
           },
           "duration": {
            "type": "number",
            "maximum": 100000,
            "minimum": 0
           }
          },
          "additionalProperties": false
         },
         "maxItems": 100,
         "minItems": 1
        },
        "capacity_Ah": {
         "type": "number",
         "maximum": 10000,
         "minimum": 0.01
        },
        "initial_soc": {
         "type": "number",
         "maximum": 1,
         "minimum": 0
        },
        "ocv_coefficients": {
         "type": "array",
         "items": {
          "type": "number",
          "maximum": 100,
          "minimum": -100
         },
         "maxItems": 8,
         "minItems": 1
        },
        "initial_polarization": {
         "type": "number",
         "maximum": 100,
         "minimum": -100
        }
       },
       "additionalProperties": false
      },
      "claim": {}
     },
     "additionalProperties": false
    }
   },
   "description": "UTF8 JSON artifact at most16000 bytes, computed result20000 bytes; unknown for derived out-of-domain, singular or ill-conditioned systems. Numeric result rounded six decimals. Exact zero-order hold current steps for explicit one-RC Thevenin battery; Coulomb SOC, exponential RC polarization, caller-supplied OCV polynomial, terminal voltage at each step. Constant coefficients, no temp
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/one-rc-thevenin-battery-piecewise-current-polarization-soc-voltage-014c2a11/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from detect.halowerk.com](https://www.zero.xyz/host/detect.halowerk.com/llms.txt)
