https://www.brainiac.software/api/v1/solar-design/string-sizing$0.03 USDCSize PV module strings for an inverter MPPT
Compute minimum and maximum modules per series string and maximum parallel strings per MPPT from module temperature coefficients, site temperatures and inverter DC limits.
Body
| Field | Required | Notes |
|---|---|---|
module | Yes | object; Object |
site | Yes | object; Object |
inverter | Yes | object; Object |
Request exampleJSON
{
"module": {
"voc": 49.9,
"vmp": 41.96,
"isc": 14,
"imp": 13.11,
"tempCoeffVoc": -0.128,
"tempCoeffVocUnit": "V_per_C",
"tempCoeffVmp": -0.003,
"tempCoeffVmpUnit": "fraction_per_C",
"tempCoeffIsc": 0.00728,
"tempCoeffIscUnit": "A_per_C",
"bifacialGain": 0
},
"site": {
"recordLowAmbient": -10,
"maxCellTemp": 70
},
"inverter": {
"maxDcVoltage": 1500,
"mpptMin": 500,
"mpptMax": 1300,
"maxInputCurrentPerMppt": 30,
"maxIscPerMppt": null
}
}Response exampleJSON
{
"vocAtTmin": 54.379999999999995,
"vmpAtTmax": 36.2954,
"vmpAtTmin": 46.3658,
"iscAtTmax": 14.3276,
"maxModulesBySystemVoltage": 27,
"minModulesByMppt": 14,
"maxModulesByMpptUpper": 28,
"recommendedRange": [
14,
27
],
"maxStringsPerMppt": 2,
"feasible": true,
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "pvlib python SPA / irradiance algorithms (BSD-3-Clause); NREL SPA Reda & Andreas 2004/2008; Perez et al. 1990",
"url": "https://github.com/pvlib/pvlib-python",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"recordLowAmbient is used as the cell temperature for Voc (night-to-dawn assumption).",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/string-sizing" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"module": {
"voc": 49.9,
"vmp": 41.96,
"isc": 14,
"imp": 13.11,
"tempCoeffVoc": -0.128,
"tempCoeffVocUnit": "V_per_C",
"tempCoeffVmp": -0.003,
"tempCoeffVmpUnit": "fraction_per_C",
"tempCoeffIsc": 0.00728,
"tempCoeffIscUnit": "A_per_C",
"bifacialGain": 0
},
"site": {
"recordLowAmbient": -10,
"maxCellTemp": 70
},
"inverter": {
"maxDcVoltage": 1500,
"mpptMin": 500,
"mpptMax": 1300,
"maxInputCurrentPerMppt": 30,
"maxIscPerMppt": null
}
}
JSONhttps://www.brainiac.software/api/v1/solar-design/dc-ac-ratio-check$0.03 USDCCheck DC/AC ratio and inverter clipping
Compute the DC/AC ratio and optionally estimate AC energy and clipping from a caller DC power series with constant efficiency or a PVWatts inverter curve.
Body
| Field | Required | Notes |
|---|---|---|
dcNameplateKw | Yes | number |
acRatingKw | Yes | number |
inverterEfficiency | No | number; Default: 0.96 |
dcPowerSeriesKw | No | array; Array |
intervalHours | No | number; Default: 1 |
ratioWarnAbove | No | number; Default: 1.3 |
useCecCurve | No | boolean; Default: false |
Request exampleJSON
{
"dcNameplateKw": 29.7,
"acRatingKw": 25,
"inverterEfficiency": 0.96,
"dcPowerSeriesKw": [
0,
2,
8,
15,
22,
27,
29,
27,
22,
15,
8,
2,
0
],
"intervalHours": 1,
"ratioWarnAbove": 1.3
}Response exampleJSON
{
"dcAcRatio": 1.188,
"warnings": [],
"acEnergyKwh": 165.24,
"clippedEnergyKwh": 4.679999999999996,
"clippingFraction": 0.02754237288135591,
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "PVWatts Version 5 Manual (Dobos 2014, NREL/TP-6A20-62641)",
"url": "https://www.nrel.gov/docs/fy14osti/62641.pdf",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"Without dcPowerSeriesKw only the nameplate DC/AC ratio is returned.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/dc-ac-ratio-check" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"dcNameplateKw": 29.7,
"acRatingKw": 25,
"inverterEfficiency": 0.96,
"dcPowerSeriesKw": [
0,
2,
8,
15,
22,
27,
29,
27,
22,
15,
8,
2,
0
],
"intervalHours": 1,
"ratioWarnAbove": 1.3
}
JSONhttps://www.brainiac.software/api/v1/solar-design/poa-irradiance-transpose$0.04 USDCTranspose GHI/DNI/DHI to plane-of-array irradiance
Compute plane-of-array irradiance with isotropic, Hay-Davies or Perez sky models and NREL SPA solar geometry from caller irradiance records.
Body
| Field | Required | Notes |
|---|---|---|
latitude | Yes | number |
longitude | Yes | number |
elevation | No | number; Default: 0 |
tilt | Yes | number |
azimuth | Yes | number |
albedo | No | number; Default: 0.2 |
model | No | string; One of: isotropic, haydavies, perez; Default: "perez" |
records | Yes | array; Array |
pressurePa | No | number; Default: 101325 |
temperatureC | No | number; Default: 12 |
deltaT | No | number; Default: 67 |
Request exampleJSON
{
"latitude": 51.5,
"longitude": -0.13,
"elevation": 0,
"tilt": 30,
"azimuth": 180,
"albedo": 0.2,
"model": "perez",
"records": [
{
"time": "2026-06-21T12:00:00Z",
"ghi": 800,
"dni": 600,
"dhi": 250
}
]
}Response exampleJSON
{
"records": [
{
"time": "2026-06-21T12:00:00Z",
"apparentZenith": 28.05788760207966,
"solarAzimuth": 178.86045677515926,
"aoi": 2.0192198013423734,
"dniExtra": 1321.6235925714136,
"poaGlobal": 894.160192475058,
"poaDirect": 599.6274382774938,
"poaSkyDiffuse": 283.8147865003193,
"poaGroundDiffuse": 10.717967697244903
}
],
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "pvlib python SPA / irradiance algorithms (BSD-3-Clause); NREL SPA Reda & Andreas 2004/2008; Perez et al. 1990",
"url": "https://github.com/pvlib/pvlib-python",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"Solar position uses NREL SPA as in pvlib method=nrel_numpy with bundled coefficient tables.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/poa-irradiance-transpose" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"latitude": 51.5,
"longitude": -0.13,
"elevation": 0,
"tilt": 30,
"azimuth": 180,
"albedo": 0.2,
"model": "perez",
"records": [
{
"time": "2026-06-21T12:00:00Z",
"ghi": 800,
"dni": 600,
"dhi": 250
}
]
}
JSONhttps://www.brainiac.software/api/v1/solar-design/energy-yield-estimate$0.04 USDCEstimate AC energy with PVWatts v5
Estimate AC energy from caller POA irradiance and temperatures using the PVWatts v5 DC and inverter models with a transparent loss stack.
Body
| Field | Required | Notes |
|---|---|---|
dcNameplateW | Yes | number |
gammaPdc | Yes | number |
acRatingW | Yes | number |
inverterNominalEfficiency | No | number; Default: 0.96 |
lossesPercent | No | number; Default: 14.08 |
temperatureModel | No | object; Object |
records | No | array; Array |
monthly | No | array; Array |
intervalHours | No | number; Default: 1 |
Request exampleJSON
{
"dcNameplateW": 29700,
"gammaPdc": -0.0034,
"acRatingW": 25000,
"inverterNominalEfficiency": 0.96,
"lossesPercent": 14.08,
"temperatureModel": {
"type": "pvsyst",
"uc": 29,
"uv": 0,
"alphaAbsorption": 0.9,
"moduleEfficiency": 0.1
},
"records": [
{
"time": "2026-06-21T12:00:00Z",
"poa": 800,
"ambientTemp": 20,
"windSpeed": 1
}
],
"intervalHours": 1
}Response exampleJSON
{
"records": [
{
"time": "2026-06-21T12:00:00Z",
"cellTemp": 42.3448275862069,
"pdc": 22358.815448275862,
"pdcAfterLosses": 19210.69423315862,
"pac": 18483.439181716883
}
],
"totalAcKwh": 18.483439181716882,
"lossStack": {
"totalPercent": 14.08
},
"accuracyNote": "interval_mode",
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "PVWatts Version 5 Manual (Dobos 2014, NREL/TP-6A20-62641)",
"url": "https://www.nrel.gov/docs/fy14osti/62641.pdf",
"retrievedAt": "2026-11-14",
"status": "ok"
},
"…"
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"PVWatts v5 DC and inverter models; cell temperature uses the PVsyst model when cellTemp is omitted.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/energy-yield-estimate" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"dcNameplateW": 29700,
"gammaPdc": -0.0034,
"acRatingW": 25000,
"inverterNominalEfficiency": 0.96,
"lossesPercent": 14.08,
"temperatureModel": {
"type": "pvsyst",
"uc": 29,
"uv": 0,
"alphaAbsorption": 0.9,
"moduleEfficiency": 0.1
},
"records": [
{
"time": "2026-06-21T12:00:00Z",
"poa": 800,
"ambientTemp": 20,
"windSpeed": 1
}
],
"intervalHours": 1
}
JSONhttps://www.brainiac.software/api/v1/solar-design/row-spacing$0.02 USDCCompute inter-row spacing and GCR
Compute row height, shadow gap, row pitch and ground coverage ratio that avoid row-to-row shading at a design sun position.
Body
| Field | Required | Notes |
|---|---|---|
moduleSlopeLength | Yes | number |
tilt | Yes | number |
arrayAzimuth | No | number; Default: 180 |
sun | No | object; Object |
designTimes | No | array; Array |
latitude | No | number |
longitude | No | number |
elevation | No | number; Default: 0 |
groundSlope | No | number; Default: 0 |
Request exampleJSON
{
"moduleSlopeLength": 2.278,
"tilt": 30,
"arrayAzimuth": 180,
"sun": {
"elevation": 20,
"azimuth": 140
},
"groundSlope": 0
}Response exampleJSON
{
"rowHeight": 1.1389999999999998,
"shadowGap": 2.3972416933258462,
"rowPitch": 4.370047563146798,
"gcr": 0.5212757909572157,
"sunElevation": 20,
"sunAzimuth": 140,
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "pvlib python SPA / irradiance algorithms (BSD-3-Clause); NREL SPA Reda & Andreas 2004/2008; Perez et al. 1990",
"url": "https://github.com/pvlib/pvlib-python",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"Spacing avoids row-to-row shading at the design sun position only; seasonal extremes should be checked separately."
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/row-spacing" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"moduleSlopeLength": 2.278,
"tilt": 30,
"arrayAzimuth": 180,
"sun": {
"elevation": 20,
"azimuth": 140
},
"groundSlope": 0
}
JSONhttps://www.brainiac.software/api/v1/solar-design/horizon-shading-loss$0.03 USDCEstimate far-field horizon shading losses
Estimate beam and isotropic sky-diffuse losses caused by a caller far-field horizon profile against sun positions and beam POA.
Body
| Field | Required | Notes |
|---|---|---|
horizon | Yes | array; Array |
records | No | array; Array |
latitude | No | number |
longitude | No | number |
elevation | No | number; Default: 0 |
times | No | array; Array |
beamPoa | No | array; Array |
Request exampleJSON
{
"horizon": [
{
"azimuth": 0,
"elevation": 10
},
{
"azimuth": 90,
"elevation": 10
},
{
"azimuth": 180,
"elevation": 10
},
{
"azimuth": 270,
"elevation": 10
}
],
"records": [
{
"sunElevation": 25,
"sunAzimuth": 160,
"beamPoa": 500
}
]
}Response exampleJSON
{
"beamLossFraction": 0,
"skyDiffuseLossFraction": 0.03015368960704569,
"blockedHours": 0,
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "pvlib python SPA / irradiance algorithms (BSD-3-Clause); NREL SPA Reda & Andreas 2004/2008; Perez et al. 1990",
"url": "https://github.com/pvlib/pvlib-python",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"Far-field horizon only; near-field objects closer than the array scale are not modelled.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/horizon-shading-loss" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"horizon": [
{
"azimuth": 0,
"elevation": 10
},
{
"azimuth": 90,
"elevation": 10
},
{
"azimuth": 180,
"elevation": 10
},
{
"azimuth": 270,
"elevation": 10
}
],
"records": [
{
"sunElevation": 25,
"sunAzimuth": 160,
"beamPoa": 500
}
]
}
JSONhttps://www.brainiac.software/api/v1/solar-design/system-loss-stack$0.01 USDCCombine PVWatts system loss percentages
Combine individual loss percentages into a total system loss using PVWatts multiplicative derating, with optional defaults for missing categories.
Body
| Field | Required | Notes |
|---|---|---|
losses | No | object; Default: {} |
useDefaultsForMissing | No | boolean; Default: true |
Request exampleJSON
{
"losses": {
"soiling": 2,
"shading": 3,
"snow": 0,
"mismatch": 2,
"wiring": 2,
"connections": 0.5,
"lid": 1.5,
"nameplate": 1,
"age": 0,
"availability": 3
},
"useDefaultsForMissing": true
}Response exampleJSON
{
"totalPercent": 14.075660688264469,
"derate": 0.8592433931173553,
"items": [
{
"name": "soiling",
"percent": 2,
"source": "caller"
},
{
"name": "shading",
"percent": 3,
"source": "caller"
},
"…"
],
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "PVWatts Version 5 Manual (Dobos 2014, NREL/TP-6A20-62641)",
"url": "https://www.nrel.gov/docs/fy14osti/62641.pdf",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"Losses combine multiplicatively per PVWatts v5: total = 100·[1 − Π(1 − l_i/100)]."
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/system-loss-stack" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"losses": {
"soiling": 2,
"shading": 3,
"snow": 0,
"mismatch": 2,
"wiring": 2,
"connections": 0.5,
"lid": 1.5,
"nameplate": 1,
"age": 0,
"availability": 3
},
"useDefaultsForMissing": true
}
JSONhttps://www.brainiac.software/api/v1/solar-design/battery-backup-sizing$0.03 USDCSize battery backup energy and inverter power
Size battery energy and inverter continuous/surge power needed to back up critical loads for a target autonomy with DoD and efficiency derates.
Body
| Field | Required | Notes |
|---|---|---|
loads | Yes | array; Array |
autonomyHours | Yes | number |
depthOfDischarge | Yes | number |
dischargeEfficiency | Yes | number |
temperatureDerate | No | number; Default: 1 |
inverterMargin | No | number; Default: 1.25 |
pvRechargeKwhPerDay | No | number; Default: 0 |
simultaneousStart | No | boolean; Default: false |
Request exampleJSON
{
"loads": [
{
"name": "fridge+lights+router",
"powerKw": 2,
"hoursPerDay": 24,
"surgeKw": 6
}
],
"autonomyHours": 10,
"depthOfDischarge": 0.9,
"dischargeEfficiency": 0.95,
"temperatureDerate": 1,
"inverterMargin": 1.25,
"pvRechargeKwhPerDay": 0
}Response exampleJSON
{
"energyNeededKwh": 20,
"nominalCapacityKwh": 23.391812865497077,
"inverterContinuousKw": 2.5,
"inverterSurgeKw": 6,
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"temperatureDerate is a caller datasheet value; no battery thermal model is applied.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/battery-backup-sizing" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"loads": [
{
"name": "fridge+lights+router",
"powerKw": 2,
"hoursPerDay": 24,
"surgeKw": 6
}
],
"autonomyHours": 10,
"depthOfDischarge": 0.9,
"dischargeEfficiency": 0.95,
"temperatureDerate": 1,
"inverterMargin": 1.25,
"pvRechargeKwhPerDay": 0
}
JSONhttps://www.brainiac.software/api/v1/solar-design/tariff-savings$0.03 USDCEstimate bill savings under a TOU tariff
Compute bill savings from caller interval generation and load under a time-of-use tariff with export credit, net metering or no export value.
Body
| Field | Required | Notes |
|---|---|---|
intervalHours | No | number; Default: 1 |
loadKwh | Yes | array; Array |
generationKwh | Yes | array; Array |
importPrice | Yes | array; Array |
exportMode | No | string; One of: export_rate, net_metering_kwh, none; Default: "export_rate" |
exportPrice | No | number; Default: 0 |
fixedCharges | No | number; Default: 0 |
demandCharge | No | — |
billingPeriods | No | array; Array |
Request exampleJSON
{
"intervalHours": 1,
"loadKwh": [
0.5,
0.5,
0.5,
0.5,
0.5,
0.5,
0.5,
1.5,
1,
0.8,
0.8,
0.8,
0.9,
0.9,
0.8,
0.8,
1,
2,
2.5,
2,
1.5,
1,
0.7,
0.5
],
"generationKwh": [
0,
0,
0,
0,
0,
0,
0.2,
0.8,
1.5,
2.2,
2.8,
3,
3.1,
2.9,
2.4,
1.7,
0.9,
0.3,
0,
0,
0,
0,
0,
0
],
"importPrice": [
0.1,
0.1,
0.1,
0.1,
0.1,
0.1,
0.1,
0.25,
0.25,
0.25,
0.25,
0.25,
0.25,
0.25,
0.25,
0.25,
0.4,
0.4,
0.4,
0.4,
0.25,
0.1,
0.1,
0.1
],
"exportMode": "export_rate",
"exportPrice": 0.05,
"fixedCharges": 0,
"demandCharge": null
}Response exampleJSON
{
"billWithoutPv": 6.02,
"billWithPv": 2.9799999999999995,
"savings": 3.04,
"importKwh": 14,
"exportKwh": 12.8,
"selfConsumedKwh": 9,
"selfConsumptionRate": 0.4128440366972478,
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"Tariff prices and export rules are caller-supplied; no utility rate database is queried.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/tariff-savings" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"intervalHours": 1,
"loadKwh": [
0.5,
0.5,
0.5,
0.5,
0.5,
0.5,
0.5,
1.5,
1,
0.8,
0.8,
0.8,
0.9,
0.9,
0.8,
0.8,
1,
2,
2.5,
2,
1.5,
1,
0.7,
0.5
],
"generationKwh": [
0,
0,
0,
0,
0,
0,
0.2,
0.8,
1.5,
2.2,
2.8,
3,
3.1,
2.9,
2.4,
1.7,
0.9,
0.3,
0,
0,
0,
0,
0,
0
],
"importPrice": [
0.1,
0.1,
0.1,
0.1,
0.1,
0.1,
0.1,
0.25,
0.25,
0.25,
0.25,
0.25,
0.25,
0.25,
0.25,
0.25,
0.4,
0.4,
0.4,
0.4,
0.25,
0.1,
0.1,
0.1
],
"exportMode": "export_rate",
"exportPrice": 0.05,
"fixedCharges": 0,
"demandCharge": null
}
JSONhttps://www.brainiac.software/api/v1/solar-design/financial-payback$0.03 USDCCompute PV payback, NPV, IRR and LCOE
Compute simple payback, NPV, IRR and LCOE from capex, incentives, year-1 energy, degradation, O&M and price escalation.
Body
| Field | Required | Notes |
|---|---|---|
capex | Yes | number |
upfrontIncentives | No | number; Default: 0 |
year1EnergyKwh | Yes | number |
degradation | No | number; Default: 0.005 |
energyValuePerKwh | Yes | number |
energyEscalation | No | number; Default: 0.02 |
omPerYear | No | number; Default: 0 |
omEscalation | No | number; Default: 0.02 |
years | Yes | integer |
discountRate | Yes | number |
Request exampleJSON
{
"capex": 20000,
"upfrontIncentives": 3000,
"year1EnergyKwh": 9000,
"degradation": 0.005,
"energyValuePerKwh": 0.25,
"energyEscalation": 0.02,
"omPerYear": 200,
"omEscalation": 0.02,
"years": 25,
"discountRate": 0.05
}Response exampleJSON
{
"netCapex": 17000,
"year1CashFlow": 2050,
"npv": 16267.394915881545,
"irr": 0.12612992523272165,
"paybackYears": 7.889390667220237,
"lcoe": 0.1688917763747619,
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"Incentives are caller numbers; no tax-credit rules are encoded.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/financial-payback" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"capex": 20000,
"upfrontIncentives": 3000,
"year1EnergyKwh": 9000,
"degradation": 0.005,
"energyValuePerKwh": 0.25,
"energyEscalation": 0.02,
"omPerYear": 200,
"omEscalation": 0.02,
"years": 25,
"discountRate": 0.05
}
JSONhttps://www.brainiac.software/api/v1/solar-design/module-layout-fit$0.04 USDCFit modules onto a roof polygon
Maximise the number of modules on a roof-face polygon with caller setbacks, orientation, gaps and obstruction polygons.
Body
| Field | Required | Notes |
|---|---|---|
roof | Yes | array; Array |
setback | Yes | number |
module | Yes | object; Object |
gap | No | number; Default: 0.02 |
orientations | No | array; Default: ["portrait","landscape"]; Array |
obstructions | No | array; Default: []; Array |
gridOffsets | No | integer; Default: 10 |
Request exampleJSON
{
"roof": [
[
0,
0
],
[
10,
0
],
[
10,
6
],
[
0,
6
]
],
"setback": 0.5,
"module": {
"width": 1.134,
"height": 2.278
},
"gap": 0.02,
"orientations": [
"portrait",
"landscape"
],
"obstructions": [],
"gridOffsets": 10
}Response exampleJSON
{
"best": {
"orientation": "portrait",
"count": 14,
"rows": 2,
"columns": 7
},
"candidates": [
{
"orientation": "portrait",
"count": 14
},
{
"orientation": "landscape",
"count": 12
}
],
"placements": [
{
"x": 0.5,
"y": 0.5,
"w": 1.134,
"h": 2.278
},
{
"x": 1.654,
"y": 0.5,
"w": 1.134,
"h": 2.278
},
"…"
],
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"Roof polygon is treated in the roof plane (2D metres). Setbacks are caller-supplied; jurisdiction rules vary.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/module-layout-fit" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"roof": [
[
0,
0
],
[
10,
0
],
[
10,
6
],
[
0,
6
]
],
"setback": 0.5,
"module": {
"width": 1.134,
"height": 2.278
},
"gap": 0.02,
"orientations": [
"portrait",
"landscape"
],
"obstructions": [],
"gridOffsets": 10
}
JSONhttps://www.brainiac.software/api/v1/solar-design/nec-690-current$0.02 USDCCompute NEC 690.8 PV circuit current
Compute PV circuit maximum current and minimum conductor ampacity using NEC 690.8 125% factors for the selected code edition.
Body
| Field | Required | Notes |
|---|---|---|
edition | No | string; One of: 2017, 2020, 2023; Default: "2023" |
moduleIsc | Yes | number |
parallelStrings | No | integer; Default: 1 |
continuousFactor | No | number; Default: 1.25 |
Request exampleJSON
{
"edition": "2023",
"moduleIsc": 14,
"parallelStrings": 2,
"continuousFactor": 1.25
}Response exampleJSON
{
"maxCircuitCurrent": 35,
"minConductorAmpacity": 43.75,
"minOcpdRating": 43.75,
"perStringMaxCurrent": 17.5,
"edition": "2023",
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
},
{
"source": "NFPA 70 National Electrical Code §690.8 factors (2017/2020/2023 editions); formula cited only, NFPA text not vendored",
"url": "https://www.nfpa.org/codes-and-standards/nfpa-70-standard-development/70",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"Applies NEC 690.8(A)(1)(a)(1) and 690.8(B) 125% factors only; 2023 alternative methods are out of scope.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/nec-690-current" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"edition": "2023",
"moduleIsc": 14,
"parallelStrings": 2,
"continuousFactor": 1.25
}
JSONhttps://www.brainiac.software/api/v1/solar-design/module-spec-compare$0.02 USDCCompare module datasheet metrics
Normalise and compare module datasheet values for efficiency, W/m², temperature-adjusted power, price per watt and warranty retention.
Body
| Field | Required | Notes |
|---|---|---|
modules | Yes | array; Array |
referenceCellTemp | No | number; Default: 45 |
Request exampleJSON
{
"modules": [
{
"name": "A",
"pmax": 550,
"width": 1.134,
"height": 2.278,
"tempCoeffPmax": -0.34,
"price": 165,
"warrantyYear25Retention": 0.874
},
{
"name": "B",
"pmax": 430,
"width": 1.134,
"height": 1.762,
"tempCoeffPmax": -0.29,
"price": 140,
"warrantyYear25Retention": 0.889
}
],
"referenceCellTemp": 45
}Response exampleJSON
{
"modules": [
{
"name": "A",
"efficiency": 0.2129099290351851,
"wattsPerM2": 212.90992903518512,
"pricePerW": 0.3,
"pmaxAtRefTemp": 512.6,
"warrantyYear25Retention": 0.874,
"noct": null,
"pmaxNoct": null
},
{
"name": "B",
"efficiency": 0.21520358258912933,
"wattsPerM2": 215.20358258912933,
"pricePerW": 0.32558139534883723,
"pmaxAtRefTemp": 405.06,
"warrantyYear25Retention": 0.889,
"noct": null,
"pmaxNoct": null
}
],
"ranking": {
"efficiency": [
"B",
"A"
],
"wattsPerM2": [
"B",
"A"
],
"pricePerW": [
"A",
"B"
],
"pmaxAtRefTemp": [
"A",
"B"
],
"warrantyYear25Retention": [
"B",
"A"
]
},
"sources": [
{
"source": "Caller-supplied module, inverter, irradiance and site inputs processed locally",
"url": "https://www.brainiac.software/api/v1/solar-design",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"Efficiency = pmax/(1000·area) at STC. Optional NOCT values are reported separately and never mixed with STC.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/module-spec-compare" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"modules": [
{
"name": "A",
"pmax": 550,
"width": 1.134,
"height": 2.278,
"tempCoeffPmax": -0.34,
"price": 165,
"warrantyYear25Retention": 0.874
},
{
"name": "B",
"pmax": 430,
"width": 1.134,
"height": 1.762,
"tempCoeffPmax": -0.29,
"price": 140,
"warrantyYear25Retention": 0.889
}
],
"referenceCellTemp": 45
}
JSONhttps://www.brainiac.software/api/v1/solar-design/pan-ond-parse$0.02 USDCParse PVsyst PAN or OND text files
Parse PVsyst PAN (module) and OND (inverter) text files into nested raw JSON and a normalised datasheet object.
Body
| Field | Required | Notes |
|---|---|---|
fileType | Yes | string; One of: pan, ond |
content | Yes | string |
Request exampleJSON
{
"fileType": "pan",
"content": "PVObject_=pvModule\n Version=7.2\n PVObject_Commercial=pvCommercial\n Manufacturer=ET SOLAR\n Model=ET-M772BH550GL\n Width=1.134\n Height=2.278\n PNom=550.0\n Isc=14.0\n Voc=49.9\n Imp=13.11\n Vmp=41.96\n muISC=7.28\n muVocSpec=-128.0\n NCelS=72\n BifacialityFactor=0.7\n"
}Response exampleJSON
{
"raw": {
"PVObject_": {
"PVObject_": "pvModule",
"Version": 7.2,
"Flags": "$00900243",
"PVObject_Commercial": {
"PVObject_Commercial": "pvCommercial",
"Comment": "ET SOLAR",
"Flags": "$0041",
"Manufacturer": "ET SOLAR",
"Model": "ET-M772BH550GL",
"DataSource": "Manufacturer 2021",
"YearBeg": 2021,
"Width": 1.134,
"Height": 2.278,
"Depth": 0.035,
"Weight": 32,
"NPieces": 100,
"PriceDate": "06/04/22 12:39"
},
"Technol": "mtSiMono",
"NCelS": 72,
"NCelP": 2,
"NDiode": 3,
"SubModuleLayout": "slTwinHalfCells",
"FrontSurface": "fsARCoating",
"GRef": 1000,
"TRef": 25,
"PNom": 550,
"PNomTolUp": 0.9,
"BifacialityFactor": 0.7,
"Isc": 14,
"Voc": 49.9,
"Imp": 13.11,
"Vmp": 41.96,
"muISC": 7.28,
"muVocSpec": -128,
"muPmpReq": -0.34,
"RShunt": 300,
"Rp_0": 2000,
"Rp_Exp": 5.5,
"RSerie": 0.203,
"Gamma": 0.98,
"muGamma": -0.0001,
"VMaxIEC": 1500,
"VMaxUL": 1500,
"Absorb": 0.9,
"ARev": 3.2,
"BRev": 16.716,
"RDiode": 0.01,
"VRevDiode": -0.7,
"IMaxDiode": 30,
"AirMassRef": 1.5,
"CellArea": 165.1,
"SandiaAMCorr": 50,
"PVObject_IAM": {
"PVObject_IAM": "pvIAM",
"Flags": "$00",
"IAMMode": "UserProfile",
"IAMProfile": {
"IAMProfile": "TCubicProfile",
"NPtsMax": 9,
"NPtsEff": 9,
"LastCompile": "$B18D",
"Mode": 3,
"Point_1": [
0,
1
],
"Point_2": [
20,
1
],
"Point_3": [
30,
1
],
"Point_4": [
40,
0.99
],
"Point_5": [
50,
0.98
],
"Point_6": [
60,
0.96
],
"Point_7": [
70,
0.89
],
"Point_8": [
80,
0.66
],
"Point_9": [
90,
0
]
}
}
}
},
"normalized": {
"manufacturer": "ET SOLAR",
"model": "ET-M772BH550GL",
"pNom": 550,
"voc": 49.9,
"isc": 14,
"vmp": 41.96,
"imp": 13.11,
"muIscAPerC": 0.00728,
"muVocVPerC": -0.128,
"cellsSeries": 72,
"width": 1.134,
"height": 2.278,
"bifacialityFactor": 0.7,
"iamProfile": [
[
0,
1
],
[
20,
1
],
"…"
]
},
"sources": [
{
"source": "PVsyst PAN/OND text format parsed locally (pvlib iotools.read_panond behaviour)",
"url": "https://github.com/pvlib/pvlib-python",
"retrievedAt": "2026-11-14",
"status": "ok"
}
],
"limitations": [
"Outputs are design-stage calculations on caller-supplied inputs for human review. They are not engineering stamps, code…",
"Binary/legacy (pre-6.x) files are rejected as unsupported_format.",
"…"
]
}cURL
curl -i -X POST "https://www.brainiac.software/api/v1/solar-design/pan-ond-parse" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"fileType": "pan",
"content": "PVObject_=pvModule\n Version=7.2\n PVObject_Commercial=pvCommercial\n Manufacturer=ET SOLAR\n Model=ET-M772BH550GL\n Width=1.134\n Height=2.278\n PNom=550.0\n Isc=14.0\n Voc=49.9\n Imp=13.11\n Vmp=41.96\n muISC=7.28\n muVocSpec=-128.0\n NCelS=72\n BifacialityFactor=0.7\n"
}
JSON