Modifier distributions
This page documents the mathematics that SunSolve Power evaluates in the browser for the Modifiers tab. When modifiers are configured as a population of cells, the interface previews the resulting open-circuit voltage () and fill-factor () distributions live, without a server round-trip, using a self-contained two-diode equivalent-circuit solve.
The preview is an approximation intended for interactive feedback. The authoritative electrical result is always produced by the backend solver described in Equivalent circuit model; the equations here cover only the client-side preview and the calibration that feeds it.
Throughout, current densities are written (A/cm²), the two ideality factors are and , and the specific resistances are and (Ω·cm²). The physical constants are the elementary charge , the Boltzmann constant , and a nominal cell temperature .
Modifiers as multipliers
Section link: Modifiers as multipliersEvery modifier stores a fractional multiplier rather than an absolute value. A multiplier of leaves a parameter unchanged; the Modifiers input page describes the user-facing convention.
The preview scales seven equivalent-circuit quantities per cell: , , , , , and . For a cell, each parameter’s effective value is its base value multiplied by the product of every multiplier that targets that cell for that parameter:
where is one of the seven parameters and is the multiplier contributed by the -th source (a targeted adjuster, or one draw from a distribution). Because the combination is a product, the multipliers are commutative: the order in which they are applied does not change the result.
Modifiers can be authored on a wider set of parameters than the preview understands. The enhanced-recombination diode (, , ) and every reverse-breakdown parameter are sampled alongside the rest and sent to the backend, but the preview’s two-diode solve has nowhere to put them and treats their multipliers as . A configuration that modifies only those parameters therefore leaves the previewed and distributions unchanged while still changing the backend result.
Distribution types and random sampling
Section link: Distribution types and random samplingIn population mode each parameter multiplier is a random variable. The preview draws one sample of each enabled parameter for every cell in a pooled population, then forward-solves that cell. The pool holds one cell per cell in the module, or 512 cells, whichever is larger, so that a small module still yields a legible histogram.
Deterministic random numbers
Section link: Deterministic random numbersAll randomness comes from a small, seeded pseudo-random number generator (mulberry32) that returns a uniform variate . The generator is fully deterministic: identical inputs always reproduce the same preview.
Each parameter stream is seeded independently so that different parameters and circuits do not correlate. For circuit index and parameter index the seed is mixed from a fixed base seed :
A single standard-normal variate (mean , standard deviation ) is obtained from two uniforms with the Box–Muller transform:
with floored away from exactly so the logarithm is always finite.
Drawing a multiplier from each distribution kind
Section link: Drawing a multiplier from each distribution kindA parameter field may use any of four distribution kinds. In each case the sampled multiplier is:
Fixed — a constant, with no randomness:
Top-hat (uniform between a lower and upper bound):
Its equivalent mean and standard deviation, used during calibration, are:
Gaussian (normal, parameterised by mean and standard deviation ):
Lognormal (parameterised by its own arithmetic mean and standard deviation ). The arithmetic moments are first converted to the underlying normal’s log-space parameters:
and the sample is then drawn in log space:
The lognormal is used for the diode saturation currents because they enter the diode equation through an exponential; a plain Gaussian there would place probability mass at physically impossible negative multipliers. For the Gaussian and lognormal kinds an optional lower and upper bound clamps each sample after it is drawn.
The equivalent-circuit preview solve
Section link: The equivalent-circuit preview solveFor each sampled cell the preview evaluates a two-diode equivalent circuit (a subset of the full multi-diode model in Equivalent circuit model, without the enhanced-recombination diode or reverse-bias breakdown).
The thermal voltage for a diode of ideality factor is:
The cell current density at an applied voltage satisfies the implicit two-diode relation, where is the junction voltage:
This equation is solved for at a given voltage by an iterative root-find. Two quantities are then derived per cell.
Open-circuit voltage is the voltage at which the current vanishes:
It is located with a bracketed root-find over the interval , which is guaranteed to contain .
Fill factor needs the maximum-power point, which is found by changing variables. Taking the junction voltage as the independent variable rather than the terminal voltage makes the current explicit, because then appears only in the terminal relation and not on the right-hand side:
The power density is then , and its derivative is available in closed form. The maximum is bracketed by construction: at the cell sits past short circuit at negative terminal voltage and the slope is positive, while at the current has fallen to zero and the slope is negative. Bisecting the slope over therefore converges on the peak, and the fill factor follows from the power there:
Because power is flat to first order at its peak, each halving of the bracket quarters the error in ; the preview stops after 18 halvings, by which point the residual error is far below the displayed precision. Locating the peak this way is both more accurate and cheaper than sweeping terminal voltage on a fixed grid, since a coarse grid can only ever underestimate a smooth maximum.
The sampled and values across the cell population form the two preview histograms. A sampled cell whose multipliers drive it outside the physical range — a non-positive , , , or , a negative , or a solve that returns no finite or — is discarded rather than plotted, and the interface reports how many cells were rejected.
Deriving equivalent-circuit distributions from Voc and FF
Section link: Deriving equivalent-circuit distributions from Voc and FFUsers typically know the spread of and they want to model rather than the spread of the underlying diode parameters. The derive from Voc/FF option lets them specify target and distributions (as multipliers over the circuit’s own nominal values) and calibrates two equivalent-circuit parameters to reproduce them. The target pair is either with , or with .
Target moments
Section link: Target momentsThe nominal and are the values the preview solve produces with both derived multipliers held at . Every other parameter contributes its authored point value at this step rather than the mean of its distribution, so the nominal pair describes one specific cell rather than the centre of the population. The absolute target moments are the nominal values scaled by the authored multiplier moments:
and likewise for .
Inverting the means
Section link: Inverting the meansdoes not have to be searched for. At open circuit no current flows, so drops out of the junction voltage and the two-diode relation reduces to a current balance in which is the only unknown:
Keeping the circuit’s own in this step is essential: a single-diode inversion would attribute the second diode’s share of the recombination to and inflate it.
The second parameter is then recovered from the target mean :
- For the – target, and both depend on , so the two are coupled. The closed form above resolves that coupling without iteration: it makes an exact function of along the constant- curve, leaving a one-dimensional root-find on alone. is monotonic in along that curve, so bisection settles it. The search runs on , because ranges over decades and a linear bracket would resolve small values far more coarsely than large ones.
- For the – target there is no coupling, because has no effect on (at open circuit no current flows through it). A single pass suffices: from , then from by bisection.
Each solved value is divided by the base value to become the derived multiplier, so a target equal to the circuit’s nominal and returns multipliers of .
Targets the circuit cannot reach
Section link: Targets the circuit cannot reachThe constant- curve has two ends, and they bound what the cell can produce. Raising to
drives to zero: beyond it the second diode alone would exceed the photocurrent. It is therefore the largest the open-circuit balance can carry, and it gives the lowest reachable , while gives the highest. A target outside that span returns the nearer end, flagged as a boundary fit and reported with the that end actually achieves. Because the search is bracketed, it always terminates with an answer.
The – target instead searches between and , and a target outside the span those ends produce abandons the calibration rather than clamping to it. The calibration also declines to run when the parameter it would derive is switched off in the circuit, because a multiplier over a base of zero cannot express any value.
Propagating the spreads
Section link: Propagating the spreadsThe spread of each derived multiplier is found by a first-order (delta-method) propagation of the target variances. Both derived multipliers influence and , so their variances are solved jointly from a system of local sensitivities. Writing for the multiplier and for the second, and differentiating with respect to and :
Each multiplier is differentiated in the space its own distribution is fitted in, so that the solved variance is the one the fit needs. is always lognormal, so . The second is for the – target, where it is lognormal too, and for the – target, where it is Gaussian. The partial derivatives are estimated by central finite differences about the solved means. For the – target the term is zero, and the system collapses to the simpler case where the spread is carried entirely by and the residual spread by . A singular system or a negative solved variance falls back to that triangular form.
Fitting the derived distributions
Section link: Fitting the derived distributionsand are fitted as lognormals (they enter the diode equation exponentially), while is fitted as a Gaussian floored at a tiny positive multiplier (the backend solver rejects , and a negative series resistance is unphysical, so an over-wide target piles the clamped mass just above zero rather than distorting the distribution). The log-space standard deviation is capped at so that a near-zero local sensitivity cannot inflate the variance without bound.
For the lognormal fits the solved multiplier becomes the distribution’s median, , since that is the value which reproduces the target exactly when the spread is zero. The arithmetic mean that the distribution field stores is then larger by the usual lognormal factor:
The fitted distributions are written back over the two derived parameters, and the population is then sampled and solved exactly as in the sections above.
Because the spreads come from a linearisation about the solved point, the calibration is exact only for a cell sitting at that point: the median cell reproduces the requested and , while the sampled spreads approximate the requested targets and drift as the requested spread widens or the circuit’s response becomes less linear.
Deriving from a measured current-voltage summary
Section link: Deriving from a measured current-voltage summaryDiode parameters can also be derived from a measured , and summary rather than from target multipliers. For a single summary the same coupled inversion described above is used, falling back to the classic single-diode closed form when that pair cannot be fitted:
When the summary is itself given as a distribution, is propagated by Monte Carlo instead: 300 pairs are drawn from the stated means and standard deviations, the closed form above is evaluated for each, and the mean and standard deviation of the result become the derived . then follows from the mean , and its spread is taken as half the gap between the values that an one standard deviation above and below the mean require. Measured summaries quote in mA/cm², which is converted to the A/cm² used everywhere else on this page.
Fill-factor ceiling
Section link: Fill-factor ceilingThe preview also reports a fill-factor ceiling: the highest the population could reach with no second-diode recombination. For each sampled cell it re-solves and with that cell’s own set to zero, and takes the maximum across the population:
Removing the second diode () can only raise a cell’s fill factor, but the maximum-power point is located by a finite bisection rather than in closed form, so the computed is not guaranteed to be monotone in down to the last digit. Taking the larger of each cell’s own and its value removes any need to rely on that monotonicity: the ceiling can never fall below the plotted , so the population maximum is a strict upper bound on the distribution.
Determinism
Section link: DeterminismEvery step above — the seeded generator, the per-parameter seeds, and the numerical solves — is deterministic. The same circuit and the same modifier configuration always reproduce the same preview histograms, which keeps the displayed distributions stable while a user edits unrelated inputs.